[toc]
概要
このページでは、D3Workerが提供するサービス「Salesforce [配送]」の設定方法について説明します。
このサービスを利用することで、指定されたSalesforceのオブジェクトにレコードを登録し、文書を添付することができます。
本サービスの新規提供は終了しております。
新サービスの「Salesforce Files [配送]」または「Salesforce Files [配送] - セッション」をご利用ください。
「Salesforce [配送]」とは
指定されたSalesforceのオブジェクトにレコードを登録し、文書化サービスで取得したドキュメントを添付する配送サービスです。
ファイルを添付せず、指定したオブジェクトの特定の項目をD3Workerに送られたデータで更新するといった使い方も可能です。
サービスの設定
本サービスでは「Salesforce [配送]」を使用します。
「Salesforce [配送]」サービスを使用する際、接続アプリケーションのインストールが必要です。
下記の記事をご参照ください。
1. D3Workerにログインする
D3Workerにログインします。
2. サービスを定義する
- 「サービス」タブをクリックします。
- 「新規作成」ボタンをクリックします。
3. サービスタイプを選択する
サービスタイプの選択にて「Salesforce [配送]」を選択します。
ご利用中のD3Workerテナントで当サービスが存在しない場合は、弊社サポートにお問い合わせください。
4. サービス内の各項目を設定する
各項目の設定内容は、以下のセクションを参照してください。
名称とメモ
| 項目名 | 必須 | 説明 |
|---|---|---|
| 名称 | 〇 | サービス名称(ユニークな任意の名称)を入力します。 |
| メモ | - | 必要に応じて、簡単なメモを入力します。 |
Salesforceへの接続
-
接続されるSalesforce組織に応じて、ログインURLを選択します。
-
login.salesforce.com
本番環境に接続されます。
-
test.salesforce.com
Sandbox環境に接続されます。
-
[私のドメイン].my.salesforce.com
私のドメインでの接続が必要な場合にご利用ください。
⚠️注意Salesforceへの接続設定は、「名称」「メモ(任意)」を設定し、一度サービスを保存してから設定可能になります。
-
-
「接続」ボタンをクリックし、Salesforceアカウントでサインインします。
接続後に「接続の確認」をクリックすると初めに接続したSalesforce組織との接続状況を確認でき、「解除」をクリックすると初めに接続したSalesforce組織の情報をD3Workerから削除します。解除後は、再び「接続」するまでこのサービスは機能しません。
接続情報
| 項目名 | 必須 | 説明 |
|---|---|---|
| タイムアウト | 〇 | タイムアウトするまでの秒数を指定できます。タイムアウトまでの秒数は、接続と読み込みのそれぞれについて指定できます。 |
文書ファイル
| 項目名 | 必須 | 説明 |
|---|---|---|
| オブジェクトのAPI参照名 | 〇 | 文書ファイルを添付するオブジェクトのAPI参照名を入力します。 |
| オブジェクトのID or SOQL | - | 文書ファイルを添付するオブジェクトのレコードIDを指定します。 この項目を指定した場合、オブジェクトの対象レコードを更新します。IDを直接指定するか、IDを取得するSOQLを記述することができます。 ※指定したIDが存在しない場合は、レコードを新規作成します。 |
| 添付 | 〇 | レコードのメモ&添付に文書ファイルを添付するか指定します。 |
オブジェクトのID or SOQLを使用する場合の注意事項
- SOQLを使用する場合は、必ず先頭文字を「$」としてください。
- 「$」ではじまる場合、CSVフィールドの値をエスケープします。
- 取得項目はオブジェクトに紐づくID項目を1つのみ指定してください。
- 外部IDを使用することはできません。
- 副問い合わせは使用することはできません。
-
取得結果が複数件となる場合はエラーとなります。
フィールド
新規登録時の必須フィールド(+任意のフィールド)または更新するフィールドを指定します。「+」ボタンで指定するフィールドを追加できます。
| 項目名 | 必須 | 説明 |
|---|---|---|
| フィールドのAPI参照名 | 〇 | フィールドのAPI参照名を入力します。 |
| 値 or SOQL | 〇 | フィールドの値を指定します。値を直接指定するか、値を取得するSOQLを記述することができます。 ※オブジェクトに定義されている入力規則などに反した値の場合、レコードが登録できないため、配送が失敗します。 |
| データ型 | 〇 | フィールド値のデータ型を選択します。 |
値 or SOQLを使用する場合の注意事項
- SOQLを使用する場合は、必ず先頭文字を「$」としてください。
- 「$」ではじまる場合、CSVフィールドの値をエスケープします。
- 取得項目は1つのみ指定してください。
- リレーション項目は、オブジェクトのID、またはSOQLで指定してください。指定可能な項目はID項目のみとなり、外部IDを指定することはできません。
- 副問い合わせは使用することはできません。
- 取得結果が複数件となる場合はエラーとなります。
データ型が日付の場合
ISO 8601規格のうち、以下のフォーマットを使用してください。
- YYYY-MM-DD
- YYYY-MM-DDThh:mm:ss+hh:mm
- YYYY-MM-DDThh:mm:ss-hh:mm
- YYYY-MM-DDThh:mm:ssZ
- YYYY-MM-DDThh:mm:ss.SSSZ
- YYYYMMDD
- YYYYMMDDhhmmss
5. 「保存」ボタンをクリックする
各設定が終わったら、画面左下の「保存」ボタンをクリックします。