前提条件の完了

アダプタの構築を開始する前に、Oracle Integrationへのアクセスの取得、必要なソフトウェアのインストールなど、いくつかのタスクを完了する必要があります。

順序	タスク	詳細情報
1	Oracle Integrationへのアクセス	まだ持っていない場合は、次を取得します: Oracle Integrationのアカウント(サインイン資格証明を含む) Oracle IntegrationインスタンスのURL Oracle Integration管理者と協力して、このタスクを完了します。
2	Oracle IntegrationインスタンスのOracle Cloud Infrastructure Identity and Access Management (IAM)にクライアント・アプリケーションを作成し、クライアント資格証明を取得	「クライアント・アプリケーションの作成および資格証明の取得」を参照してください。
3	前に作成したクライアント・アプリケーションに統合インスタンス開発者ロールを割り当てます	「クライアント・アプリケーションへの統合インスタンス開発者ロールの割当て」を参照してください。
4	必要なソフトウェアをダウンロードしてインストールします	「必要なソフトウェアのダウンロードとインストール」を参照してください。
5	Rapid Adapter Builder用のVS Code拡張機能のインストール	「Rapid Adapter Builder用のVS Code拡張機能のインストール」を参照してください。
6	Rapid Adapter BuilderのVS Code拡張機能の構成	「Rapid Adapter BuilderのVS Code拡張機能の構成」を参照してください。

クライアント・アプリケーションの作成および資格証明の取得

Oracle Cloud Infrastructure Identity and Access Management (IAM)で、Oracle Integrationインスタンスのクライアント・アプリケーションを作成し、クライアント資格証明を取得します。

これらのクライアント資格証明は、Rapid Adapter Builderを使用してアダプタを公開する際に、パブリッシャ・プロファイルの詳細で使用します。

クライアント・アプリケーションを作成し、必要な詳細を取得するには、「Oracle Identity Domain環境でのOAuth 2.0付与の使用」の「クライアント資格証明およびリソース所有者のパスワード資格証明の前提条件」を参照してください。「クライアント資格証明」権限タイプを選択します。

Oracle Integrationインスタンスに関する次の詳細を取得する必要があります:

Host: Oracle IntegrationインスタンスのURL
integrationInstance: Oracle Integrationインスタンスの名前
次のクライアント資格証明:
- tokenUrl
- clientId
- clientSecret
- scope

クライアント・アプリケーションへの統合インスタンス開発者ロールの割当て

クライアント資格証明を正常に使用するには、以前に作成したクライアント・アプリケーションに統合インスタンス開発者ロールを割り当てます。

必要なロールをクライアント・アプリケーションに割り当てるには:

Oracle Cloudコンソールにログインします。
ナビゲーション・ペインで、Oracle Cloud Servicesをクリックします。

Oracle Cloud Servicesページが表示されます。
Oracle Integrationインスタンスに対応する特定のアプリケーションを選択します。
ナビゲーション・ペインで、「アプリケーション・ロール」をクリックします。

適用可能なすべてのロールのリストが表示されます。
ServiceDeveloperロールを展開し、「割当済アプリケーション」の横にある「管理」をクリックします。
「使用可能なアプリケーションの表示」をクリックします。
作成したアプリケーションを選択し、「割当」をクリックし、「閉じる」をクリックします。
これで、IAMによって統合インスタンス開発者ロールがアプリケーションに割り当てられます。

必要なソフトウェアのダウンロードとインストール

Rapid Adapter Builderを使用するには、追加のアプリケーションまたはソフトウェアがシステムにインストールされている必要があります。

Postmanアプリケーションをダウンロードしてインストールします。「Postmanのダウンロード」ページにアクセスします。 Postmanでアカウントを作成し、すべての機能にアクセスします。
VS Codeをダウンロードしてインストールします。「Visual Studio Codeのダウンロード」ページにアクセスします。

VS Codeバージョン1.73.0以上を使用する必要があります。

Rapid Adapter Builder用のVS Code拡張機能のインストール

Rapid Adapter BuilderのVS Code拡張機能をダウンロードしてインストールします。

Visual Studio Marketplaceで、Oracleのページにアクセスしてください。
「Oracle Integration CloudRapid Adapter Builder」タイルを見つけてクリックします。
「詳細」ページが開きます。
「インストール」をクリックします。
拡張ファイルがVS Codeで開きます。
VS Codeの「インストール」をクリックします。
これで、拡張機能がインストールされ、サイドバーに表示されます。

Rapid Adapter BuilderのVS Code拡張機能の構成

Rapid Adapter BuilderのVS Code拡張機能をインストールした後、システム上のワークスペースを初期化し、その拡張のパブリッシャ・プロファイルを構成する必要があります。

構造化ワークスペースとして使用するシステム上のフォルダを選択し、その中のアダプタ関連のアーティファクトを整理します。 VS Code拡張機能を使用して、このワークスペースを初期化します。

また、アダプタを公開するOracle Integrationインスタンスの詳細を使用して、拡張のパブリッシャ・プロファイルを更新します。以前に取得したクライアント資格証明と、いくつかの追加データを入力します。パブリッシャ・プロファイルの情報は、様々なタスクについて、指定されたOracle Integrationインスタンスと通信するために使用されます。拡張機能では、Oracle Integrationインスタンスごとに入力したクライアント資格証明がpublisher-profiles.yamlファイルに安全に格納されます。 yamlファイルの構造は次のとおりです:

プロパティ名	定義
`active`	使用するアクティブなプロファイル。値は、プロファイル・リストのプロファイル名と一致する必要があります。
`profiles`	プロファイル・オブジェクトの配列。
`profiles[*].name`	プロファイルの一意の名前。
`profiles[*].host`	REST APIのOracle Integrationインスタンスの設計時URL。
`profiles[*].integrationInstance`	Oracle Integrationインスタンスの名前。
`profiles[*].auth.tokenUrl`	Oracle Integrationインスタンスのget-token URL。Oracle Cloud Infrastructure Identity and Access Management (IAM)から取得されます。
`profiles[*].auth.clientId`	IAMの構成済アプリケーションのクライアントID。
`profiles[*].auth.clientSecret`	IAMの構成済アプリケーションのクライアント・シークレット。
`profiles[*].auth.scope`	IAMで構成されたアプリケーションの許可されたスコープ。

VS Codeで次のタスクを実行して、必要な構成を行います。

VS Code拡張を使用してワークスペースを初期化します。
1. VS Codeで、サイドバーの「エクスプローラ」をクリックします。
2. 「フォルダを開く」をクリックし、アダプタ開発のワークスペースとしてシステム上のフォルダを選択します。
  これで、エクスプローラ・ビューの左側にフォルダがリストされます。
  
  ノート:
  上部のリボンの「ファイル」をクリックし、「フォルダを開く...」を選択してVS Codeのフォルダを開くこともできます。
3. Ctrl + Shift + Pを押してコマンド・パレットを開き、RAB: Initialize Workspaceと入力して、Enterを押します。
  VS Code拡張は、ワークスペースを初期化し、ワークスペース内にいくつかのディレクトリおよびテンプレート・ファイルを作成します。作成されたディレクトリおよびファイルは、左側のエクスプローラ・ビューに表示されます。次のディレクトリおよびファイルが作成されます:
  - api: このフォルダには、すべてのOpenAPIファイルを保存できます。
    
    ノート:
    OpenAPIドキュメントをアダプタ・バンドルにパッケージ化するVS Code拡張機能の場合、OpenAPIドキュメントの名前をopenapi.resource.jsonに変更します。
  - definitions: 拡張機能により、このフォルダにデフォルトのアダプタ定義ドキュメントmain.add.jsonが作成されます。デフォルトのドキュメントは、PostmanコレクションまたはOpenAPIファイルのデータで上書きできます。さらに、生成したその他のアダプタ定義ドキュメントはすべて、このフォルダに保存されます。すべてのアダプタ定義ドキュメントのファイル名には、.add.jsonが付加されます。
  - misc: すべてのPostmanコレクションをこのフォルダに保存できます。すべてのPostmanコレクションのファイル名に.postman_collection.jsonが付加されていることを確認します。
  - logo.svg: アダプタのデフォルトのロゴ・ファイルがルート・フォルダの下に作成されます。このファイルを必要なイメージに置き換えることができます。
拡張機能のパブリッシャ・プロファイルを構成します。
1. VS Codeで、サイドバーの「OIC Rapid Adapter Builder」をクリックします。
2. 結果のビューで、「パブリッシャ・プロファイル」セクションの「編集」をクリックします。
  publisher-profiles.yamlファイルがエディタで開きます。
3. 前に取得したクライアント資格証明でファイルを更新します。「クライアント・アプリケーションの作成および資格証明の取得」を参照してください。また、使用するプロファイルの名前でactiveフィールドを更新します。
4. キーボードのCtrl+Sを押してファイルを保存します。
複数のOracle Integrationインスタンスの資格証明を入力すると、.yamlファイルは、詳細をインデントして実装された階層構造に格納されます。

次の例は、.yamlファイルに格納されている2つのOracle Integrationインスタンス(Test_Lab1およびTest_Lab2)の詳細を示しています。
```
# select which profile to use.
active: Test_Lab1

# multiple profiles can be defined.
profiles:  
  - name: Test_Lab1
    host: https://<oicinstance.oraclecloud.com>
    integrationInstance: example-instance1
    auth:
      tokenUrl: https://<IAM-token>/oauth2/v1/token
      clientId: ef8xxxxxbf0c4101a4f74ae5fe301exx
      clientSecret: 0ebdae12-xxxx-4182-9051-8dbd83b2xxxx
      scope: https://08DADxxxx9D4496F9FBAFxxCFA1B0657.integration.region-1.oraclecloud.com:443urn:opc:resource:consumer::all
  - name: Test_Lab2
    host: https://<oicinstance.oraclecloud.com>
    integrationInstance: example-instance2
    auth:
      tokenUrl: https://<IAM-token>/oauth2/v1/token
      clientId: ef9xxxxxbf0c4101a4f74ae5fe301exx
      clientSecret: 1ebdae12-xxxx-4182-9051-8dbd83b2xxxx
      scope: https://18DADxxxx9D4496F9FBAFxxCFA1B0657.integration.region-2.oraclecloud.com:443urn:opc:resource:consumer::all        
```