【TECH COLUMN】SalesforceとViewFramerとD3WorkerとAdobe Signの連携 – OPSS - 株式会社オプロ

[toc]

概要

Salesforceのレコードから契約書を生成してAdobe Signに送るまでの流れを説明します。

OPROARTS Liveで帳票のテンプレートをデザインします。
本記事では以下のような帳票デザインを使用して説明します。

CSVデータを受け取る設定は以下のようにします。

以下のようにマッピングします。

上の画像の赤枠で囲んだ部分のデータは以下のようになっています。

本記事ではSalesforceの取引先オブジェクトと取引先責任者オブジェクトから契約書を出力する場面を想定しますので、特別な設定は不要です。

OPROARTSで生成した帳票をAdobe Signに連携するために、以下のサービスを使用します。

OPROARTSサービスとAdobe Signサービスのそれぞれを基にしたサービスを作成します。
サービスの設定に関しては、以下の記事を参照してください。

基本設定にて名称を決定したら、文書化サービスと配送サービスのそれぞれに作成した2つのサービスを指定します。

どちらのサービスについても、設定の変更をせずに保存します。

基本設定にて名称を決定したら、以下のように設定します。

データソース

ViewFramerから受け渡されるCSVのフィールドを指定します。
エンベロープ

エンベロープフィールドに「ContractCompany」を、アクティブ化するフィールドに「エンベロープフィールド」を指定して、「ELSEとして使用する」にチェックを入れます。
文書とデータのマッピング

生成されるPDF文書の名前と作成した帳票テンプレートの名前を入力したら、帳票テンプレートで指定したCSVフィールドの順番と同じになるようにデータセットのフィールド値を設定します。

⚠️

注意

帳票テンプレートの名前には、はじめに「live_」を付けてください。
作成したテンプレートの名前が「template_name」である場合は、ここで入力する値は「live_template_name」になります。

⚠️

注意

同じウェブブラウザーで複数のビューやマッピングを参照・編集すると上書きされてしまいます。
必ず1つのタブで操作してください。

既存のビューを参考にしたい場合は、別のブラウザーで参考にしたいビューを開いてください。
ただし、同時編集はできませんので参照のみにしてください。
また、別のブラウザーにした場合も複数のビューを開くことは避けてください。

基本設定にて名称を決定したら、以下のように設定します。

リレーション設定

取引先IDを用いて取引先責任者と取引先のリレーション設定をします。
出力設定

帳票に出力する値を指定します。

Addressの項目（赤枠で囲んだ部分）については以下のように記述しています。
出力条件設定

パラメータ（ここでは「ID」）を設定し、その値と等しい取引先責任者IDを持つレコードのみを出力対象にします。
パラメータ「ID」の値には、出力時にSalesforceで開いている取引先責任者レコードのIDが入ります。

作成したビューとD3Workerのワークを結びつけるために、マッピングを作成します。
「マッピング：定義」画面では以下のように指定します。

続いて「マッピング：定義：出力設定」画面の「D3Worker」タブをクリックし、作成したワークのデータソースと作成したビューの項目を結びつけます。

設定が終わったら、「配備」をクリックします。

ViewFramerのマッピング一覧画面で、呼び出したいマッピングの「APIサンプル」欄にある「APIサンプル」ボタンをクリックします。
サービスで「D3Worker」を選択し、「Visualforceページ」ボタンをクリックします。
契約書を生成してAdobe Signへ送るためのカスタムVisualforceページがダウンロードされます。