機械翻訳について

アダプタの構築およびテストのワークフロー

アダプタを構築およびテストするには、次のアプローチを一般的なガイドラインとして使用します。ただし、これらのステップの一部を任意の順序で完了することもできます。 要件に合わせてアダプタを構築するときに、アダプタを反復的に絞り込みます。

ワークフロー表

ノート:

ワークフローおよび関連するステップは、アプリケーションのAPIのPostmanコレクションを使用したアダプタの構築を示しています。 ただし、このワークフローを使用して、アプリケーションAPIのセットを記述するOpenAPIドキュメントを使用してアダプタを構築することもできます。 OpenAPIドキュメントを使用する場合は、ドキュメントをVS Codeにインポートし、「ワークフロー表」のステップ3から開始します。

推奨される反復開発プロセスの図を次に示します:

順序	ステップ	詳細情報
1	APIコールの詳細の取得	開始するには、アプリケーションで使用可能なパブリックAPIを参照し、特定のAPIリクエストを作成するために必要なURLおよびパラメータを取得します。 「APIコールの詳細の取得」を参照してください。
2	リクエストを使用したPostmanコレクションの作成	Postmanアプリケーションで、APIリクエストを使用してコレクションを作成し、リクエストをテストし、コレクションをJSONファイルにエクスポートします。 ベスト・プラクティスとして、コレクションで1つのAPIリクエストから開始します。 「APIリクエストを使用したPostmanコレクションの作成」。
3	アダプタ定義ドキュメントの生成	Rapid Adapter BuilderのVS Code拡張機能を使用して、Postmanコレクション(またはOpenAPIドキュメント)からアダプタ定義ドキュメントを生成します。 「アダプタ定義ドキュメントの生成」。
4	アダプタ定義ドキュメントの確認および更新	Postmanコレクションをアダプタ定義ドキュメントに変換すると、接続やアクションなど、ドキュメントの複数のセクションが自動的に移入されます。 ただし、VS Codeエディタでは、要件に従ってドキュメントを確認および更新できます。 「アダプタ定義ドキュメントの確認および更新」を参照してください
5	アダプタ定義ドキュメントの検証	アダプタ定義ドキュメントを更新した後、ドキュメントを検証して、エラーがないことを確認します。 「アダプタ定義ドキュメントの検証」を参照してください。
6	テスト用アダプタの登録	アダプタをテスト用にOracle Integrationの開発インスタンスで使用できるようにします。 「テスト用のアダプタの登録」を参照してください。
7	アダプタのテスト	アダプタの機能をテストして、すべてが期待どおりに動作することを確認します。 「アダプタのテスト」を参照してください。 テスト中の結果に応じて、アダプタ定義ドキュメントを更新します。 目的の結果が得られるまで、確認と検証、テストを行います。
8	前のステップを繰り返して機能を追加	1つの機能をアダプタに正常に追加したら、別のAPIリクエストのサポートを追加します。 ただし、新しいリクエストごとに新しいアダプタ定義ドキュメントを生成する必要はありません。 VS Code拡張を使用すると、同じアダプタ定義ドキュメントに新しいリクエストを追加できます。 「アダプタ定義ドキュメントへの機能の追加」を参照してください。

ノート:

アダプタの構築またはテスト中に、統合開発者がアダプタを操作するのに役立つドキュメントを作成します。 Oracleによって作成された任意のアダプタ・ユーザー・ガイドをテンプレートとして使用できます。 Oracle Help Centerの「アダプタ・ページ」を参照してください。

アダプタの反復開発が完了したら、それをOracle Integrationの本番インスタンスで解放できます。 「アダプタの本番へのデプロイ」を参照してください。