機械翻訳について

RESTおよびWebサービス・コネクタの作成

「プロセス」を使用して、公開されたRESTおよびWebサービスへの接続を作成できます。 プロセス・アプリケーションはこれらのサービスと通信し、データを交換できます。

トピック:

• RESTおよびWebサービスについて

• RESTコネクタの作成

• Webサービス・コネクタの作成

• Webサービス定義ファイルの使用

RESTおよびWebサービスについて

プロセス・アプリケーションは、RESTまたはWebサービスとして公開されているローカルおよびリモート・アプリケーションと通信し、データを交換できます。

RESTとWebサービスのいずれを使用するかを検討する場合、アプリケーションごとにサポートされるものが異なるため、プロトコルがすでに決定されている可能性があることに留意してください。 一般的なルールとして、Webを介した統合にはRESTサービスを使用し、企業アプリケーション統合シナリオにはWebサービスを使用します。 クラウド・アプリケーションは対話のためにコンシューマにオープンREST APIを提供し、クラウドで実行されているアプリケーションは、通常、RESTコールを介して通信します。

RESTおよびWebサービスはHyperText Transfer Protocol (HTTP)を使用してWorld Wide Web (WWW)で通信するクライアントおよびサーバー・アプリケーションです。

RESTおよびWebサービスの一般的な情報は、次を参照してください。

• Web Application Description Language (WADL)ファイルのW3Cホームページ:

  www.w3.org/Submission/wadl

• Web Services Description Language (WSDL)ファイルのW3Cホームページ:

  www.w3.org/TR/wsdl

• Java EE 6チュートリアルのWebサービスの章:

  docs.oracle.com/javaee/6/tutorial/doc/gijti.html

接続先のRESTまたはWebサービスに関するいくつかの基本情報が必要になります。 しかし、サービスが構成されている方法の詳細を把握する必要はありません。

RESTサービスへの接続

RESTサービスへの接続を作成するには、次のサービス情報が必要です。

• WADL、RAML、YAMLまたはその他に接続するためのRESTサービスの定義

• 異なるリソースの場所へのURL

• サービスとのデータの送受信に必要なタイプの作成に使用するJSONサンプルを取得するためのURLへのアクセス

• 各リソースで使用する操作のリスト

• 操作に渡すパラメータのリスト

• セキュアなRESTサービスの場合、サービスにアクセスするのに必要なユーザー名およびパスワード

Webサービスへの接続

Webサービスへの接続を作成するには、次のサービス情報が必要です。

• ローカル・ファイル・パスまたはURLとしてのWSDLファイルの場所

• 選択するWSDLファイルのポート・タイプおよびコールバック・ポート・タイプ

• セキュアなWebサービスの場合、サービスにアクセスするのに必要なユーザー名およびパスワード

RESTコネクタの作成

アウトバウンドRESTコネクタを使用して、RESTサービスを呼び出し、RESTアーキテクチャをサポートするWebサーバー上のデータを取得、作成、更新または削除します。 このコネクタにより、Oracle Integrationは、Oracle Cloudの内部または外部で実行されているSaaSおよびPaaSアプリケーションを含む、REST経由で他のOracle Cloudアプリケーションと対話できます。 RESTコネクタ・エディタを使用して、サービスの定義に使用される記述言語に関係なく、RESTサービスへの接続に必要なリソースおよび操作を定義します。

RESTコネクタの作成には、次の主要なタスクが含まれます。

• エディタを開くコネクタを作成します。

• コネクタのタイムアウト設定を設定します。

• コネクタに認証を適用します(オプション)。

• コネクタにリソースを追加します。

• リソースに操作を追加します。

• 操作のリクエストおよびレスポンス・パラメータを指定します。

• 要素パレットのコネクタの表示設定を指定します。

• プロセス内でRESTコネクタを実装します。

たとえば、EloquaからRESTサービス・コールを介してOracle Eloquaと対話するOracle Integrationアプリケーションを作成し、そのアプリケーションではOracle Eloquaから電子メールを取得して、プロセスからの情報で電子メールを更新できます。

• RESTコネクタはGET操作を使用してEloquaから電子メールの内容を取得し、PUT操作を使用してレスポンスで電子メールを更新します。 ビジネス・オブジェクトには、サンプルのペイロード値が含まれています。

• プロセスには、Eloquaの統合ポイントとして機能する2つのサービス・タスクが含まれています。 プロセスが承認対象の電子メールIDを受信します。 1つのサービス・タスクが、指定された電子メールIDを使用して、Eloquaからの電子メール内容をフェッチします。 承認または拒否のアクションの後、他のサービス・タスクが電子メールの内容を変更し、承認または拒否の結果を含めます。

RESTコネクタを作成、構成および実装するには:

1. RESTコネクタを作成します。
   1. 「アプリケーション・ホーム」タブで、「統合」をクリックし、「統合」ビューを選択します。
   2. 「統合へのリンク」をクリックし、「RESTコネクタの作成」を選択します。

      オプションで、「作成」をクリックし、「外部」をクリックして、RESTを選択します。

   3. 「Create REST Connector」ダイアログ・ボックスで、RESTサービスの名前およびベースURLを入力して、「Create」をクリックします。
      Restコネクタ・エディタが開き、ここには、展開可能な「Configuration」セクションおよび「Resources」セクションがあります。 「Configuration」セクションに、指定したベースURLが表示されます。
   4. 「Edit」をクリックして、コネクタの構成設定を展開します。
2. 全般タブで、RESTコネクタのタイムアウト設定を設定します(オプション)。

   
   図general_tab_rest.pngの説明

   1. 「読取りタイムアウト」フィールドに、ホストからのデータの読み取りを待機するタイムアウトをミリ秒単位で指定します。
   2. 「接続タイムアウト」フィールドに、初期接続を確立するためのタイムアウトをミリ秒単位で指定します。
3. 「セキュリティ」タブで、RESTコネクタに認証を適用します(オプション)。

   デフォルトでは、セキュリティは構成されていません。 HTTP Basic認証を適用して、リクエストを行うときにユーザー名とパスワードを要求することによって、Webリソースへのアクセス制御が提供されるようにできます。

   
   図security_tab_rest.pngの説明

   1. 「セキュリティ・タイプ」フィールドで、「APP ID - 基本認証」を選択して、基本認証をコネクタに適用します。
   2. 表示されるキーストア資格証明フィールドを完成させます。 新しいキーを作成するには、「New Key」を選択し、キー名、ユーザー名およびパスワードを入力します。
   3. 「Apply」をクリックして、構成設定を保存します。

   「Apply」は、保存する変更がある場合にのみアクティブです。

   資格証明の管理についてさらに学習したいですか。 「Webサービスの資格証明の構成」を参照してください。

4. コネクタにリソースを追加します。

   リソースには、標準のHTTPメソッド・リクエストを使用してリソースの基本的な作成、読み取り、更新、および削除操作(CRUD)を実行してデータを制御する1つ以上の操作が含まれています。

   
   図weath_connect1.pngの説明

   1. 「Resources」セクションの上部で、「Add」をクリックします。 「Resources」リストに追加された新しいリソースをクリックして展開します。
   2. リソースの名前を入力します。 サービス・タスクを実装するときに、このリソース名を選択します。
   3. 「Path」フィールドで、ベースURL内のリソース・パスを識別します。
   4. 必要に応じて、「Resources」セクションのオプションを使用して、リソースを複製(クローン化)および削除したり、加えられた変更を元に戻したり、やり直します。 リソースの複製は、類似するリソースを構成する場合に役立ちます。
5. リソースに操作を追加します。
   1. 「Operations」セクションで、「Add」をクリックします。
   2. 追加するHTTPメソッド(GET、PUT、POST、PATCH、DELETEまたはHEAD)を選択します。 新しい操作が、名前およびパスとともに「Operations」リストに追加されます。

      
      図weath_connect2.pngの説明

6. 操作のリクエストおよびレスポンス・パラメータを指定します。
   1. 「Operations」リストで、操作を選択して展開します。 必要に応じて、操作の「Type」、「Name」および階層「Path」フィールドを変更します。 オプションで、「Documentation」フィールドに説明を入力します。
   2. 「Request」および「Response」タブをクリックして、操作のパラメータおよび本文フィールドを表示します。 選択したHTTPメソッドによって、操作のために完成させるリクエスト・メッセージとレスポンス・メッセージの組合せが決まります。 タブの1つまたは複数の必須フィールドを完成させる必要がある場合は、アスタリスクが表示されます。

      HTTPメソッドの必須パラメータとオプション・パラメータについては、次の表を参照してください。 この表の情報は、HTTP/1.1のプロトコル定義のメソッドの定義に関する項に基づいています。

      HTTPメソッド	説明	リクエスト・メッセージ本文	レスポンス・メッセージ本文
      GET	リソースから情報を取得します。	オプショナル	Yes
      POST	リソースを作成します	Yes	オプショナル
      PUT	既存のリソースを完全に更新します。	Yes	オプショナル
      PATCH	既存のリソースを部分的に更新します。	Yes	オプショナル
      DELETE	リソースを削除します	オプショナル	オプショナル
      HEAD	レスポンスでメッセージ本文が返されないことを除き、GETと同じです	オプショナル	No

   3. 「Body」フィールドで、ビジネス・オブジェクトを追加または選択して、メッセージ・データを格納します。 REST操作ペイロードのJSONファイルに基づいて、ビジネス・オブジェクトを作成できます。 JSONサンプルをインポートするか貼り付けることによってビジネス・オブジェクトを作成するには、「Create Business Object」をクリックして「Import Business Object from JSON」ダイアログ・ボックスのフィールドに情報を入力し、JSONサンプル・テキストをアップロードするか貼り付けて、「Import」をクリックします。 JSONテキストが検証され、無効な場合はエラーが表示されます。
      RESTコネクタのJSON出力に、数字で始まるエレメントまたはスペースを含むエレメントが含まれていないことを確認してください。 これらの要素は、実行時にXMLに変換されたときに失敗したマッピング・エラーをスローする可能性があります。 要素名は大文字と小文字が区別され、文字またはアンダースコアで始まる必要があります。
   4. 「Body」フィールドでビジネス・オブジェクトを選択する場合は、「Media type」フィールドで、メッセージのメディア・タイプを指定することも必要となります。 Oracle Integrationはapplication/jsonをサポートします。
   5. 「Parameters」表で、操作について1つまたは複数のパラメータを構成します。 空の行をクリックして行を追加し、名前、スタイルおよび説明のフィールドを完成させます。 サポートされるスタイル・オプションには、選択したメソッドに応じて、テンプレート、ヘッダー、本文および問合せが含まれます。 操作のパス({Id}など)でパラメータ・トークンを追加、編集または削除すると、対応するテンプレート・パラメータが自動的に作成、編集または削除されます。
   6. 「Apply」をクリックして、操作を保存します。 「Apply」は、すべての必須情報が入力された場合にのみアクティブです。
7. 「可視性」タブで、要素パレットのコネクタの表示設定を指定します。

   
   図visibility_tab_rest.pngの説明

   1. 要素パレットのコネクタを非表示または表示するには、「パレットに表示」アイコンをクリックします。 コネクタはデフォルトでパレットに表示されるように設定されています。
   2. 次のいずれかを選択します。

      • 「コネクタを表示」を押して、パレットにコネクタを表示します。

      • 「リソースを表示」を使用して、コネクタ・リソースをパレットに表示します。

   3. 「ディスプレイのカスタマイズ...」をクリックして、パレットに表示されるコネクタまたはリソースの名前をカスタマイズします。 コネクタ・リソースを表示することを選択した場合は、パレットに表示する各リソースの表示名を選択できます。

      
      図display_resource.pngの説明

8. プロセス内でRESTコネクタを実装します。
   1. プロセスでは、「統合」フロー要素を展開し、使用するコネクタをキャンバスにドラッグ・アンド・ドロップします。
   2. データの関連付けを使用して、コネクタの入力と出力を構成します。 たとえば、RESTコネクタがGET操作を使用してEloquaから電子メールの内容を取得し、PUT操作を使用してレスポンスで電子メールを更新する場合、サービス・コールによって値が変更されるときにその値を格納するようビジネス・オブジェクトを構成します。
   3. パレットにRESTコネクタを表示しないことを選択した場合は、プロセス内の1つ以上のサービス・タスクで実装できます。

      このステップでは、RESTサービスを呼び出し、操作を実行して、ビジネス・オブジェクトにデータの変更を格納するように、1つまたは複数のサービス・タスクを構成します。 「統合、RESTおよびWebサービスの起動」を参照してください。 サービス・タスクへの入力および出力として新しい値(本文のメッセージやテンプレートなど)を渡すように、データ関連付けを構成します。

   4. プロセスで、サービス・タスクを追加するか開きます。 そのプロパティで、RESTサービスへのサービス・コールを実装します。 RESTコネクタ、リソースおよび呼び出す操作を選択します。
   5. データ関連付けを使用して、サービス・タスクの入力および出力を構成します。 たとえば、RESTコネクタがGET操作を使用してEloquaから電子メールの内容を取得し、PUT操作を使用してレスポンスで電子メールを更新する場合、サービス・コールによって値が変更されるときにその値を格納するようビジネス・オブジェクトを構成します。

      RESTサービス・コネクタを削除するには、「Integrations」ページでその削除アイコンをクリックします。 サービス・タスクによって呼出し中のRESTサービス・コネクタを削除することはできません。

Webサービス定義ファイルの使用

「Integrations」ページの「Definitions」ビューから、Webサービス定義(WSDL)ファイルをインポートし、新しいバージョンのファイルをアップロードし、特定のポート・タイプに基づいて新しいWebサービス・コネクタ・ファイルを追加できます。

「Application Home」タブで、「Integrations」をクリックした後、「Definitions」ビュー・オプションをクリックします。

WSDLのインポート

このインポート機能を使用してWSDLファイルの現在のバージョンを更新できます。 ただし、このインポート機能を使用したWSDLファイルの更新は、「Definitions」 - 「Details」ビューにある更新機能とは異なり、現在のWSDLファイルの更新のみ可能です。 インポート機能を使用してWSDLファイルを更新すると、ZIPファイルに含まれるWSDLファイルおよびXSD依存関係やリモートURLからインポートされるWSDLファイルおよびXSD依存関係が更新されます。

WSDLをインポートするには:

1. 「Import」をクリックして、「Upload Web Service Definition File」ダイアログ・ボックスを開きます。

2. 次のオプションのいずれかを選択します。

   • Upload from file: 「Browse」をクリックしてWSDLファイルまたはZIPファイルを参照します。

   • Use URL: WSDLファイルまたはZipファイルのURLを指定します。

3. 「Validate」をクリックした後、「Upload」をクリックします。

   「Validate」をクリックすると、検証に成功した場合、追加するファイルのサマリーが表示されます。

   ノート:

   検証に成功しなかった場合、ファイルのサマリーのかわりに、検証エラーまたは警告が表示されます。  検証の警告は、アップロードするファイルのいくつかが既存のファイルを上書きする場合に表示されます。 その場合、アップロードして既存のファイルを上書きできます。 予期しないエラーが発生した場合は常に、エラーはサーバー・ログに記録され、アップロードは取り消されます。 検証に失敗したファイルはインポートできません。

「Upload」をクリックしてインポートを受け入れると、操作がコミットされ、ファイルがアプリケーションにアップロードされて、「Integrations」ページの「Definition」ビューに表示されます。

新しいバージョンのWSDLのアップロード

WSDLの新しいバージョンをアップロードするには:

1. 上書きするWSDLの名前をクリックします。

2. 「Options」メニューをクリックした後、「Upload New Version」を選択して、「Upload New Version」ダイアログを開きます。

   

3. 次のオプションのいずれかを選択します。

   • Upload from file: 「Browse」をクリックしてWSDLファイルまたはZIPファイルを参照します。

   • Use URL: WSDLファイルまたはZipファイルのURLを指定します。

4. 「Validate」をクリックした後、「Upload」をクリックします。

   「Validate」をクリックすると、検証に成功した場合、追加するファイルのサマリーが表示されます。

特定のビジネス・ケースでは、現在のWSDLに「互換性なし」である変更でWSDL (SOAP)統合を更新する必要があります。

互換性のないWSDL (SOAP integration)には、次のような変更を含めることができます:

• ポート・タイプ(現在のWSDLで使用されている)が削除されました
• 一部の操作がポート・タイプから削除されました
• 一部の要素は、新規タイプに更新されたか、(XSD)スキーマから削除されました

互換性のない変更でWSDLを更新しているときには、変更の影響を示す警告メッセージが表示されます。 互換性のない変更でWSDLを更新した後、アプリケーションを検証し、更新のために発生した可能性のあるエラーを修正します。

Webサービス・コネクタの追加

特定のポート・タイプに基づいて新しいWebサービス・コネクタを追加するには:

1. 「Add」をクリックして「Add Service Connector」ダイアログを開きます。 名前を入力し、ポート・タイプを選択します。 必要に応じてコールバック・ポート・タイプも選択できます。

2. 「Advanced」を展開して次の情報を入力した後、「OK」をクリックして新しいWebサービス接続を追加します。

   • Read Time Out: WSDLファイルの読取りに対するタイムアウト時間をミリ秒単位で指定します。

   • Connection Time Out: Webサービスへの接続に対するタイムアウト時間をミリ秒単位で指定します。

   • Security: ドロップダウン・リストから、「None」、「APP Id - Basic Auth」、「APP Id - Username Token」または「APP Id - Username Token With Message Protection」を選択します。

     「統合へのメッセージ・セキュリティの適用」を参照してください。

   • Certificate: 「Security」を「APP Id - Username Token With Message Protection」に設定した場合、ドロップダウン・リストから「New Certificate Alias」を選択し、「Add Certificate」をクリックして証明書をアップロードします。

     「設計時のセキュリティ証明書の管理」を参照してください。

   • Keystore Credential: 「Security」を「None」に設定しなかった場合、ドロップダウン・リストからキーを選択します。

     [New Key]を選択し、名前、ユーザー名およびパスワードを入力することもできます。 既存のキーの場合、「Username」および「Password」の値は自動的に移入されます。

     資格証明を追加する方法についてさらに学習したいですか。 「Webサービスの資格証明の構成」を参照してください。

リモート参照を含むローカルWSDLファイルの準備

WSDLファイルに、リモート・スキーマ・ファイル対する依存関係がある場合は、ファイルをダウンロードして、ローカル参照を設定できます。 このステップはローカル・ファイルから作成する場合にのみ必要となることに注意してください。 リモートURLから作成する場合は、「プロセス」がリモート参照を処理します。

「プロセス」の外部で作成されたWebサービスまたはWebサービスとして公開されているプロセスについても、同じステップを実行する必要があります。

プロセスのWebサービス接続で使用するリモート参照を含むWSDLファイルを準備するには:

1. WSDLsとSchemasという名前の2つのサブディレクトリを持つルート・ディレクトリを作成します。
   WSDLs下のすべてのファイルがWSDLファイルで、さらにSchemas下のすべてのファイルがスキーマ・ファイルであるかぎり、WSDLsおよびSchemasのサブディレクトリを追加作成できます。
2. WSDLファイルへのアクセスにURLを使用する必要がある場合は、WSDLファイルをダウンロードし、それをWSDLsディレクトリにコピーします。
3. WSDLファイルの拡張子が.wsdl以外(.xmlなど)である場合は、WSDLファイルの名前を変更して、.wsdl拡張子を付けます。
4. WSDLファイルをテキスト・エディタで開きます。
5. WSDLファイルでスキーマ(.xsd)ファイルを参照するURLを検索します。
   たとえば、スキーマ・ファイルの参照は次のようになります: schemaLocation="http://www.example.com/ExampleService/ExampleSchema.xsd"
6. 各スキーマ・ファイルをダウンロードし、それをSchemasディレクトリまたはSchemasのサブティレクトリにコピーします。
7. WSDLファイルで、各スキーマ・ファイルの参照をSchemasディレクトリを参照するように変更します。
   たとえば、編集済のスキーマ・ファイルの参照は次のようになります: schemaLocation="/Schemas/ExampleService/ExampleSchema.xsd"
8. WSDLファイルを保存して閉じます。
9. WSDLsおよびSchemasディレクトリを含むルート・ディレクトリを圧縮します。
   圧縮プロセスにより.zipファイルに追加ファイルが作成されていないことを確認してください。 .zipファイルには、WSDLsおよびSchemasのディレクトリとサブディレクトリのみが含まれ、これらのディレクトリとサブディレクトリにはWSDLファイルおよびスキーマ・ファイルのみが含まれます。

生成された.zipファイルを使用して、Webサービスへの接続を作成します。 「Webサービス・コネクタの作成」を参照してください。

データ関連付けでSOAPヘッダーを使用

SOAPコネクタのWSDLで指定されたヘッダーに基づいて、データ入力と出力を作成します。 ヘッダーはSOAPコネクタを通して公開され、ヘッダーの値は、プロセス内のデータ関連付けを構成する際の入力データおよび出力データのマッピングに使用できます。

1. WSDLにヘッダーが指定されているSOAP統合を作成します。

   「Oracle Integration Generation 2での統合の使用」の「Oracle Integrationを使用した統合の開発」を参照してください。

   たとえば、次に示すように、WSDLをヘッダーと使用する統合を作成しました。

   
   「図wsdl-header.pngの説明」

   ヘッダーのメッセージには、userId、technicalUserId、sessionIdなどのヘッダー値があります。 これらの値はデータの関連付け中に使用できます。

2. コネクタを作成することでプロセスでアクティブな統合を使用します。
   1. 「アプリケーション」ホーム・タブで、「統合>」をクリックします。
   2. 統合の使用ダイアログ・ボックスで、ヘッダーを含むWSDLで作成した統合を参照して選択します。
   3. 「作成」.をクリックします
3. プロセス内のSOAPコネクタをコールします。

   これは、統合フロー要素(次のステップに示す)またはプロセスのSOAPエンドポイントをコールするサービス・タスクから直接行うことができます。

   1. プロセスで、要素パレット内の「統合」フロー要素を展開します。
   2. コネクタをキャンバスのプロセス・フローにドラッグ・アンド・ドロップします。
4. ヘッダー値を入力および出力データとして使用したデータ関連付けの構成。

   たとえば、InputTextをuserID (ヘッダー値)にマップし、InputText1をtechnicalUserId (ヘッダー値)にマップします。

   
   「図wsdl-header-da.pngの説明」

「統合の構成」を参照してください。