Salesforce Connector リファレンス
Salesforce をデータ取得元 (新規の Salesforce レコードを取得し、たとえば Google スプレッドシートにコピー) またはデータ取得先 (Workday で新規従業員を取得し、Salesforce で取引先責任者を作成) として使用します。 フローでのデータの操作方法の一部の詳細は、データ取得元またはデータ取得先に固有です。詳細は、選択したトリガーやアクションによっても異なります。
Connections (接続)
include:composer::_partials/connection-definition.adoc[]
include:composer::_partials/connection-name.adoc[]
- ユーザー名とパスワード
-
Salesforce にログインするために使用したユーザー名とパスワード。 データ取得元がコンポーザーを操作するのと同じ Salesforce 組織であっても、接続を作成する必要があります。 ただし、コンポーザーで再びパスワードが要求されることはありません。代わりに、認証承認ダイアログが表示されます。
- URL
-
Salesforce にログインするために使用した URL。例:
myOrg.salesforce.com。
Salesforce 接続アプリケーションの制限
Salesforce では、各ユーザーが一度に 5 件までの接続アプリケーションへのアクセス権を付与できます。 この制限が原因で、同じ Salesforce 組織へのコンポーザー接続を 6 件以上作成すると、認証されたトークン数が 5 件に戻るまで、Salesforce によって通知なしに一番古いものから最後に作成されたものの順でトークンが取り消されます。
この問題を回避するために、可能であれば、ユーザーおよび Salesforce 組織ごとに 1 件の接続のみを作成するようにしてください。
Salesforce 接続アプリケーションと認証についての詳細は、 Salesforce ドキュメントを参照してください。
IP 制限の緩和
組織で IP 制限が設定されている場合、IP 参照のエラーや OAuth エラーが発生する場合があります。このエラーを解決するには、IP 制限を緩和します。
Salesforce への接続で IP 制限を緩和する手順は、次のとおりです。
-
Salesforce 組織にログインします。その組織の Salesforce システム管理者である必要があります。
-
[Setup (設定)] > [Connected Apps OAuth Usage (接続アプリケーションの OAuth の利用状況)] に移動します。
-
[MuleSoft OCS app for KPROD (KPROD 用 MuleSoft OCS アプリケーション)] という説明が付いたリストで [MuleSoft Platform (MuleSoft プラットフォーム)] を見つけ、[Install (インストール)] をクリックします。
-
認証ダイアログで [Install (インストール)] をクリックします。
これにより、接続アプリケーション (作成した接続) が IP 制限を緩和するために使用可能になります。コンポーザーアプリケーションは再インストールされません。
-
[Edit Policies (ポリシーを編集)] をクリックします。
-
[IP Relaxation (IP 制限)] を [Relax IP Restrictions (IP 制限を緩和)] に変更して、変更内容を保存します。
これで、接続の IP 制限が緩和されます。
バイナリファイルの転送
コンポーザーフロー内からデータピルを使用して、項目入力としてバイナリファイルを転送できます。たとえば、Salesforce インスタンス間でファイルの同期を維持する場合、あるインスタンスからバイナリファイルコンテンツをダウンロードし、後でその同じファイルコンテンツを別のインスタンスにアップロードできます。
次の Salesforce オブジェクトはバイナリ転送をサポートしています。
-
コンテンツ -
バージョンドキュメント -
添付ファイル
転送あたりの推奨ファイルサイズ制限は 25MB で、システム間で転送されるファイルは切り捨てられません。
トリガー
include:composer::_partials/trigger-definition.adoc[]
- New record
-
15 秒おきに新規レコードをチェックします。
- New or updated record
-
15 秒おきに指定されたオブジェクト種別の新規または更新済みレコードをチェックします。
- Deleted record
-
論理削除されたレコードをチェックします。論理削除されたレコードは約 15 日間、Salesforce に保存されます。
レコードは通常、約 15 日間保存された後で、物理削除され、取得できなくなります。 * 論理削除タイムスタンプは変更できません。
トリガー条件
トリガー条件を追加して、ワークフローをトリガーする条件を指定できます。たとえば、特定の項目が指定した条件を満たす場合のみトリガーするようにワークフローを制限できます。
トリガー条件を追加する手順は、次のとおりです。
-
トリガーを選択します。
-
[Trigger Conditions (トリガー条件)] セクションで、[Criteria (条件)] ドロップダウンメニューをクリックして [All Conditions Must Be Met (AND) (すべての条件を満たす必要がある (AND))] または [Any Condition Must Be Met (OR) (いずれかの条件を満たす必要がある (OR))] を選択します。
-
特定の項目の条件を指定します。
トリガー条件を追加するには、[Add Condition (条件を追加)] をクリックします。
アクション
include:composer::_partials/action-definition.adoc[]
- Create new record
-
標準またはカスタムレコードを作成します。
- Update record
-
外部 ID で指定されているように標準またはカスタムレコードを更新します。
- Get records
-
指定した条件に一致するすべてのレコードを返します。
サンプルアクション設定", 500]-
アクションで取得する項目は [Result fields (結果項目)] セクションで選択できます。
-
1 つ以上の条件を追加して、[Criteria (条件)] セクションで返されるレコードの種別を指定できます。たとえば、姓が「B」で始まることを指定することもできます。
-
返されるレコードの並び替え順は [Sort records (レコードを並び替え)] セクションで制御できます。レコードは指定した項目の昇順または降順で並び替えることができます。
-
[How Many Records to Retrieve (取得するレコードの数)] セクションで [All records (すべてのレコード)] を選択すると、条件に一致するレコードのリストを取得できます。[All records (すべてのレコード)] オプションはデフォルトで選択されています。リストから単一レコードにアクセスする場合は、For Each ループをフローに追加する必要があります。
-
一意の識別子で検索を絞り込んだ場合は、[How Many Records to Retrieve (取得するレコードの数)] セクションで [Only the first record (最初のレコードのみ)] を選択すると、単一レコードが返されます。単一レコードが返されると、検索の出力がリストから単一レコードに変更されます。Get records アクションは、すべてのレコードを検索し、リストの最初のレコードのみを返します。
以前に [All records (すべてのレコード)] を選択し、その後選択を [Only the first record (最初のレコードのみ)] に変更した場合、既存のフローのデータピルが無効になる可能性があります。
Get Records がフローのステップであり、項目レベルの暗号化が有効で暗号化された項目での絞り込みを行おうとしている場合は、次の文字列操作のみがサポートされます:
equals、not equals、または空。項目レベルの暗号化では contains、starts with、または ends with はサポートされません。項目レベルの暗号化についての詳細は、 Salesforce ドキュメントを参照してください。 -
- Create or update record
-
レコード ID で指定されているように標準またはカスタムレコードを更新します。 レコード ID が見つからない場合、レコードを作成します。
- Delete record
-
そのオブジェクト種別とレコード ID で指定されたレコードを削除します。
- ファイルのアップロード
-
Salesforce のフォルダーにファイルを追加します。
- Download file
-
指定されたファイルのバイナリコンテンツを返します。
アクション設定からエラーを設定する
フロー内でエラーが発生した場合、エラーの詳細が [Run History (実行履歴)] ページに表示されます。[Run History (実行履歴)] ページには、エラーが発生した日時、エラーの説明、およびエラーが発生したフロー内の場所が表示されます。この情報を使用して、フロー内の問題のトラブルシューティングを行うことができます。ただし、発生する可能性のあるエラーを処理するために、事前に設定を行うことができます。
アクション設定からエラーを設定する手順は、次のとおりです。
-
アクションを選択します。
-
[If an error occurs (エラーが発生した場合)] セクションで、次のいずれかを選択します。
-
Stop Flow (フローを停止)
-
Continue to next step (次のステップに進む)
-
Create an error branch (エラー分岐を作成)
-
Continue to another branch (別の分岐に進む)
-
アクション設定のエラーが設定されます。エラーが発生した場合、選択した設定がフロー内で実行されます。