機械翻訳について

「Oracle Utilitiesアダプタ」バージョン24.04.0以上のSwagger 2.0 RESTカタログの使用

Swagger 2.0 RESTカタログを「Oracle Utilitiesアダプタ」バージョン24.04.0以上の接続で使用すると、接続の「テスト」をクリックすると、次のエラーが表示されます。 

Swagger 2.0 is no longer supported in Utilities Adapter. Please use openAPI 3.x REST catalog. 
Please check Utilities Adapter documentation for more information.

Swagger 2.0 RESTカタログを使用する既存の統合がある場合、ランタイムは影響を受けません。 ただし、設計時接続の編集、接続の再テスト、メタデータのリフレッシュ、アーティファクトのリフレッシュまたは再アクティブ化を試みると、統合は失敗します。 OpenAPI 3.x定義を使用するようにカタログを更新する必要があります。

ノート:

Oracle Integration 3のすべてのユーティリティ統合アクセラレータは、OpenAPI 3.xカタログ定義をサポートしています。 すべての非OUAF (NMS)アプリケーション・カタログは、すでにOpenAPI 3.xにあります。 カスタム統合の場合は、最初にOpenAPI 3.xカタログとマッピングがOpenAPI 3.x互換であるかどうかを確認します。

REST Swagger 2.0カタログとOpenAPI 3.xカタログの違い

2つの仕様の違いを理解するには:
  1. 有効な資格証明を指定して、Postmanを開き、RESTカタログ・レスポンスをGETします。


    イメージは、上部にあるGET操作、APIおよび「送信」ボタンを示しています。 この下には、「パラメータ」、「認可」、「ヘッダー」、「本文」、「事前リクエスト・スクリプト」、「テスト」および「設定」タブがあります。 この下には「タイプ」リストがあり、「基本認証」が選択されています。 右側には、「ユーザー名」および「パスワード」フィールドと「パスワードの表示」チェック・ボックスがあります。 この下には、「本文」、「Cookie」、「ヘッダー」および「テスト結果」のタブがあります。 この下には、「プリティ」、「RAW」、「プレビュー」および「ビジュアル化」のタブがあります。 リストからJSONが選択されています。 この下には、コードの各行があります。

  2. カタログ・レスポンスで、次の形式のビジネス・サービスのopenAPIUrlフィールドを確認します。
    <openAPIUrl>https://<hostname>:<port>/ouaf/rest/ouaf/openapi/v2/<servicename></openAPIUrl>
    • openAPIUrlのURLに/v2が含まれている場合、Swagger 2.0カタログになります。 GET openAPIUrlレスポンスを使用して、PostmanまたはSwaggerエディタからopenAPIUrlにアクセスすることもできます。 レスポンスにswagger : 2.0が含まれている場合は、Swagger 2.0カタログです。


      イメージは、上部にあるGET操作、APIおよび「送信」ボタンを示しています。 この下には、「パラメータ」、「認可」、「ヘッダー」、「本文」、「事前リクエスト・スクリプト」、「テスト」および「設定」タブがあります。 この下には「タイプ」リストがあり、「基本認証」が選択されています。 右側には、「ユーザー名」および「パスワード」フィールドと「パスワードの表示」チェック・ボックスがあります。 この下には、「本文」、「Cookie」、「ヘッダー」および「テスト結果」のタブがあります。 この下には、「プリティ」、「RAW」、「プレビュー」および「ビジュアル化」のタブがあります。 リストからJSONが選択されています。 この下には、コードの各行があります。

    • openAPIUrlフィールドにURLに/v2が含まれていない場合、OpenAPI 3.xカタログになります。 GET openAPIUrlレスポンスを使用して、PostmanまたはSwaggerエディタからopenAPIUrlにアクセスすることもできます。 レスポンスにopenapi : 3.x.xが含まれている場合は、OpenAPI 3.xカタログです。


      イメージは、上部にあるGET操作、APIおよび「送信」ボタンを示しています。 この下には、「パラメータ」、「認可」、「ヘッダー」、「本文」、「事前リクエスト・スクリプト」、「テスト」および「設定」タブがあります。 この下には「タイプ」リストがあり、「基本認証」が選択されています。 右側には、「ユーザー名」および「パスワード」フィールドと「パスワードの表示」チェック・ボックスがあります。 この下には、「本文」、「Cookie」、「ヘッダー」および「テスト結果」のタブがあります。 この下には、「プリティ」、「RAW」、「プレビュー」および「ビジュアル化」のタブがあります。 リストからJSONが選択されています。 この下には、コードの各行があります。

REST Swagger 2.0を統合のOpenAPI 3.xカタログに置き換えます

統合でREST Swagger 2.0カタログが接続で使用されている場合は、アプリケーションのOpenAPI 3.xカタログに置き換えます。 「接続」ページで構成されたカタログURLに違いはありません。 カタログ内のインバウンド/アウトバウンド・サービスの仕様のopenAPIUrlのみが異なります。 統合が編集された場合、設計時マッパーのマッピングは、この変更後に影響を受けます。

OpenAPI 3.xカタログ仕様をすでに使用している場合は、対応する「Oracle Utilitiesアダプタ」のマッパーを開いて検証します。 ルート・ノードがcomponents.schemasで始まるかどうかを確認します。
  • その場合、カタログはOpenAPI 3です。xでサポートされているカタログであり、統合はそのまま機能します。
  • そうでない場合は、マッピングが古く、更新する必要があるSwagger 2.0仕様が使用されます。

そうしないと、変更は必要なく、カスタム統合は問題なく動作します。 マッパーがSwagger 2.0仕様を使用している場合、Oracle Integration 3で古いマッピングが機能しないため、ナレッジ記事「API 3.xを開くには、Swagger 2.0でマッパーの問題を修正するステップ」に従ってマッピングを再実行することをお薦めします。