帳票テンプレートの識別子の書き方

サンプルテンプレート

帳票テンプレートの例として、「見積書」のサンプルファイル（Excelファイル）を用意しています。

サンプルファイルは、以下からダウンロードが可能です。
ダウンロード：見積書サンプルテンプレート

識別子の基本

識別子とは、帳票テンプレート内でeセールスマネージャーのデータを差し込む位置を指定するための、特別な文字列のことです。
作成したExcelファイルのセルに、データを差し込みたい箇所には、以下のように識別子を記載します。

（例）顧客アプリの「顧客名」項目の値を指定する場合

【esm】{{customers.customer.customer_name}}

• 「【esm】」で始まるものだけが置換されます。「【esm】」のない{{ }}や${ }は、書いたままの文字として出力されます。
• セルの中に、他の文字と混ぜて記載することも可能です。
  例：TEL: 【esm】{{customers.customer.tel_no}} → TEL: 0312345678
• 1つのセルに、複数の識別子を並べて記載することも可能です。
• チェックボックスの複数選択や複数の紐づきなど、値が複数ある項目は、「、」区切りで1セルに連結されます。
  行に分けたい場合は、以下ををご参照ください。
関連リンク：明細を行で繰り返す（ループ）

識別子の調べ方

{{ }}の中身は、eセールスマネージャーの項目編集画面の［高度な設定］にある［識別子］からコピーできる文字列を、そのまま使用します。
コピーできるのは項目のフルパスです。
例：顧客アプリの［顧客名］
customers.customer.customer_name

項目型の対応可否

項目型ごとの対応可否は以下のとおりです。
対応している項目型のうち、書き方に注意が必要なものは、この後の各セクションで説明します。

数値項目と数式

数値項目は、Excel上で計算に利用できる数値としてセルへ出力されます。

• 桁区切りや通貨表示は、Excelテンプレートのセル書式で設定します。
• SUMなどのExcel数式を使用できます。
• 数値として扱えない値は、文字列として出力されます。

住所項目を差し込む

住所項目は、郵便番号・住所・建物名を個別に指定して出力します。

（例）住所項目（type_address1）の郵便番号・住所・建物名を指定する場合

〒【esm】{{...type_address1.zipcode}}　【esm】{{...type_address1.street}} 【esm】{{...type_address1.building}}

画像を差し込む

ファイル項目の識別子を通常どおり記載すると、その位置に画像として埋め込まれます。
特別な記法は不要です。

別データの項目をたどって差し込む

通常の紐づき項目から、紐づき先の項目を出力したい場合は、識別子を@でつなぎます。
@の左側には「紐づき項目」、右側には「紐づき先で出力したい項目」の識別子を記載します。

（例）顧客に紐づく取引の「単価」項目の値を指定する場合

【esm】{{customers.customer.relational_trading_product@deals.deal.unit_price}}

• 先頭には、帳票を出力する対象アプリの項目を指定します。
• 識別子同士は@でつなぎます。
• @は最大2つまで使用でき、最大3階層までたどれます。
• 途中に指定する項目は、紐づき項目である必要があります。

特殊な紐づき項目：自社担当者・当日面談者・受取人・紹介元・社外担当者・コンタクト先

以下の項目は、eセールスマネージャー内部の構造が他の紐づき項目と異なる、特殊な項目です。
項目ごとの指定方法は以下のとおりです。

また、以下の項目は@でつながず、単独の識別子として記載します。

• 当日面談者の「参加者名」
• 受取人の「受取日」
• 紹介元の「紹介日」
• 社外担当者の「社外担当者名」

eセールスマネージャー上でコピー不可の識別子

「主担当」、「紹介元」、「コンタクト先の名刺」は、eセールスマネージャー上で識別子をコピーできません。
以下の記載例を参考に、使用してください。

【esm】{{customers.customer.charge_employee@customers.charge_employee.main_charge@employees.employee.employee_name}}

【esm】{{customers.customer.charge_department@customers.charge_department.main_charge@employees.department.department_name}}

【esm】{{customers.customer.charge_group@customers.charge_group.main_charge@employees.common_group.common_group_name}}

【esm】{{business_cards.business_card.introduction_source@business_cards.introduction_source.source_business_card_id@business_cards.business_card.business_card_full_name}}

【esm】{{customers.customer.relational_business_card_info@business_cards.business_card_info.relational_businesscard@business_cards.business_card.business_card_full_name}}

【esm】{{businessplans.businessplan.relational_business_card_info@business_cards.business_card_info.relational_businesscard@business_cards.business_card.business_card_full_name}}

【esm】{{customers.customer.relational_business_card_info@business_cards.business_card_info.text_business_card_name}}

明細を行で繰り返す（ループ）

紐づくレコードの件数分だけ行を増やしたい場合は、loop:を付けます。

（例）顧客に紐づくすべての取引について、1件ずつ行を増やしながら「単価」項目の値を出力する場合

【esm】{{loop:customers.customer.relational_trading_product@deals.deal.unit_price}}

その行が、データの件数分だけ下方向に複製されます。
罫線・塗りつぶしなどの書式も複製されます。