Zoho WriterのマージAPIを使用する際のマージフィールドIDとサブフォームフィールドの管理方法

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

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

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

2. マージ項目IDの取得方法とMerge APIでの使用方法

オプションA: Writerユーザーインターフェイスで項目IDを取得する方法

マージテンプレートを開き、左側のパネルにある自動化タブに移動します。
マージパネルで項目の管理をクリックし、項目IDを表示を選択して正確な項目IDを取得します。
サブフォーム項目IDの場合：
- サブフォームタブに移動します。
- サブフォームを展開し、項目IDを表示をクリックして項目IDを表示・コピーします。

メイン項目ID

サブフォーム項目ID

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

項目IDは、WriterのREST APIやDelugeタスクを利用してプログラム上でも取得できます。

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

PDFテンプレート上の繰り返し領域でサブフォームの値を表示・置換する際に、技術的な制限があることが確認されています。この制限の解消と、PDFテンプレートでの繰り返し領域のマージ体験向上に向けて、現在対応中です。

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

4. WriterでMerge APIにサブフォームまたは関連リストの項目を渡す方法

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

サブフォーム項目をマッピングする手順：

Writerのマージテンプレートで、繰り返しボタンを詳細Merge項目の下で使用し、サブフォームテーブルまたは繰り返し領域を挿入します。
サブフォームや関連リスト項目のマージ項目IDを（質問2で説明した方法で）取得し、下記の形式で入力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': '仕様',

'商品。item_replacement': 'はい'

{

'商品。item_code': '1278',

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

'商品。item_description': '仕様',

'商品。item_replacement': 'はい'

}

]

}

]

}

例#2: Sample コードでサブフォーム／関連リスト項目をDelugeでマッピングする方法

マージデータにサブフォームが2つ含まれている場合、たとえば商品とrepairsがある場合、次の方法を使用します。

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': '
仕様
itemmap。put('商品。item_replacement': 'はい');
itemsList。追加する(itemmap);
 
//subform2 
repairList = list();
repairDetails = Map();
repairDetails。put('Repairs。Service_code', 'R100');
repairDetails。put('Repairs。説明', 'ベルト不良');
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');