本記事では、D3Workerの「Salesforce Files [配送] - セッション」サービス設定方法をご紹介します。
<D3Workerのサービス「Salesforce Files [配送] - セッション」とは>
Salesforce Filesを使用して、ライブラリとオブジェクトにD3Workerが文書化サービスで取得したドキュメントを登録するサービスです。
オブジェクトに対しては、ドキュメントを登録せずに、レコードの作成や更新のみを行うことができます。
「Salesforce Files [配送] 」サービスが事前にSalesforce の接続情報を登録しておくのに対して、「Salesforce Files [配送] - セッション」サービスではD3Workerへのリクエストの度にセッションIDをやり取りすることでSalesforce への接続を行います。
そのためリクエストの内容に応じて異なる組織やユーザーを用いて文書を登録することが可能です。
では、早速サービスの設定についてご説明します。
＜サービスの設定方法＞
１．D3Workerへログインします。
２．ログイン後、「サービス」タブを選択します。
３．サービスを定義するため、「新規作成」を選択します。
４．サービスタイプの選択にて「Salesforce Files [配送] - セッション」を選択します。
※ご利用中のD3Workerテナントで当サービスが存在しない場合、弊社サポートにお問合せください。
5．サービス内の各項目を設定していきます。
サービスで使用するセッションIDについては、セッションID用のエンベロープパラメータを用意し、D3Workerのデータソース経由で受け渡すことになります。
| 項目名 | 指定する内容 |
|---|---|
| インスタンスURL | 文書登録先Salesforce組織のインスタンスURLを入力します。 インスタンスURLは以下のURLで、インスタンス名については設定の組織情報から確認可能です。 https://{インスタンス名}.salesforce.com |
| セッションID | セッションIDを指定します。 サービス設定画面では指定せず、エンベロープ設定画面でセッションID用のエンベロープパラメータを用意します。 |
| ユーザーID | 文書登録先Salesforce組織にログインするユーザーIDを入力します。 |
| 組織ID | 文書登録先Salesforce組織の組織IDを入力します。 |
それより下の各設定項目については「Salesforce Files [配送] 」サービス設定記事で説明している内容と同じですので割愛させていただきます。
設定のイメージをつかんでいただければ幸いです。
「Salesforce Files [配送] - セッション」をご利用の際はご活用ください。
補足
「 - セッション」が付いている方のSalesforce Filesサービスでは、Salesforceの「セッションID」「組織ID」「ユーザID」「インスタンスURL」の4つの情報が必要になります。
これら4つの情報は、以下のカスタム数式項目を対象の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)) |
※組織IDとユーザIDが固定の場合は「セッションID」と「インスタンスURL」項目の作成でOKです。サービス設定画面で組織ID・ユーザIDの固定値を指定してください。
※上記4項目はすべて数式項目のため、ユーザがアクセス・参照する度評価され値が変動します。