エラー処理および検証

機械翻訳について

エラー処理および検証

Oracle Utilitiesアダプタとの統合を設計する際は、次の点に注意してください。

基本認証、OAuthリソース所有者のパスワード資格証明およびOAuthクライアント資格証明のセキュリティ・ポリシーは、現在、RESTベースの接続でサポートされています。
ユーザー名パスワード・トークン、基本認証およびOAuthクライアント資格証明のセキュリティ・ポリシーは、現在、SOAPベースの接続でサポートされています。
統合キャンバスのトリガー領域にOracle Utilitiesアダプタ接続をドラッグすると、「基本情報」ページで相対リソースURIを入力するよう求められます。標準リソースURIの書式は、/で始まり、その後に文字が続きます。他のURI形式を入力すると、エラー・メッセージが表示されます。
組合せ間接続カタログ・エラーの処理:
SOAPベースの接続を使用して統合を作成する場合、RESTベースのカタログを使用するように接続を変更すると、その統合に次の影響があります:
- 統合がすでにアクティブ化されている場合、統合に影響はありません。
- 統合がアクティブ化されていない場合に統合をアクティブ化しようとすると、失敗し、次のエラー・メッセージが表示されます:
```
Activation Error:- This Integration was created using SOAP based connection
but now connection changed to REST. Configure your connection to SOAP again or edit
the integration for REST.
```
RESTベースの接続を使用して統合を作成する場合、SOAPベースのカタログを使用するように接続を変更すると、その統合に同じ影響を与えます。次のエラー・メッセージが表示されます:
```
Activation Error:- This Integration was created using REST based connection but 
now connection changed to SOAP. Configure your connection to REST again or edit the 
integration for SOAP.
```

「Oracle Utilitiesアダプタ」では、次の方法を使用して、RESTエンドポイントの呼出し(アウトバウンド)およびトリガー(インバウンド)方向のエラーを処理します。

起動(アウトバウンド)方向のエラー処理:
呼出し(アウトバウンド)方向の「Oracle Utilitiesアダプタ」は、エラー・コードで受信したHTTPレスポンスの標準APIInvocationErrorを返します。また、リクエストの準備、エンドポイントのコールまたはレスポンスの処理中に「Oracle Utilitiesアダプタ」内で処理エラーが発生した場合も、APIInvocationErrorが生成されます。

マッパーのAPIInvocationErrorの形式は、次のとおりです。

errorDetailsセクションには実際の原因が含まれます。

オーケストレートされた統合では、APIInvocationErrorはフォルト・ハンドラで処理できます。
トリガー(インバウンド)方向のエラー処理:
トリガー(インバウンド)方向の「Oracle Utilitiesアダプタ」は、HTTPクライアントがHTTPリクエストを使用するためにリクエストできるHTTPエンドポイントを公開し、HTTPレスポンスを返します。

成功すると、「Oracle Utilitiesアダプタ」は成功レスポンスを返します。「Oracle Utilitiesアダプタ」は、状況に応じて、エラー・コード・ファミリに属するHTTPステータスのエラー・レスポンスを返します。
また、「Oracle Utilitiesアダプタ」は、エラーに関する追加の詳細およびトラブルシューティングの可能なステップを含むエラー・レスポンスを返します。構成されているレスポンス・メディア・タイプに応じて、標準的なエラー・レスポンス形式が返されます。次に、JSONレスポンス構造のサンプルを示します。
```
{
  "type" : "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1",
  "title" : "Internal Server Error",
  "detail" : "An internal error occurred while processing the request. Please see the fault details for the nested error details.",
  "o:errorCode" : "500",
  "o:errorDetails" : [ {
    "type" : "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
    "instance" : "{\n   \"error_message\" : \"Invalid request. Missing the 'origin' parameter.\",\n   \"routes\" : [],\n   
    \"status\" : \"INVALID_REQUEST\"\n}\n",
    "title" : "Bad Request",
    "o:errorPath" : "GET http://maps.googleapis.com/maps/api/directions/json?destination=Montreal returned a response status of 
      400 Bad Request",
    "o:errorCode" : "APIInvocationError"
  } ]
}
```
o:errorDetailsセクションは実際の原因用に予約されています。含まれるプレフィクスo:は、Oracle標準に基づいています。

マップされていないフォルトは、Oracle Integrationによってシステム・フォルトとしてインバウンド「Oracle Utilitiesアダプタ」に伝播されます。適切な詳細は伝達されない場合があります。このため、フォルト・パイプラインを定義することをお薦めします。