メモ:   この記事は、Adobe、AWS Lambda、Genesys Cloud、Google、Microsoft Dynamics 365、Salesforce、Webサービス、Zendeskデータアクションの統合に適用されます。

データアクション統合のデータアクションをテストすると、認証、証明書、処理、またはリモートエンドポイントエラーが原因で、アクションが失敗することがあります。 

認証エラー

以下のコンテンツは、すべてのデータアクションの統合に適用されます。

これらのエラーは、リモートエンドポイントに対する認証中に、リモートサードパーティサービスで発生します。 

応答例

{
    "errorCode": "INVALID_CREDENTIALS",
    "status": 400,
    "correlationId": "43436e96-5c19-4c52-b951-4ea05d9a9af7",
    "entityName": "msDynamics",
    "userMessage": "There was an issue validating the credentials.",
    "userParams": [],
    "details": [
        {
            "errorCode": "ACTION.AUTHENTICATION"
        }
    ],
    "errors": [
        {
            "errorCode": "INVALID_CREDENTIALS",
            "status": 400,
            "userMessage": "Request to backend service failed.  Response from web service: {\"error\":\"invalid_grant\",\"error_description\":\"AADSTS50126: Invalid username or password\\r\\nTrace ID: 5a830f2e-1978-47f4-a49c-8bfb208f8100\\r\\nCorrelation ID: 0ac36657-3a9a-43b9-9101-fde463adba2a\\r\\nTimestamp: 2019-02-11 14:17:11Z\",\"error_codes\":[50126],\"timestamp\":\"2019-02-11 14:17:11Z\",\"trace_id\":\"5a830f2e-1978-47f4-a49c-8bfb208f8100\",\"correlation_id\":\"0ac36657-3a9a-43b9-9101-fde463adba2a\"} [53df0750-c233-4434-9d36-6377ededb014]",
            "userParams": [],
            "details": [],
            "errors": []
        }
    ]
}

証明書エラー

以下のコンテンツは、Webサービスのデータアクション統合にのみ適用されます。

このエラーは、Webサービスデータアクションがリモートエンドポイントから証明書を拒否した場合に発生します。

ヒント:   証明書構成の問題を確認するには、https:// のような HTTPS セキュリティ チェッカーをポイントします。/ssltest を Web サービスに送信します。

これらのエラーは、いくつかの理由で発生します。

  • ウェブサイトのルート証明書が自己署名であるか、または公開されていない。 Webサービスのデータアクションでは、公に信頼されている認証機関が証明書を発行する必要があります。
  • Web サーバーは、信頼チェーンに中間証明書を提供しません。 Webサービスのデータアクションでは、エンドポイントがTLS交渉中に中間証明書を提供する必要があります。 この問題を解決するには、Webサービスのドキュメントを確認するか、Webサービスについてベンダーにお問い合わせください。

応答例

{
  "message": "The server encountered an unexpected condition which prevented it from fulfilling the request.",
  "code": "internal.server.error",
  "status": 500,
  "messageParams": {},
  "contextId": "5dfe55e3-b172-406d-94f7-5d826afd4c0e",
  "details": [
    {
      "errorCode": "ACTION.REMOTE_ENDPOINT"
    }
  ],
  "errors": [
    {
      "message": "REST call for action execute failed. Message:Unable to send message after 2 attempts, due to: SunCertPathBuilderException: unable to find valid certification path to requested target [5dfe55e3-b172-406d-94f7-5d826afd4c0e]",
      "code": "INTERNAL_SERVER_ERROR",
      "status": 500,
      "messageParams": {},
      "details": [],
      "errors": []
    }
  ]
}

処理エラー

以下のコンテンツは、すべてのデータアクションの統合に適用されます。

これらのエラーは、存在しないデータアクションの実行、ボディテンプレートが無効なJSON、JSONPathエラーなど、データアクションの内部処理中に発生します。

応答例

{
    "errorCode": "NOT_FOUND",
    "status": 404,
    "correlationId": "a04c66e5-a2ec-46f3-9c7f-d904cd7e46cc",
    "userMessage": "Action with id static_-_Salesforce-GetAccountByPhoneNumber_-_37f5a780-70d7-408c-9cf7-8cd4cc7265fc was not found",
    "userParams": [],
    "details": [
        {
            "errorCode": "ACTION.PROCESSING"
        }
    ]
}

このエラーは、AcceptヘッダーにJSON以外のコンテンツタイプを使用してデータアクションを作成した場合にも発生する可能性があります。 たとえば、 text / html Acceptヘッダーで、次の応答を受け取ります。

応答例

{
    "status": 400,
    "errorCode": "INVALID_SCHEMA",
    "userMessage": "The 'Accept' header only supports json content types when specified",
    "userParams": [],
    "correlationId": "7930ce0c-ec9e-4929-9a70-0fe087b518b2",
    "details": [
        {
            "errorCode": "ACTION.PROCESSING"
        }
    ]
}

リモートエンドポイントエラー

以下のコンテンツは、すべてのデータアクションの統合に適用されます。

これらのエラーはリモートエンドポイントから返されます。 次の例では、アクションは電話番号に基づいて連絡先を取得しようとしますが、そのアクションが接続しているサービスに連絡先が存在しません。 

応答例

{
    "userMessage": "The requested resource was not found.",
    "errorCode": "NOT_FOUND",
    "correlationId": "fb9dda21-979f-4718-b772-8ecc3fbb7dac",
    "details.errorCode": [
        "ACTION.REMOTE_ENDPOINT"
    ],
    "status": 404
}

ヘッダーのないアクションセットが実行され、リモートエンドポイントが非JSON応答を返すと、次のエラーが発生します。

{
    "status": 400,
    "errorCode": "BAD_REQUEST",
    "userMessage": "The request could not be understood by the server due to malformed syntax.",
    "userParams": [],
    "correlationId": "fbb8bb72-0637-4028-b7d8-caba6686244b",
    "details": [
        {
            "errorCode": "ACTION.REMOTE_ENDPOINT"
        }
    ]
}

詳細については、 統合のためのテストデータアクション

統合の詳細については、 データアクションの統合についてをご覧ください。