[toc]

概要

本記事では、D3Workerの「Salesforce Files [配送] - セッション」サービスの設定方法について説明します。
このサービスを使用することで、リクエストの度にセッションIDをやり取りして、異なるSalesforce組織やユーザーを用いた文書登録が可能になります。

前提条件

Salesforce Filesを使用して、ライブラリとオブジェクトにD3Workerが文書化サービスで取得したドキュメントを登録するサービスです。オブジェクトに対しては、ドキュメントを登録せずに、レコードの作成や更新のみを行うことができます。

「Salesforce Files [配送]」サービスとの主な違いは、接続方法にあります。

Salesforce Files [配送]

事前にSalesforceの接続情報をサービス設定に登録します。固定の組織・ユーザーで文書を取得します。
Salesforce Files [配送] - セッション

リクエストの度にセッションIDをやり取りすることで、Salesforceへの接続を行います。
リクエストの内容に応じて異なる組織やユーザーを使用して文書を取得することが可能です。

「Salesforce Files [配送] - セッション」をご利用の際は、以下の4つの情報が必要になります。
帳票出力を行うSalesforceオブジェクトにこれらの項目を追加してください。

セッション接続系サービスの「Salesforceの接続情報」（セッションID／組織ID／ユーザーID／インスタンスURL）は、カスタム数式項目を対象のSalesforceオブジェクトに作成することで、Salesforceのレコードから取得できるようになります。

表示ラベル（例）	API参照名（例）	データ型	数式
セッションID	SessionId	数式（テキスト）	`$Api.Session_ID`
組織ID	OrgId	数式（テキスト）	`$Organization.Id`
ユーザーID	UserId	数式（テキスト）	`$User.Id`
インスタンスURL	InstanceURL	数式（テキスト）	`LEFT($Api.Partner_Server_URL_350, FIND("/services/Soap/", $Api.Partner_Server_URL_350))`

⚠️

注意

上記4項目はすべて数式項目のため、ユーザーがアクセス・参照する度に評価され、値が変動します。

D3Workerへログインします。
ログイン後、「サービス」タブを選択します。
サービスを定義するため、「新規作成」を選択してください。
サービスタイプの選択にて「Salesforce Files [配送] - セッション」を選択します。

⚠️

注意

ご利用中のD3Workerテナントで当サービスが存在しない場合は、弊社サポートにお問い合わせください。
サービス内の各項目を設定していきます。
Salesforceの接続情報はエンベロープで設定する為、空白にします。
サービスで使用するセッションIDについては、セッションID用のエンベロープパラメータを用意し、D3Workerのデータソース経由で受け渡すことになります。

Salesforceの接続情報より下の各設定項目は、「Salesforce Files [配送]」サービス設定記事で説明している内容と同じです。設定方法は上記記事を参照してください。
設定が完了したら保存します。

「エンベロープ」タブを選択します。
エンベロープを定義するため、「新規作成」を選択してください。
「配送サービス」タブを選択します。
手順3~5で作成したサービス（Salesforce Files [配送] - セッション）を選択します。
配送サービス内の各項目を設定します。

Salesforceの接続情報
下部の画像のように、事前準備で作成した「インスタンスURL、セッションID、ユーザID、組織ID」をSalesforceから値を受け取るため、例：{インスタンスURL}のようなパラメータを作成してください。
設定が完了したら保存してください。