HubLを使用して、カスタム見積もりテンプレート内でCRMデータにアクセスして、そのデータを表示できます。template_dataオブジェクトは、見積もりに関連付けられているほぼ全てのデータの保持します。そこで見つからないデータには、オブジェクトレコードを見積もりに関連付けるか、HubLのCRM_object関数を使用できます。
@hubspot
フォルダー内にあるcms-quotes-theme
フォルダーに移動します。templates
フォルダー内にあるbasic.html
、modern.html
、またはoriginal.html
テンプレートを表示します。これらのテンプレートの先頭には、以下のコードブロックが含まれています。
mock_data.html
ファイルからインポートされた後、template_data
内のデータ(存在する場合)を使用するためにQUOTE
変数に設定されます。QUOTE
変数は、上記にリストされている他の変数(ASSOCIATED_OBJECTS
など)に値を取り込むためにも使用されます。これにより、簡単なコードで該当のデータににアクセスできます。ただし、好みに応じて別の方法でデータを構造化することもできます。
上記のコードでは、メインのQUOTE
変数を設定するためにtemplate_data
も使用されています。template_data
は、ページ内の見積もりと取引の実データの全てを格納するオブジェクトです。このオブジェクトがテンプレート内で見つからない場合、HubSpotは代わりにmock_data.html
からデータを読み込みます。
template_data
オブジェクトを介してほとんどのデータに、直接アクセスできます。提供されているオブジェクト全体を確認するには、テンプレート内で{{ template_data|pprint }}
を使用します。
変数 | Type | Description |
---|---|---|
template_data | dict | quote、quote.associated_objects、および合計dict数を格納するdict |
変数 | Type | Description |
---|---|---|
template_data.quote | dict | 見積もり自体の全てのデータを格納するdict |
template_data.quote.associated_objects.deal.hs_object_id | Integer | 取引ID |
template_data.quote.hubspot_owner_id | Integer | 取引担当者ID |
template_data.quote.hs_all_owner_ids | integer or array of integers | 全ての取引担当者ID |
template_data.quote.hs_created_by_user_id | Integer | 見積もりを作成したユーザー |
template_data.quote.hs_lastmodifieddate | datetime | 見積もりが最後に更新された日付エポック形式 |
template_data.quote.hubspot_owner_assigneddate | datetime | 見積もりに担当者が割り当てられた日付エポック形式 |
template_data.quote.hs_createdate | datetime | 見積もりが作成された日時エポック形式 |
template_data.quote.hs_expiration_date | datetime | 見積もりの有効期限が切れる日付エポック形式 |
template_data.quote.hs_title | String | 見積もりのタイトル |
template_data.quote.hs_template_type | String | ”CUSTOMIZABLE_QUOTE_TEMPLATE” |
template_data.quote.hs_slug | String | 見積もりウェブページのURLスラッグ |
template_data.quote.hs_proposal_template_path | String | デベロッパー ファイル システムでのテンプレートのパス(ファイル拡張子を含む) |
template_data.quote.hs_quote_amount | String | 金額 |
template_data.quote.hs_currency | String | 見積もり金額の通貨(3文字のISO 4217通貨コード形式)“USD” |
template_data.quote.hs_language | String | 言語コード”en” |
template_data.quote.hs_locale | String | ロケールコード”en-us” |
template_data.quote.hs_terms | String | 見積もり作成者が指定した条件テキスト |
template_data.quote.hs_sender_firstname | String | 見積もりの送信者の名 |
template_data.quote.hs_sender_company_name | String | 見積もりの送信者の会社名 |
template_data.quote.hs_sender_company_image_url | String | 見積もりの送信者の会社ロゴ |
template_data.quote.hs_status | String | 見積もりのステータス”APPROVAL_NOT_NEEDED” |
template_data.quote.hs_primary_color | string/hex color code | ”#425b76” |
template_data.quote.hs_quote_number | String | 一意の見積もりID番号 |
template_data.quote.hs_payment_enabled | boolean | 支払いフィールドを表示する必要があるかどうかをテストするために使用 |
template_data.quote.hs_esign_enabled | boolean | 電子署名フィールドを表示する必要があるかどうかをテストするために使用 |
template_data
内で他の変数にもアクセスできます。これらを表示するには、|pprint
をご利用ください。また、見積もりの関連付けに含まれる一部の変数は、見積もり/取引に基づいてのみ使用できます。今後もこのドキュメントで、アクセスできる他のデータに関する情報をご紹介していきます。プリティープリントに加え、cms-quote-theme内にあるモック データ ファイルを表示して、利用可能なデータとその構造を確認することもできます。associated_objects
を使用して、見積もりに関連付けられているレコード内のデータ(取引、会社など)にアクセスできます。
例えば次のコードを使用すると、見積もりの受信者に関連付けられている会社レコード内の会社ロゴを見積もりに追加できます。
if
ステートメントを使用して、検出されたロゴをテンプレートに表示します(利用可能な場合)。会社のロゴが手動で設定されていない場合、ロゴは表示されません。
template_data
内でカスタムオブジェクトが関連付けられます。例えば、取引に関連付けられたカスタムオブジェクトが含まれます。
これらのオブジェクトにアクセスするには、次のコードを使用します。
template_data.quote.associated_objects.deal.associated_objects.custom_objects._2_2193031
crm_associations()
関数とcrm_objects()
関数を使用して、カスタムオブジェクトを検索することもできます。
例えば、取引に関連付けられているカスタムオブジェクトを検索する場合は、次のようにtemplate_data
からデータを渡します。