統合ストア用のアダプタの作成

ライフサイクルの概要

アダプタを統合ストアで使用できるようにするには、Oracle Partner Networkに参加して、アダプタの提案をOracleに送信し、アダプタを開発およびテストし、Oracleから最終承認を得る必要があります。

Oracleパートナのアダプタ開発のライフサイクル。

スタート・ガイド

アダプタ開発プロセスを開始する前に、次のタスクを実行する必要があります。

Oracle Partner Networkにパートナとして登録します。ビルド・トラックを選択します。
開発するアダプタの詳細とともに、提案をOracleに送信します。提案に次の詳細を含める必要があります:
- アダプタをビルドする予定のアプリケーション。
- アダプタのビジネス・ユースケース。
- アダプタのサポート・モデル。
  Oracle Supportサービス・レベル合意(SLA)に準拠しているかどうかを指定します。条件に詳細情報を提供していることを確認します。
- アダプタのテスト計画。
  Oracle Integrationの新しいリリースごとにアダプタをテストするかどうかを指定します。
- アダプタのドキュメント計画。
  Oracleで共有されるアダプタのドキュメント標準およびテンプレートに従う必要があります。
- アダプタの収益化計画。
提案がOracleによって承認されると、開発プロセスを開始できます。

アダプタのビルドおよびテスト

この項では、統合ストア用のアダプタをビルドするためのガイドラインを示します。

OpenAPIドキュメントまたはアプリケーションのAPIのPostmanコレクションからアダプタをビルドします。「アダプタの構築およびテスト」を参照してください。
アダプタ開発のベスト・プラクティスに準拠します。「アダプタを作成するためのベスト・プラクティス」を参照してください。
アダプタの自動化テストを設計して実行します。

アダプタの公開

アダプタのビルドおよびテストが終了したら、ここに示すステップに従ってアダプタを公開します。

アダプタ・アーティファクトを承認のためにOracleに送信します。
.rabファイルは、次のガイドラインに従ってOracleに送信する必要があります:
1. アダプタ定義ドキュメントで、次のようにidフィールド(infoセクション)の値を入力します:
  - <OPNID>:<adapterId>
    OPNIDはOracle Partner Network IDで、ハイフン(-)文字を含めることはできません。
2. .rabファイルを作成するには、VS Codeの「RAB: RABバンドルの作成」コマンドのみを使用します。「アダプタ・バンドルの作成またはインポート」を参照してください。
3. アダプタ・バンドルのフォルダ構造が次の図に従ってあることを確認します:
```
<OPNID>_<adapterId>-<xx.xx.xx>
|-->logo.svg
|-->definitions
   |-->main.add.json
|-->api
```
4. アダプタ・バンドルの名前: <OPNID>_<adapterId>-<xx.xx.xx>.rab。
  OPNIDはOracle Partner Network IDで、ハイフン(-)文字を含めることはできません。例名: 4712203150920_auraplayer-1.0.23.rab。
5. アダプタ・バンドルとともに、次の詳細を含む条件ドキュメントを共有します:
  - サポート・モデルと顧客の問題に対処する計画。
  - サポートを提供する予定の時間。
    たとえば: 24時間365日 (1日の制限時間、1週間の制限日数など)。
  - Oracleとのパートナシップ・プラン。
    たとえば、Oracleとのパートナ・リングを続行し、アダプタをサポートする予定の期間を見積もります。
  - アダプタの終了計画。
    たとえば、Oracleとのパートナシップを終了する場合は、顧客の問題を軽減する計画を指定します。
アーティファクトをレビュー用に発行する以外に、アダプタを統合ストアにステージングし、テストし、アダプタの一般提供(GA)が可能な場合はOracleに通知します。アダプタのステージング中に次のチェックを実行します:
1. インスタンスで次の機能フラグが有効になっているかどうかを確認: oic.common.enable.staging-accelerators。そうでない場合は、次の情報でSRをログに記録して有効にしてください。
  - FF: oic.common.enable.staging-accelerators
  - region : <your instance's region>
  - URL: <your Oracle Integration URL>
  - OCID: <your Oracle Integration OCID>
2. ステージング済アダプタがインスタンスにすぐに表示されるようにするには、インスタンスでキャッシュの無効化操作を実行します。それ以外の場合は、アダプタが表示されるまで約8時間かかることがあります。キャッシュの無効化操作を実行するURLの例を次に示します:
  https://<OICDomainName>/ic/api/integration/v1/accelerators?integrationInstance=<InstanceName>&invalidateCache=true
3. 既存のアダプタIDを再利用しないでください。アダプタIDを設定するには、前述のステップ1aを参照してください。
アダプタ・アーティファクトの確認後、OracleはアダプタGAを統合ストアに作成します。次に、GAリリースに関連するいくつかのタスクを示します:
1. ステージング済アダプタを使用して作成したすべての統合(IARまたはCARファイル)をエクスポートし、インスタンスからアダプタをアンインストールし、同じ内容をOracleに確認します。
  これにより、構築した統合が失われることはありません。
2. これで、Oracleはアダプタの一般提供を可能にし、ユーザーに通知します。
3. アダプタをすぐに表示するには、キャッシュの無効化操作を実行します。それ以外の場合、アダプタは自動リフレッシュ後にインスタンスに表示されますが、これは8時間後に行われます。
4. これで、以前の統合をインスタンスに再度インポートできます。

アダプタのサポートと保守

この項では、統合ストアにパブリッシュされたアダプタのサポートおよびメンテナンスのガイドラインを示します。

条件文書に記載したサポート・モデルに従う必要があります。
アダプタが顧客または顧客セットに制限されている場合は、その特定の顧客または顧客セットとの個別の契約を作成する必要があります。 Oracleはそのような契約には関与しません。
新しいOracle Integrationリリースごとに、ご使用の開発環境にリリースにパッチを適用し、アダプタのすべてのユース・ケースに対して自動化テストを実行します。
バグを修正したり、アダプタを拡張したりしながら、ベスト・プラクティスに従います。
Oracle Integrationで問題を特定する場合は、詳細なログおよび情報を含むSRを作成します。