MuleSoft for Flow: インテグレーションの制限と考慮事項
外部システムへの接続を確立するときは、次の制限に留意してください。
必要なエディション
| サポートされているエディションを表示する。 |
| この機能を使用するには、MuleSoft for Flow: Integration アドオンが必要です。ただし、MuleSoft for Flow: Integration アドオンを必要としないセグメントトリガーフロー、有効化トリガーフロー、ブロードキャストフローは例外です。Professional Edition では、API アクセス アドオンが必要です。アドオンを購入する場合は、Salesforce アカウントエグゼクティブにお問い合わせください。 |
| MuleSoft for Flow: Agentforce で使用するインテグレーション機能には、Foundations Edition または Agentforce 1 Edition が必要です。これらのエディションを購入するには、Salesforce アカウントエグゼクティブにお問い合わせください。 |
一般的な制限事項
- MuleSoft for Flow: インテグレーションは自動レイアウトでのみサポートされ、自由形式ではサポートされません。
- 外部システム変更トリガーフローの出力に直接変換ビューを使用することはできません。インラインビューの $Event 出力から項目を選択し、[ビューを変換] に切り替えて、そのデータをソースデータとして使用します。
- 変換ビューでは、Boolean リテラル値のグローバル定数
TrueまたはFalseがサポートされます。使用可能なオプションから定数を選択します。手動で入力しないでください。
トランザクションごとのフロー制限に達する
フローに複数のアクションが含まれていて、トランザクションあたりのフロー制限に達したために失敗している場合は、フローのアクションの前に [待機時間] 要素を挿入します。待機時間を [1 minute] に設定することで、続行する前に変更を処理できます。これにより、リソースの使用状況を管理し、ワークフローをスムーズに実行できます。
サードパーティコネクタを使用した外部システム変更トリガーフローおよびフローのテスト
外部システム変更トリガーフローまたはサードパーティコネクタを使用するフローをテストする場合、テストで返されるレコードの最大数は 5 です。
外部システム変更トリガーポーリング失敗の処理
外部システム変更トリガーフローでは、ポーリング機能を使用して、選択したスケジュールでレコードを取得します。
ポーリング動作と無効化
- 再試行: ポーリングが失敗すると、フローは最大 3 回連続して再試行します。
- 自動無効化: ポーラーが 3 回連続して失敗した後に実行されます。この動作は、ポーラーレベルの失敗 (認証や接続など) に適用されますが、個々のレコードレベルの失敗には適用されません。
- 再有効化: ポーラーの失敗によってフローが無効化された場合は、原因となっている問題を解決して、フローを手動で再有効化します。
ポーラーの制限と例外
- Pre-execution Failures: 実行の開始前にポーラーが失敗した場合、開始要素で障害パスを使用できなくなります。
- ペイロード制限: 128,000 文字を超えるポーリング応答 (データとメタデータを含む) がペイロード制限を超えている。
Salesforce で商談の状況が [商談成立] に変更されたときに、フローによって外部システムに販売注文が作成されます。
-
フローは 5 分ごとにポーリングします。
-
午後 1 時 00 分、複数の商談が商談成立としてマークされます。フローは午後 1 時 00 分にポーリングし、条件に一致し、
lastModifiedDateTime値が午後 12 時 55 分より大きいレコードを返します。Salesforce は 5 個の商談を返します。フローは、この 5 個の商談を取得し、5 個のフローインタビューを実行して外部システムで処理します。
-
インタビューのタイムスタンプは午後 1 時 00 分、フローは午後 1 時 05 分に再度ポーリングされます。午後 1 時 5 分に、フローは条件に一致して
lastModifiedDateTime値が午後 1 時より後のレコードをポーリングします。
Salesforce はバックグラウンドでデータを処理します。午後 1:00:00 に完了した商談が午後 1:00:05 にデータベースにコミットされ、タイムスタンプが午後 1:00:00 になっている可能性があります。レコードが更新されて遅延が発生した場合、トリガーが実行されない可能性があります。
Agentforce 機能: 動的アクションの制限事項
MuleSoft for Flow の Agentforce 機能: インテグレーションでは、サードパーティコネクタでの動的アクションはサポートされません。NetSuite、Salesforce、および Zendesk コネクタからの動的メタデータに依存するフローでは Agentforce を使用できません。
バリューマップの考慮事項と制限事項
インテグレーションフローをリリースする前に、実行時の動作、パッケージ化要件、サポート対象外のシナリオを確認してください。
実行時の動作
- 値マップのルックアップは、ソース値から目標値への前方参照のみです。
- ソース値には、各値マップの一意の値が必要です。
- 目標値は行間で繰り返すことができます。
- マッピングされていないソース値は、値マッピングのデフォルトの動作設定をトリガーします。
マッピングされていない値のデフォルトの動作
- Fail the flow: フローはエラーを返し、停止します。
- マッピングされていない値としてパススルー: マッピングされていないソース値が出力として返されます。
- デフォルト値の定義: ユーザー定義のデフォルトの目標値が返されます。
グローバルリソース管理
- グローバルフローリソースから値の対応付けを管理します。
- リストビューでは一括削除がサポートされていないため、値の対応付けを個別に削除します。
- 値マップを削除する前に、値マップへのすべてのフロー参照を削除します。
入力モードとフローのサポートの制限
- 外部トリガーの開始要素では、[値の対応付け] 入力モードを使用しないでください。開始要素ではサポートされていません。
- 値マップでは定数リソースがサポートされないため、ソースの変数または項目を参照します。
管理パッケージ
- 第 2 世代管理パッケージ (2GP) をバリューマップの主要なパッケージ化方法として使用する。
- 第一世代管理パッケージ (1GP) では、参照値マップは自動的に含まれないため、手動で追加します。
設定手順については、「Create and Manage Value Maps」を参照してください。変換で値の対応付けを適用するには、「Use a Value Map in Transform (変換での値の対応付けの使用)」を参照してください。
サードパーティコネクタの制限と考慮事項
指定ログイン情報を使用した外部システムへの接続
接続セキュリティをカスタマイズし、API パフォーマンスを管理するには、サポートされるすべてのコネクタで独自の OAuth アプリケーションを (外部ログイン情報を使用して) 使用できます。
サードパーティコネクタの一般的な制限を次に示します。
- 返されるレコードの最大数は、Get <Records> アクションの場合は 10,000 件です。
- 外部サービスの名前は、サードパーティコネクタの名前と完全には一致しません。フローで名前の競合や問題が発生しないように、外部サービスに一意の名前を使用します。
サードパーティコネクタの具体的な制限と考慮事項を次に示します。
- HubSpot コネクタ
- Salesforce 商談を HubSpot 商談に関連付けようとすると、関連付けに失敗します。
- NetSuite コネクタ
- [トリガー] および [レコードを取得] アクションでは、テキスト互換のカスタム項目のみがサポートされます。ただし、Get Record アクションを使用すると、データ型に関係なく、レコードのすべてのカスタム項目が返されます。
- NetSuite 接続を使用するフローで MuleSoft for Flow: Integration Query Builder を使用して自動的にトリガーする場合、品目とリストは返されません。品目またはリストを返すには、関連するレコードタイプで [レコードを取得] アクションを使用します。
- NetSuite Customer オブジェクトでは、taxItem、taxSchedule、projectTemplate、および projectTemplateId 項目はサポートされていません。
基盤となる NetSuite REST API では、顧客レコードを作成または更新するためのこれらの項目は公開されません。現在、コネクタには直接的な回避策はありません。代わりに、次のいずれかの代替方法を使用します。
- カスタム項目と NetSuite オートメーションを使用してデータを処理します。
- NetSuite UI で項目を手動で更新します。
- NetSuite カスタマーサポートに連絡して、REST API でこれらの項目に優先順位を付けるように依頼してください。
- Microsoft Dynamics 365 Business Central Connector
- 販売請求書または販売注文を作成するときに、有効な顧客番号を入力します。ただし、Customer API では、すべての必須項目に値が含まれている必要はありません (Gen. Bus など)。Posting Group、Customer Posting Group、Tax Area Code)。そのため、API またはフローを使用してこれらの値のない顧客レコードを作成できます。その顧客レコードを使用して販売請求書または販売注文を作成すると、操作は失敗し、
Error: Customer Posting Group must have a value in Customer.エラーメッセージが表示されます。販売請求書と販売注文を正常に作成するには、各顧客レコードの [顧客転記グループ] 項目が入力されていることを確認します。
- 販売請求書または販売注文を作成するときに、有効な顧客番号を入力します。ただし、Customer API では、すべての必須項目に値が含まれている必要はありません (Gen. Bus など)。Posting Group、Customer Posting Group、Tax Area Code)。そのため、API またはフローを使用してこれらの値のない顧客レコードを作成できます。その顧客レコードを使用して販売請求書または販売注文を作成すると、操作は失敗し、
- Salesforce コネクタ
- 認証中に Salesforce から Salesforce への接続を認証すると、接続アプリケーションのセキュリティポリシーで、ポリシーのロールアウト前に作成された接続アプリケーションに対する明示的な承認が要求されるため、
OAUTH_APPROVAL_ERROR_GENERICエラーが表示されることがあります。この問題を解決するには、対象組織のシステム管理者が次の手順を実行して接続アプリケーションを明示的に承認する必要があります。- 初期設定では、Salesforce システム管理者に「アンインストールされた接続アプリケーションを承認」権限が必要です。
- 確立された組織の場合、Salesforce システム管理者は Salesforce コネクタ接続アプリケーションを承認します。
1 人の Salesforce システム管理者がアプリケーションを承認すると、後続のユーザーは「アンインストールされた接続アプリケーションを承認」権限がなくても認証できます。
- API ユーザーが接続を正常に認証した後で接続テストを実行すると、テストがエラー
Connection test failed: The resource doesn't existで失敗することがあります。この失敗は、テスト中にコネクタが Account sObject の Describe エンドポイントに対してクエリを実行しようとしたために発生します。API ユーザーに十分な権限がない場合、このエンドポイント要求は失敗します。接続を確立およびテストするには、接続を作成するユーザーに次の権限が必要です。これらはプロファイルまたは権限セットを介して付与されます。- 「API の有効化」
- Account sObject への参照アクセス権
- 認証中に Salesforce から Salesforce への接続を認証すると、接続アプリケーションのセキュリティポリシーで、ポリシーのロールアウト前に作成された接続アプリケーションに対する明示的な承認が要求されるため、
