Zoho Writerのマージテンプレートでrecord_idパラメータを使用する方法

Zoho Writerのマージテンプレートでrecord_idパラメータを使用する方法

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

Zoho Writerのrecord_idパラメーターをマージテンプレートで使用することで、record_id値に基づいて必要な項目の値を簡単に取得できます。この新しいパラメーターを利用すれば、Delugeコードでテンプレート内の頻度項目を手動でマッピングする必要がありません。

record_idパラメーター利用の前提条件

record_idパラメーターを利用する前に、以下の条件を満たしていることを確認してください。
  1. マージテンプレートがデータ元と接続済みである必要があります。
  2. データ取得元のデータ元に対する必要な権限があること。
  3. ドキュメントを生成するために十分な自動化クレジットを保有していること。クレジットと料金の詳細はこちら。

Merge APIが対応するZohoアプリ

現時点では、Merge APIは以下のZohoアプリと連携し、record_idを利用して該当データを取得できます。
  1. Zoho CRM
  2. Zoho Creator
  3. Bigin
  4. Zoho Recruit

サンプルコード

以下は、Delugeコード内でrecord_idパラメーターを利用し、Zoho CRMの特定データをWriterテンプレートへマージする例です。
  1. document_id = '4tx4ie20882e93a3b40a58a613213b5491b99';
  2. recordId = '154845000004785001';
  3. outputsettings = Map();
  4. outputsettings.put('doc_name','Student Grade PDF');
  5. outputsettings.put('folder_id','mt3vx64b53cadf1dxxxxxxxxxxx');
  6. outputsettings.put('output_format','pdf');
  7. param = Map();
  8. param.put('record_id',recordId);
  9. param.put('output_settings',outputsettings);
  10. response = invokeurl
  11. [
  12. url :'https://zohoapis.com/writer/api/v2/ドキュメント/1mg03e345d3ecbe4241958089f6cd9a55421d/merge/store'
  13. 種類 :POST
  14. パラメーター:param
  15. connection:'writercrm'
  16. ];
  17. info response;
このDelugeコードは指定されたrecord_idに該当するデータを取得し、ドキュメントテンプレートにマージして、パーソナライズされたドキュメントを動的に生成します。

record_idパラメーターのメリット

  1. 必須データとその項目は取得済みで、データIDを使って自動的にマッピングされます。
  2. プロセスは正確で、エラーがありません。
  3. 自動化により、時間と労力を節約できます。
record_idパラメータがDelugeコードをどのように簡素化するかについては、こちらのフォーラム投稿をご参照ください。