Oracle® Fusion Middleware

Oracle Sales Cloud Adapterの使用方法

リリース12.2.1.1.0

E79311-01(原本部品番号:E73569-01)

2016年6月

Oracle Fusion Middleware Oracle Sales Cloudアダプタの使用、リリース 12.2.1.1.0

E79311-01

Copyright © 2015, 2016, Oracle and/or its affiliates  All rights reserved.

原本著者: Mark Kennedy

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。適用されるお客様とOracle Corporationとの間の契約に別段の定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。適用されるお客様とOracle Corporationとの間の契約に定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

目次

タイトルおよび著作権情報

はじめに

- 対象読者

- 関連リソース

- 表記規則

1 Oracle Sales Cloudアダプタの概要

- Oracle Sales Cloud

- クラウド・アダプタのインストール

- インストール後の構成タスクの実行

- Oracle Sales Cloudサービス・カタログ・サービスWSDLまたはイベント・カタログURLの指定

- 認証資格証明の取得

- サポートされていない機能

- 制限事項

2 Oracle Sales Cloudアダプタ機能の理解

- アダプタのアーキテクチャ

- カスタム・ビジネス・オブジェクト

- Oracle Sales Cloudアダプタ設計統合パターンの理解

- アダプタ構成ウィザードとの統合の設計

- 実行時のアプリケーションの監視

3 SOAコンポジット・アプリケーションの設計

- SOAコンポジット・アプリケーションの作成

- SOAコンポジット・アプリケーションにアダプタをサービスまたは参照として追加

- SOAコンポジット・アプリケーションの設計の完了

4 Oracle Service Busビジネス・サービスの設計

- Oracle Service Busビジネス・サービスの作成

- ビジネス・サービスにアダプタをサービスまたは参照として追加

- Oracle Service Busビジネス・サービスの設計の完了

5 Oracle Sales Cloudプロパティの構成

- 基本情報プロパティの構成

- 基本情報ページで実行可能な内容

- 基本情報ページに表示される内容

- Oracle Cloudアダプタの接続とCSFキーのプロパティの構成

- Oracle Cloudアダプタの接続ページで実行可能な内容

- Oracle Cloudアダプタの接続ページに表示される内容

- Oracle CloudアダプタのCSFキーページで実行可能な内容

- Oracle CloudアダプタのCSFキーページで実行可能な内容

- Oracle Sales Cloudソースのリクエスト・プロパティの構成

- Oracle Sales Cloudソースのリクエスト・ページで実行可能な内容

- Oracle Sales Cloudソースのリクエスト・ページに表示される内容

- Oracle Sales Cloudソースのレスポンス・プロパティの構成

- Oracle Sales Cloudトリガーの「レスポンス」ページで実行可能な内容

- Oracle Sales Cloudトリガーの「レスポンス」ページに表示される内容

- Oracle Sales Cloudターゲットの操作プロパティの構成

- Oracle Sales Cloudターゲットの操作ページで実行可能な内容

- Oracle Sales Cloudターゲットの操作ページに表示される内容

- 「サマリー」ページでの構成値の確認

- サマリーページで実行可能な内容

- サマリーページに表示される内容

6 アプリケーションの管理

- Oracle Enterprise Manager Fusion Middleware Controlでのアプリケーションの管理

- Oracle Service Bus ConsoleからのOracle Service Busビジネス・サービスのテスト

7 トラブルシューティングおよびエラー処理

- CSFキーを使用したイベントURLへの接続時のOracle JDeveloperでのSSL例外の回避

- CSFキーを使用したOracle Sales Cloudインバウンド・イベントURLへの接続の失敗

- イベントベースのコンポジットをサーバーにデプロイする前に資格証明の詳細をJCAファイルに追加する方法

はじめに

ここでは、次の項目について説明します。

『Oracle Fusion Middleware Oracle Sales Cloudアダプタの使用』では、SOAコンポジット・アプリケーションおよびOracle Service Busビジネス・サービスでのOracle Sales Cloudアダプタの使用方法について説明します。

- 対象読者

- 関連リソース

- 表記規則

対象読者

『Oracle Fusion Middleware Oracle Sales Cloudアダプタの使用』は、Oracle Sales Cloudアダプタを使用するアプリケーションを作成、デプロイ、テストおよび監視するユーザーを対象にしています。

関連リソース

詳細は、次のOracleドキュメントを参照してください。

- 『Oracle SOAスイートでのSOAアプリケーションの開発』

- Oracle SOA SuiteおよびOracle Business Process Management Suiteの管理

- Oracle Service Busの管理

- テクノロジ・アダプタの理解

表記規則

このマニュアルでは次の表記規則を使用します。

表記規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック

イタリックは、ユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

1 Oracle Sales Cloudアダプタの概要

この項では、Oracle Sales Cloudアダプタの概要を説明します。

内容

- Oracle Sales Cloud

- クラウド・アダプタのインストール

- インストール後の構成タスクの実行

- Oracle Sales Cloud WSDLの指定

- 認証資格証明の取得

- サポートされていない機能

- 制限事項

Oracle Sales Cloud

Oracle Sales Cloudでは、デプロイと使用が容易なツールによる最新の販売活動が可能です。これらは、完全なモバイル型で、強力な分析機能を備えており、共同の販売活動や収益確保用に設計されています。Oracle Sales Cloudは、販売キャンペーンの作成や追跡、ビジネス案件へのリードの開発、案件の追跡による収益確保のための一連の機能を備えています。売上勘定、リードおよび案件を、領域や販売チームに自動で割り当てることができます。

Oracle Sales Cloudアダプタによって、顧客は、統合に関連する具体的な詳細を知ることなく、業務用アプリケーションまたはSaaSアプリケーションをOracle Sales Cloudに容易に統合できます。

Oracle Fusion Applicationsと統合するには、設計時および実行時の複数の考慮事項が伴います。このためには、認証、セッション管理、フォルト処理、データ変換マッピングなど、統合への追加ロジックをユーザーが手動で作成および管理する必要があります。Oracle Sales Cloudアダプタでは、ポイント・アンド・クリックによるグラフィカルなウィザードベースのデザイナなど、即時利用可能な機能を使用して、この複雑なロジックを作成および管理するコストが削減されます。Oracle Sales Cloud接続:

- アダプタ構成中に選択された公開ビジネス・オブジェクトまたはイベント・サブスクリプションに対する自動マッピングを生成します。

- ビジネス・オブジェクト: 統合による動作の基準となる自己完結型ビジネス・ドキュメントを表します。統合は、そのビジネス・オブジェクトの新しいレコードを作成するためのリクエストを送信できます。それらは、ビジネス・オブジェクトの既存のレコードを更新または削除するためのリクエストを送信できます。統合は、そのビジネス・オブジェクトを表す1つ以上のレコードの情報を取得するためのリクエストを送信することもできます。

- イベント・サブスクリプション: サブスクライブ先のイベント・ドキュメントを表します。イベント・サブスクリプションは、Oracle Sales Cloud アプリケーションによって生成されます。

- 公開されているOracle Sales Cloudビジネス・オブジェクトまたはイベント・サブスクリプションと実行時に相互作用して、それらに定義されている操作を実行します。

- 統合に利用可能なビジネス・オブジェクトとサービスに関するコンテキスト情報を設計時に開発者に提供します。

- Oracle Sales CloudサービスWSDLで間接的に参照される、スタンドアロンおよび子の両方のカスタム・オブジェクトを提供します。これらのオブジェクトは、最上級の強力なタイプのオブジェクトとして表されます。

詳細は、「Oracle Sales Cloudプロパティの構成」を参照してください。

クラウド・アダプタのインストール

クラウド・アダプタは、Oracle SOA Suiteのインストール時に自動的にインストールされます。

アダプタのインストールが完了したら、「インストール後の構成タスクの実行」で説明するタスクを実行します。

注意:
サポートされているバージョンとプラットフォームの詳細は、「サポートされているシステム構成」のリリース動作保証マトリックスを参照してください。

インストール後の構成タスクの実行

クラウド・アダプタをインストールした後、インストール後の構成タスクを実行する必要があります。

インストール後の構成タスクについては、『Oracle Fusion Middleware Oracle Cloudアダプタ・インストール後の構成ガイド』を参照してください。

Oracle Sales Cloudサービス・カタログ・サービスWSDLまたはイベント・カタログURLの指定

必須のOracle Sales Cloudサービス・カタログ・サービスWSDL (ビジネス・オブジェクトへのアクセス用)を指定する必要があります。また、任意でイベント・カタログURL (イベント・サブスクリプションへのアクセス用)も指定します。

サービス・カタログ・サービスWSDLの取得

ビジネス・オブジェクトにアクセスするためには、必須のOracle Sales Cloudサービス・カタログ・サービスWSDLが必要です。また、イベント・サブスクリプション用に、イベント・カタログURLを任意で指定することもできます。サービス・カタログ・サービスWSDLは、ビジネス・オブジェクトまたはビジネス・サービスを使用してインバウンド・エンドポイントとアウトバウンド・エンドポイントの両方でアダプタを構成するために必要です。イベント・カタログURLは、イベント・サブスクリプション用にインバウンド・アダプタを構成するために必要です。

WSDL要件

WSDLの入手先

URLはサービス・カタログ・サービスWSDLのものにしてください。サービス・カタログ・サービスは、統合に利用可能な外部サービスのリストを返すFusion Applicationサービスです。それを使用すると、クライアントは、そのインスタンスに利用可能なすべての公開Fusion Applicationサービス・エンドポイントに関する情報を取得できます。

サービス・カタログ・サービスを使用すると、クライアントは、そのインスタンスに利用可能なすべての公開Oracle Fusion Applicationサービス・エンドポイントに関する情報を取得できます。それによって返される情報は、特定のクラウド・インスタンスに固有のものであり、インスタンスに適用されるパッチで導入されている新しいサービスも反映します。このサービスは、クラウド・インスタンス上で利用可能なSOAPサービスをプログラムによって見つけ出し、必要なメタデータを取得して、ビジネス・オブジェクトを管理するSOAPサービスを呼び出します。

Oracle Sales Cloud接続を作成する開発者は、Oracle Sales Cloudサービス管理者と協力して、特定のSaaSアプリケーションにプロビジョニングされたサービス・カタログ・サービスの具体WSDL URLを取得する必要があります。

この項では、トークン化されたサービス・カタログ・サービスWSDLの外部の仮想ホストとポートを抽出する方法について説明します。トポロジ登録設定タスクのトポロジ情報には、ドメインやアプリケーションの外部の仮想ホストとポートが含まれます。次に、サービス・カタログ・サービスのWSDL URL (例: https://atf_server:port/fndAppCoreServices/ServiceCatalogService)を使用して値を抽出する手順について説明します。

トポロジの確認ページにアクセスするには、ASM_REVIEW_TOPOLOGY_HIERARCHY_PRIV資格をユーザーのジョブ・ロールに付与する必要があります。資格は、ASM_APPLICATION_DEPLOYER_DUTY義務ロールに付与されます。これは、義務ロールASM_APPLICATION_DEVELOPER_DUTYおよびASM_APPLICATION_ADMIN_DUTYによって継承されます。

次の手順で説明するメニュー項目とタスクがクラウド・サービスで利用できない場合、アカウントで必要なロールが欠落しています。このような場合は、クラウド・インスタンスのセキュリティ管理者に連絡してください。

1. クラウド・インスタンスにログインします。

2. ウィンドウ上部のグローバル領域でナビゲータアイコンをクリックして、見出し「ツール」の「セットアップとメンテナンス」を選択します。

3. ウィンドウ左側のタスク領域のトポロジ登録セクションで、「トポロジの確認」を選択します。

4. ウィンドウ中央の詳細タブをクリックします。
タブには、クラウド・インスタンスで構成されているドメインのリストが表示されます。

5. トポロジ・マネージャで、サービス・パス値のトークン名とドメイン名をマップします。

サービス・パスのトークン名

ドメイン名

atf_server

CommonDomain

crm_server

CRMDomain

fin_server

FinancialDomain

hcm_server

HCMDomain

ic_server

ICDomain

prc_server

ProcurementDomain

prj_server

ProjectsDomain

scm_server

SCMDomain

6. ドメイン名を展開し、ドメインにデプロイされるJ2EEアプリケーションの外部の仮想ホストとポートを選択します。サンプル・ウィンドウでは、この特定インスタンスの値は、それぞれfs-your-cloud-hostnameと443になります。

7. domainName_server:PortNumberを、前の手順で特定した外部の仮想ホストとポートに置き換えます。次に例を示します。
https://fs-your-cloud-hostname:port/fndAppCoreServices/ServiceCatalogService?wsdl

イベント・カタログURLの取得

顧客関係管理(CRM)のURLフォーマットを把握して、CRMアプリケーションのユーザー・インタフェースにアクセスする必要があります。URLフォーマットに従って、イベント・カタログURLを特定します。たとえば、CRMのURLが次のフォーマットの場合。

https://fusxxxx-crm-ext.us.oracle.com/customer/faces/CrmFusionHome

イベント・カタログURLは次のようになります。

https://fusxxxx-crm-ext.us.oracle.com/soa-infra

注意:
アダプタ構成ウィザードの「リクエスト」ページ上のイベントにサブスクライブする場合は、Application_Name/Project_Name/SOA/Adapters/ディレクトリのインバウンドJCAファイルを、次に示す詳細を使用して、手動で更新する必要があります。

<property name="csfkey" value="osc"/>
<property name="csfMap" value="oracle.wsm.security"/>

これは、アダプタ構成ウィザードの「CSFキーの作成」ページでCSFの詳細を指定していても、これらの詳細がJCAファイルに追加されないためです。インバウンド・イベント・サブスクリプションを含むコンポジットのデプロイを試行すると、デプロイに失敗します。手動でインバウンドJCAファイルを更新することで、デプロイメントを正常に実行できます。

認証資格証明の取得

Oracle JDeveloperで、資格証明ストア・フレームワーク(CSF)認証キーの作成に必要なユーザー名とパスワードをSOAドメイン管理者から取得します。これらの資格証明は、ほとんどのクラウド・アダプタに必要です。

Oracle Eloqua Cloudアダプタを構成する場合は、資格証明に3つのプロパティ(企業、ユーザー名およびパスワード)が必要です。

サポートされていない機能

アダプタは次の機能をサポートしていません。

- アダプタの実行時再試行構成プロパティ(jca.retry.count, jca.retry.backoff、jca.retry.interval、jca.retry.maxIntervalなど)

- Oracle Enterprise Manager Fusion Middleware Controlでのエラー・ホスピタルのメッセージ・リカバリ

- Oracle Enterprise Manager Fusion Middleware Controlの参照(アウトバウンド)アダプタ用の「プロパティ」タブへのプロパティの表示(サービスWSDL URLや使用されるCSFキーなど)。これらは、「サービスと参照」ページで選択する参照アダプタです。

- 拒否メッセージの処理

- 呼出しの数などのメトリック。

- Oracle JDeveloperの「公開されたサービス」スイムレーンまたは「外部参照」スイムレーンでクラウド・アダプタを右クリックして利用できる次のメッセージ暗号化と復号化の機能。

- 「公開されたサービス」スイムレーンでのクラウド・アダプタの「機密データの保護」→「リクエスト・データの暗号化」。

- 「外部参照」スイムレーンでのクラウド・アダプタの「機密データの保護」→「機密データの復号化」。

- Oracle JDeveloperの「公開されたサービス」スイムレーンまたは「外部参照」スイムレーンでクラウド・アダプタを右クリックしたときに使用できるポリシー・アタッチメント機能。

制限事項

次の制約に注意してください:

Oracle Fusion Applicationのトポロジでは、Webとサービス・リソースの可視性を内部と外部の2つのカテゴリに分類するため、すべてのOracle Fusion ApplicationサービスがSaaSモードで利用できるわけではありません。そのため、一部のサービスは内部向けであり、統合用にアダプタで使用できません。 外部サービスのみが公開用として利用できます。

アダプタは、 内部ファミリ・モジュールの統合に使用できません。これは、それらに定義されているサービスが外部サービスではないためです。

2 Oracle Sales Cloudアダプタ機能の理解

Oracle Sales Cloudアダプタには、次の機能があります。

内容

- アダプタのアーキテクチャ

- カスタム・ビジネス・オブジェクト

- Oracle Sales Cloudアダプタ設計統合パターンの理解

- アダプタ構成ウィザードとの統合の設計

- 実行時のアプリケーションの監視

アダプタのアーキテクチャ

アダプタには次の主要機能があります。

サービス・カタログ・サービス

アダプタ構成時に指定するWSDL URLは、サービス・カタログ・サービスWSDLのものにしてください。サービス・カタログ・サービスは、統合に利用可能な外部サービスのリストを返すFusion Applicationサービスです。サービス・カタログ・サービスには次の機能があります。

- クラウド・インスタンスでプロビジョニングされます。

- 特定のクラウド・インスタンスに関するパブリック外部サービス情報を提供します。 これには、パッチおよびカスタマイズに導入されている新しいサービスが反映されます。

- サービス・カタログ・サービスがプロビジョニングされた、クラウド・インスタンス上のパブリック外部サービスのエンドポイントとメタデータを取得します。 返される情報は、特定のクラウド・インスタンスに固有のものであり、インスタンスに適用されたパッチに導入されている新しいサービスが反映されます。 パートナと顧客は、Oracle Applicationsクラウド内のOracle Fusion Applicationsでこのサービスを使用することにより、クラウド・インスタンス上で使用可能なSOAPサービスをプログラムで検出したり、ビジネス・オブジェクトを管理するためのSOAPサービスを呼び出すために必要なメタデータを取得したりできます。

ビジネス・オブジェクト

サービスが実装するビジネス・オブジェクトは、属性の集合が含まれる論理エンティティの階層で構成されます。たとえば、案件サービスは、案件ビジネス・オブジェクトで定義されます。案件ビジネス・オブジェクトは、案件の連絡先や案件のリードなどの様々なエンティティで構成されます。ビジネス・オブジェクトは、サービスが動作する機能オブジェクトです。たとえば、案件、売上勘定、セールス・リード、マーケティング・キャンペーン、売上予測などがあります。

イベント・サブスクリプション

イベント・サブスクリプションは、サブスクライブ先のイベント・ドキュメントを表します。イベント・サブスクリプションは、Oracle Sales Cloud アプリケーションによって生成されます。

ビジネス・オブジェクトに関する注記

ビジネス・オブジェクトは関連オブジェクトにグループ化され、さらに上位レベルの関連オブジェクトにグループ化されます。たとえば、案件サービスのビジネス・オブジェクトの値は次のようになります。

- CRM: 案件管理: 案件

前述の値は、サービスがオポチュニティ・オブジェクトに対して動作していることを意味します。 オポチュニティ・オブジェクトはオポチュニティ管理と呼ばれる関連オブジェクト・セットにグループ化されます。次に、この関連オブジェクトはCRM (Customer Relationship Management)と呼ばれる、より大規模な関連オブジェクト・セットにグループ化されます。 オポチュニティ管理グループに含まれる他のビジネス・オブジェクトは、販売方法と販売収益です。CRMには、その他にリード管理やパートナ管理などの論理ビジネス・オブジェクト・グループがあります。

ビジネス・オブジェクト・サービスのライフ・サイクル

ビジネス・オブジェクト・サービスは、ライフ・サイクルの3つのフェーズを経由します。

- アクティブ: このフェーズは、サービスが初めて配布されると開始し、非推奨になるまで続きます。

- 非推奨: サービスは、新しいバージョンのサービスと交代した場合や、将来のリリースで廃止が予定されている場合に、非推奨になる可能性があります。 非推奨のステータスは、サービスがまだサポートされてはいるが、将来のリリースでは廃止されることを意味します。
非推奨のサービスは、サポート対象外という意味ではありません。廃止になるまでサポートは続きます。非推奨のサービスは、サービスが将来終了することがユーザーに伝えられている間に非推奨サイクルを経由する必要があります。ただし、引き続きサポートが必要なサービスになります。

選択したビジネス・オブジェクトまたはサービスのライフ・サイクルの値が非推奨の場合、警告メッセージが表示されます。ビジネス・オブジェクトまたはサービスによって、交換用のビジネス・オブジェクトまたはサービスに関する情報が取得される場合も表示されます。この情報は、サービスのWSDLの注釈要素から得られます。

サービスWSDLの一部を次に示します。

<wsdl:documentation xmlns:oer="http://xmlns.oracle.com/oer">
<name>Opportunity Service</name>
<description>A service to create, update, get, find, or delete opportunities.
WARNING: This service will be deprecated and replaced with a newer version in the upcoming release.</description>
<oer:lifecycle>Active</oer:lifecycle>
<oer:compatibility>Supported - Backward Compatibility Assured</oer:compatibility>
. . .
<oer:category name="lbo">
<value>CRM-CRM : MOO-Opportunity Management : MOO_OPPORTUNITY-Opportunity</value>
</oer:category>
</wsdl:documentation>

新しいサービス消費者は、アクティブな新しいバージョンのサービスを消費し、既存のカスタマは、アクティブな新しいバージョンのサービスに移行する必要があります。

- 廃止: サービスの出荷およびサポートは行われなくなります。

サポートの有無

パブリック外部SOAPサービスは、廃止されるまでライフサイクル全体にわたってサポートされます。 一方で、プライベートと見なされ、パートナや顧客による消費の対象ではないサービスは、サポートされません。

クラウド・サービス

クラウドWebサービス(Oracle Sales CloudまたはOracle HCM Cloudの場合など)では、企業がクラウド(Oracle Sales CloudやOracle HCM Cloudなど)との統合目的でプログラムを構築する際に使用できるアプリケーション・プログラミング・インタフェース(API)にアクセスできます。APIは、クラウド・オブジェクトへのインタフェースを記述する一連のWSDLファイルで構成されます。これは、クラウド情報(Oracle Sales CloudまたはOracle HCM Cloudの場合など)にアクセスするためのプログラム・インタフェースを備えています。カスタマ・アプリケーションは、標準Webサービス開発ツールによってWSDLファイルを使用できます。WebサービスAPIを使用すると、企業はクラウド(Oracle Sales CloudまたはOracle HCM Cloudなど)との統合目的でプログラムを構築できます。

クライアント統合の一般的な例として、CRMとバックオフィス・アプリケーションの統合があります。リアルタイムの売上やマーケティング情報をクラウド(Oracle Sales CloudまたはOracle HCM Cloudなど)から取得し、それを財務やその他のバックオフィス・アプリケーションで使用できます。たとえば、最近閉じた案件に関する情報をWebサービス・インタフェースを使用して取得し、この情報を、Webサービス・ユーザー・インタフェースを備える注文入力システムに挿入できます。さらに、ユーザーがすぐにアクセスできるように、バックオフィス・アプリケーションの情報を格納できます。これは、カスタム・フィールドに表示されます。

セキュリティ

Fusion Webサービスにアクセスする前に、クラウド・サービス(Oracle Sales CloudまたはOracle HCM Cloudなど)に付属のセキュリティ・ポリシーに従ってユーザー資格証明を指定する必要があります。認証が成功すると、ユーザーがログインし、Webサービス・リクエストを発行してデータへのアクセスやデータの取得が可能です。各Webサービス・コールがアトミック・トランザクションになり、永続セッションに関連付けられないように、クラウドWebサービスはすべてステートレスになります(Oracle Sales CloudまたはOracle HCM Cloudなど)。ステートレスWebサービス・コールの管理は、基本のFusionフレームワークで行い、エンド・ユーザーから抽出されます。

カスタム・ビジネス・オブジェクト

アダプタには、カスタム・ビジネス・オブジェクトのサポートが含まれます。

カスタム・オブジェクトは、デプロイしたインスタンスでユーザーが追加するユーザー定義オブジェクトと似ています。

カスタム・オブジェクトとカスタム属性には、名前に"_c"が付加されます。カスタム・オブジェクトは、汎用サービス・インタフェースを使用して公開されます。カスタム・オブジェクトWebサービスには、カスタム・オブジェクトがパラメータとして渡される汎用操作が含まれます。サービスWSDLで参照されるスキーマを調べると、利用可能な操作のパラメータの詳細がわかります。

Oracle Sales Cloudアダプタ設計統合パターンの理解

Oracle Sales Cloudアダプタは、アダプタ構成ウィザードで次の設計統合パターンをサポートしています。

Oracle Sales CloudアダプタからOracle Sales Cloudアプリケーションへのアウトバウンド統合

- Oracle Sales Cloudアプリケーションに接続するようにOracle Sales Cloudアダプタを構成します。

- 一連の使用可能なビジネス・オブジェクト(標準およびカスタム)とイベント・サブスクリプション内を移動して、オブジェクトを呼び出すための操作を選択します。また、検索機能を使用して、ビジネス・オブジェクトを探すこともできます。

- アダプタ構成を保存して、アダプタ構成ウィザードを終了します。

- アプリケーション・ビジネス・オブジェクトと、Oracle Sales Cloudの論理ビジネス・オブジェクトをマップします。

- SOAコンポジット・アプリケーションの設計を完了します。

実行時、SOAコンポジット・アプリケーションは、Oracle Sales Cloudアダプタを使用してOracle Sales Cloud上のビジネス・オブジェクトに対して選択した操作を行います。

Oracle Sales CloudアプリケーションからOracle Sales Cloudアダプタへのインバウンド統合

Oracle Sales Cloudアダプタは、インバウンド接続用に構成することもできます。たとえば、業務用アプリケーションをOracle Sales Cloudアプリケーションに統合するには、Oracle Sales Cloudアダプタを使用してインバウンド・サービス・インタフェースを定義します。このサービスは、Oracle Sales Cloudで呼び出されます。

- Oracle Sales Cloudで呼び出されるインバウンド・サービス・インタフェースを定義します。

- オブジェクトのリストを参照して、サービス・エンドポイントを構成します。Oracle Sales Cloudから受信するビジネス・オブジェクトを、このSOAコンポジット・アプリケーションへのリクエスト・ペイロードとして選択します。

- Oracle Sales Cloudアダプタ構成を完了します。

- SOAコンポジット・アプリケーションの設計を、ビジネス要件ごとに完了します。

アダプタ構成ウィザードとの統合の設計

アダプタ構成ウィザードを使用して、SOAコンポジット・アプリケーションまたはOracle Service Busビジネス・サービスにOracle Sales Cloudアダプタを含めます。

アダプタ構成ウィザードは、Oracle Sales Cloudアプリケーションとの通信に必要なアーティファクトを選択できる構成ページで構成されます。インバウンド(ソース)方向またはアウトバウンド(ターゲット)方向にアダプタを構成できます。

注意:
アダプタの構成中に「ファイルのローカライズ」ダイアログが表示された場合は、「取消」をクリックしてください。WSDLファイルはローカライズできません。

- インバウンド(ソース)方向:

- 基本情報ページでは、わかりやすい名前とオプションの説明を入力するよう求められます。

- 接続ページでは、使用するWSDL、セキュリティ・ポリシー(ユーザー名パスワード・トークン)およびCSF認証キーの指定が求められます。認証キーを作成するには、追加アイコンをクリックして、キー名、ユーザー名およびパスワードを指定します。
接続ページでOracle Sales Cloudアプリケーションへの接続をテストすることもできます。これによって、サービス・カタログ・サービスへのURLと資格証明が正しいことを確認できます。接続が成功したか、資格証明がOracle Sales Cloudアプリケーションによって認証されたかどうかを示すステータスが表示されます。接続の試行時に発生したエラーも表示されます。

- 「リクエスト」ページでは、Oracle Sales Cloudアプリケーションからのリクエストとして受信するビジネス・オブジェクトまたはイベント・サブスクリプションの選択が求められます。

注意:

- インバウンド方向でビジネス・オブジェクトを選択すると、表の下に説明が表示されますが、選択オブジェクトのライフサイクル情報(アクティブまたは非推奨など)は表示されません。アウトバウンド方向では、ビジネス・オブジェクトのライフサイクル情報が表示されます。

- イベント・サブスクリプションの場合、コールバックは必要ありません。したがって、「レスポンス」ページでレスポンスに「なし」を選択する必要があります。

Oracle Sales Cloudインスタンスで利用可能なすべてのデータ・オブジェクトを取得するために、アダプタは最初にサービスのWSDLで参照されるスキーマ・ドキュメント(.XSD)を読み込みます。次に、アダプタは、このXSDを解析してすべてのスキーマ・インポートのリストを取得し、それらをデータ・オブジェクトとして表示します。

たとえば、アダプタでは、案件サービスのWSDLと参照スキーマOpportunityService.xsdファイルを読み込むことで、最初に案件ビジネス・オブジェクトとその有用なメタデータを表示します。XSDは、案件ビジネス・オブジェクトが定義される別のスキーマOpportunity.xsdを順にインポートします。 案件ビジネス・オブジェクトのメタデータは、このスキーマで定義されます。

すぐに選択できるように、ビジネス・オブジェクトの表示をフィルタ処理できる検索機能が用意されています。検索文字列を入力すると、すべてのオブジェクトを表示するのではなく、一致したビジネス・オブジェクトのみがリストに表示されます。

- レスポンス・ページでは、Oracle Sales Cloudアプリケーションにレスポンス・ドキュメントとして送信する、統合のビジネス・オブジェクトの選択が求められます。レスポンスを送信しないためには、「なし」を選択します。Oracle Sales Cloudアプリケーションにすぐにレスポンスを返すようにオプションで選択することもできます。即時レスポンスは、対話型のレスポンスを表します。即時レスポンスの場合、いずれかのデータ・オブジェクトをレスポンス・ドキュメントとして選択できます。

- 「サマリー」ページには、前のページでの選択内容が表示されます。

- アウトバウンド(ソース)方向:

- 基本情報ページでは、わかりやすい名前とオプションの説明を入力するよう求められます。これは、インバウンド方向で表示されるページと同じです。

- 接続ページでは、使用するWSDL、セキュリティ・ポリシー(なし、基本認証またはユーザー名パスワード・トークン)およびCSF認証キーの指定が求められます。これは、インバウンド方向で表示されるページと同じです。
操作ページでは、ビジネス・オブジェクトまたはサービスと、選択内容に対して実行する操作の選択が求められます。

サービス名に基づく検索機能も備えています。ビジネス・オブジェクトをすばやく選択するには、検索文字列を入力します。リスト・ブラウザでは、すべてのサービスを表示するかわりに、一致するビジネス・サービスのみがレンダリングされます。

- 「サマリー」ページには、前のページでの選択内容が表示されます。

次のアーティファクトがアダプタ・インスタンスごとに作成され、Oracle JDeveloperの「アプリケーション」ウィンドウに表示されます。

- WSDLファイル: Oracle Sales Cloudアプリケーション・サービスに統合すると同時に、データ・マッピングの作成に関して簡略化されたユーザー・エクスペリエンスを提供します。たとえば、抽象WSDLでは、強力な型のタイプ、選択した操作とビジネス・オブジェクトの名前、リクエストとレスポンスの構造を定義します。

- JCAファイル: 実行時にアダプタが使用する内部実装の詳細が含まれます。これには、アダプタが使用する様々な相互作用と接続のプロパティが含まれます。

アプリケーションの構成が完了したら、Oracle JDeveloperからランタイム環境にアプリケーションをデプロイできます。

注意:
ウィザードでは、レスポンス・メッセージ・コールバックの作成はサポートされません。かわりに、コールバックをサポートするアクティビティを含めるBPELプロセスを設計できます。

注意:
構成済のOracle Sales Cloudアダプタやリファレンスを再編集する場合は、サービス・カタログWSDLがサービスURLに置き換えられます。正しく動作させるには、アダプタのサービス・カタログWSDLを再入力する必要があります。

ウィザード・ページのフィールドで指定する詳細内容については、「Oracle Sales Cloudプロパティの構成」を参照してください。

実行時のアプリケーションの監視

実行時環境からアプリケーションを監視できます。

アダプタのランタイム部分を使用して、設計時に生成された情報をサービス・エンドポイントに配信します。SOAコンポジット・アプリケーションまたはOracle Service Busビジネス・サービスをOracle Enterprise Manager Fusion Middleware Controlから監視できます。Oracle Service Busビジネス・サービスをOracle Service Bus Consoleからテストして監視することもできます。ただし、Oracle Enterprise Manager Fusion Middleware Controlでは、アダプタのサービスおよび参照メトリックは監視できません。

3 SOAコンポジット・アプリケーションの設計

この項では、Oracle JDeveloperでOracle Sales Cloudアダプタを含むSOAコンポジット・アプリケーションを設計する方法について説明します。

内容

- SOAコンポジット・アプリケーションの作成

- SOAコンポジット・アプリケーションにアダプタをサービスまたは参照として追加

- SOAコンポジット・アプリケーションの設計の完了

SOAコンポジット・アプリケーションの作成

この項では、アダプタを公開サービスまたは外部参照として含めるSOAコンポジット・アプリケーションの作成方法の概要を示します。

1. Oracle JDeveloperを起動します。

2. 「ファイル」メニューで、「新規」→「アプリケーション」を選択します。

3. 「新規ギャラリ」ダイアログで、「アイテム」リストから「SOAアプリケーション」を選択して、「OK」をクリックします。SOAのSOAアプリケーションの作成ウィザードが表示されます。

4. アプリケーション名を指定し、「次へ」をクリックします。

5. プロジェクト名を指定し、「次へ」をクリックします。

6. 「BPELプロセスを使用するコンポジット」を選択して、「終了」をクリックします。
SOAコンポジット・エディタに、設計するSOAコンポジット・アプリケーションが表示されます。

SOAコンポジット・アプリケーションにアダプタをサービスまたは参照として追加

Oracle Sales Cloudアダプタは、Oracle JDeveloperで、「公開されたサービス」スイムレーンへのインバウンド(ソース)サービスとして、または「外部参照」スイムレーンへのアウトバウンド(ターゲット)サービスとしてSOAコンポジット・アプリケーションに追加できます。

1. SOAコンポジット・アプリケーションのコンポーネント・パレットに移動します。

2. 「カスタム/サード・パーティ」の「クラウド」セクションに移動します。
アダプタが表示されます。

3. アダプタを適切なスイムレーンにドラッグします。

a. インバウンド(ソース)サービスを作成するには、アダプタを「公開されたサービス」スイムレーンにドラッグして、アダプタを構成するためのウィザード・ページについて説明する次の項を確認します。

- 基本情報プロパティの構成

- Oracle Cloudアダプタの接続とCSFキーのプロパティの構成

- Oracle Sales Cloudソースのリクエスト・プロパティの構成

- Oracle Sales Cloudソースのレスポンス・プロパティの構成

- 「サマリー」ページでの構成値の確認

b. アウトバウンド(ターゲット)参照を作成するには、アダプタを「外部参照」スイムレーンにドラッグして、アダプタを構成するためのウィザード・ページについて説明する次の項を確認します。

- 基本情報プロパティの構成

- Oracle Cloudアダプタの接続とCSFキーのプロパティの構成

- Oracle Sales Cloudターゲットの操作プロパティの構成

- 「サマリー」ページでの構成値の確認

SOAコンポジット・アプリケーションの設計の完了

この項では、SOAコンポジット・アプリケーションの設計の完了方法とアプリケーションのデプロイ方法の概要を示します。

1. SOAコンポジット・アプリケーションの残りの内容を設計します。次に例を示します。

a. アダプタにBPELプロセスを接続します。この例の場合、BPELプロセスは外部参照としてアダプタに接続されます。

b. BPELプロセスの内容を設計します。次に例を示します。

i. BPELプロセスをダブルクリックします。

ii. アダプタを呼び出す呼出しアクティビティを追加して構成します。

iii. アダプタに対するメッセージの送受信のときに、ある変数の内容を別の変数にコピーする割当アクティビティを追加して構成します。

iv. 必要に応じて、他のアクティビティを追加して構成します。
完了したら、SOAコンポジット・エディタにSOAコンポジット・アプリケーションを表示します。

SOAコンポジット・アプリケーションの作成と設計の詳細は、『Oracle Fusion Middleware Oracle SOA SuiteでのSOAアプリケーションの開発』を参照してください。

2. SOAコンポジット・アプリケーションをデプロイします。

a. ナビゲータでプロジェクトを右クリックし、「デプロイ」→「project_name」を選択します。

b. デプロイメント・ウィザードの手順に従って、SOAコンポジット・アプリケーションをアプリケーション・サーバーにデプロイします。

4 Oracle Service Busビジネス・サービスの設計

この項では、Oracle JDeveloperでアダプタを含むOracle Service Busビジネス・サービスを設計する方法について説明します。

内容

- Oracle Service Busビジネス・サービスの作成

- ビジネス・サービスにアダプタをサービスまたは参照として追加

- Oracle Service Busビジネス・サービスの設計の完了

Oracle Service Busビジネス・サービスの作成

この項では、Oracle JDeveloperで、アダプタを含めるOracle Service Busビジネス・サービスを作成する方法の概要を示します。

1. Oracle JDeveloperを起動します。

2. 「ファイル」メニューで、「新規」→「アプリケーション」を選択します。

3. 「新規ギャラリ」ダイアログで、「アイテム」リストから「Service Busアプリケーション」を選択して、「OK」をクリックします。

4. アプリケーション名を指定し、「次へ」をクリックします。

5. プロジェクト名を指定します。

6. 「Service Bus」を選択して、「終了」をクリックします。
Oracle Service Bus概要エディタに、設計するOracle Service Busビジネス・サービスが表示されます。

ビジネス・サービスにアダプタをサービスまたは参照として追加

アダプタは、Oracle JDeveloperで、「プロキシ・サービス」スイムレーンへのインバウンド(ソース)プロキシ・サービスとして、または「外部サービス」スイムレーンへのアウトバウンド(ターゲット)外部サービスとしてOracle Service Busビジネス・サービスに追加できます。

注意:
アダプタの構成中にOSBリソースのインポートダイアログが表示された場合は、「取消」をクリックしてください。WSDLファイルはローカライズできません。

1. Oracle Service Busビジネス・サービスのコンポーネント・パレットに移動します。

2. 「Service Bus」の「クラウド」セクションに移動します。
アダプタが表示されます。

3. アダプタを適切なスイムレーンにドラッグします。

a. インバウンド(ソース)プロキシ・サービスを作成するには、アダプタを「プロキシ・サービス」スイムレーンにドラッグして、アダプタを構成するためのウィザード・ページについて説明する次の項を確認します。

- 基本情報プロパティの構成

- Oracle Cloudアダプタの接続とCSFキーのプロパティの構成

- Oracle Sales Cloudソースのリクエスト・プロパティの構成

- Oracle Sales Cloudソースのレスポンス構成プロパティの構成

- 「サマリー」ページでの構成値の確認

b. アウトバウンド(ターゲット)外部サービスを作成するには、アダプタを「外部サービス」スイムレーンにドラッグして、アダプタを構成するためのウィザード・ページについて説明する次の項を確認します。

- 基本情報プロパティの構成

- Oracle Cloudアダプタの接続とCSFキーのプロパティの構成

- Oracle Sales Cloudターゲットの操作プロパティの構成

- 「サマリー」ページでの構成値の確認

Oracle Service Busビジネス・サービスの設計の完了

この項では、 Oracle Service Busビジネス・サービスの設計の完了方法とアプリケーションのデプロイ方法の概要を示します。

1. Oracle Service Busビジネス・サービスの内容を設計します。たとえば、ビジネス・サ－ビスでOracle Service Busプロキシ・サービスを構成するとします。

a. Oracle Service Bus概要エディタで、「パイプライン/分割結合」レーンを右クリックして、「挿入」→「パイプライン」をクリックします。
「パイプライン・サービスの作成」ダイアログが表示されます。

b. パイプラインの名前を入力してプロジェクトの場所を選択し、「次」をクリックします

c. 「サービス・タイプ」に「WSDL」を選択します。

d. 「WSDL」セクションの右側で、「参照」アイコンをクリックして「WSDL」を選択します。

e. 「アプリケーション」を選択します。

f. 「リソース・チューザ」を展開し、WSDLファイルを選択して、「OK」をクリックします。

g. 「プロキシ・サービスとして公開」が選択されていることを確認します。

h. 「プロキシ・トランスポート」リストから、「HTTP」を選択して、「終了」をクリックします。
Oracle Service Bus概要エディタに、「パイプライン」コンポーネントが表示されます。

i. 「パイプライン」コンポーネントに外部サービスを接続します。

Oracle Service Busビジネス・サービスの作成および設計の詳細は、『Oracle Fusion Middleware Oracle Service Busでのサービスの開発』を参照してください。

2. デフォルト・ルーティングを表すパイプラインを開きます。

3. サービスと対応する操作が、ダイアログ下部のルーティング・プロパティタブに表示されることを確認します。
アウトバウンド・プロジェクトをデプロイする準備ができました。

4. ビジネス・サービスをデプロイします。

a. プロジェクトを選択し、「Service Busサーバーへのデプロイ」を選択します。

b. デプロイメント・ウィザードの手順に従います。

5 Oracle Sales Cloudプロパティの構成

Oracle Sales Cloudアダプタを使用すると、Oracle Sales Cloudアプリケーションとの統合を作成できます。

次の各項では、統合のソースとターゲットとしてOracle Sales Cloudアダプタを構成する手順をガイドするウィザード・ページについて説明します。

内容

- 基本情報プロパティの構成

- Oracle Cloudアダプタの接続とCSFキーのプロパティの構成

- Oracle Sales Cloudソースのリクエスト構成プロパティの構成

- Oracle Sales Cloudソースのレスポンス構成プロパティの構成

- Oracle Sales Cloudターゲットの操作プロパティの構成

- 「サマリー」ページでの構成値の確認

Oracle Sales Cloudの詳細は、「Oracle Sales Cloud」を参照してください。

基本情報プロパティの構成

統合のソース・アダプタおよびターゲット・アダプタそれぞれの「基本情報」ページに名前と説明を入力できます。

内容

- 基本情報ページで実行可能な内容

- 基本情報ページに表示される内容

基本情報ページで実行可能な内容

「基本情報」ページで、次の値を指定できます。「基本情報」ページはウィザードの最初のページです。このページは、アダプタでサポートされているトリガー(ソース)または呼出し(ターゲット)領域にアダプタをドラッグするたびに表示されます。

- わかりやすい名前を指定します。

- 責任の説明を指定します。

基本情報ページに表示される内容

次の表では、基本情報ページの主要情報について説明します。

要素

説明

エンドポイントにどのような名前を付けますか。

この接続の役割を他者が理解できるように、わかりやすい名前を指定します。アルファベット文字、数字、アンダースコアおよびダッシュを名前に使用できます。次の文字は使用できません。

- 空白文字(My Inbound Connectionなど)

- 特殊文字(#;83&またはrigh(t)now4など)

- マルチバイト・キャラクタ

このエンドポイントでは何が行われますか。

接続の責任の説明をオプションで入力します。例: This connection receives an inbound request to synchronize account information with the cloud application.

Oracle Cloudアダプタの接続およびCSFキーのプロパティの構成

統合に関するOracle Cloudアダプタの構成接続と資格証明ストア・フレームワーク(CSF)キーの値を入力します。

内容

- Oracle Cloudアダプタの接続ページで実行可能な内容

- Oracle Cloudアダプタの接続ページに表示される内容

- Oracle CloudアダプタのCSFキーページで実行可能な内容

- Oracle CloudアダプタのCSFキーページで実行可能な内容

Oracle Cloudアダプタの接続ページで実行可能な内容

Oracle Cloudアダプタの次の接続値を指定できます。

- 一部のアダプタのWSDL URLを指定します。Oracle Eloqua Cloudアダプタを構成する場合、WSDLは必要ありません。

- セキュリティ・ポリシーを指定します。

- 認証キーを作成します。一方向に作成されるキー(アウトバウンドなど)は、それ以外の方向(インバウンドなど)にも利用できます。

Oracle Cloudアダプタの接続ページに表示される内容

次の表では、Oracle Cloudアダプタの接続ページの主要情報について説明しています。

要素

説明

WSDL URL

注意: このフィールドは、Oracle Eloqua Cloudアダプタの場合は表示されません。

WSDLを指定します。WSDLは、インスタンスに固有の統合を構築する場合に使用されます。WSDL URLフィールドの横の参照アイコンを選択して、ファイル・システムまたは別のソースからWSDLを選択することもできます。ダイアログ上部の「ファイル・システム」をクリックして、WSDLを参照します。

セキュリティ・ポリシー

環境に適したセキュリティ・ポリシー(USERNAME_PASSWORD_TOKENなど)を選択します。

- ウィザードには、適用できないものを含むすべてのポリシーが表示されます。正しく選択するには、ポリシーの知識が必要です。たとえば、アイデンティティは伝播されないため、SAMLベースのポリシーは選択できません。

- クラウド・アダプタに適用するポリシーは、そのクラウド・アダプタに一意のもので、コンポジットの他のエンドポイントに影響を与えることはありません。

認証キー

CSF認証キーを選択します。

- 追加: クリックして、新規の認証キーを作成します。キー名、ユーザー名およびパスワードを指定する必要があります。

- 編集: クリックして、認証キーを編集します。

- 削除: クリックして、認証キーを削除します。

テスト

クリックして、認証キーを検証します。

Oracle CloudアダプタのCSFキーページで実行可能な内容

Oracle Cloudアダプタの次のCSFキーの値を指定できます。

- CSFキー名

- ユーザー名およびパスワード

- Oracle NetSuite Cloudアダプタのみを構成する場合は、電子メール・アカウントとロールを指定する必要があります。

- Oracle Eloqua Cloudアダプタのみを構成する場合は、企業名を指定する必要があります。

Oracle CloudアダプタのCSFキーページで実行可能な内容

次の表では、Oracle CloudアダプタのCSFキーページの主要情報について説明しています。

要素

説明

CSFキー名

CSFキーを指定して、資格証明のランタイム投入を有効にします。アダプタはCSFを使用して、アプリケーション(Oracle Sales CloudまたはOracle ERPアプリケーションなど)での認証に必要なユーザー名とパスワードを取得します。このキーにより、設計時にログイン資格証明が識別されます。

企業名(Oracle Eloqua Cloudアダプタのみ)

注意: このフィールドは、Oracle Eloqua Cloudアダプタの場合のみ表示されます。

Oracle Eloquaの企業名を指定します。

電子メール、アカウントおよびロール

注意: このフィールドは、Oracle NetSuite Cloudアダプタの場合のみ表示されます。

電子メール・アカウントとロールを指定します。

ユーザー名

アプリケーション(Oracle Sales CloudまたはOracle ERPアプリケーションなど)に接続するためのユーザー名を入力します。ユーザー資格証明は、管理者によって提供されます。

パスワード

アプリケーションに接続するためのパスワードを入力します。

パスワードの再入力

再度、同じパスワードを入力します。

Oracle Sales Cloudソースのリクエスト・プロパティの構成

統合に関するOracle Sales Cloud接続ソースのリクエストの値を入力します。指定する値により、統合が開始されます。

内容

- Oracle Sales Cloudソースのリクエスト・ページで実行可能な内容

- Oracle Sales Cloudソースのリクエスト・ページに表示される内容

Oracle Sales Cloudソースのリクエスト・ページで実行可能な内容

Oracle Sales Cloudアプリケーションのソースの次のリクエスト値を選択できます。

Oracle Sales Cloudからのリクエストとして受信する特定のタイプを選択します。ビジネス・オブジェクトまたはイベント・サブスクリプションのどちらを選択できるかは、Oracle Sales Cloudアダプタの構成中に指定したWSDLファイル(ビジネス・オブジェクトの場合)またはイベント・カタログURL (イベント・サブスクリプションの場合)の内容に基づいて決まります。

- Oracle Sales Cloudからのリクエストとしてビジネス・オブジェクトを受信するように選択します。この選択により、統合が呼び出されます。

- Oracle Sales Cloudアプリケーションによって生成されたイベント・サブスクリプションを、Oracle Sales Cloudからのリクエストとして受信することを選択します。この選択により、統合が呼び出されます。

Oracle Sales Cloudソースのリクエスト・ページに表示される内容

次の表では、Oracle Sales Cloudアダプタ・ソースのリクエスト・ページの主な情報について説明します。

要素

説明

リクエストの構成

統合に適したリクエスト・タイプを選択します。下に表示されるフィールドは、選択するリクエスト・タイプに基づいています。

- ビジネス・オブジェクトを使用: 選択すると、ビジネス・オブジェクトのリストが表示されます。

- ビジネス・イベントを使用: 選択すると、イベント・サブスクリプションのリストが表示されます

ビジネス・オブジェクトの選択

(「ビジネス・オブジェクトを使用」が選択されている場合に表示)

統合を開始するリクエストとして受信するビジネス・オブジェクトをOracle Sales Cloudアプリケーションから選択します。

「サブスクリプションのビジネス・イベント」

(「ビジネス・イベントを使用」が選択されている場合に表示)

サブスクライブするOracle Sales Cloudアプリケーションからイベント・サブスクリプションを選択します。このイベントは、統合を開始するリクエストとして受信されます。

「フィルタ式Business_Event_Name」

(「ビジネス・イベントを使用」が選択されている場合に表示)

イベント条件のフィルタ式を入力します。フィルタ式によって、メッセージの内容(ペイロードまたはヘッダー)を分析してからイベント・サブスクリプションを送信することが指定されます。たとえば、メッセージに顧客IDが含まれる場合のみイベント・サブスクリプションを送信するように指定するフィルタ式を適用できます。式のロジックが満たされると、イベントの統合への送信が認められます。

オブジェクト名でフィルタリングまたはイベント名でフィルタ

名前の1文字目を入力すると、ビジネス・オブジェクトまたはイベント・サブスクリプションの表示がフィルタ処理されます。

Oracle Sales Cloudソースのレスポンス・プロパティの構成

統合に関するOracle Sales Cloudソースのレスポンスの値を入力します。

内容

- Oracle Sales Cloudソースのレスポンス・ページで実行可能な内容

- Oracle Sales Cloudソースのレスポンス・ページに表示される内容

Oracle Sales Cloudトリガーの「レスポンス」ページで実行可能な内容

Oracle Sales Cloudのレスポンス・タイプから成る操作とビジネス・オブジェクトを構成できます。

- 即時(同期)レスポンス: レスポンス・ビジネス・オブジェクトは、すぐに出力として返されます。レスポンス・ページでレスポンス・タイプに「即時」を選択し、クライアントへのレスポンスの一部としてビジネス・オブジェクトを選択します。

- レスポンスは不要: レスポンスが必要ないため、「レスポンス」ページの「なし」を選択します。

Oracle Sales Cloudトリガーの「レスポンス」ページに表示される内容

Oracle Sales Cloudアプリケーションにレスポンス・ドキュメントとして送信する、統合のビジネス・オブジェクトを選択します。

次のタイプのレスポンスを使用できます。

- 即時: 同期レスポンスが必要(手順は表5-1を参照)

- なし: レスポンスは不要(手順は表5-2を参照)

次の表は、即時(同時)レスポンスが必要な場合に利用可能なフィールドについて説明しています。

表5-1 レスポンス・タイプ - 即時(同期)レスポンスが必要

要素

説明

レスポンス・タイプ

レスポンスを統合から受信するまで待機するには、Oracle Sales Cloudアプリケーションの「即時」を選択します。これは、リクエストおよびレスポンス・メッセージ交換パターンとも呼ばれます。これはデフォルト選択です。

オブジェクト名でフィルタリング

1文字目を入力して、ビジネス・オブジェクトの表示をフィルタ処理します。

ビジネス・オブジェクトの選択

レスポンスとして、Oracle Sales Cloudアプリケーションから受信するビジネス・オブジェクトを選択します。「オブジェクト名でフィルタリング」フィールドにビジネス・オブジェクトの最初の文字を入力すると、ビジネス・オブジェクトの表示をフィルタ処理できます。選択したビジネス・オブジェクトの説明が、このリストの下に表示されます。

次の表は、レスポンスが不要な場合に利用可能なフィールドについて説明しています。

表5-2 なし - レスポンスは不要

要素

説明

レスポンス・タイプ

「なし」を選択します。

ビジネス・オブジェクトの選択

「なし」を選択すると、このセクションは非表示になります。

Oracle Sales Cloudターゲットの操作プロパティの構成

統合に関するOracle Sales Cloudターゲットの操作の値を入力します。

内容

- Oracle Sales Cloudターゲットの操作ページで実行可能な内容

- Oracle Sales Cloudターゲットの操作ページに表示される内容

Oracle Sales Cloudターゲットの操作ページで実行可能な内容

Oracle Sales Cloudターゲットの次の操作値を構成できます。

- ビジネス・オブジェクトまたはサービスを参照および選択します。

- ビジネス・オブジェクトまたはサービスに対して実行する操作を選択します。

Oracle Sales Cloudターゲットの操作ページに表示される内容

次の表では、Oracle Sales Cloudターゲットの操作ページの主要情報について説明しています。

要素

説明

参照

選択して、ビジネス・オブジェクトまたはサービスごとに参照します。ビジネス・オブジェクトとサービスの間には、1対1の対応関係があります。サービスはビジネス・オブジェクトとして機能します。

- ビジネス・オブジェクト: 選択して、利用可能なビジネス・オブジェクトの一覧を参照します。

- サービス: 選択して、利用可能なビジネス・サービスの一覧を参照します。

オブジェクト・フィルタ名

1文字目を入力して、ビジネス・オブジェクトの表示をフィルタ処理します。

ビジネス・オブジェクト

使用するビジネス・オブジェクトまたはサービスを選択します。

ビジネス・オブジェクトまたはサービスに対して実行する操作を選択します。

選択したビジネス・オブジェクトまたはサービスに対して実行する操作を選択します。

ライフ・サイクル

選択したビジネス・オブジェクトまたはサービスの状態を表示します。非推奨は、ビジネス・ドキュメントの使用の終わりが近付いており、注意して使用する必要があることを表します。

説明

選択したビジネス・オブジェクトまたはサービスの説明を表示します。

サマリーページでの構成値の確認

指定したアダプタの構成値を「サマリー」ページで確認できます。

内容

- サマリーページで実行可能な内容

- サマリーページに表示される内容

サマリーページで実行可能な内容

ソースまたはターゲットの構成の詳細をサマリーページで確認できます。「サマリー」ページは、構成を完了した後の、各アダプタの最後のウィザード・ページです。

- ソースまたはターゲット・アダプタに定義した構成の詳細が表示されます。たとえば、リクエスト・ビジネス・オブジェクトと即時レスポンス・ビジネス・オブジェクトを含むインバウンド・ソース・アダプタを定義した場合、この構成の具体的な詳細が「サマリー」ページに表示されます。

- 構成の詳細を保存する場合は、「完了」をクリックします。

- 左パネルの特定のタブをクリックするか、「戻る」をクリックして特定のページにアクセスして、構成の定義を更新します。

- 構成の詳細を取り消すには、「取消」をクリックします。

サマリーページに表示される内容

次の表では、サマリーページの主要情報について説明しています。

要素

説明

サマリー

ウィザードの前のページで定義したソースまたはターゲットの構成値のサマリーを表示します。

生成されたXSDファイルが提供されるアダプタの場合は、XSDリンクをクリックすると、ファイルの読取り専用バージョンが表示されます。

前のページに戻って値を更新するには、左パネルの適切なタブをクリックするか、「戻る」をクリックします。

6 アプリケーションの管理

この章では、Oracle Enterprise Manager Fusion Middleware ControlまたはOracle Service Bus Consoleから、アダプタを使用するOracle SOA SuiteまたはOracle Service Busアプリケーションを管理および監視する方法について説明します。

内容

- Oracle Enterprise Manager Fusion Middleware Controlでのアプリケーションの管理

- Oracle Service Bus ConsoleからのOracle Service Busプロジェクトのテスト

Oracle Enterprise Manager Fusion Middleware Controlでのアプリケーションの管理

Oracle Enterprise Manager Fusion Middleware Controlで、アダプタを含むSOAコンポジット・アプリケーションまたはOracle Service Busビジネス・サービスを管理します。

1. Oracle Enterprise Manager Fusion Middleware Controlにログインします。

2. ナビゲータで、ツリーを展開してSOAコンポジット・アプリケーションまたはOracle Service Busビジネス・サービス・プロジェクト(この例の場合はSOAコンポジット・アプリケーションを選択)を表示します。

3. SOAコンポジット・アプリケーションを選択します。

4. 「テスト」をクリックします。
「Webサービスのテスト」ページが表示されます。

5. ページのフィールドに入力して、コンポジットのテストを開始します。

6. 「Webサービスのテスト」をクリックします。
呼出し結果が表示されます。

7. 「フロー・トレースの起動」をクリックして、アダプタのフロー詳細を含む、SOAコンポジット・アプリケーションのフロー・トレースを表示します。
Oracle Enterprise Manager Fusion Middleware Controlからのアプリケーションの監視の詳細は、『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suiteの管理』と『Oracle Fusion Middleware Oracle Service Busの管理』を参照してください。

Oracle Service Bus ConsoleからのOracle Service Busビジネス・サービスのテスト

Oracle Service Bus ConsoleからOracle Service Busビジネス・サービス・プロジェクトをテストできます。

1. Oracle Service Bus Consoleにログインします。

2. ナビゲータの「すべてのプロジェクト」で、テストするプロジェクトを開きます。

3. ナビゲータで、該当プロジェクトのビジネス・サービスをクリックします。

4. 「テスト・コンソールの起動」(緑色の矢印ボタン)をクリックして、アウトバウンド・エンドポイントをテストします。
テストするプロキシ・サービスと操作を表示するウィンドウが開きます。

5. 入力を指定して「実行」をクリックします。
Oracle Cloudアプリケーションにペイロードが送信されます。「レスポンス・ドキュメント」セクションにレスポンスが表示されます。

Oracle Service Busビジネス・サービス・プロジェクトのテストの詳細は、『Oracle Fusion Middleware Oracle Service Busの管理』を参照してください。

7 トラブルシューティングおよびエラー処理

この項では、Oracle Sales Cloudアダプタに関するエラーをトラブルシューティングし、処理する方法について説明します。

トピック

- CSFキーを使用したイベントURLへの接続時のOracle JDeveloperでのSSL例外の回避

- CSFキーを使用したOracle Sales Cloudインバウンド・イベントURLへの接続の失敗

- イベントベースのコンポジットをサーバーにデプロイする前に資格証明の詳細をJCAファイルに追加する方法

CSFキーを使用したイベントURLへの接続時のOracle JDeveloperでのSSL例外の回避

Oracle JDeveloperでイベントベースのOracle Sales Cloud接続を作成しているときにCSFキーを定義する場合は、「テスト」ボタンをクリックするとSSL例外エラーを受け取ることができます。この問題を回避するには、次の手順を実行します。

1. $JDEV_HOME/bin/jdev.confファイルを開きます。

2. 次を追加します。

AddVMOption -Dsun.security.ssl.allowUnsafeRenegotiation=true
AddVMOption -Dhttps.protocols=TLSv1,SSLv3

3. Oracle JDeveloperを再起動します。

CSFキーを使用したOracle Sales Cloudインバウンド・イベントURLへの接続の失敗

Oracle JDeveloperで、インバウンドのイベントベースのOracle Sales Cloud接続を作成しているときにCSFキーを定義する場合は、「テスト」ボタンをクリックすると、次に示すSSL例外エラーを受け取ることができます。

Unable to establish a secure connection to
https://hostname.us.oracle.com:10614/fndAppCoreServices/ServiceCatalogService?wsdl. SSL protocol related exception occurred.
Mar 14, 2016 9:54:51 PM oracle.cloud.adapter.api.util.DefaultLoggerService
logSevere
SEVERE: oracle.j2ee.ws.wsdl.LocalizedWSDLException: WSDLException:
faultCode=PARSER_ERROR: Failed to read wsdl file at:
"https://hostname.us.oracle.com:10614/fndAppCoreServices/ServiceCatalogService?wsdl", caused by: javax.net.ssl.SSLException.:
javax.net.ssl.SSLException:
Received fatal alert: close_notify
at oracle.j2ee.ws.wsdl.xml.WSDLReaderImpl.readWSDL(WSDLReaderImpl.java:411)
at oracle.j2ee.ws.wsdl.xml.WSDLReaderImpl.readWSDL(WSDLReaderImpl.java:728)
at oracle.j2ee.ws.wsdl.xml.WSDLReaderImpl.readWSDL(WSDLReaderImpl.java:706)
at
oracle.tip.tools.ide.adapters.cloud.impl.service.DefaultWSDLHelperService.getD
efinitionFromURL(DefaultWSDLHelperService.java:58)
at
oracle.tip.tools.ide.adapters.cloud.impl.service.DefaultWSDLHelperService.getE
ndpointAddressFromWSDL(DefaultWSDLHelperService.java:70)
at
. . .
. . .
. . .

この問題を回避するには、次の手順を実行します。

1. $JDEV_HOME/bin/jdev.confファイルを開きます。

2. 次を追加します。

AddVMOption -Djdk.tls.client.protocols=TLSv1

3. Oracle JDeveloperを再起動します。

4. setDomainEnv.shランタイム・ファイルを開きます。

5. 次のプロパティを更新します。

-Djdk.tls.client.protocols=TLSv1

イベントベースのコンポジットをサーバーにデプロイする前に資格証明の詳細をJCAファイルに追加する方法

Oracle Sales Cloudアダプタのイベントベース・サービスの設計中に、資格情報の詳細をJCAファイルに移入する必要があります。資格情報の詳細をJCAファイルに移入しないと、デプロイ中にイベントベースのコンポジットが失敗します。

<Nov 30, 2015 5:53:43 PM IST> <Error> <oracle.soa.adapter> <BEA-000000>
<JCABinding=>  OSCEvent Error while performing endpoint Activation:
javax.resource.ResourceException:
oracle.cloud.connector.api.CloudInvocationException:
oracle.cloud.connector.api.CloudInvocationException:
oracle.cloud.connector.api.CloudInvocationException: Error: 401 : Cannot get
the subscription for the id
. . .
. . .

この問題を回避するには、次の手順を実行します。

1. 次に示す詳細を使用して、公開されたサービス側のJCAファイルを更新します。

<property name="csfkey" value="csfkey"/>
<property name="csfMap" value="oracle.wsm.security"/>

オラクルの法律上の注意点について

コピーライトについて

Copyright © 1994-2017, Oracle and/or its affiliates. All rights reserved.

ライセンス制約の保証と結果的に生じる損害の免責

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

保証免責

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクルまでご連絡ください。

制限付権利について

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

危険な用途への使用について

このソフトウェアまたはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアまたはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、Oracle Corporationおよびその関連会社は一切の責任を負いかねます。

商標と登録商標について

OracleおよびJavaはオラクルおよびその関連会社の登録商標です。その他の社名、商品名等は各社の商標または登録商標である場合があります。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

第三者のコンテンツ、製品、サービスに対する免責事項

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。適用されるお客様とOracle Corporationとの間の契約に別段の定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。適用されるお客様とOracle Corporationとの間の契約に定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

アルファ版およびベータ版ドラフト・ドキュメントについて

このドキュメントが試作版の場合:

このドキュメントは試作版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。Oracle Corporationおよびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

非公開のアルファ版およびベータ版ドラフト・ドキュメントについて

このドキュメントが非公開の試作版の場合:

このドキュメントに含まれる情報は、情報の共有のみを目的としたものであって、顧客諮問委員会(Customer Advisory Board)のメンバーとしてのお客様の立場でのみ、またはお客様のベータ・トライアル契約のみに従って検討されるべきものとします。マテリアル、コード、または機能の提供をお約束するものではなく、購入決定を行う際の判断材料とすべきではありません。このドキュメントに記載されている特徴または機能の開発、リリースおよび時期については、オラクルの裁量により決定されます。

このドキュメントには、ソフトウェアまたは印刷物などの形式を問わず、オラクルが独占的な権利を有する財産的情報が含まれています。この機密資料へのアクセスと使用は、お客様とオラクルとの間で締結され、お客様が遵守に同意した、Oracle Master Agreement、Oracle License and Oracle Services Agreement (オラクル・ライセンスおよびサービスに関する契約書)、Oracle PartnerNetwork Agreement、Oracle Distribution Agreementまたはその他のライセンス契約の条件に従うものとします。このドキュメントとその内容の開示、コピー、複製および配布には、オラクルによる事前の承諾を必要とします。このドキュメントはライセンス契約の一部となるものではなく、オラクルおよびその子会社や関連会社との契約を構成するものではありません。

ドキュメントのアクセシビリティについて

オラクルのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc を参照してください。

Oracle Supportへのアクセス

サポートをご契約のお客様には、My Oracle Supportを通して電子支援サービスを提供しています。詳細情報はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=infoか、聴覚に障害のあるお客様はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trsを参照してください。