機械翻訳について
  1. Oracle Integration 3でのRapid Adapter Builderの使用
  2. アダプタ定義ドキュメントの使用
  3. 情報定義の更新
  4. 情報定義について学習
  5. 情報プロパティおよびサンプル・コード

情報プロパティおよびサンプル・コード

アダプタ定義ドキュメントのinfoセクションには、通常、ここにリストされているプロパティが含まれており、次のサンプル構造があります。

プロパティ

infoセクションには、次のプロパティが含まれます。

プロパティ 説明

id
アダプタの一意の識別子。

ノート:

id値の先頭にネームスペースがあり、識別子とコロンで区切られていることを確認します。 たとえば : "id" : "oracle:zuora"。oracleはネームスペースです。

type

アダプタが接続するアプリケーションのタイプ。 次の値から選択します:

  • Technology
  • Enterprise Messaging
  • Storage
  • Third Party
  • IaaS Services (Third Party & OCI)
  • Database
  • Block Chain

displayName

アダプタの名前。 この名前は、アダプタ・レジストリ・ページ、接続作成および選択関連ページなど、Oracle Integrationのユーザー・インタフェース上のいくつかの場所に表示されます。 このフィールドはローカライズできます。また、第三者がアイデンティティまたは名前の変更を決定した場合は、名前を変更することもできます。

description

アダプタの説明。 この値は、デザイン・ページ内のアダプタ・ページのOracle Integrationに表示されます。

version

アダプタのバージョン。 バージョンを指定する際は、最初の数字がメジャー・バージョンを表し、最後のメジャー・バージョンとの下位互換性がないセマンティック・バージョン・ルールに従ってください。 次の数字は下位互換性のある機能追加を表し、3桁目はアダプタのアクションおよびトリガーの契約を変更しない修正を示します。

セマンティック・バージョニングの詳細は、https://semver.org/を参照してください。

バージョン番号を更新すると、Rapid Adapter Builderプラットフォームによって、既存のアダプタ・バージョンと照合してバージョン番号が検証されます。詳細は、「セマンティック・バージョン・チェックのルール」を参照してください。

specVersion

アダプタ定義ドキュメントで使用される言語のバージョン。 このフィールドは、実行する言語バージョンをRapid Adapter Builderに示します。

categories

アダプタを作成するアプリケーションのカテゴリ。 カテゴリは、アダプタをOracle Integration内で編成する方法を決定します。 次の値から選択します:

  • ERP
  • HCM & HRMS
  • CRM & CX
  • Industries
  • On-premises Enterprise
  • SOA Connectivity
  • Social and Productivity
  • Database
  • Supply Chain Management
  • E-Commerce
  • Enterprise Messaging
  • Technology
  • Health Care
  • IaaS Services & OCI Services

appInfo

アダプタに関する情報。 この情報は、通常、Oracle Partner Networkの一部であり、アダプタを組織外に配布する予定の場合に関連します。

次のプロパティが使用可能です:

  • name: アダプタが統合機能を提供する組織、アプリケーションまたはテクノロジ。 名前がサード・パーティのブランディング要件に準拠していることを確認します。 この名前は、アダプタ・レジストリ・メタデータに表示されます。 たとえば、AsanaまたはSurveyMonkeyです。
  • description: アダプタの統合機能の説明。
  • contactUS: アダプタを開発した組織の連絡先情報。
  • supportURL: ユーザーがサポートをリクエストしたり、アダプタに関連する問題をレポートするために使用できるURL。
  • documentationURL: アダプタの詳細なドキュメントを参照するWebアドレス。

publisherInfo

アダプタを開発した組織に関する情報(通常は、使用する組織)。

次のプロパティが使用可能です:

  • name: アダプタを所有および管理する組織の名前。 名前がサード・パーティのブランディング要件に準拠していることを確認します。 この名前は、アダプタ・レジストリ・メタデータに表示されます。 たとえば、AdvancoまたはAuraplayerです。
  • description: アダプタを所有する組織の説明。 この説明は、アダプタ・レジストリ・メタデータに表示されます。
  • supportURL: ユーザーがサポートをリクエストしたり、アダプタに関連する問題をレポートするために使用できるURL。
  • documentationURL: アダプタの詳細なドキュメントを参照するWebアドレス。

settings

アダプタのセキュリティ設定および機能に関する情報。

  • supportsConnectivityAgent: trueまたはfalse。接続エージェントを使用してアダプタがオンプレミス環境にアクセスできるかどうかを示します。

  • supportsRegeneration: アダプタが構成済エンドポイントの再生成をサポートするかどうかを示すtrueまたはfalse。 エンドポイントを再生成すると、構成済アクションのスキーマは、サード・パーティのバックエンド・メタデータ・オブジェクト・モデルの変更に基づいて、リクエストおよびレスポンスの新しいスキーマ情報でリフレッシュされます。 「Oracle Integration 3での統合の使用」の「統合のエンドポイントのリフレッシュ」を参照してください。

  • _debug: trueまたはfalse。Oracle Integrationがバックグラウンド統合フローの実行ログを取得するかどうかを示します。これは、アダプタのフィールドまたは操作の構成時に必要になる場合があります。 「Designtimeでの統合フローのデバッグ」を参照してください。

  • allowNonSSL: trueまたはfalse。アダプタがSSLで保護されていないエンドポイントへのアウトバウンド・リクエストを実行できるかどうかを示します。

  • disableOutboundPayloadSanitization: デフォルトでは、Oracle Integrationは、リクエストの送信中またはレスポンスの受信中にJSONデータをエンコードして、インジェクション攻撃を防止します。 この動作を無効にするには、このプロパティをtrueに設定します。 たとえば、このプロパティがtrueに設定されている場合、統合開発者は接続をカスタマイズして、スクリプトをアプリケーションに注入できます。

    • このプロパティをfalseに設定すると、ターゲット・アプリケーションに送信されるアウトバウンド・ペイロード(リクエストおよびレスポンスを含む)はサニタイズされ、注入されたスクリプトは含まれません。

    • このプロパティをtrueに設定すると、ターゲット・アプリケーションに送信されるアウトバウンド・ペイロード(リクエストおよびレスポンスを含む)はサニタイズされず、注入されたスクリプトを含めることができます。

  • allowedDomains: アウトバウンド・リクエストに許可されるドメインの配列。 flowsおよびconnectionセクションで指定されるすべてのドメインも、このプロパティで指定する必要があります。

    「アウトバウンド呼出しを特定のドメインに制限」を参照してください。

  • followRedirects: 将来の使用のために予約されています。

サンプル・コード

{
  "info": {
    "id": "cloud:microsoft-task",
    "displayName": "Microsoft To-do Task",
    "description": "Microsoft To-do Task is a cloud-based task management service.",
    "version": "1.0.0",
    "specVersion": "1.0",
    "categories": [],
    "appInfo": {
      "name": "Oracle Corporation",
      "description": "https://www.oracle.com/about",
      "contactUS": "http://www.oracle.com/us/corporate/contact/index.html",
      "supportURL": "http://otn.oracle.com",
      "documentationURL": "https://www.oracle.com/pls/topic/lookup?ctx=appintICSGM-GUID-66A8F995-D32F-420B-9250-290B7D210FBB"
    },
    "publisherInfo": {
      "name": "Oracle Corporation",
      "description": "https://www.oracle.com/about",
      "contactUS": "http://www.oracle.com/us/corporate/contact/index.html",
      "supportURL": "http://otn.oracle.com",
      "documentationURL": "https://www.oracle.com/pls/topic/lookup?ctx=appintICSGM-GUID-66A8F995-D32F-420B-9250-290B7D210FBB"
    },
    "settings": {
      
    }
  }
}