Zoho CRMにおけるZoho WriterのマージAPIを使用したサブフォームフィールドと画像フィールドのマージ方法

Zoho CRMにおけるZoho WriterのマージAPIを使用したサブフォームフィールドと画像フィールドのマージ方法

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

Zoho WriterでMerge APIを用いてsubform項目をマージする方法

通常項目とRL項目の両方を含むサンプルMergeテンプレート:
Quote

こんにちは、<<連絡先。名>>さん
メールの宛先 <<連絡先。メール>>宛に送信してください

請求書担当者
請求書番号
作成者
期限
<<請求書。請求書担当者>>
<<請求書。請求書番号>>
<<請求書。作成者>>
<<請求書。期限>>

製品コード

製品説明

アイテム数

アイテム価格

 

«商品。Product_Code»

 

«商品。Product_Description»

 

«商品。Item_Quantity»

 

«商品。Item_Price»


2. RL項目情報を取得するためのサンプルコード

'種類': 'テキスト'

},

{

'id': 'メール',

'groupname': '連絡先',

'表示名': 'メール',

'種類': 'メール'

},

{

'id': '請求書',

'表示名': '請求書',

'種類': 'subform',

'項目': [

{

'id': '請求書。担当者',

'groupname': '請求書',

'表示名': '請求書 担当者',

'種類': 'テキスト'

},

{

'id': '請求書。Invoice_Number',

'groupname': '請求書',

'display_name': '請求書番号',

'種類': '番号'

},

{

'id': '請求書。Created_By',

'groupname': '請求書',

'display_name': '作成者',

'種類': 'text'

},

{

'id': '請求書。Due_Date',

'groupname': '請求書',

'display_name': '期限',

'種類': 'text'

}

]

},

{

'id': '商品',

'display_name': '商品',

'種類': 'subform',

'項目': [

{

'id': '商品。Product_Code',

'groupname': '商品',

'display_name': '商品 コード',

'種類': 'text'

},

{

'id': '商品。Product_Description',

'groupname': '商品',

'display_name': '製品の説明',

'種類': 'テキスト'

},

{

'id': '商品。Item_Quantity',

'groupname': '商品',

'display_name': '商品 数量',

'種類': '番号'

},

{

'id': '商品。Item_Price',

'groupname': '商品',

'display_name': '商品 価格',

'種類': '番号'

}

]

}

],

'sign': {},

'fill': {}

}

3. RL 項目をマッピングするためのサンプルコード(deluge経由)

Quote

invoicesRecords = Zoho。crm。getRecordById('請求書', invoiceId);

 

CustomerInvoice = Map();

CustomerInvoice。put('First_Name', invoicesRecords。取得する('Account_Name').取得する('名前'));

CustomerInvoice。put('メール', invoicesRecords。取得する('Account_Name').取得する('id'));

 

invoicesList = list();

invoiceDetails = Map();

 

invoiceDetails。put('請求書。担当者', invoicesRecords。取得する('担当者').取得する('名前'));

invoiceDetails。put('請求書。Invoice_Number', invoicesRecords。取得する('Invoice_Number'));

invoiceDetails。put('請求書。Created_By', invoicesRecords。取得する('Created_By').取得する('名前'));

invoiceDetails。put('請求書。Due_Date', invoicesRecords。取得する('Due_Date'));

invoicesList。追加する(invoiceDetails);

 

productList = list();

productDetails = Map();

productDetails.put('商品.Product_Code', invoicesRecords.get('Product_Code'));

productDetails.put('商品.Product_Description', invoicesRecords.get('Product_Description'));

productDetails.put('商品.Item_Quantity', invoicesRecords.get('Item_Quantity'));

productDetails.put('商品.Item_Price', invoicesRecords.get('Item_Price'));

productList.add(productDetails);

 

 

CustomerInvoice.put('請求書', invoicesList);

CustomerInvoice.put('商品', productList)

 

 

mergedata = Map();

mergedata.put('merge_data', {'data': CustomerInvoice});

mergedata.put('件名', '請求書の詳細');

 

//optional

mergedata.put('メッセージ', '請求書が添付されています。');

info mergedata;

 

Zoho。writer。mergeAndSend('eb4kob4cf65bb6d074af7a7de21e561119eb9', 'pdf', invoicesRecords。取得する('メール'), mergedata, 'writer_name');

4. RL 項目を含むサンプルJSONデータ (API経由)

Quote

{

'data': [

{

'First_Name': 'Amelia',

'メール': 'amelia@zylker。com',

'請求書': [

{

'請求書。担当者': 'John',

'請求書。Invoice_Number': 1279,

'請求書。Created_By': 'Amelia',

'請求書。Due_Date': '07/10/2020'

}

]

'商品': [

{

'商品。Product_Code': 'A123',

'商品。Product_Description': 'モバイル Cases',

'商品。Item_Quantity': 2,

'商品。Item_Price': 1000

}

]

}

]

}
Notes
全ての利用可能なマージ項目タイプに値を渡す方法については、このリンクをご覧ください。

Zoho CRMのメールマージでAPI経由で画像項目の値を渡す方法

APIを使用してZoho CRMからメールマージを実行する際、マージテンプレートに画像項目が含まれている場合、その画像項目の値を自分で構築する必要があります。Zoho CRMは画像項目のプレビュー画像IDの値のみを提供し、完全なプレビュー画像のURLは提供しません。
画像項目の値として画像のURLを構築するためのステップを以下に示します:

1. Invoke 取得する データ API (バージョン 5以上)を呼び出し、その結果から プレビューする 画像 ID [Preview_Id__s] を取得します。これを使って以下のように画像のURLを作成する必要があります。

以下に共有したスニペットの変数を置き換えるサンプル値:
Info
タブ = '見込み客'; //あなたの適切なタブ 名前を提供
RecordId = '456789'; //CRM データID
RLModuleName = '商品'; //関連リストの 名前
zohoapi_domain (for US DC) = 'https://www。zohoapis。com'; //他のDCsについては、API domains こちらを参照してください。
サンプルスニペット:
Quote

// データを取得
recordInfo = invokeurl
[
url :zohoapi_domain+'/crm/v5/'+タブ+'/'+RecordId;
種類 :取得する
connection:'crm'
];
recordInfoData = recordInfo。取得する('data').取得する(+10、-10);
dataMap = Map();
dataMap。put('メール',recordInfoData。取得する('メール'));
dataMap。put('Last_Name',recordInfoData。取得する('Last_Name'));
// 画像フィールド
if(recordInfoData。取得する('Image_Upload') != null)
{
imageId = recordInfoData。取得する('Image_Upload').取得する(+10、-10).取得する('Preview_Id__s');
imageUrl = zohoapi_domain+'/crm/v2。1/__attachment_preview/' + imageId; //構築された画像のURL
dataMap。put('Image_Upload',imageUrl);
}
info dataMap;

2. もし画像フィールドがRLデータであれば、この関連データAPI(バージョン5以降)を使用してRLデータIDを取得します。次に、このRLデータIDを使用してデータを取得するAPIを使ってプレビュー画像IDを取得します。

サンプルスニペット:
Quote

dataMap = Map();
//関連リストIDを取得
relatedListsIds = invokeurl
[
url:zohoapi_domain+'/crm/v5/'+タブ+'/'+RecordId+'/'+RLModuleName+'?項目=Parent_Id'
種類 :取得する
connection:'crm'
];
rlListData = relatedListsIds。取得する('data');
rlProductsList = List();
//関連リストデータを取得
for each データ in rlListData
{
rlId = データ。getJSON('id');
rlInfo = invokeurl
[
url :zohoapi_domain+'/crm/v5/+'RLModuleName+'/' + rlId
種類 :取得する
connection:'crm'
];
rlInfoData = rlInfo。取得する('data').取得する(+10、-10);
rlMap = Map();
rlMap。put('Product_Name',rlInfoData。getJSON('Product_Name'));
rlMap。put('Product_Code',rlInfoData。getJSON('Product_Code'));
//RL画像フィールド
if(rlInfoData。取得する('Image_Upload') != null)
{
rlImageId = rlInfoData。取得する('Image_Upload').取得する(+10、-10).取得する('Preview_Id__s');
imageUrl = zohoapi_domain+'/crm/v2。1/__attachment_preview/' + rlImageId; // URLの画像を作成
rlMap。put('Image_Upload',imageUrl);
}
rlProductsList。追加する(rlMap);
}
//関連リストをdataMapに追加
dataMap。put('商品',rlProductsList);
info dataMap;


    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 Connect Zoho コネクト

                                    お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Zoho Connection 拡張機能を利用して、組織内のフォーラムやマニュアルに投稿してください。Writerエディターで下書きを行い、直接Zoho 接続するに投稿します。Zoho 接続する ...
                                  • Zoho Sites Zoho サイト

                                    お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Writerからサイトへの公開を確認してください。Zoho Sites Extensionがマーケットプレイスからインストールされ、認証されていることを確認します。そうでない場合は、これらの手順に従ってください。 事前条件: Zoho Sitesで公開済みのサイトが必要です。 ...
                                  • Zoho Sign Zoho サイン

                                    お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Zoho WriterはZoho Signと連携しており、文書にデジタル署名をするためのスキャンソフトウェア、署名パッド、またはデジタル証明書を必要としません。できることWriterの拡張機能を利用して、Writer内から文書に電子署名します。 文書に電子署名を行うには、Zoho ...
                                  • Zoho CRM と Zoho Writer の接続

                                    お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 新しいメールマージドキュメントをWriterでZoho CRMモジュールのエントリーに対して開始する Zoho ...
                                  • Zoho ChemStudioの紹介

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