[toc]

概要

本記事では、D3Workerの「Salesforce Files [文書化] - セッション」サービスの設定方法を説明します。
セッションIDを使用して動的にSalesforceへ接続し、異なる組織やユーザーからファイルを取得する手順を分かりやすくご紹介します。

前提条件

Salesforce Files [文書化] - セッションサービスは、Salesforce Files上のファイルを文書として扱うサービスです。
ライブラリまたは添付からファイルを取得します。

「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項目はすべて数式項目のため、ユーザーがアクセス・参照する度に評価され、値が変動します。

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

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