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

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

Zoho WriterでMerge APIを使用してサブフォーム項目をマージする方法

1. 関連（RL）項目を含むWriterでMergeテンプレートを作成する

普通とRL項目の両方を含むMergeテンプレートの例：

こんにちは、<<連絡先。名>>

メールを送る先：<<連絡先。メール>>

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

製品コード

製品説明

アイテムの数量

アイテムの価格

«商品。Product_Code»

«商品。Product_Description»

«商品。Item_Quantity»

«商品。Item_Price»

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

アイテム = invokeurl

[

url: 'https://zohoapis.com/writer/api/v1/ドキュメント/eb4kob4cf65bb6d074af*******/アイテム '

タイプ: 取得する

コネクション:'writercrm'

];

情報アイテム;

document_id -> これはドキュメントを開くURLから取得できます: https://{{ドメイン}}/writer/開く/eb4kob4cf65bb6d074af****************

例: document_id='eb4kob4cf65bb6d074af****************'

コネクション名 -> Delugeのコネクションおよびその作成方法については、このリンクを参照してください。

例: コネクション名='writer_name'

手順2のサンプルレスポンス:

{

'merge': [

{

'id': 'First_Name',

'groupname': 'コンタクト',

'display_name': '名',

'種類': 'テキスト'

{

'id': 'メール',

'groupname': '連絡先',

'display_name': 'メール',

'種類': 'メール'

{

'id': '請求書',

'display_name': '請求書',

'種類': 'サブフォーム',

'項目': [

{

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

'groupname': '請求書',

'display_name': '請求書担当者',

'種類': 'テキスト'

{

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

'groupname': '請求書',

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

'種類': '番号'

{

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

'groupname': '請求書',

'display_name': '作成者',

'種類': 'テキスト'

{

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

'groupname': '請求書',

'display_name': '期限',

'種類': 'テキスト'

}

]

{

'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経由）

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.取得する('Product_Code'));

productDetails.put('製品.Product_Description', invoicesRecords.取得する('Product_Description'));

productDetails.put('製品.Item_Quantity', invoicesRecords.取得する('Item_Quantity'));

productDetails.put('製品.Item_Price', invoicesRecords.取得する('Item_Price'));

productList.追加する(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 経由)

{

'data': [

{

'First_Name': 'Amelia',

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

'invoice': [

{

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

'請求書。Invoice_Number': 1279,

'請求書。作成者': 'Amelia',

'請求書。支払い期限': '07/10/2020'

}

]

'商品': [

{

'商品。Product_Code': 'A123',

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

'商品。Item_Quantity': 2,

'商品。Item_Price': 1000

}

]

}

]

}

合併項目の種類に対して値を渡す方法を理解するためには、このリンクを参照してください。

Zoho CRMのメールマージへの画像項目値の渡し方

私たちのマージAPIを使用してZoho CRMからメールマージを行う際、マージテンプレートに画像項目が含まれている場合は、画像項目の値を自分で生成する必要があります。Zoho CRMは画像項目のプレビュー画像ID値のみを提供し、完全なプレビュー画像URLは提供しません。

画像URLを生成し、画像項目値として渡すための以下の手順に従ってください：

1. データAPIを呼び出す（バージョン5以上）し、該当する画像項目差出人のプレビュー画像ID [Preview_Id__s]を取得します。以下のように、このプレビュー画像IDを使って画像のURLを構築する必要があります。

以下のスニペットで使用する変数のサンプル値:

タブ = '見込み客'; //あなたの対応するタブ名を提供してください

RecordId = '456789'; //CRMデータのID

RLModuleName = '商品'; //関連リストの名前

zohoapi_domain (USデータセンター用) = 'https://www。zohoapis。com'; //その他のデータセンターはAPIドメインをこちらを参照してください。

サンプルスニペット:

// データを取得する

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データである場合、この関連データDataAPIを利用してRLデータIDを取得します（バージョン5以上）。その後、このRLデータIDを含むデータを取得するAPIを呼び出してプレビュー画像IDを取得します。

サンプルスニペット:

dataMap = Map();

///取得する関連リスト IDs

relatedListsIds = invokeurl

[

url:zohoapi_domain+'/crm/v5/'+タブ+'/'+RecordId+'/'+RLModuleName+'?項目=Parent_Id'

種類 :取得する

connection:'crm'

];

rlListData = relatedListsIds。取得する('data');

rlProductsList = List();

//取得する関連リスト Data

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);

}

//追加する関連リスト to dataMap

dataMap。put('商品',rlProductsList);

info dataMap;

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

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

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

詳細・お申し込みはこちら

Zoho Workerly Home
Forums
Connect With Us:

Zoho Recruit Home
Forums
Connect With Us:

Zoho コミュニティオンラインフォーラム

フォーラムをフォローして、Zoho ユーザーによる活用のノウハウやアドバイスを入手。サービスのアップデート情報やユーザー向けイベントの告知について通知を受け取りましょう。

詳細・フォローはこちら

Zoho WorkDrive Resources

Zoho Desk Resources

Desk Community Learning Series
Digest
Functions
Meetups
Kbase
Resources
Glossary
Desk Marketplace
MVP Corner
Word of the Day

New to Zoho Workerly?

Access Zoho Workerly

New to Zoho Recruit?

Access Zoho Recruit

New to Zoho CRM?

Signup Now

Access Zoho CRM

Latest Feature Updates

New to Zoho Projects?

Access Zoho Projects

New to Zoho Sprints?

Access Zoho Sprints

New to Zoho Assist?

Access Zoho Assist

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.

Watch Now

eBooks

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

Download eBooks

Webinars

CRM Tips

Make the most of Zoho CRM with these useful tips.

Learn More

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

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

Zoho WriterでMerge APIを使用してサブフォーム項目をマージする方法

1. 関連（RL）項目を含むWriterでMergeテンプレートを作成する

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

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

4. RL フィールドを含むサンプル JSON データ (API 経由)

Zoho CRMのメールマージへの画像項目値の渡し方

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

Zoho コミュニティ オンラインフォーラム

Zoho WorkDrive Resources

Related Articles

Zoho Connect Zoho コネクト

Zoho Sites Zoho サイト

Zoho Sign Zoho サイン

Zoho CRM と Zoho Writer の接続

Zoho ChemStudioの紹介

Resources

Videos

eBooks

Webinars

CRM Tips

Zoho コミュニティオンラインフォーラム