Zoho Writerの差し込みAPIでのマージフィールドIDとサブフォームフィールドの管理方法

Zoho Writerの差し込みAPIでのマージフィールドIDとサブフォームフィールドの管理方法

お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

1. マージ処理中にマージ項目の値が正しく差し込まれたり置換されたりしないのはなぜですか?

マージ値が正しく置き換えられない、または出力ドキュメントで欠落している場合、マージ入力データ内で正しい項目 ID に値が渡されていない可能性があります。この問題を回避するには、正確な項目 ID を使用していることを確認してください。

2. マージ項目 ID を取得し、Merge API で使用する方法

オプション A:Writer のユーザーインターフェイスから項目 ID を取得する
  1. マージテンプレートを開き、左側パネルのAutomateタブに移動します。
  2. マージパネルで項目を管理をクリックし、項目 ID を表示を選択して、正確な項目 ID を取得します。
  3. サブフォーム項目 ID の場合:
    • Subformタブに移動します。
    • サブフォームを展開し、項目 ID を表示をクリックして項目 ID を表示・コピーします。

メイン項目 ID


サブフォーム項目 ID


オプション B:API を使用して項目 ID を取得する

項目 ID は、Writer の REST APIDeluge タスクを使用してプログラムから取得することもできます。

3. PDF テンプレートでサブフォームや複数行項目の値が正しくマージされないのはなぜですか?

PDF テンプレート内の繰り返し領域でサブフォームの値を表示・置換する際には、既知の技術的な制限があります。この制限を解消し、PDF テンプレートでの繰り返し領域のマージにおけるユーザー体験を改善できるよう、現在対応を進めています。

回避策データが正しく反映されるようにするには、テンプレート内にテキストボックスを挿入し、その中に繰り返しテーブルまたは繰り返し領域を配置してください。これにより、データが期待どおりにマージされます。


マージテンプレートでは、サブフォーム項目や関連リスト項目は、正しくマージされるように特定の形式で渡す必要がある特別なマージ項目です。

サブフォーム項目をマッピングする手順:
  1. Writer のマージテンプレートで、繰り返しボタン(詳細マージ項目内)を使用して、サブフォームテーブルまたは繰り返し領域を挿入します。
  2. 前述の質問 2 の手順に従ってサブフォーム項目や関連リスト項目のマージ項目 ID を取得し、以下の形式で入力 JSON データ内に値をマッピングします。
例 #1:API 経由でサブフォーム/関連リスト項目を含むマージ入力データを指定するサンプルコード

{

'data': [

{

'customer_name': 'Amelia',

'customer_address': '13th 町名・番地, USA',

'customer_email_address': 'amelia@zylker.com',

'customer_phone_number': '9876543210',

'invoice_number': '123456',

'商品': [

{

'商品。item_code': '123',

'商品。item_name': 'Fastrack Revoltt FS1',

'商品。item_description': 'Specifications',

'商品。item_replacement': 'はい'

},

{

'商品。item_code': '1278',

'商品。item_name': 'Samsung Refrigerator',

'商品。item_description': 'Specifications',

'商品。item_replacement': 'はい'

}

]

},

{
'customer_name': 'John',
'customer_address': '15th 町名・番地, India',
....
}

]

}
例 #2:Deluge でサブフォーム/関連リスト項目をマッピングするサンプルコード

マージデータに、商品repairsのように 2 つのサブフォームが含まれている場合は、次の方法を使用します。
  • CRM、Recruit、People などとの連携では、getRecordsなどの API を使用してデータを取得します。
  • 上記の例のように、メイン項目とサブフォーム項目の両方に値をマッピングします。

dataMap = Map();

recordsData。put('customer_name': 'Amelia');

recordsData。put('customer_address': '13th 町名・番地 USA');

recordsData。put('customer_email_address': 'amelia@zylker.com');

recordsData。put('customer_phone_number': '9876543210');

recordsData。put('invoice_number': '123456');

 

// サブフォーム 1

itemsList = list();

itemMap = Map();

itemmap。put('商品。item_code': '123');

itemmap。put('商品。item_name': 'Fastrack Revoltt FS1');

itemmap。put( '商品。item_description': '<p><b>Specifications</b></p>');

itemmap。put('商品。item_replacement': 'はい');

itemsList。追加する(itemmap);

 

// サブフォーム 2

repairList = list();

repairDetails = Map();

repairDetails。put('Repairs。Service_code', 'R100');

repairDetails。put('Repairs。説明', 'Faulty belt');

repairDetails。put('Repairs。数量', '5');

repairDetails。put('Repairs。価格', 10000);

repairList。追加する(repairDetails);

 

recordsData。put('商品', itemsList);

recordsData。put('Repairs', repairList)

 

mergedata = Map();

mergedata。put('merge_data', {'data': recordsData});

// 以下のように、このマージデータを該当するマージ API に渡します

 

Zoho。writer。mergeAndSend('eb4kob4cf65bb6d074af7a7de21e561119eb9', 'pdf', 'amelia@zylker.com', mergedata, 'writer_name');

その他の詳細については、CRM 連携ガイドを参照してください。

Notesすべてのマージ項目タイプに値を渡す方法についての詳細なガイドは、マージ項目の包括的ドキュメントを参照してください。

    Zoho CRM 管理者向けトレーニング

    「導入したばかりで基本操作や設定に不安がある」、「短期間で集中的に運用開始できる状態にしたい」、「運用を開始しているが再度学び直したい」 といった課題を抱えられているユーザーさまに向けた少人数制のオンライントレーニングです。

    日々の営業活動を効率的に管理し、導入効果を高めるための方法を学びましょう。

    Zoho CRM Training



              Zoho Campaigns Resources

                Zoho WorkDrive Resources




                  • Desk Community Learning Series


                  • Digest


                  • Functions


                  • Meetups


                  • Kbase


                  • Resources


                  • Glossary


                  • Desk Marketplace


                  • MVP Corner


                  • Word of the Day


                  • Ask the Experts









                                  • Related Articles

                                  • Zoho Writerでの引用と参考文献の追加方法

                                    お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 概要 Zoho Writer では、研究論文や卒業論文を作成する際に参照した資料を一覧にするための引用と参考文献リストを追加できます。引用のコピー、編集、削除も行えます。 Zoho Writer で利用できる引用スタイル APA(第7版) MLA(第8版) ...
                                  • Zoho Writerで画像を挿入する方法

                                    お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 概要 画像はコンテンツを視覚的に強化し、アイデアをより効果的に伝えるのに役立ちます。Zoho Writer では、デバイス、オンラインライブラリ、接続済みサービスなど、複数のソースから画像を挿入できます。 前提条件 画像を使用する権利またはライセンスを保有していることを確認します。 ...
                                  • Zoho ChemStudio拡張機能で化学構造式を挿入する方法

                                    お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 概要 Zoho Writer で Zoho ChemStudio 拡張機能を使用すると、ChemStudio で作成した化学構造式を画像としてドキュメントに直接挿入できます。これにより、ツールを切り替えることなく、プロフェッショナルなドキュメントを作成できます。 前提条件 Zoho ...
                                  • Zoho Writerでの画像の配置方法

                                    お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 概要 配置コントロールを使うと、画像をテキストと同じ行に配置したり、ページ上で浮かせて配置したりと、思いどおりの位置に置くことができます。あらかじめ用意されたプリセットや詳細なカスタム設定を使用して、画像をページ、余白、段、または段落に対して揃えることができます。 手順 ...
                                  • Zoho Writerで記入可能なフォームを共有する方法

                                    お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 概要 Zoho Writer では、入力可能フォームを Zoho ユーザーと Zoho 以外のユーザーの両方と共有できます。アクセス権限の設定、パスワード保護の有効化、有効期限の設定、必要に応じたアクセスの取り消しによって、受信者のフォームへの操作方法を制御できます。 前提条件 ...

                                  Resources

                                  Videos

                                  Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                  eBooks

                                  Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                  Webinars

                                  Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                  CRM Tips

                                  Make the most of Zoho CRM with these useful tips.