Oracle® Fusion Middleware

Oracle RightNow Cloud Adapterの使用方法

12.2.1.2.0

E82714-02(原本部品番号:E77869-02)

2017年2月

Oracle® Fusion Middleware Oracle RightNowアダプタの使用方法について記述した、Oracle SOA (サービス指向アーキテクチャ)開発者向けのドキュメント。

Oracle Fusion Middleware Oracle RightNow Cloudアダプタの使用、12.2.1.2.0

E82714-02

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

原本著者:  Oracle Corporation

協力者: Ravindran Sankaran、Bo Stern、Srimant Misra、Sunil Gopal、Narayana Pedapudi、Anuj Kaushal、Srikanth Somayajula、Venkata Purna Vamsi Krishna Jandhyala、Rajesh Venkataraman、Divya Vijayalakshmi

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

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

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

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 RightNowアダプタの概要

- はじめに

- 概要

- Oracle RightNowアダプタを使用するための前提条件

- Oracle RightNowアダプタの設計の概要

- サポートされているバージョンとプラットフォーム

- Oracle RightNowアダプタによってサポートされるWSDL

2 RightNowアダプタのスタート・ガイド

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

- Oracle RightNowアダプタの接続パラメータの使用

- 標準WSDLの取得

- クライアント/サーバーへのOracle RightNowアプリケーションの証明書のインポート

- keytoolを使用したWebLogic ServerへのOracle RightNowアプリケーションの公開証明書のインポート

- Oracle RightNowアダプタのパーミッションの構成

- オブジェクト固有のパーミッションの詳細

- アカウント・パスワードによるOracle RightNow Cxサーバーでの認証

- Oracle Cloud Connect Web Services for SOAP APIのアクセス制御

- 設計時および実行時のOracle RightNowアダプタの理解

- サポートされない機能

3 Oracle RightNowアダプタ構成ウィザードのウォークスルー

- JDeveloperでの一般的な構成手順の実行

- JDeveloperでのSOAアプリケーション・プロジェクトの作成

- インバウンド・サービスのOracle RightNowアダプタの構成

- アウトバウンド・サービスのOracle RightNowアダプタの構成

- 操作の作成、読取り、更新および削除の理解

- サポートされる機能

- CRUD操作の使用

- 1つ以上のビジネス・オブジェクトの作成

- 1つ以上のオブジェクトからのデータの取得

- 1つ以上のビジネス・オブジェクトの更新

- 1つ以上のビジネス・オブジェクトの削除

- バッチ機能の使用

- Oracle RightNowアダプタのユーザー・インタフェースによるバッチ機能のサポート

- バッチ・プロセスWSDL

- チェーン

- チェーンの使用

- サポートされる処理オプション

- CreateProcessingOptions

- DestroyProcessingOptions

- GetProcessingOptions

- UpdateProcessingOptions

- ROQLの使用

- ROQLの使用

- ROQL問合せ文

- ROQL問合せ文

- ROQL問合せ文の実行

- ROQLクエリー・ビルダーの使用

- 標準およびカスタム・ビジネス・オブジェクトの検出の簡略化

- コンテキストに基づく問合せ構成要素の提案

- オートコンプリートの提供

- 可読性を向上するための別名のサポート

- ROQLを使用したリレーションシップの提案

- クエリー・ビルダーを使用したインラインおよびセマンティック検証の取得

- ROQLのアダプタ・サポート

- 問合せ引数

- バインド・パラメータのサポート

4 RightNowアダプタの高度な概念の理解

- SOAP APIの理解

- オブジェクトの理解

- トランザクションの理解

- Oracle RightNow Cxスキーマの多相動作の処理

- 例: カスタム・オブジェクトのマッピング

- 例: Oracle RightNowアダプタを使用しないオブジェクトのマッピング

- 例: Oracle RightNowアダプタを使用したオブジェクトのマッピング

- クラウドでのカスタム・オブジェクトとの統合

- RightNow Cxサーバーでのカスタム・オブジェクトの作成

- カスタム・オブジェクトの選択による操作の実行

- Oracle RightNowアダプタのセキュリティ管理の理解

- アカウント・パスワードによるOracle RightNow Cxサーバーでの認証

- Oracle RightNow CXサーバーでのアクセス制御の理解

- Oracle Cloud Connect Web Services for SOAPのサイト構成

- RightNow Cxでのアクセス制限パーミッションの構成

- アカウント資格証明の検証

- プロファイル構成

- パスワード・ベースの認証

- Oracle RightNowアダプタのテスト機能

- 設計時のテスト機能の詳細

- Oracle RightNowアダプタの制限および制約の処理

- 削除カスケードの削除効果

- RightNow Cxサーバーにより強制されるAPI制限

5 サービス・コンポーネントとのBPEL統合の理解(BPEL/メディエータ)

- 概要

- アカウント・オブジェクトの理解

- サービス統合のためのコンポジットの設計

- BPELおよびメディエータのコンポジットの定義

- Oracle RightNowアダプタの構成

- BPELとの統合

- コンポジットのデプロイ

- コンポジットのテスト

- アウトバウンド・プロセスのテスト

6 Oracle RightNowアダプタとのOracle Service Bus統合の開発

- Oracle Cloudアダプタ・アーティファクトの生成

- Oracle Service Bus Consoleを使用したOracle Service Busプロジェクトの作成

- Service Busプロジェクトの作成とOracle Service Bus JCAビジネス・サービスの生成

- Oracle Service Busの空のコンソールの作成と新しいService Busプロジェクトの作成

- Oracle RightNowアダプタによるService Busビジネス・サービスの定義

- Oracle RightNowアダプタ・コンポーネントの構成

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

7 RightNowアダプタでのトラブルシューティングとエラー処理

- Oracle RightNowアダプタの設計時のJDeveloperエラーの理解

- APIフォルトとエラー処理の理解

- リクエスト・エラーについて

- サーバー・エラーについて

- 予期しないエラーについて

- RightNow例外コードの理解

- アダプタのフォルト処理の理解

8 Oracle RightNowアダプタの使用例

- 単一のビジネス・オブジェクトに対する作成、読取り、更新および破棄(CRUD)操作の実行

- 複数のビジネス・オブジェクトに対するCRUD操作の実行

- 複数のビジネス・オブジェクトと複数の操作によるバッチ操作の実行

- ROQLを使用した任意のオブジェクトの問合せ

- カスタム・オブジェクトに対するCRUD操作の実行

- 1つのバッチ・リクエストによる複数の操作のチェーン

9 Oracle RightNow Cloudプロパティの構成

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

- 「基本情報」ページでできること

- 「基本情報」ページの表示内容

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

- Oracle HCM Cloudアダプタの「接続」ページで実行可能な操作

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

- Oracle HCM Cloudアダプタの「CSFキー」ページで実行可能な操作

- Oracle HCM Cloudアダプタの「CSFキー」ページに表示される内容

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

- Oracle RightNow Cloudソースの「リクエスト」ページでできること

- Oracle RightNow Cloudソースの「リクエスト」ページの表示内容

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

- Oracle RightNow Cloudソースの「レスポンス」ページでできること

- Oracle RightNow Cloudソースの「レスポンス」ページの表示内容

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

- Oracle RightNow Cloudターゲットの「操作」ページでできること

- Oracle RightNow Cloudターゲットの「操作」ページの表示内容

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

- 「サマリー」ページでできること

- 「サマリー」ページの表示内容

A RightNow資格証明を管理するための資格証明ストアの構成

はじめに

- 対象読者

- 関連ドキュメント

- 表記規則

対象読者

『Oracle Cloud Adapter for Oracle RightNow Cloud Serviceユーザーズ・ガイド』は、Oracle RightNowアダプタを使用するすべてのユーザーを対象としています。

関連ドキュメント

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

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

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

- Oracle Service Busの管理

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

表記規則

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

表記規則

意味

太字

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

イタリック

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

固定幅フォント

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

1 RightNowアダプタの概要

この章では、Oracle Cloud Adapter for Oracle RightNow Cloud Service (Oracle RightNowアダプタ)の概要について説明します。

この章の内容は次のとおりです。

- はじめに

- 概要

- サポートされているバージョンとプラットフォーム

はじめに

Oracle RightNowアダプタは、Oracle Cloudの統合されたクロスチャネル・サービス・ソリューションのためにWeb、ソーシャル・ツールおよびコンタクト・センター・エクスペリエンスを結合し、組織による売上げの向上、顧客の獲得、信頼の構築、リレーションシップの強化、コストと作業の削減を可能にします。RightNow Cloud Serviceエンタープライズ・プラットフォームによって、透過的な信頼性、最高レベルのセキュリティ、およびミッション・クリティカルな顧客サービスとサポートの最適な提供が実現します。これは、Oracle RightNow製品ファミリのキー・コンポーネントです。

現在、全世界の異なる業種にわたる何千ものエンタープライズの顧客が、Oracle RightNow Cxを使用して、Web、コンタクト・センター、ソーシャルなどの複数のチャネルを通じて優れたカスタマ・エクスペリエンスを提供しています。

これらのチャネルによって、顧客は、どこからでもWebを通じて問題を簡単に自己解決し、Facebookなどのソーシャル・チャネルを通じて製品に関するサポート問題をコラボレーションし、(最も重要なこととして)チャネルのすべてを通じてインシデントの適切なタイミングでの解決策を管理できます。

エンタープライズでは、SaaSアセットのROIを最大化するため、その個々のSaaSサプリケーションおよび社内アプリケーションのデータが正確かつ最新で、統合されていることを確認する必要があります。

たとえば、エンタープライズでは、業務を効率化し、Field Serviceと社内アプリケーションまたはSaaSアプリケーション(E-Business SuiteやTOA ETADirectなど)との統合、および他のSaaSアプリケーションとの統合を通じて現場の技術者にサービスのリアルタイム・スケジュールを配信することで、Oracle Sales CloudやSalesforce.comによってエンタープライズの販売担当者が自分の顧客や見込顧客と会話するときに、カスタマ・エクスペリエンスを完全に視覚化することができます。同様に、JiraやBugzillaなどの不具合追跡アプリケーションとの統合によって、顧客がレポートした問題のエンドツーエンドの解決策を最初から最後まで管理できます。

Oracle RightNow Cxによって、デスクトップ拡張性、データ統合およびWeb統合のための様々な統合機能が公開されます。Oracle RightNow Cxのデータ統合機能によって、データのリアルタイム・アクセスと、他のSaaSアプリケーションおよび社内アプリケーションとの同期が可能になります。Oracle RightNow Cxは、Oracle Cloud Connect Web Services for SOAPと呼ばれるWebサービス・プラットフォーム(Oracle RightNow Cxプラットフォームに格納されたデータに安全にアクセスして変更するために使用できるSOAPベースの一連のサービス)を公開しています。これは、顧客とパートナがWSDL 1.1やSOAP 1.1などの業界標準を使用してOracle RightNow Cxプラットフォームと統合できるようにする、下位互換性のある公開APIです。これによって、様々な言語、プラットフォームおよびツールが広くサポートされます。

Oracle RightNowアダプタでは、このWebサービス・プラットフォームを利用し、Oracle RightNow Cxとのシームレスな接続と簡易な統合を実現します。Oracle RightNowアダプタとSOA Suiteプラットフォームを使用することで、顧客は、他のアプリケーションとのポイント・ツー・ポイント統合をカスタム開発する場合の開発、QA、メンテナンスおよびアップグレードに要するコストを抑えることができます。

Oracle RightNowアダプタでは、Oracle RightNowアプリケーションのカスタム属性のサポートを利用するために、ビジネス・オブジェクトのカスタム属性(新しいRightNowコンセプトのカスタム属性とカスタム・フィールドおよびデフォルトcパッケージ)をサポートします。次の詳細に注意してください。

- カスタム属性とカスタム・フィールドは、マッパーに階層構造で表示されます。たとえば、統合を作成し、アダプタ構成ウィザードの「リクエスト」ページでContactビジネス・オブジェクトを選択するとします。マッパーに移動してContact要素を展開すると、ContactCustomFieldsという要素が表示されます。この要素を展開すると、カスタム属性が階層構造でツリーに表示されます。カスタム属性は、マッパーのカスタム・パッケージの一部としても表示されます。

- 現在カスタム属性がサポートされているビジネス・オブジェクトを含む、以前のリリースのOracle Integration Cloud Serviceから統合を事前に作成していた場合、それらの属性は、統合のアーティファクトを再生成した後、マッパーに表示されます。ただし、それらの属性は階層構造で表示されず、以前のリリースのフラット構造で(パッケージの下でなく)表示されます。

- カスタム属性は、ダウンロードできる生成されたアーティファクトにも表示できます。

Oracle RightNowアダプタでは、QueryCSVを使用したデータの問合せをサポートするRightNow Object Query Language (ROQL)をサポートします。これにより、表形式でデータを取得できます。

概要

Oracle RightNowアダプタは、Connect Web Services API for SOAPを基盤とし、Oracle RightNow Cxプラットフォームとのリアルタイム統合を提供します。RightNow APIバージョン1.3はサポートされます。Oracle RightNow Connect Web Servicesプラットフォームは、コール側アプリケーションに2つのWebサービス定義(WSDL)を公開します。

- 標準WSDL。このWSDLは、Oracle RightNowインスタンスに固有の統合をモデル化するために、統合設計者が使用します。型指定されたWSDLは、Connect Common Object Modelの厳密に型指定された表現です。厳密に型指定されたWSDLには、標準のHTTP GETリクエストを使用して次のURLからアクセスできます。標準WSDLには、ビジネス・オブジェクトとイベント・サブスクリプションの両方に対するサポートを含めることができます。これにより、ビジネス・オブジェクトかイベント・サブスクリプションのいずれかを、リクエストとしてOracle RightNowアプリケーションから受信できます。イベント・サブスクリプションは、Oracle RightNowアプリケーションのバージョンがバージョン15.5 (2015年5月リリース)か、それ以降の場合にのみサポートされます。そうでない場合は、ビジネス・オブジェクトのみが、選択肢として構成ウィザードに表示されます。

<a target="_blank" href="http://">http://</a><host_name>/cgi-bin/<interface>.cfg/services/soap?wsdl=typed

標準WSDLは、組織の特定のOracle RightNow Cxインスタンスに関連付けられるため、インスタンス構成の変更またはカスタマイズが発生すると変更されます。

- パートナWSDL。このWSDLは、Oracle RightNow Cxの複数のインスタンスで動作する統合を構築する統合設計者が使用します。これによって、Oracle RightNowの複数のインスタンスで使用できる汎用オブジェクトと連携動作できます。汎用WSDLには、標準のHTTP GETリクエストを使用して次のURLからアクセスできます。

<a target="_blank" href="http://">http://</a><host_name>/cgi-bin/<interface>.cfg/services/soap?wsdl=generic

このWSDLは、静的で、組織ごとに変更されないため、組織固有のRightNow Cxインスタンスに対するカスタマイズや変更は発生しません。これは、主にパートナが使用するため、パートナWSDLという名前で呼ばれます。

Oracle RightNowアダプタによって、顧客は、標準WSDLを通じて特定のOracle RightNow Cxインスタンスとの統合を実行できます(ただし、パートナWSDLベースの統合は現在サポートされていません)。

標準WSDLは、次のようなカテゴリの操作を公開します。

- 基本CRUD操作(RightNowでのビジネス・オブジェクトの作成、取得、更新、破棄)

- ROQL (オブジェクトとしてのRightNowのデータの問合せのみ)

- バッチ操作(1つの操作における1つ以上の他の操作のバッチ)

前述の操作(特にCRUD操作)は、本質的に多相です。この場合、アプリケーションでサポートされるすべてのビジネス・オブジェクト全体で4つの汎用CRUD操作(作成、取得、更新および破棄)のみを必ず公開することで、統合インタフェースが簡略化されるように見えますが、同時に統合プロセス中(特にデータ・マッピング中)における課題も発生します。詳細は、「サービス・コンポーネントとのBPEL統合の理解(BPEL/メディエータ)」および「Oracle RightNowアダプタとのOracle Service Bus統合の開発」を参照してください。

例1-1に、汎用CRUD操作を含むRightNow標準WSDLを示します。

例1-1 RightNow標準WSDLでの汎用CRUD操作

<wsdl:operation name="Create">
<wsdl:input message="rnw_v1_2:CreateRequest"/>
<wsdl:output message="rnw_v1_2:CreateResponse"/>
<wsdl:fault message="rnw_v1_2:RequestErrorFault" name="RequestErrorFault"/>
<wsdl:fault message="rnw_v1_2:ServerErrorFault" name="ServerErrorFault"/>
<wsdl:fault message="rnw_v1_2:
UnexpectedErrorFault"name="UnexpectedErrorFault"/>
</wsdl:operation>
<wsdl:operation name="Get">
<wsdl:input message="rnw_v1_2:GetRequest"/>
<wsdl:output message="rnw_v1_2:GetResponse"/>
<wsdl:fault message="rnw_v1_2:RequestErrorFault" name="RequestErrorFault"/>
<wsdl:fault message="rnw_v1_2:ServerErrorFault" name="ServerErrorFault"/>
<wsdl:fault message="rnw_v1_2:
UnexpectedErrorFault"   name="UnexpectedErrorFault"/>
</wsdl:operation>
<wsdl:operation name="Get">
<wsdl:input message="rnw_v1_2:GetRequest"/>
<wsdl:output message="rnw_v1_2:GetResponse"/>
<wsdl:fault message="rnw_v1_2:RequestErrorFault"
name="RequestErrorFault"/>
<wsdl:fault message="rnw_v1_2:ServerErrorFault"
name="ServerErrorFault"/>
<wsdl:fault message="rnw_v1_2:
UnexpectedErrorFault" name="UnexpectedErrorFault"/>
</wsdl:operation>
<wsdl:operation name="Update">
<wsdl:input message="rnw_v1_2:UpdateRequest"/>
<wsdl:output
message="rnw_v1_2:UpdateResponse"/>
<wsdl:fault message="rnw_v1_2:RequestErrorFault" name="RequestErrorFault"/>
<wsdl:fault message="rnw_v1_2:ServerErrorFault" name="ServerErrorFault"/>
<wsdl:fault message="rnw_v1_2:UnexpectedErrorFault" name="UnexpectedErrorFault"/>
</wsdl:operation>
<wsdl:operation name="Destroy">
<wsdl:input message="rnw_v1_2:DestroyRequest"/>
<wsdl:output message="rnw_v1_2:DestroyResponse"/>
<wsdl:fault message="rnw_v1_2:RequestErrorFault" name="RequestErrorFault"/>
<wsdl:fault message="rnw_v1_2:ServerErrorFault" name="ServerErrorFault"/>
<wsdl:fault message="rnw_v1_2:
UnexpectedErrorFault" name="UnexpectedErrorFault"/>
</wsdl:operation>

RightNow Object Query Language (ROQL (ロックウェルと発音))は、APIのクライアントがOracle RightNow Cxプラットフォームに対してSQLに似た問合せを実行できるようにする問合せサブシステムです。この言語は、Object Data Management Group (ODMG)によって開発された、SQLの後にモデル化されたオブジェクト指向データベース向けの問合せ言語標準であるObject Query Language (OQL)から発展しました。

ROQLでは、オブジェクトの問合せのみがサポートされます。QueryObjectでは、コール側アプリケーションはオブジェクトのリストとしてデータを取得できます。

例1-2 特定のIDでインシデントの詳細を取得するROQL問合せの例

select Incident from Incident I where I.ID=102345

Oracle RightNowアダプタは、統合モデラーからインタフェースの複雑性を隠蔽する簡易なグラフィカル形式のオブジェクト操作ビューで、標準WSDLで定義された機能を公開します。多相インタフェース定義とは対照的に、Oracle RightNowアダプタは、設計時構成から、厳密に型指定されたサービス操作を生成します。これによって、データ・マッピング作業が大幅に簡略化されます。

Oracle RightNowアダプタを使用するための前提条件

次に、SOA SuiteまたはOracle Service BusのいずれかとOracle RightNowアダプタを使用して統合のモデル化を開始するための前提条件を示します。

これらの前提条件に加え、適切にサポートされたバージョンのSOA SuiteおよびOracle Service Busが存在することを確認する必要があります。サポートされるバージョンおよびプラットフォームの詳細は、http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.htmlのリリース動作保証マトリックスを参照してください。

- 標準WSDLを取得します。標準WSDLの詳細は、Oracle RightNow Connect Web Services for SOAP開発者ガイドのWSDLの取得に関する項を参照してください。

- 有効なRightNow Cx資格証明があることを確認します。詳細は、Oracle RightNow Connect Web Services for SOAP開発者ガイドのOracle Cloud Adapter for Service Cloud接続パラメータに関する項を参照してください。

- クライアント証明書を取得します。詳細は、Oracle RightNow Connect Web Services for SOAP開発者ガイドのクライアント/サーバーに対するService Cloud証明書に関する項を参照してください。

Oracle RightNowアダプタの設計の概要

Oracle RightNowアダプタは、複数のアダプタ・インスタンスを持つことができます。アダプタ・インスタンスは、基本的に、構成されたOracle RightNowアダプタで、これはRightNow CXサーバーに接続し、構成中に選択したRightNow Cxクラウド操作を起動できます。

各アダプタ・インスタンスには、統合WSDLやJCAファイルなどの独自のアーティファクトがあります。

各アダプタ・インスタンスは単一のRightNow Cxクラウド操作を参照するため、アダプタ・インスタンスからRightNow Cxクラウド操作に対する1対1対応があります。サポートされる操作のリストは、「操作の作成、読取り、更新および削除の理解」を参照してください。

アダプタ・インスタンスは、SOAコンポジットの一部です。アダプタ・ウィザードが実行されるたびに、Oracle RightNowアダプタの1つのインスタンスが作成されます。

Oracle RightNowアダプタ・インスタンスは、JCAファイル、WSDL、およびcomposite.xmlに追加された参照要素で構成されます。

Oracle RightNowアダプタでは、Oracle SOA Suiteからアウトバウンド同期コールを作成するRightNowがサポートされます。

Oracle RightNowアダプタのランタイム・フレームワークでは、前述の手順で生成されたアーティファクトが使用されます。

表1-1は、アダプタ構成ウィザードによって生成されるSOAコンポジット・アダプタ・アーティファクトとその注意事項を示しています。

表1-1 Oracle RightNowアダプタ・アーティファクト

アーティファクト

備考

rightnowReference.wsdl

Oracle RightNowアダプタでは、標準WSDLのみがサポートされます。

<serviceName>_rightnow.jca

JCAファイルには、実行時にアダプタが使用する内部実装の詳細が含まれます。これには、アダプタが使用する様々な相互作用と接続のプロパティが含まれます。操作は、エンドポイントに対して実行する必要のあるアクション(作成や更新など)を記述します。ファイルの内容は、アダプタ構成中の選択によって決定されます。

サポートされているバージョンとプラットフォーム

サポートされるバージョンおよびプラットフォームの詳細は、http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.htmlのリリース動作保証マトリックスを参照してください。

Oracle RightNowアダプタによってサポートされるWSDL

Oracle RightNowアダプタでは、標準WSDLのみがサポートされます。パートナWSDLはサポートされません。RightNowアダプタでサポートされるAPIバージョンは、1.3です。「標準WSDLの取得」も参照してください。

標準WSDLの詳細は、Oracle RightNow Connect Web Services for SOAP開発者ガイドの「はじめに: Webサービスへの接続の概要」、WSDLの取得に関する項を参照してください。

2 RightNowアダプタのスタート・ガイド

この章では、Oracle RightNowアダプタの使用を開始する方法について説明します。Oracle RightNowアダプタの設計時および実行時の機能を準備した後に特定の使用例を実行する方法の詳細は、「Oracle RightNowアダプタの使用例」を参照してください。

ここには、Oracle RightNowアダプタの使用をすぐに開始する方法に関する情報があり、次の内容が含まれます。

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

- Oracle RightNowアダプタの接続パラメータの使用

- 標準WSDLの取得

- 設計時および実行時のOracle RightNowアダプタの理解

- サポートされない機能

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

この項では、クラウド・アダプタのインストールの詳細について説明します。

クラウド・アダプタのインストール方法の詳細は、パッチに付属しているREADME.txtファイルを参照してください。

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

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

Oracle RightNowアダプタの接続パラメータの使用

この項では、ビジネス・オブジェクトに操作を実行できるようにするOracle RightNowアダプタの接続パラメータについて説明します。

Oracle RightNowアダプタでは、Oracle RightNowアダプタ構成ウィザードの使用を開始できるようにするため、ユーザーのログイン資格証明が必要です。

必要な接続パラメータは次のとおりです。

- ユーザー名

- パスワード

- 認証キーまたはCSF (資格証明ストア・フレームワーク)キー。これは、ランタイム資格証明をインジェクトするために使用するキーです。アダプタでは、CSFキーを使用して、RightNow認証に必要なユーザー名とパスワードを取得します。このキーはデザインタイムの間に、ユーザーのOracle RightNow CXログイン資格証明を識別します。実行時、SOAコンポジット・アプリケーションをサーバーにデプロイしている間にキーが自動的に作成されます。oracle.wsm.security。CSFキー・ルールは、次のように作用します。

- CSFキーの資格証明が存在しない場合は、それらを作成します。

- CSFキーの資格証明がすでに存在する場合は、それらをオーバーレイしません。これにより、デプロイメント中にエラーが発生します。

- CSFキーの資格証明がすでに存在する場合、デプロイメントの資格証明はサーバー上の資格証明と比較されます。それらが完全に一致しない場合は、例外が発生し、デプロイメントは失敗します。手動でCSFキーを変更して、デプロイメントを再試行する必要があります。

詳細は、「RightNow資格証明を管理するための資格証明ストアの構成」を参照してください。

- 追加情報は、「アカウント・パスワードによるOracle RightNow Cxサーバーでの認証」を参照してください。

標準WSDLの取得

RightNowアダプタで使用するために標準WSDLを取得する手順:

1. Oracle RightNow Cxアカウントから次の詳細情報を収集します。

- ホスト

- インタフェース名

- ユーザー名とパスワード

2. Webブラウザを開き、次のURLのホスト名とインタフェースの詳細を適切に置き換えて入力し、標準WSDLを取得します。

https://<host_name>/cgi-bin/<interface>.cfg/services/soap?wsdl=typed

次に例を示します。

https://integration-test.rightnowdemo.com/cgi-bin/integration_test.cfg/services/soap?wsdl=typed

注意:

Oracle RightNow Connect Web Services for SOAP APIを使用できるようにするため、ユーザー・アカウントに対して公開SOAP APIのパーミッションを有効化する必要があります。

公開SOAP APIのパーミッションによって、このプロファイルを持つスタッフ・メンバーは、アカウントまたはセッションの認証を通じて公開SOAP APIにアクセスできます。

Oracle RightNowアダプタでは、パートナWSDL/汎用WSDLはサポートされません。したがって、次のURLはサポートされません。

http://integration-test.rightnowdemo.com/cgi-bin/integration_test.cfg/services/soap?wsdl=generic

クライアント/サーバーへのOracle RightNowアプリケーションの証明書のインポート

Oracle RightNowアダプタの証明書をクライアント/サーバーにインポートするには、次の手順を実行します。

1. ブラウザを開き、次のURLのhost_nameとinterfaceの詳細を置き換えて入力します。

https://<host_name>/cgi-bin/<interface>.cfg/services/soap?wsdl=typed

次に例を示します。

http://integration-test.rightnowdemo.com/cgi-bin/integration_test.cfg/services/soap?wsdl=typed

この場合、host_nameはintegration-test.rightnowdemo.com、interfaceはintegration_testになります

2. 図2-1に示すように、ロック・アイコンをクリックします。

図2-1 Internet Explorerブラウザのブラウザ・ウィンドウのロック・アイコン

図2-2に、Chromeブラウザのロック・アイコンの場所を示します。

図2-2 矢印で示されたChromeブラウザのロック・アイコンの場所

図2-3に、Mozilla Firefoxブラウザのロック・アイコンの場所を示します。

図2-3 矢印で示されたMozilla Firefoxブラウザのロック・アイコンの場所

小さいウィンドウが表示されます。ポップアップの一番下にある「証明書の表示」をクリックします(図2-4を参照)。

図2-4 ポップアップの「証明書の表示」

3. 「証明書の表示」をクリックすると、別のウィンドウが表示され、証明書の詳細が示されます。「詳細」タブを開き、「ファイルにコピー」をクリックします(図2-5を参照)。

図2-5 証明書の詳細のポップアップ

4. Windowsの証明書のエクスポート・ウィザードが開きます。「次へ」をクリックして、「Base-64 encoded X.509 (.CER)」オプションを選択します(図2-6を参照)。

図2-6 「Base-64 encoded X.509m(.CER)」が選択された証明書ウィザード

5. 「次へ」をクリックし、証明書を保存する場所を選択します。証明書ファイルの適切な名前を指定して保存します。たとえば、rightnowdemo.crtという証明書を、フォルダ FMW_HOME/wlserver/server/libにコピーできます。

6. ダウンロードした証明書をアプリケーション・サーバーにインポートし、クライアント証明書をリクエストするようにアプリケーション・サーバーを構成します。証明書の有効期限が切れた場合は、証明書を再インポートしてください。

keytoolを使用したWebLogic ServerへのOracle RightNowアプリケーションの公開証明書のインポート

keytoolを使用して、Oracle WebLogic ServerにOracle RightNowアプリケーションの公開証明書をインポートする必要があります。

インポートする手順を実行する前に、コンソールの「SSL」タブにあるパラメータの「ホスト名の検証」フィールドがサーバー側で「NONE」に設定されていることを確認します。

Oracle WebLogic Server keytoolにOracle RightNowアダプタの公開証明書をインポートする手順:

1. 認証局を保存するシステム上の適切な場所を指定します。これを信頼できる対象としてマークしてください。これをシステム上の適切な場所に保存します。

2. WebLogicサーバーの信頼キーストアの場所を見つけるため、管理コンソール(http://url:port/console/)にログインします

3. ホームページで、「環境」サブセクションの「サーバー」に移動します。

4. 表示されているサーバーのリストから管理サーバーを選択します。

5. 「キーストア」タブに進みます(図2-7を参照)。

図2-7 「キーストア」タブ

6. 「キーストア」タブで、「デモ信頼キーストア」パスを選択します。これは、キーストアが存在する場所のパスです。

このパスは、{Middleware_Home} \wlserver_10.3\server\libなどです。

7. この証明書を認証局からWebLogic Serverの信頼ストアにインポートします。Windowsを使用している場合、コマンド・プロンプトを使用し、UNIX/Linuxを使用している場合、コマンド・シェルを使用して前述のパスに移動します。

8. キーストアが存在する場所のパスで、次のkeytoolコマンドを実行します。

keytool -import -trustcacerts -alias OracleRightNowCA -file <Filename with location> -keystore DemoTrust.jks -storepass DemoTrustKeyStorePassPhrase

たとえば、ダウンロードした証明書を手順7で示された場所に保持しており、証明書の名前がOracleServiceCloudCA.cerであるとすると、使用するkeytoolコマンドは次のようになります。

keytool -import -trustcacerts -alias OracleRightNowCA -file OracleServiceCloudCA.cer -keystore DemoTrust.jks -storepass DemoTrustKeyStorePassPhrase

9. 証明書がキーストアに追加されたことを示すメッセージが表示され、証明書のインポートに成功したことがわかります。この証明書を信用するかどうかを尋ねるプロンプトが表示されたら、Yesと入力して[Enter]を押します。

10. 証明書がキーストアに追加されたことを確認するには、次のコマンドを使用してすべての証明書をリストします。

keytool -list -keystore DemoTrust.jks -storepass DemoTrustKeyStorePassPhrase

新しくインポートされた証明書が、キーストアに存在する証明書の一部として表示されます。

11. サーバーを再起動して、前述の手順で行った変更を反映させます。

Oracle RightNowアダプタのパーミッションの構成

CRUD操作や問合せ操作のコールを作成できるようにパーミッションを構成するには、次の手順を実行します。

1. Oracle RightNow CXクライアントをインストールします。

2. Oracle RightNow CXクライアントにログインします。Oracle RightNow CXユーザーズ・ガイドを参照してください。

3. 「スタッフ・マネジメント」に移動し、「プロファイル」をクリックします。

4. 「プロファイル」を選択し、有効化する必要のあるユーザー・アカウントを選択します。

5. 「アクセス権」タブをクリックします。

6. 「公開SOAP API」に対して「すべて選択」を選択します。

7. 「公開SOAP API」で「アカウント認証」を選択します。

8. オブジェクト固有のタブでオブジェクト固有のパーミッションを選択します。次の項を参照してください。

オブジェクト固有のパーミッションの詳細

これらの権限の詳細は、表2-1を参照してください。追加情報は、Oracle RightNow CX Cloud Service Serverユーザーズ・ガイド(2014年8月)を参照してください。

表2-1 オブジェクトに関する情報の参照先

参照する情報

Oracle RightNow Cxユーザーズ・ガイドの参照先の場所

組織パーミッション

コア機能→スタッフ・マネジメント→プロファイルのカスタマイズ→組織パーミッションに移動

連絡先パーミッション

コア機能→スタッフ・マネジメント→プロファイルのカスタマイズ→連絡先パーミッションに移動

サービス・パーミッション

コア機能→スタッフ・マネジメント→プロファイルのカスタマイズ→サービス・パーミッションに移動

案件トラッキング・パーミッション

コア機能→スタッフ・マネジメント→プロファイルのカスタマイズ→案件トラッキング・パーミッションに移動

カスタム・オブジェクト・パーミッション

コア機能→スタッフ・マネジメント→プロファイルのカスタマイズ→カスタム・オブジェクト・パーミッションに移動

関連するパーミッションの情報(特にRightNow CXのIPアドレス範囲および制限事項に関する情報)は、Oracle RightNow Cx Serverリリース・ノート(2013年5月)を参照してください。

アカウント・パスワードによるOracle RightNow Cxサーバーでの認証

次の項では、アカウント・パスワードを使用してOracle RightNow Cxサーバーで認証を行う方法について説明します。

Oracle Cloud Connect Web Services for SOAP APIのアクセス制御

Oracle Cloud Connect Web Services for SOAP APIがリクエストを受信すると、一連のアクセス制御方法が強制されます。

1. APIがサイト・レベルで有効になっていることを確認するため、サイト構成がチェックされます。

2. リクエストに指定されているユーザー資格証明が検証されます。

3. 適切なプロファイル・ビットが有効になっていることを確認するため、指定されたアカウントのプロファイルがチェックされます。プロファイルは、管理機能に対するアクセスの制御と、スタッフ・メンバー固有のパーミッション、デフォルトのワークスペース、デフォルトのナビゲーション・セットおよびレポート・アクセスの割当てを行うためのメカニズムです。

注意:

サーバー側のアクセス制御は、Oracle Cloud Connect Web Services for SOAPによって作成されるすべてのコアAPIコールに対して強制されます。現在のパーミッションは、Oracle RightNowのプロファイル・パーミッション・エディタの読取り、編集、削除および移動の各チェック・ボックスにマップされます。サーバー側のアクセスは、2013年5月以降の新しいサイトではデフォルトで有効化されますが、2013年5月のリリースより前にアップグレードされたサイトでは無効化されます。既存のOracle RightNowユーザーで、サイトを2013年5月以降のビルドにアップグレードする予定の場合、このセキュリティ強化機能を有効化するようにカスタマ・サポートに連絡してください。

すでにサーバー側のアクセス制御が現在のサイトで有効化されている場合、プロファイル・パーミッションの変更は慎重に行ってください。Oracle RightNow管理者が特定のOracle Cloud Connect Web Services for SOAP統合のプロファイルに対するパーミッションを変更すると、その変更によって統合が破損する可能性があります。

設計時および実行時のOracle RightNowアダプタの理解

この項では、設計時および実行時にOracle RightNowアダプタにアクセスするための概要について説明します。

Oracle RightNowアダプタには、次の2つのコンポーネントがあります。

- デザインタイム。Oracle RightNowアダプタのデザインタイム・コンポーネントは、構成ウィザードです。このウィザードによって、Webサービスを起動して使用するために必要なアーティファクトを生成できます。これは、RightNow Cxと通信するために必要なアーティファクトを作成する構成ウィンドウで構成されます。
Oracle RightNowアダプタ用のOracle JDeveloperデザインタイムによって、RightNow Cxに対する社内コネクタ/アダプタを簡単に作成できるユーザー・インタフェースが提供されます。これには次の機能があります。

- RightNow Cxへの接続が行われるRightNow Cx WSDLに入力する機能。

- RightNow Cx WSDLとその関連CSFキーの検証。

- Oracle RightNow接続の成功についてのテスト。

- RightNow CXで使用できる標準オブジェクトまたはイベント・サブスクリプションの検索。

- RightNow CXビジネス・オブジェクトを次の2つの方法で選択/問合せ可能。

- シャトル・ベースのビジネス・オブジェクト・ブラウザ・ウィジェットを使用する方法。

- デザインタイムの間にROQL問合せのテストおよび検証を行う機能。

図2-8に示すフローチャートは、デザインタイムの一連のライフサイクル(Oracle RightNowアダプタの構成で実行するアクション)を示しています。これは、ランタイムのアダプタ構成ウィザードと、そのSOAコンテキストにデザインタイムがどのように関連しているかを示しています。

図2-8 Oracle RightNowアダプタ・デザインタイムのフローチャート

- このアダプタには、次のランタイム・コンポーネントもあります。アダプタのランタイム部分を使用して、設計時に生成された情報をサービス・エンドポイントに配信します。これは、Webサービスの起動が発生する場所です。

Oracle RightNowアダプタは、Oracle SOA Suite 12.2.1の新しいユーザーと既存のユーザーの両方を対象にインストールできます。

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

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

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

3 Oracle RightNowアダプタ構成ウィザードのウォークスルー

この章では、Oracle JDeveloperを使用したOracle RightNowアダプタの一般的な構成手順に加え、作成、読取り、更新および削除に関してアダプタで使用できる様々な操作、それらの操作で使用できる機能、およびRightNow Object Query Language (ROQL)問合せ言語の使用について説明します。

この章の内容は次のとおりです。

- JDeveloperでの一般的な構成手順の実行

- 操作の作成、読取り、更新および削除の理解

- ROQLの使用

多くの項で操作やオプションの概要を説明しており、詳細情報が記載された他の章を参照しています。

JDeveloperでの一般的な構成手順の実行

この項では、Oracle JDeveloperを使用してOracle RightNowアダプタ・プロジェクトを開始する場合に共通の構成手順の概要について説明します。Oracle JDeveloperを使用すると、Oracle RightNowアダプタを構成してBPELプロジェクトを作成できますが、Oracle Service Busなどの他のサービス・エンジンで使用するようにアダプタを構成することもできます。

JDeveloperでのSOAアプリケーション・プロジェクトの作成

Oracle JDeveloperを使用して、アウトバウンドまたはインバウンド・サービスとして使用するようにOracle RightNowアダプタを構成するには、まずSOAアプリケーション・プロジェクトを作成します。

1. Oracle JDeveloperの「ファイル」メニューで、「新規」をクリックして「アプリケーション」を選択します。

図3-1 ナビゲーション

2. 「新規ギャラリ」ページが表示されます。「項目」リストから「SOAアプリケーション」を選択します。

図3-2 SOAアプリケーションの作成

3. アプリケーションに適切な名前を指定します。

図3-3 アプリケーションの名前付け

4. 「次へ」をクリックしてプロジェクトに適切な名前を指定します。

図3-4 プロジェクトの名前付け

5. 「次へ」をクリックします。

6. 「標準コンポジット」を選択します。

7. 「BPELプロセスを使用するコンポジット」を選択します。

図3-5 SOA設定の構成

8. 「終了」をクリックします。
SOAコンポジット・アプリケーションが設計用にSOAコンポジット・エディタに表示されます。
サービスおよび参照のクラウド・アダプタを「公開されたサービス」および「外部参照」スイムレーンにドラッグ・アンド・ドロップした場合は、次の機能がサポートされません。

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

- 「公開されたサービス」スイムレーンのアダプタに対し、「機密データの保護」 > 「リクエスト・データの暗号化」。

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

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

インバウンド・サービスのOracle RightNowアダプタの構成

Oracle JDeveloperを使用してインバウンド・サービスとして使用するようにOracle RightNowアダプタを構成する手順:

1. Oracle JDeveloperの「コンポーネント」から「公開されたサービス」スイムレーンにOracle RightNowアダプタ・コンポーネントをドラッグ・アンド・ドロップします。

2. スイムレーンのOracle RightNowアダプタ・アイコンをクリックします。Oracle RightNowアダプタの基本情報画面が表示されます。

3. 基本情報を入力して、Oracle RightNowアダプタに接続します。

構成

例/情報

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

わかりやすい名前を入力します。

エンドポイントでの実行内容

説明を入力します。

4. 「次へ」をクリックします。「接続」ページが表示されます。

5. 接続情報を入力します。

構成

例/情報

WSDL URL

RightNow管理者からWSDLを入手します。

セキュリティ・ポリシー

ポリシーを選択します。

認証キー

RightNow管理者から認証キーを入手できます。

テスト

接続をテストして、資格証明を検証します。

6. 「次へ」をクリックします。

7. Oracle RightNow Cxから受信するビジネス・オブジェクトまたはイベント・サブスクリプションを、この統合を開始するリクエスト・ドキュメントとして選択し、「次へ」を選択します。標準WSDLには、ビジネス・オブジェクトとイベント・サブスクリプションの両方に対するサポートを含めることができます。これにより、ビジネス・オブジェクトかイベント・サブスクリプションのいずれかを、リクエストとしてOracle RightNowアプリケーションから受信できます。イベント・サブスクリプションは、Oracle RightNowアプリケーションのバージョンがバージョン15.5 (2015年5月リリース)か、それ以降の場合にのみサポートされます。そうでない場合は、ビジネス・オブジェクトのみが、選択肢として構成ウィザードに表示されます。

8. レスポンス・タイプと、レスポンスのオプションのビジネス・オブジェクトを選択します。

- レスポンスが不要な場合は、「なし」を選択します。

- 「即時」を選択し、統合でOracle RightNow Cxにレスポンス・ドキュメントとして送信するビジネス・オブジェクトを選択します。

9. 「次へ」をクリックします。

「サマリー」ページが表示されます。

10. 「終了」をクリックします。

アウトバウンド・サービスのOracle RightNowアダプタの構成

Oracle JDeveloperを使用してアウトバウンド・サービスとして使用するようにOracle RightNowアダプタを構成する手順:

1. Oracle JDeveloperの「コンポーネント」リストから参照スイムレーンにOracle RightNowアダプタ・コンポーネントをドラッグ・アンド・ドロップします。

2. スイムレーンのRightNowアダプタ・アイコンをクリックします。基本情報画面が表示されます。

3. 基本情報を入力して、Oracle RightNowアダプタに接続します。

構成

例/情報

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

わかりやすい名前を入力します。

エンドポイントでの実行内容

説明を入力します。

4. 「次へ」をクリックします。「接続」ページが表示されます。

5. 接続情報を入力します。

構成

例/情報

WSDL URL

RightNow管理者からWSDLを入手します。

セキュリティ・ポリシー

ポリシーを選択します。

認証キー

RightNow管理者から認証キーを入手できます。

テスト

接続をテストして、資格証明を検証します。

6. 「次へ」をクリックします。RightNowアダプタ構成ウィザードに、選択可能な追加情報が表示されます。

- 実行する操作です。

- 操作を実行する対象となるオブジェクト。

- 操作固有の任意の構成。

この時点で、単一のCRUD操作を実行するか、複数操作をバッチで実行するかを指定できます。

- 単一操作 - 単一操作による作業の場合はこのオプションを選択します。

- バッチ操作 - 複数の操作による作業の場合はこの操作を選択します。
次の図は「操作」画面を示しています。ここでは、操作の選択に関連する大部分の作業を実行します。

7. 「次へ」をクリックします。

「サマリー」ページが表示されます。

8. 「終了」をクリックします。

操作の作成、読取り、更新および削除の理解

Oracle RightNowアダプタで使用可能な操作には、作成、読取り、更新および削除(CRUD)操作が含まれます。

CRUD操作によって、Oracle RightNow Cxシステムに含まれるオブジェクトの作成、読取り、更新および削除が可能になります。

すべてのCRUD操作は、多相動作セクションで定義されたとおりに多相的に動作します。そのため、任意のCRUD操作は、入力パラメータとして1からNまでの異種プライマリ・オブジェクトを受け入れることが可能で、それによって単一のリクエストで混在するオブジェクト・タイプを任意のCRUD操作に提供できます。

たとえば、Contact、IncidentおよびOrganizationオブジェクトを、Createメソッドの単一の起動に対して提供できます。

単一のCRUDリクエストで提供できるオブジェクトのハード制限は1000ですが、操作上の制約のため、最大数のオブジェクトを提供するとエラーが発生する可能性があります。

CreateおよびGet (Read)の戻り値は、1からNのRNObjectを含むリストです。このリストのサイズは、操作リクエストで提供されるリストのサイズに一致します。UpdateおよびDestroyメソッドは、成功時に値を返しません。CRUD操作に失敗すると、SOAPフォルトがクライアントに返されます。

一方、Create操作は、suppressResponseが無効になっている場合、作成したビジネス・オブジェクトのIDを返しますが、Get操作はビジネス・オブジェクト全体を返します。

Oracle Cloud Connect Web Services for SOAPのクライアントがCreate操作を起動すると、1つのオブジェクトまたはオブジェクトのリストが返されます。オブジェクトに関連するデータの残りが必要な場合、Get操作を実行する必要があります。

Create操作は、すべてのプライマリ・オブジェクトに直接実行できます。

Oracle Cloud Connect Web ServicesのクライアントがGet操作を起動すると、1つのオブジェクトまたはオブジェクトのリストが返されます。

Destroy操作は、プライマリ・オブジェクトとサブオブジェクトを破棄します。

サポートされる機能

次の項では、Oracle RightNowアダプタによってサポートされる機能のリストを示します。

- CRUD操作の使用

- バッチ機能の使用

- チェーン

- チェーンの使用

CRUD操作の使用

Oracle RightNowアダプタでは、CRUD、つまり作成、読取り、更新および破棄操作がサポートされます。サポートされる基本操作は次のとおりです。

- 1つ以上のビジネス・オブジェクトの作成

- 1つ以上のオブジェクトからのデータの取得

- 1つ以上のビジネス・オブジェクトの更新

- 1つ以上のビジネス・オブジェクトの削除

1つ以上のビジネス・オブジェクトの作成

Oracle RightNowアダプタを使用して、RightNow Cxで1つ以上のビジネス・オブジェクト(標準またはカスタム)を作成できます。たとえば、Organization、ContactおよびIncidentオブジェクトを、すべて単一のリクエストの一部として、または3つの独立したリクエストとして作成できます。

たとえば、操作画面では、1つのリクエストの一部としてOrganization、ContactおよびIncidentオブジェクトを選択できます。

1つ以上のオブジェクトからのデータの取得

Oracle RightNowアダプタを使用して、RightNow CXクラウド・プラットフォームで使用可能な1つ以上のオブジェクトからデータを取得できます。たとえば、Oracle RightNowアダプタを使用して、組織のみに関連するデータを取得したり、1つのリクエストで組織、連絡先およびインシデントの組合せに関する情報を取得できます。

たとえば、操作画面でGet操作を指定してOrganizationオブジェクトを選択し、Organizationからデータを取得できます。

1. 「操作タイプの選択」リストからGet操作を選択します。

2. 矢印を使用してOrganizationオブジェクトを「選択可能」リストから「選択済」リストに移動します。

3. 「次へ」をクリックします。

1つ以上のビジネス・オブジェクトの更新

Update操作を使用して、任意のプライマリ・オブジェクトと関連サブオブジェクトを更新します。RightNow CXクラウド・プラットフォームで1つ以上のビジネス・オブジェクト(標準またはカスタム)を更新できます。たとえば、Organization、ContactおよびIncidentオブジェクトを、単一のリクエストの一部として、または3つの独立したリクエストとして更新できます。

たとえば、Organization、ContactおよびIncidentオブジェクトを、単一のUpdateリクエストの一部として、操作画面で更新できます。

更新操作を実行するには、次の手順を実行します。

1. 「操作タイプの選択」リストからUpdateを選択します。

2. 選択可能リストから1つ以上のビジネス・オブジェクトを選択します。

3. 矢印を使用して、ビジネス・オブジェクトを選択済リストに移動します。

4. 「次へ」をクリックします。

3つのオブジェクトに対する一連の更新の一部として1つのオブジェクトを更新できます。

1つ以上のビジネス・オブジェクトの削除

Oracle RightNowアダプタを使用して、RightNow Cxクラウド・プラットフォームで1つ以上のビジネス・オブジェクト(標準またはカスタム)を削除できます。たとえば、Organization、ContactおよびIncidentオブジェクトを、すべて単一のリクエストの一部として、または3つの独立したリクエストとして削除できます。

次のスクリーンショットでは、Oracle RightNowアダプタの操作画面を使用して、Organization、ContactおよびIncidentオブジェクトを削除します。

複数のビジネス・オブジェクトを削除するには、次の手順を実行します。

1. 「操作タイプの選択」リストからDestroy操作を選択します。

2. 矢印を使用してOrganization、ContactおよびIncidentオブジェクトを「選択可能」リストから「選択済」リストに移動します。

3. 「次へ」をクリックします。

バッチ機能の使用

バッチ機能は、Oracle RightNowアダプタの独特な機能であり、1つ以上の異種操作を単一の操作を通じてRightNow Cxサーバーに送信できます。この機能によって、統合開発者は、既存の組織の更新、既存の組織の連絡先の作成、既存のインシデントのメモの削除、または新しいインシデントの作成が可能になります。バッチ機能の使用により、これらすべての指示を結合し、単一の操作としてOracle RightNow Cxサーバーに送信できます。Oracle RightNowアダプタは、バッチ操作とバッチ・オプションを構成するために必要なツールを提供して、この機能を拡張します。

アダプタでは、バッチ操作と処理オプションのために統合の容易なインタフェースも提供しています。バッチ操作オプションを選択してこのオプションを構成できます。

バッチ機能には他に次の機能も含まれます。

- バッチの各操作には、個別の処理オプションがあります。アダプタ構成ウィザードでは、ユーザーが処理オプションを構成するためのグラフィカルで直感的な方法が提供されます。

- バッチ内の操作は、通常、単一のトランザクションで実行されますが、commitAfterプロパティを使用してこれらの操作を異なる作業ユニットにグループ化することもできます。このプロパティでは、複数の操作を1つのトランザクションにグループ化します。実行時、バッチ内の一連の操作を1つの操作の一部として定義する場合、そのトランザクション境界の最後の操作後にこのアクションが送信されます。

Oracle RightNowアダプタのユーザー・インタフェースによるバッチ機能のサポート

バッチ機能は、Oracle RightNowアダプタの独特な機能であり、1つ以上の操作を単一の操作を通じてOracle RightNow Cxに送信できます。

Oracle RightNowアダプタは、バッチ操作とバッチ・オプションを構成するために必要なツールを提供して、バッチ機能を拡張します。これは、バッチ操作と処理オプションのために統合の容易なインタフェースも提供しています。

次の項では、アダプタ構成ウィザードを使用してバッチ操作用にOracle RightNowアダプタをモデル化する方法について説明します。

1. SOAプロジェクトまたはService Busプロジェクトで、「コンポーネント」からコンポジット・スイムレーンにOracle RightNowアダプタをドラッグ・アンド・ドロップします。有効な接続名を指定します。

2. 接続の詳細を指定します。

3. 操作ページで、バッチ操作オプションを選択してバッチ操作を構成します。

4. このオプションを選択すると、複数の操作をバッチとして構成できます。

5. ここで、バッチ操作として操作を選択および追加できます。

6. 追加された各操作は、適切なビジネス・オブジェクトとともにリスト表示されます。

7. バッチ・プロセスの各操作には、「プロパティ」タブで指定できる個別の処理オプションがあります。たとえば、「操作の追加」には、指定可能な3つのプロパティ(「外部イベントの抑制」、「ルールの抑制」および「後でコミット」)があります。

8. 「次へ」を選択してアダプタ・ウィザードを完了します。確認ダイアログに、生成されたアーティファクトが表示されます。

バッチ内の操作は、通常、単一のトランザクションで実行されますが、commitAfterプロパティを使用してこれらの操作を別々の作業ユニットにグループ化することもできます。

バッチ・プロセスWSDL

次の例は、バッチ・プロセスによるサンプルWSDLの異なる部分を示しています。最初の例は、バッチ操作用の統合WSDL内に定義されたポート・タイプおよび操作を示しています。

例3-1 ポート・タイプおよび操作

<wsdl:portType name="rightnowReferencePortType">
<wsdl:operation name="Batch">
<cloud:CloudOperation xmlns:cloud="http://xml.oracle.com/types" targetOperation="Batch"/>
<wsdl:input message="ns0:BatchRequestMessage"/>
<wsdl:output message="ns0:BatchResponseMessage"/>
<wsdl:fault name="ServerErrorFault"
message="ns0:ServerErrorFault"/>
<wsdl:fault name="RequestErrorFault"
message="ns0:RequestErrorFault"/>
<wsdl:fault name="UnexpectedErrorFault" message="ns0:UnexpectedErrorFault"/>
</wsdl:operation>
</wsdl:portType>

2番目の例は、統合WSDLバッチ操作で定義された入力メッセージ・タイプを示しています。

例3-2 統合WSDLバッチ操作で定義された入力メッセージ・タイプ

<xs:element name="Batch" type="ns2:BatchRequestType"/>
<xs:complexType name="BatchRequestType">
<xs:sequence>
<xs:element name="Create"
type="ns2:CreateRequestType"/>
<xs:element name="Update"
type="ns2:UpdateRequestType"/>
<xs:element name="Get"
type="ns2:GetRequestType"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="CreateRequestType">
<xs:sequence>
<xs:element maxOccurs="unbounded" minOccurs="0" type="ns7:Account" name="Account"/>
</xs:sequence>
</xs:complexType>

次の例は、統合WSDLバッチ操作で定義された出力メッセージ・タイプを示しています。

例3-3 統合WSDLバッチ操作で定義された出力メッセージ・タイプ

<xs:element name="BatchResponse" type="ns2:BatchResponseType"/>
<xs:complexType name="BatchResponseType">
<xs:sequence>
<xs:element name="Create" type="ns2:CreateResponseType"/>
<xs:element name="Update" type="ns2:UpdateResponseType"/>
<xs:element name="Get" type="ns2:GetResponseType"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="CreateResponseType">
<xs:sequence>
<xs:element maxOccurs="unbounded" minOccurs="0"
type="ns7:Account" name="Account"/>
<xs:element name="RequestErrorFault" maxOccurs="1"
minOccurs="0"
type="ns9:RequestErrorFaultType"/>
<xs:element name="UnexpectedErrorFault"
maxOccurs="1" minOccurs="0"
type="ns9:UnexpectedErrorFaultType"/>
<xs:element name="ServerErrorFault"
maxOccurs="1" minOccurs="0"
type="ns9:ServerErrorFaultType"/>
</xs:sequence>
</xs:complexType>

チェーン

チェーンは、単一のバッチ・リクエスト内で複数の操作を相互に関連付けるために使用できるOracle RightNowアダプタの機能です。具体的には、チェーンをバッチと併用して、関連する操作を実行します。操作のチェーンを作成するには、チェーンのソースおよびターゲットの操作が同じ作業ユニット内に存在する必要があります。

注意:
Oracle RightNow Cloudアダプタをアウトバウンド方向に構成するときに、チェーンを使用する場合は、「後でコミット」処理オプションを選択しないでください。アウトバウンド方向の構成の詳細は、「Oracle RightNowアダプタのユーザー・インタフェースによるバッチ機能のサポート」を参照してください。

たとえば、次のリクエストには、同じサンプル・バッチ・リクエストのすべての部分である3つの操作が含まれます。

1. Contactの作成。

2. Incidentの作成(このIncidentのプライマリContactは最初の手順で作成したものです)。

3. Incidentの取得(作成したIncidentのみを返す必要があります)。

例3-4の例で強調表示されている属性を使用して、これがコード内でどのように記述されるかを確認します。

例3-4 チェーンのXML

<Batch
xmlns="http://xmlns.oracle.com/pcbpel/adapter/
rightnow/RNDemo01/RNBatchDemo01/rightnowReference"
xmlns:rna_v1_2="urn:metadata.ws.rightnow.com/v1_2" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:rnm_v1_2="urn:messages.ws.rightnow.com/v1_2"
xmlns:rnn_v1_2="urn:nullfields.ws.rightnow.com/v1_2"
xmlns:rnf_v1_2="urn:faults.ws.rightnow.com/v1_2" xmlns:ns1="urn:base.ws.rightnow.com/v1_2"
xmlns:rno_v1_2="urn:objects.ws.rightnow.com/v1_2" xmlns:plnk="http://docs.oasis-open.org/wsbpel/2.0/plnktype"
xmlns:http="http://schemas.xmlsoap.org/wsdl/http/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:rng_v1_2="urn:generic.ws.rightnow.com/v1_2"
xmlns:rnw_v1_2="urn:wsdl.ws.rightnow.com/v1_2"
xmlns:tns="http://xmlns.oracle.com/pcbpel/adapter/
rightnow/RNDemo01/RNBatchDemo01/rightnowReference"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<tns:CreateContact>
<tns:Contact>
<ns1:ID xsi:type="ns1:ChainSourceID"
variableName="MyContact" />
<rno_v1_2:Name>
<rno_v1_2:First>John</rno_v1_2:First>
<rno_v1_2:Last>Doe</rno_v1_2:Last>
</rno_v1_2:Name>
</tns:Contact>
</tns:CreateContact>
<tns:CreateIncident>
<tns:Incident>
<ns1:ID xsi:type="ns1:ChainSourceID"
variableName="MyIncident" />
<rno_v1_2:PrimaryContact>
<rno_v1_2:Contact>
<ns1:ID xsi:type="ns1:ChainDestinationID" variableName="MyContact" />
</rno_v1_2:Contact>
</rno_v1_2:PrimaryContact>
<rno_v1_2:Subject>This is a test subject.
</rno_v1_2:Subject>
</tns:Incident>
</tns:CreateIncident>
<tns:GetIncident>
<tns:Incident>
<ns1:ID xsi:type="ns1:ChainDestinationID"
variableName="MyIncident" />
</tns:Incident>
</tns:GetIncident>
</Batch>

例3-5に関連付けられているリクエストおよびレスポンス・ペイロードは、統合リクエスト・ペイロードの例を示しています。

例3-5 統合リクエスト・ペイロード

<Batch
xmlns="http://xmlns.oracle.com/pcbpel/adapter/
rightnow/RNDemo01/RNBatchDemo01/rightnowReference"
xmlns:rna_v1_2="urn:metadata.ws.rightnow.com/v1_2" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:rnm_v1_2="urn:messages.ws.rightnow.com/v1_2"
xmlns:rnn_v1_2="urn:nullfields.ws.rightnow.com/v1_2"
xmlns:rnf_v1_2="urn:faults.ws.rightnow.com/v1_2" xmlns:ns1="urn:base.ws.rightnow.com/v1_2"
xmlns:rno_v1_2="urn:objects.ws.rightnow.com/v1_2" xmlns:plnk="http://docs.oasis-open.org/wsbpel/2.0/plnktype"
xmlns:http="http://schemas.xmlsoap.org/wsdl/http/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:rng_v1_2="urn:generic.ws.rightnow.com/v1_2" xmlns:rnw_v1_2="urn:wsdl.ws.rightnow.com/v1_2"
xmlns:tns="http://xmlns.oracle.com/pcbpel/
adapter/rightnow/RNDemo01/RNBatchDemo01/rightnowReference"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<tns:CreateContact>
<tns:Contact>
<ns1:ID xsi:type="ns1:ChainSourceID" variableName="MyContact" />
<rno_v1_2:Name>
<rno_v1_2:First>John</rno_v1_2:First>
<rno_v1_2:Last>Doe</rno_v1_2:Last>
</rno_v1_2:Name>
</tns:Contact>
</tns:CreateContact>
<tns:CreateIncident>
<tns:Incident>
<ns1:ID xsi:type="ns1:ChainSourceID"
variableName="MyIncident" />
<rno_v1_2:PrimaryContact>
<rno_v1_2:Contact>
<ns1:ID xsi:type="ns1:ChainDestinationID" variableName="MyContact" />
</rno_v1_2:Contact>
</rno_v1_2:PrimaryContact>
<rno_v1_2:Subject>This is a test
subject.</rno_v1_2:Subject>
</tns:Incident>
</tns:CreateIncident>
<tns:GetIncident>
<tns:Incident>
<ns1:ID xsi:type="ns1:ChainDestinationID"
variableName="MyIncident" />
</tns:Incident>
</tns:GetIncident>
</Batch>

レスポンス・ペイロードを例3-6に示します。

例3-6 統合レスポンス・ペイロード

<itns:BatchResponse xmlns:n0=
"urn:messages.ws.rightnow.com/v1_2"
xmlns:n2="urn:base.ws.rightnow.com/v1_2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:n1="urn:objects.ws.rightnow.com/v1_2" xmlns:itns="urn:oracle.cloud.adapter.rightnow/1214">
<itns:Create>

<itns:Contact>
<n2:ID id="1903" />
</itns:Contact>
</itns:Create>
<itns:Create>

<itns:Incident>
<n2:ID id="455" />
</itns:Incident>
</itns:Create>
<itns:Get>

<itns:Incident>
<n2:ID id="455" />
<n2:LookupName>140623-000003</n2:LookupName>
<n2:CreatedTime>2014-06-23T14:44:03.000Z</n2:CreatedTime>
<n2:UpdatedTime>2014-06-23T14:44:03.000Z</n2:UpdatedTime>
<n1:CreatedByAccount>
<n2:ID id="2" />
</n1:CreatedByAccount>
<n1:InitialResponseDueTime>2014-06-24T00:00:00.000Z
</n1:InitialResponseDueTime>
<n1:Interface>
<n2:ID id="1" />
</n1:Interface>
<n1:Language>
<n2:ID id="1" />
</n1:Language>
<n1:PrimaryContact>
<n1:Contact>
<n2:ID id="1903" />
</n1:Contact>
</n1:PrimaryContact>
<n1:Queue>
<n2:ID id="2" />
</n1:Queue>
<n1:ReferenceNumber>140623-000003</n1:ReferenceNumber>
<n1:Source>
<n2:ID id="6006" />
<n2:Parents xsi:type="n2:NamedReadOnlyID">
<n2:ID id="32007" />
</n2:Parents>
</n1:Source>
<n1:StatusWithType>
<n1:Status>
<n2:ID id="1" />
</n1:Status>
<n1:StatusType>
<n2:ID id="1" />
</n1:StatusType>
</n1:StatusWithType>
<n1:Subject>This is a test subject.</n1:Subject>
</itns:Incident>
</itns:Get>
</itns:BatchResponse>

チェーンの使用

チェーンは、常にバッチとともに使用され、Oracle RightNowアダプタのバッチ構成ウィザードで特別の手順を必要としません。

ただし、チェーンを使用するには、前述のサンプル・リクエストに示されているとおり、アダプタ・リクエストで正しいチェーン・ソースと宛先をリンクする必要があります。

次の手順は、Oracle XSLTマッパーによる変換中にチェーンを実行する方法を示しています。

1. Oracle XSLTマッパーで、ターゲット・タイプとしてOracle RightNowアダプタ参照/ビジネス・サービス・リクエスト・タイプをロードします。

2. 異なるオブジェクト例(Incidentなど)にチェーンさせる必要のあるContactオブジェクトを作成する場合、Contact IDを拡張機能ChainSourceIDで置き換えます。

図3-6 XSLTマッパーでの「要素またはタイプの置換」の選択

3. Contactオブジェクトを展開します。

4. ID要素を右クリックし、ポップアップから「要素またはタイプの置換」を選択します。

5. これにより、「要素またはタイプの置換」ダイアログが表示されます。ダイアログで、ChainSourceIDを選択します。

図3-7 「要素またはタイプの置換」ダイアログ

この置換によって、連絡先IDタイプが拡張されます。

図3-8 展開された連絡先IDタイプ

variableNameプロパティに、このチェーン・ヘッドを一意に識別する一意の文字列(MyContactなど)を設定します。

6. インシデントの作成操作中に、チェーンの際に連絡先に対してインシデントが作成されるように、インシデントのPrimaryContactフィールドにChainDestinationIDを設定します。

言い換えると、MyContactのChainDestinationIDがPrimaryContactフィールドに設定されます。

<rno_v1_2:PrimaryContact>
<rno_v1_2:Contact>
<ns1:ID xsi:type="ns1:ChainDestinationID"
variableName="{string ('MyContact' )}"/>
</rno_v1_2:Contact>
</rno_v1_2:PrimaryContact>

7. 同様に、Incidentを作成し、次にそのインシデントに対してGetを実行するには、Incident IDをchainSourceIDで置き換えます。variableNameプロパティに一意の文字列(MyIncidentなど)を設定します。

8. 次に、Get操作で、インシデントIDを拡張機能ChainDestinationIDに置き換え、variableNameプロパティにchainSourceIDの変数名(MyIncident)を設定します。

9. 必要に応じて他のタイプをマップします。

サポートされる処理オプション

処理オプションを使用して、RightNowクラウド操作の実行時にサーバー側処理の特定の機能を有効化および無効化できます。処理オプションは、作成されると、処理オプションを使用する様々なWSDL操作に提供されます。次に、サポートされるすべての処理オプションのリストと、その使用方法およびデフォルト値を示します。この項では、次の内容について説明します。

- CreateProcessingOptions

- バッチ機能の使用

- チェーン

- チェーンの使用

CreateProcessingOptions

作成のプロパティ・タブで指定することで、CreateProcessingOptionsとCreate操作を組み合せて使用できます。CreateProcessingOptionsには、表3-1にリストされているプロパティが含まれます。

表3-1 CreateProcessingオプション

フィールド

説明

SuppressExternalEvents

Create操作の完了後に外部イベントを実行しないことを示すために使用します。デフォルト値は、言語固有です(デフォルト値の詳細は、ドキュメントおよび生成されたクライアント・コードを参照してください)。

SuppressResponse

RightNowアダプタ固有のオプション。このプロパティは、ブール値を使用し、IDをCreate操作に対して返す必要があるかどうかを示します。

SuppressRules

Create操作の完了後にビジネス・ルールを実行しないことを示すために使用します。デフォルト値の詳細は、ドキュメントおよび生成されたクライアント・コードを参照してください。

DestroyProcessingOptions

削除操作のプロパティ・タブで指定することで、DestroyProcessiongOptionsとDelete操作を組み合せて使用できます。DestroyProcessingOptionsには、次のプロパティが含まれます。

表3-2 DestroyProcessingオプション

フィールド

説明

SuppressExternalEvents

Destroy操作の完了後に外部イベントを実行しないことを示すために使用します。デフォルト値の詳細は、ドキュメントおよび生成されたクライアント・コードを参照してください。

SuppressRules

Destroy操作の完了後にビジネス・ルールを実行しないことを示すために使用します。デフォルト値の詳細は、ドキュメントおよび生成されたクライアント・コードを参照してください。

GetProcessingOptions

取得操作のプロパティ・タブで指定することで、GetProcessiongOptionsとGet操作を組み合せて使用できます。GetProcessingOptionsには、次のプロパティが含まれます。

表3-3 GetProcessingオプション

フィールド

説明

FetchAllNames

すべてのNamedIDタイプにそのフィールドの名前とIDの両方を含めるようにサーバーに指示します。非常に効率が悪い場合およびすべての名前とIDのフィールドが必要な場合にのみこれを使用してください。すべての名前とIDのフィールドが必要でない場合、このオプションは使用しないでください(詳細は、Get操作を参照してください)。

UpdateProcessingOptions

更新操作のプロパティ・タブで指定することで、UpdateProcessingOptionsとUpdate操作を組み合せて使用できます。UpdateProcessingOptionsには、次のプロパティが含まれます。

表3-4 UpdateProcessingOptions

フィールド

説明

SuppressExternalEvents

Update操作の完了後に外部イベントを実行しないことを示すために使用します。デフォルト値は、言語固有です(デフォルト値の詳細は、言語のドキュメントおよび生成されたクライアント・コードを参照してください)。

SuppressRules

Update操作の完了後にビジネス・ルールを実行しないことを示すために使用します。デフォルト値は、言語固有です(デフォルト値の詳細は、言語のドキュメントおよび生成されたクライアント・コードを参照してください)。

ROQLの使用

RightNow Object Query Language (ROQL)機能によって、RightNow Cxデータベースに対する問合せを作成できます。

この項の内容は次のとおりです。

- ROQLの使用

- ROQL問合せ文

- ROQL問合せ文の実行

- ROQLクエリー・ビルダーの使用

- ROQLのアダプタ・サポート

ROQLの使用

操作画面でROQL操作カテゴリを選択する場合、ROQL問合せを入力するフィールドが表示されます。選択した操作に応じて、ROQL文を入力します。

ROQLによって、組織のRightNow Cxデータから特定の情報を検索できます。

この章では、ROQLについて詳しく説明しません。Oracle Service Cloud Connect Web Services for SOAPを参照してください。

ROQL問合せ文

ROQL問合せ文は、Oracle RightNow Cxのデータを問い合せます。問合せ文のテキスト・ボックスは、Oracle RightNow CXに準拠したROQL文で構成されます。

問合せ操作の詳細は、ROQL操作に関する項を参照してください。ROQLの詳細は、Oracle RightNow Connect Web Services for SOAP開発者ガイドのROQLに関する項を参照してください。

ROQL問合せ文

ROQL問合せ文を使用して、RightNow Cxのデータを問い合せます。問合せ文のテキスト・ボックスは、RightNow Cxに準拠したROQL文で構成されます。

問合せ操作の詳細は、ROQL操作に関する項を参照してください。ROQLの詳細は、Oracle RightNow Connect Web Services for SOAP開発者ガイドのROQLに関する項を参照してください。

ROQL問合せ文の実行

問合せを実行してテストできます。「テスト」アイコンをクリックすると、テスト・ダイアログ・ボックスが表示されます。

「問合せテスト」ダイアログには次の領域があります。

- 「問合せ文」および「結果」。「問合せ文」テキスト・ボックスは、問合せ文自体を対象とし、実行された問合せの結果は「結果」ボックスに表示されます。問合せに1つ以上のバインド・パラメータが含まれる場合、それらの値を指定するための1つ以上の入力ボックスが表示されます。

- パラメータ・バインディング。問合せ文に表示されるパラメータ・バインディングの値を入力します。

- 問合せのテスト。クリックして問合せを実行します。

- 結果。問合せの実行に成功すると、テキスト領域にRightNow Cxからの結果が表示されます。

ROQLクエリー・ビルダーの使用

この項では、ROQLクエリー・ビルダーの使用方法について説明します。ROQLクエリー・ビルダーは、統合開発者が負担に感じることが多い各領域に対処します。

このアプローチによって、複雑でエラーのない問合せを簡単に記述できます。このような問合せの記述を実現するため、ROQLクエリー・ビルダーは、次の各項に記載された機能を提供しています。

- 標準およびカスタム・ビジネス・オブジェクトの検出の簡略化

- コンテキストに基づく問合せ構成要素の提案

- オートコンプリートの提供

- 可読性を向上するための別名のサポート

- ROQLを使用したリレーションシップの提案

- クエリー・ビルダーを使用したインラインおよびセマンティック検証の取得

標準およびカスタム・ビジネス・オブジェクトの検出の簡略化

ROQLクエリー・ビルダーは、問合せを構成する際に使用できる潜在的な標準オブジェクトとカスタム・オブジェクトを識別します。この機能の例は次のとおりです。

1. 操作画面で、操作タイプに「ROQL」を選択します。

2. ROQLエディタ・テキスト領域にSelectと入力し、[Ctrl] + [Space]を押します。クエリー・ビルダーに、Oracle RightNow Cxで利用可能な標準およびカスタム・オブジェクトのリストが表示されます。

注意:

作成したカスタム・オブジェクトが操作ページで示されるオブジェクトのリストに表示されない場合、接続ページの「キャッシュのクリア」オプションを選択し、再度接続を行ってRightNow Cxシステムの最新のメタデータを取得してください。

3. あるいは、特定のパッケージを指定して、該当のパッケージで作成されるすべてのカスタム・オブジェクトを表示できます。

コンテキストに基づく問合せ構成要素の提案

ROQLクエリー・ビルダーは、カーソルの位置に基づいて問合せ文字列のコンテキストを自動的に識別します。このコンテキストを使用して、クエリー・ビルダーは、効率的なROQL問合せを記述できるように推奨事項を提供します。この機能は、次のように動作します。

1. ROQL問合せテキスト領域にSelectと入力し、[Ctrl] + [Space]を押すと、クエリー・ビルダーにはすべての標準オブジェクトとビジネス・オブジェクトが表示されます。

2. 同様に、Select Contact from Contact whereという問合せを実行する場合に、where句に続けて[Ctrl] + [Space]を押すと、問合せの調整に使用できるContactオブジェクトのフィールドのリストと、適用可能なキーワードおよび関数が表示されます。

オートコンプリートの提供

オートコンプリート機能によって、複雑なROQL問合せを迅速で効率的な方法で簡単に構築できます。この機能は次のとおりです。

1. 問合せ文字列のSelect Seを使用する場合、Seという用語に続けて[Ctrl] + [Space]を押すと、クエリー・ビルダーによってSeで始まるすべてのオブジェクトが表示されます。

可読性を向上するための別名のサポート

ROQLクエリー・ビルダー機能では、別名がサポートされます。これは、RightNowオブジェクト(Oracle RightNowアダプタにおけるすべてのプライマリ・オブジェクトのベース・クラス)の別名が問合せの対象になっていることを認識し、別名を実際のオブジェクト名として扱います。

オブジェクトに関連付けられたすべての操作を、別名に対して実行できます。

1. 問合せ文字列Select from ServiceCategory S whereで、SはオブジェクトServiceCategoryの別名として設定されます。そのため、ServiceCategoryに関連付けられたすべての操作を、別名Sに対して実行できます。別名に対して実行できる操作の一部は、次のとおりです。

2. 前述の問合せのSelectとfromの間で[Ctrl] + [Space]を押すと、クエリー・ビルダーによってSが表示され、SelectとFromの間にSが配置されることが示されます(ここでは、Select S from ServiceCategory S whereとなります)。

3. 最初のSに続けてドットを入力すると、Service Categoryに関連付けられたすべてのリレーションシップが表示されます。

4. 同様に、この問合せSelect S from ServiceCategory S where Sで、最後のSに続けてドットを入力すると、ServiceCategoryに関連付けられたすべてのフィールドが表示されます。

ROQLを使用したリレーションシップの提案

ROQLでは、リレーションシップ機能がサポートされます。この機能によって、リレーションシップを通じて、あるプライマリ・オブジェクトから別のプライマリ・オブジェクトに到達できます。

ROQLクエリー・ビルダーは、識別済のオブジェクトから到達可能なすべてのリレーションシップを識別してリストします。リレーションシップのリレーションシップをリストできます。

詳細は、Oracle RightNow Connect Web Services for SOAP開発者ガイドを参照してください。

特定のContactの親組織を検索する必要がある場合、ROQLのテキスト領域にSelect Contactと入力して「.」を入力すると、Contactオブジェクトで使用可能なすべてのリレーションシップが表示されます。

クエリー・ビルダーを使用したインラインおよびセマンティック検証の取得

クエリー・ビルダーには、問題のあるテキストの下に赤い波線を描画して強調表示する組込みのインライン・バリデータがあります(ツールチップ・メッセージにエラーを修正するための提案も表示されます)。

クエリー・ビルダー・バリデータは、キーワード、オブジェクト名、リレーションシップ名、フィールド名および関数名のスペル・チェックを実行します。正しく入力されたキーワードは、すべて自動的に青く表示され、それらのキーワードが有効であることが示されます。

ROQLクエリー・ビルダーでは、問合せのセマンティック検証もサポートされます。現在選択されているオブジェクトに対して、指定したリレーションシップまたはフィールド名が無効であることがわかります。

ROQLのアダプタ・サポート

Oracle RightNowアダプタは、オブジェクト問合せ言語を使用してRightNow CXプラットフォームに対してSQLに似た問合せを実行できるようにする問合せサブシステムを提供します。

ROQL問合せ言語は、Object Query Language (OQL)のサブセットと、オブジェクト表記法を処理するために拡張されているSQLに似た問合せ言語に基づきます。

ROQLでは、現在、Query Objects機能のみがサポートされ、Query CSはサポートされません。

問合せ引数

例として次の問合せを使用します。

問合せ引数を使用して問合せを調整します。そのため、前述の例では、LinおよびCAが問合せ引数になります。

Select Contact from Contact where Contact.Name.First = 'Lin' AND Contact.Address.City = 'CA'

問合せパラメータは、アダプタが問合せの実行中に実際の値に置き換える問合せ引数をパラメータ化できる独自の概念です。

SQLと同様に、問合せ言語には、WHERE句でフィルタを渡して検索を調整できる機能があります。この調整は、バインド・パラメータの概念を使用することで可能になります。

バインド・パラメータのサポート

Oracle RightNowアダプタには、バインド・パラメータの形式で問合せ文に入力を行うことができるオプションがあります。

Oracle RightNowアダプタの次の問合せの例を参照してください。orgidの前に追加されたアンパサンド記号の&は、アンパサンドがバインド・パラメータであることを示します。

問合せを実行して、それがバインド・パラメータとともにどのように機能するかを確認するには、「問合せのテスト」をクリックします。

前述のように、問合せによって、バインド・パラメータの値の指定が求められます。

アダプタ問合せに対して生成されたWSDLには、入力スキーマの一部としてバインド・パラメータが含まれます。

図3-9 バインド・パラメータが表示されたWSDLの生成済入力スキーマの一部

アダプタ問合せに対して生成されたJCAファイルは、次のようになります。

例3-7 問合せでバインド・パラメータが使用されている場合に生成されたJCAファイル

<adapter-config name="rightnowReferencePortType" adapter="rightnow" wsdlLocation="../WSDLs/rightnowReference.wsdl" xmlns="http://platform.integration.oracle/blocks
/adapter/fw/metadata">
<connection-factory location=
"cloud/CloudAdapter">
<non-managed-connection managedConnectionFactoryClassName="oracle.cloud.connector.
rightnow.
RightNowConnectionFactory">
<property name="targetWSDLURL"
value="../WSDLs/soap.wsdl"/>
<property name="csfkey" value="csf21"/>
<property name="appID"
value=
"removeWhenAppIdIsHardcodedByRNPlugin"/>
<property name="applicationVersion" value="1_2"/>
</non-managed-connection>
</connection-factory>
<endpoint-interaction
portType="rightnowReferencePortType"
operation="Get">
<interaction-spec className="oracle.tip.adapter.cloud.
CloudInteractionSpec">
<property name="targetOperation" value="Get"/>
<property name="operationPath" value="Get"/>
<property name="gpo.fetchAllNames" value="false"/>
</interaction-spec>
</endpoint-interaction>
</adapter-config>

問合せがパラメータ化されると、Oracle RightNowアダプタによって、そのコンシューマは、リクエスト・ペイロードの一部として問合せパラメータを渡すことができます。

アダプタは、リクエスト・ペイロードの問合せパラメータを動的に置き換えて、サービスの起動時に引数を含むROQL問合せを再構築します。

そのため、アダプタを使用して問合せパラメータを簡単に定義することで、問合せ引数をパラメータ化し、それらのパラメータを実行時に動的にインジェクトできます。

4 RightNowアダプタの高度な概念の理解

この章では、Oracle RightNowアダプタの設計時および実行時の高度な機能について説明します。

この章には、次の機能に関する情報が含まれます。

- SOAP APIの理解

- Oracle RightNow Cxスキーマの多相動作の処理

- クラウドでのカスタム・オブジェクトとの統合

- Oracle RightNowアダプタのセキュリティ管理の理解

- Oracle RightNowアダプタのテスト機能

- Oracle RightNowアダプタの制限および制約の処理

SOAP APIの理解

Oracle RightNowアダプタでは、ビジネス・オブジェクトに対して操作を実行できるようにする接続が必要です。ビジネス・オブジェクトに対する操作に加え、RightNow APIモデルには、Oracle RightNowアダプタがRightNow Cxと通信する場合に使用されるトランザクション・タイプの定義も含まれます。

オブジェクトの理解

Oracle RightNowアダプタでアクションを実行できるオブジェクトには、次の2つのタイプがあります。

- 標準ビジネス・オブジェクト。これらは、Oracle RightNow SaaSアプリケーションによって提供されるオブジェクトです。プライマリ・オブジェクトは、直接作成、読取り、更新および削除できる一意のID (主キー)を持つオブジェクトです。プライマリ・オブジェクトは、すべてRightNow RNObjectから継承されます。プライマリ・オブジェクトには、Oracle RightNow Cxプラットフォームで設定されたライフサイクルはなく、オブジェクトが作成されると、それらは削除されるまでシステム内に存在し続けます。プライマリ・オブジェクトが独自のライフサイクルを持つ一方で、単一のプライマリ・オブジェクトに対して0から複数個存在できるサブオブジェクトは、プライマリ・オブジェクトのコンテキスト内で存在します。したがって、それらのライフサイクルは、プライマリ・オブジェクトのライフサイクルに基づきます。オブジェクトの正確なライフサイクル動作は、メタデータまたはオブジェクト・モデルのドキュメントに含まれるリレーションシップ情報から取得できます。

- カスタム・ビジネス・オブジェクト。カスタム・ビジネス・オブジェクトは、ユーザーによって作成されたオブジェクトです。これは、任意の標準オブジェクトに基づいてモデル化することも、完全に独自のものにすることもできます。作成されると、カスタム・オブジェクトは、標準のプライマリ・オブジェクトのように扱われ、そのように動作します。標準オブジェクトとカスタム・オブジェクトの唯一の違いは、使用されるオブジェクトの名前にあります。プライマリ・オブジェクトの場合、Contactなどのクラス名を使用できます。カスタム・オブジェクトの場合、カスタム・オブジェクトを一意に識別するパッケージ名とカスタム・オブジェクト名の組合せを使用できます。パッケージ名とオブジェクト名は、「.」によって結合されます。たとえば、COというカスタム・オブジェクト・パッケージとPurchasedProductというカスタム・オブジェクトがある場合、このオブジェクトはCO$PurchasedProductとして参照できます。

トランザクションの理解

RightNowアダプタでは、RightNow SaaSアプリケーションによってサポートされるメッセージ交換パターンがサポートされます。これは同期リクエスト(レスポンス・ベースのメッセージ交換パターン)です。BPEL / OSBアプリケーションは、RightNowアダプタに対する同期リクエストを作成してレスポンスを待機します。次に、アダプタは、同じスレッドに対する必要な変換を実行してから、RightNow SOAP APIを使用してRightNow Cxサーバーに対する同期リクエストを作成します。

その後、必要な処理の後にRightNowアプリケーションによって返されたレスポンスが、コール側スレッドに受信されます。アダプタは、変換を実行してからレスポンスをBPEL / OSBベースのクライアント・アプリケーションに戻します。

RightNow Cxオブジェクトに書き込まれるすべての操作(作成や更新など)は、デフォルトでコミットされます。バッチ操作によって、統合開発者は、デフォルトをオーバーライドできます。バッチのサポートの詳細は、「バッチ機能の使用」を参照してください。

Oracle RightNow Cxスキーマの多相動作の処理

Oracle Cloud Connect Web Services for SOAPによって、RNObject (すべてのプライマリRightNowオブジェクト・クラスのベース・クラス)の1つ以上のインスタンスを受け入れる(または返す)複数の操作が定義されます。

この機能によって、同じ操作が多相的に動作するため、入力値と戻り値はRNObjectの導出クラスのどのインスタンスにもなることができます。

この機能は、プログラム言語のバインディングからサブクラス・インスタンスを渡すことで、およびオブジェクトのシリアライズXMLでxsi:type属性を使用することでこの動作を実行します。xsi:typeは、タイプRNObjectの要素で置換される具象タイプを指定します。この動作によって、Oracle Cloud Connect Web Services for SOAPを使用する開発者は、ベース・クラスのRNObjectから継承された任意のタイプのオブジェクトを操作し、RNObjectのインスタンスを予期する任意の操作にそのオブジェクトを渡すことができます。また、開発者は、RNObjectの返されたインスタンスを適切なサブクラスにキャストできます。多相動作の詳細は、Oracle Service Cloud Connect Web Services for SOAPを参照してください。

この多相的な性質のため、ソース・オブジェクトからターゲット・オブジェクトにマッピングするユーザー・エクスペリエンスは、RNObjectを継承する標準オブジェクトについては少し複雑です。カスタム・オブジェクトとカスタム属性の場合、さらに複雑です。

Oracle RightNowアダプタは、標準オブジェクト、カスタム・オブジェクトおよびカスタム・フィールドの第1級オブジェクトとして要素定義を昇格することで、複雑な変換を作成する際に実行する必要のある手順の数を削減し、ソースからターゲット定義にマッピングする作業を簡略化します。

例: カスタム・オブジェクトのマッピング

次に、Oracle RightNowアダプタがある場合とない場合のカスタム・オブジェクトのマッピング・エクスペリエンスのサンプルを示します。この例は、一般的ではない可能性がありますが、マッピング・エクスペリエンスと、Oracle RightNowアダプタがある場合とない場合の処理の違いを理解するために役立ちます。

最初の例は、Oracle RightNowアダプタを使用しないでOracle RightNowカスタム・オブジェクトをマッピングする方法を示しています。2番目の例は、同じマッピングを示していますが、大幅に簡略化されているところが異なります(アダプタによってプロセスが簡略化されます)。

例: Oracle RightNowアダプタを使用しないオブジェクトのマッピング

この項では、Oracle RightNowアダプタを使用せずにカスタム・オブジェクト・インスタンスを作成する方法について説明します。このシナリオでは、SOAコンポジットを作成し、Webサービス・アダプタを使用してRightNowサービスのクライアントを作成します。次に、XSLTマッパーを使用してクライアント・ソース・スキーマからカスタム・オブジェクト・スキーマへのデータ・マッピングを作成する場合に必要な手順を示します。

図4-1を参照してください。

1. XSLTエディタのターゲット・スキーマ・ノードRNObjectで、右クリックして「要素またはタイプの置換」を選択し、汎用オブジェクトを選択します。

2. Object ObjectType→TypeNameに設定します(RightNowで作成されたRightNow CustomObject名の値)。

3. GenericFields→dataTypeに設定します(STRINGやINTEGERなど、カスタム属性のデータ型の値)。

4. GenericFields→nameに設定します(カスタム属性の名前)。

5. GenericFields→DataValue→StringValueに設定します(属性の値)。

図4-1 Oracle RightNowアダプタが生成するWSDLを使用せずにXSLTマッパーを使用してスキーマのRightNowカスタム・オブジェクトをマップする方法

ソース・ビューは次のとおりです。

図4-2 ソース・モードのサンプルXSLファイル

例: Oracle RightNowアダプタを使用したオブジェクトのマッピング

この項では、Oracle RightNowアダプタを使用してカスタム・オブジェクト・インスタンスを作成する方法について説明します。SOAコンポジットを作成し、Webサービス・アダプタを使用して統合が容易なOracle RightNowアダプタが生成するWSDLのクライアントを作成します。

次の手順によって、XSLTマッパーを使用してクライアント・ソース・スキーマからカスタム・オブジェクト・スキーマへのデータ・マッピングを作成します(スキーマは、厳密に型指定され、Oracle RightNowアダプタが生成する統合が容易なWSDLから参照されます)。カスタム・オブジェクトは、次に示すとおり、直接マッパーのフィールドとなる生成されたローカルWSDLマップの第1クラス・エンティティです。

クラウドでのカスタム・オブジェクトとの統合

カスタム・オブジェクトは、ユーザーによって作成されたオブジェクトです。これは、任意の標準オブジェクトに基づいてモデル化することも、完全に独自のものにすることもできます。また、スタンドアロン・オブジェクトにすることも、既存の標準オブジェクトの子にすることもできます。

RightNow Cxサーバーでのカスタム・オブジェクトの作成

RightNow Cxサーバーでカスタム・オブジェクトを作成するには、次の手順を実行します。

1. Oracle RightNow Cxクライアントにログインし、「RightNow Cxでのアクセス制限パーミッションの構成」の手順に従います。

2. ナビゲーション・ペインの「環境設定」をクリックします。

3. 「データベース」の下の「オブジェクト・デザイナ」をダブルクリックします。コンテンツ・ペインにオブジェクト・デザイナが表示されます。

4. カスタム・オブジェクトを追加するパッケージを選択するか、リボンの「新規」をクリックして「パッケージ」を選択し、オブジェクト用の新しいパッケージを作成します。パッケージの名前を入力します。パッケージ名の長さは、2から11文字の間にする必要があります。

5. リボンの「新規」をクリックして「オブジェクト」を選択します。オブジェクトのサマリー・ページが表示されます。

図4-3 オブジェクトのサマリー・ページ

6. 「名前」フィールドにオブジェクトの名前を入力します。

7. リボンの「フィールド」をクリックしてオブジェクトに定義済フィールドまたはカスタマイズ済フィールドを追加し、カスタム・フィールドを追加します。詳細は、Oracle RightNow Connect Web Services for SOAPのドキュメントを参照してください。

8. リボンの「保存&閉じる」ボタンをクリックしてカスタム・オブジェクトに変更を保存します。「保存」または「保存&閉じる」ボタンがクリックされると、RightNowによる検証が実行されます。フィールド名の欠落など、検証エラーがメッセージに表示されたら、オブジェクトを保存する前にそれを修正する必要があります。

9. 準備ができたらカスタム・オブジェクトをデプロイします。

カスタム・オブジェクトの選択による操作の実行

カスタム・オブジェクトを作成すると、「操作」ページでの操作の実行対象となるオブジェクトを選択できます。

カスタム・オブジェクトを選択すると、統合の容易なWSDLが、厳密に型指定された形式のカスタム・オブジェクト・スキーマとともに生成されます。図4-4は、生成されたカスタム・オブジェクト・スキーマの非標準的なサンプルを示しています。

図4-4 カスタム・オブジェクト・スキーマの例

Oracle RightNowアダプタのセキュリティ管理の理解

Oracle RightNowアダプタでは、Oracle RightNowアダプタ構成ウィザード内での接続の構成中に取得された資格証明を格納するために、資格証明ストア・フレームワークを使用します。これによって、構成中に取得された資格証明が、セキュアな形式で格納され、SOAコンポジットやOracle Service Busフローとともに格納されないことが保証されます。

アダプタは、実行時に、設計時に指定されたCSF_KEYに基づいて資格証明ストア・フレームワークから自動的に資格証明を取得します。これらの資格証明は、認証のためにRightNow Cxサーバーに送信されるドキュメントのSOAPヘッダーにインジェクトされます。

アカウント・パスワードによるOracle RightNow Cxサーバーでの認証

次の項では、アカウント・パスワードを使用してOracle RightNow Cxサーバーで認証を行う方法について説明します。この項の内容は次のとおりです。

- Oracle RightNow CXサーバーでのアクセス制御の理解

- RightNow Cxでのアクセス制限パーミッションの構成

Oracle RightNow CXサーバーでのアクセス制御の理解

Oracle Cloud Connect Web Services for SOAP APIがリクエストを受信すると、一連のアクセス制御方法が強制されます。

1. APIがサイト・レベルで有効になっていることを確認するため、サイト構成がチェックされます。

2. リクエストに指定されているユーザー資格証明が検証されます。

3. 適切なプロファイル・ビットが有効になっていることを確認するため、指定されたアカウントのプロファイルがチェックされます。プロファイルは、管理機能に対するアクセスの制御と、スタッフ・メンバー固有のパーミッション、デフォルトのワークスペース、デフォルトのナビゲーション・セットおよびレポート・アクセスの割当てを行うためのメカニズムです。

注意:

サーバー側のアクセス制御は、Oracle Cloud Connect Web Services for SOAPによって作成されるすべてのコアAPIコールに対して強制されます。現在のパーミッションは、Oracle RightNowのプロファイル・パーミッション・エディタの読取り、編集、削除および移動の各チェック・ボックスにマップされます。サーバー側のアクセスは、2013年5月以降の新しいサイトではデフォルトで有効化されますが、2013年5月のリリースより前にアップグレードされたサイトでは無効化されます。既存のOracle RightNowユーザーで、サイトを2013年5月以降のビルドにアップグレードする予定の場合、このセキュリティ強化機能を有効化するようにカスタマ・サポートに連絡してください。

すでにサーバー側のアクセス制御が現在のサイトで有効化されている場合、プロファイル・パーミッションの変更は慎重に行ってください。Oracle RightNow管理者がOracle Cloud Connect Web Services for SOAP統合のプロファイルに対するパーミッションを変更すると、それによって統合が破損する可能性があります。

Oracle Cloud Connect Web Services for SOAPのサイト構成

Oracle Cloud Connect Web Services for SOAPへのアクセスは、それが有効化されているサイトでのみ可能です。Oracle Cloud Connect Web Services for SOAPが有効でない場合、APIが動作せず、リクエスト・エラーが返されるため、Oracleアカウント・マネージャに連絡してください。

リクエスト・エラーは、検証の失敗やインバウンド・リクエストのデータ関連エラーが存在する場合には常に生成されます。例外コードはACCESS_DENIEDで、メッセージはSOAP_SERVER_DISABLEDのメッセージ・ベース文字列になります。

リクエスト・エラーと例外コードの詳細は、Oracle Connect Web Services for SOAPを参照してください。

Oracle RightNow Cxを通じてスタッフ・アカウントを認証するには、Oracle RightNow Cxのプロファイル・パーミッション・エディタでそのプロファイルを更新しておく必要があります。パーミッションのチェック・ボックスは、「スタッフ・マネジメント」→「プロファイル」→「パーミッション」にあります。

図4-5 パーミッションのチェック・ボックスの場所

また、RightNow Cx管理者は、Oracle RightNow Cxプラットフォームの構成設定を使用して、IPアドレスによってOracle Cloud Connect Web Services for SOAP統合へのアクセスを制限できます。次の設定は、「サイト構成」→「環境設定」にあります。

- SEC_PAPI_INTEG_HOSTS_SOAP: SOAPインタフェースに対するアクセスを許可するホストを定義します。有効なエントリには、ワイルドカード、特定のIPアドレス、またはIPサブネット・マスク(*.rightnow.com、1.2.3.4、10.11.12.0/255.255.255.0など)を含むドメイン名のカンマ区切りのリストがあります。
このリストのエントリに一致するホストからログインしているユーザーのみが、SOAPインタフェースへのアクセスを許可されます。デフォルトは空白です。

RightNow Cxでのアクセス制限パーミッションの構成

アクセス制限パーミッションを構成するには、次の手順を実行します。

1. Oracle RightNow Cxクライアントをインストールします。

2. ワークステーションにインストールされたOracle RightNow Cxクライアントにログインします。すぐにアプリケーションの構成とカスタマイズを開始できます。

将来同じサイトにアクセスするには、「スタート」メニュー→「すべてのプログラム」→「RightNow」→「RightNow (<site_name>)」を選択してクライアントを起動します。クライアント・アプリケーションは、サイト・ベースのため、アクセスするサイトごとに個別のクライアントをデプロイする必要があります。

ただし、1つのクライアント・アプリケーションを使用して、1つのサイトのすべてのインタフェースにアクセスできます。インタフェースは、クライアントのデプロイと同じ方法でクライアントに追加されます。

インタフェースの「準備完了」ページにアクセスし、「Oracle RightNow CX Cloud Serviceのインストール」ボタンをクリックすると(Oracle RightNow Cxユーザーズ・ガイドを参照)、デプロイメント・ツールによって、クライアントの「ログイン」ウィンドウの「インタフェース」ドロップダウン・メニューにインタフェースが追加されます。

3. SEC_PAPI_INTEG_HOSTS_SOAP設定を構成します。Oracle RightNow CXユーザーズ・ガイドを参照してください。

アカウント資格証明の検証

リクエストがAPIに送信され、サイト構成が検証されたら、次の手順では、アカウント資格証明を検証します。資格証明が確認されないと、リクエスト・エラーが返されます。例外コードはINVALID_LOGINで、メッセージはメッセージ・ベース文字列LOGIN_ID_PASSWD_COMBINATION_INV_MSGになります。

プロファイル構成

セキュリティ・ヘッダーで使用されるスタッフ・アカウントのプロファイルでは、「公開SOAP API」プロファイル・ビットを有効にする必要があります。このビットが有効でない場合、リクエスト・エラーが返されます。例外コードはACCESS_DENIEDで、メッセージはメッセージ・ベース文字列PROFILE_NO_SOAP_ACCESS_MSGになります。

パスワード・ベースの認証

Web Services Policy 1.2を使用するOracle Cloud Connect Web Service for SOAPは、http://specs.xmlsoap.org/ws/2004/09/policy/ws-policy.pdfでクライアント認証が定義されています。

セキュリティ・ポリシーのサポートXSDは、http://schemas.xmlsoap.org/ws/2004/09/policy/ws-policy.xsdにあります。

シングル・サインオンで認証するには、「Authenticating with SAML 2.0」を参照してください。

WS-Security仕様では、次のネームスペースのSOAPヘッダーにSecurityタグが必要です。

http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd

Securityタグの内部に、UsernameTokenタグ(WS-Security UsernameToken Profile 1.0仕様の一部)があります。UsernameTokenタグには、Username、Password、NonceおよびCreatedの各要素が含まれます。Password要素には、Password要素の内容がPasswordTextであるかどうかを指定するType属性が含まれます。Oracle Cloud Connect Web Services for SOAPでは、PasswordDigestはサポートされません。

NonceおよびCreated要素はサポートされません。PasswordDigestタイプやCreated/Nonce要素が含まれるリクエストを受信すると、サーバーは、不正な形式のリクエストとしてそのリクエストを拒否します。

次に、ユーザー名とパスワードの資格証明を含むSOAPリクエストの例を示します。

例4-1 ユーザー名とパスワードの資格証明を含むSOAPリクエストの例

soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004
/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
soapenv:mustUnderstand="1">
<wsse:UsernameToken
xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/
oasis-200401-wss-wssecurity-utility-1.0.xsd"
wsu:Id="UsernameToken-3902281">
<wsse:Username>comland</wsse:Username>
<wsse:Password Type=
"http://docs.oasis-open.org/wss/2004
/01/oasis-200401-wss-username-token-profile-1.0
#PasswordText">Connect1</wsse:Password>
</wsse:UsernameToken>
</wsse:Security>
</soapenv:Header>
</soapenv:Envelope>

Oracle RightNowアダプタのテスト機能

テスト機能は、2つの形式で使用可能なOracle RightNowアダプタに特有の機能です。

第1の形式では、接続パラメータをテストできます。第2の形式では、ROQL問合せを検証して実行できます。

次の項では、これらの2つの機能について詳しく説明します。

設計時のテスト機能の詳細

設計時のテスト機能には、次のテスト機能が含まれます。

注意:
Oracle JDeveloperのプロキシ設定を、外部SaaSのアプリケーションURLに接続するように設定してあることを確認してください。そうでない場合は、タイムアウトのエラーが発生します。

- RightNow CX Cloud接続のテスト: Oracle RightNowアダプタ構成ウィザードの接続ページにテスト・ボタンがあります。
「テスト」をクリックすると、次のいずれかのメッセージが表示されます。

- 成功 - 接続に成功した場合

- 失敗 - ログイン中に例外が発生した場合

- 問合せテスト・ツール: このツールによって、問合せを実行してテストします。Oracle RightNowアダプタ構成ウィザードの操作ページで「ROQL」を選択すると、問合せ文テキスト・ボックスと、問合せ結果を示した結果ボックスが含まれるテスト・ダイアログ・ボックスが表示されます。

Oracle RightNowアダプタの制限および制約の処理

このアダプタには、次の制限および制約が適用されます。これには次のものがあります。

- 削除カスケードの削除効果

- RightNow Cxサーバーにより強制されるAPI制限

削除カスケードの削除効果

破棄削除操作でOracle RightNowアダプタを使用する場合、カスケード削除効果が発生します。

プライマリ・オブジェクトは、削除操作を通じて直接削除されます。プライマリ・オブジェクトを破棄するには、オブジェクトのインスタンスがインスタンス化され、IDプロパティが設定されている必要がありますが、他のフィールドが移入されている必要はありません。プライマリ・オブジェクトが削除されると、その操作は関連するプライマリ・オブジェクトにもカスケードされる可能性があります。

カスケード削除効果の詳細とカスケード削除効果の原因となる集約の概要は、Oracle RightNow Connect Web Services for SOAP開発者ガイドを参照してください。

RightNow Cxサーバーにより強制されるAPI制限

Oracle Cloud Connect Web Services for SOAPの使用に制限はありませんが、RightNow Cxサーバーによって強制される事実上の制限があります。

Oracle RightNowアダプタの使用に関連する2つの重要な制限があります。

- SOAPリクエスト当たり100個のバッチ・アイテム。バッチ操作によって、100個のアイテムのハード制限が強制されます。この制限を超えると、操作の完了前にフォルトが返されます。制限を超えると、バッチ・アイテムは処理されません。

- 個々の作成、取得、更新および破棄操作は、1000個のアイテムに制限されます。RightNow Cxサーバーは、最初にリクエスト内のアイテム数を確認し、アイテム数が1000個を超える場合、またはそのアイテム数が原因となってアイテムの合計数がリクエストの最大値を超える場合、RightNow Cxサーバーは例外をスローしてリクエストの処理を行いません。

- SOAPリクエスト当たり10,000個の合計入力オブジェクト。マルチオブジェクトのCreate、Get、UpdateおよびDestroy操作とバッチ操作の組合せは、SOAPリクエスト当たり10,000個の合計入力オブジェクトに制限されます。RightNow Cxは、作成、取得、更新および破棄操作によって管理されるオブジェクトの累計を維持します。バルク操作が1つ発生するたびに、リクエストで処理されるオブジェクトの合計数にアイテムの数が追加されます。
バッチ操作の処理は、10,000個のオブジェクトの制限に到達するまで発生します。到達すると、10,000個の制限の原因となった操作は終了し、フォルトが返されます。入力オブジェクトを含まないバッチ・リクエスト内の操作の実行は、継続されます。

これらの3つの制限(100、1000、10000)は、別個に扱われます。いくつかの操作は、バルク制限と合計操作制限の両方に影響します(作成、取得、更新および破棄など)。

詳細は、Oracle RightNow Connect Web Services for SOAP開発者ガイドを参照してください。

5 サービス・コンポーネントとのBPEL統合の理解(BPEL/メディエータ)

この章には次の項があります。

- 概要

- サービス統合のためのコンポジットの設計

- Oracle RightNowアダプタの構成

- BPELとの統合

- コンポジットのデプロイ

- コンポジットのテスト

概要

Oracle BPEL Process Managerと統合するには、ユーザーが組織のエンタープライズWSDLを使用できる必要があります。基礎となるアダプタ・サービスは、WSDLファイルとして公開されます(これらのファイルは、Oracle RightNowアダプタ構成ウィザードで設計時に生成されます)。

生成されたWSDLファイルを使用して、アウトバウンド・アダプタ・サービスの適切なBPELプロセスを設計します。完成したBPELプロセスは、JDeveloperで正常にコンパイルされ、SOA Suiteサーバーにデプロイされる必要があります。SOA Suiteサーバーにデプロイすると、新しくデプロイされた各プロセスは、すぐにOracle Enterprise Manager Fusion Middleware Controlで表示可能となり、そこでBPELプロセスの実行、モニター、管理、およびアダプタ・イベントのモニターを行うことができます。

アカウント・オブジェクトの理解

アカウント・オブジェクトを作成し、WSDLをOracle BPEL Process Managerに統合します。アカウントは、RightNowによって提供される標準オブジェクトの1つで、RightNow Cxシステムのスタッフ・メンバーに対して生成されるアカウントです。顧客サービス担当、販売代理店およびサイト管理者は、アカウントを使用します。

具体的には、RightNow Cxのアカウント・オブジェクトは、ビジネスに関連付けられた個人またはビジネスを表します。

Oracle RightNowアダプタによって、RightNow Cxでアカウント・オブジェクトを作成できます。

サービス統合のためのコンポジットの設計

次の手順では、Oracle Fusion Middlewareアプリケーションを開発するための総合ツールであるOracle JDeveloper Studio Editionを使用してコンポジットを設計する方法について説明します。これにより、統合を効率的に作成できる使いやすい統合開発環境が提供されます。

BPELおよびメディエータのコンポジットの定義

BPELおよびメディエータのコンポジットを定義するには、次の手順を実行します。

1. JDeveloperの「ファイル」メニューで、「新規」をクリックして「アプリケーション」を選択します。

図5-1 ナビゲーション

JDeveloperに「新規ギャラリ」ページが表示されます。「項目」リストから「SOAアプリケーション」を選択します。

図5-2 SOAアプリケーションの作成

2. アプリケーションに適切な名前を指定します。

図5-3 アプリケーションの名前付け

3. 「次へ」をクリックしてプロジェクトに適切な名前を指定します。

図5-4 プロジェクトの名前付け

4. 「次へ」をクリックします。

5. 「標準コンポジット」リストから「BPELプロセスを使用するコンポジット」を選択します。

図5-5 SOA設定の構成

6. 「終了」をクリックします。

7. 「テンプレート」ドロップダウン・リストから「同期BPELプロセス」を選択し、「OK」をクリックします。

図5-6 BPELプロセスの作成

composite.xmlファイルが表示されます。

図5-7 composite.xmlファイル

8. アプリケーション・ナビゲータの「スキーマ」フォルダに、Oracle JDeveloperは、BPELプロセスの作成後にBPELProcess1.xsdという名前でXMLスキーマ・ファイルを表示します。

図5-8 XMLスキーマ・ファイル

9. ビジネス・ニーズに応じてこのスキーマ・ファイルを編集します。データ検証の強制と、SOAからOracle RightNow Cxサーバーに送信される入力にエラーがないことの確認は、フロントエンド・アプリケーションが担当します。

この使用例でのスキーマの構造は、次のとおりです。

図5-9 XMLスキーマ・ファイルの編集

Oracle RightNowアダプタの構成

新しいOracle RightNowアダプタを構成するには、次の手順を実行します。

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

1. composite.xmlファイルの「外部参照」スイムレーンで、右クリックして「Oracle RightNowアダプタ」を選択します。

2. Oracle JDeveloperに基本情報画面が表示されます。

3. わかりやすい名前とオプションの説明を入力します。

4. 「次へ」をクリックします。

5. JDeveloperに「接続」ページが表示されます。WSDL URL/場所、セキュリティ・ポリシーおよび認証キーの詳細を指定する必要があります。

6. WSDLを選択します。

a. ファイル・システムで使用できるWSDLが存在する場合、画面のWSDLの右側にある「既存のWSDLを検索します。」アイコンをクリックします。JDeveloperに「WSDLチューザ」ダイアログが表示されます。ダウンロードしたエンタープライズWSDLを検索して選択し、「OK」をクリックします。

7. 「OK」をクリックします。

8. 「OK」をクリックします。「接続」ページに戻ります。

9. 別の方法として、MDSの場所にWSDLを格納してアクセスできます。次のスクリーンショットは、MDSの場所にWSDLを格納する方法を示しています。

図5-10 MDSの場所へのWSDLの格納

10. 「IDE接続」→「SOA-MDS」に移動します。エンタープライズWSDLを配置した適切なSOA-MDS接続を選択します。アダプタ構成で使用するWSDLファイルを選択し、「OK」をクリックします。

11. WSDLが次の形式であることを確認します。

oramds:/apps/SOA/WSDLs/Integration/rightnowAPI.wsdl

別の方法として、https URLを直接指定します。

https://integration-test.rightnowdemo.com/cgi-bin/integration_test.cfg/services/soap?wsdl

12. 「OK」をクリックします。

13. 「+」ボタンをクリックして新しい認証キーを作成します。

14. 適切な名前とRightNow資格証明を指定し、「OK」をクリックします。

15. 「テスト」ボタンをクリックして認証キーを検証します。

16. 「次へ」をクリックします。

Oracle JDeveloperに「操作」ページが表示されます。

図5-11 Oracle RightNowアダプタの「操作」画面

17. RightNowでアカウントを作成する必要があるため、「操作タイプの選択」リストからCRUD操作とCreate操作を選択します。

同じ画面で、「選択可能」オブジェクトのリストから「選択済」オブジェクトのリストにAccountを移動します。

18. 画面の右上隅で、「処理オプション」リンクをクリックします。

19. 要件の処理オプションを選択します。このページに表示されるプロパティは、前のページで選択した操作に応じて異なります。この場合、「レスポンスの抑制」チェック・ボックスが選択され、レスポンスの抑制が無効化されて、falseになります。これを選択すると、Create操作によって、作成中のバッチ操作インスタンスの有効なIDが返されます。

20. 「次へ」をクリックします。JDeveloperに、選択した操作の完全な概要、操作対象のオブジェクト、およびその操作に選択したヘッダーが示された「サマリー」ページが表示されます。

21. 「終了」をクリックして、Oracle RightNowアダプタ構成ウィザードを完了します。

図5-12 「外部参照」スイムレーンにアダプタが表示された「サービス」、「コンポーネント」および「外部参照」画面

BPELとの統合

BPELとの統合を実現するには、次の手順を実行します。

1. ワイヤを使用してBPELProcess1とServiceCloudCreateAccountを接続します。

図5-13 ワイヤを使用して接続されたBPELProcess1とRightNowAccount外部参照

2. ワイヤでの接続後、コンポジットが表示されます。

図5-14 サービス、BPELProcessおよび参照がワイヤ接続されたコンポジット・アプリケーション

3. BPELProcess1をダブルクリックして開きます。Oracle RightNowアダプタは、パートナ・リンクの一部として表示されます。

図5-15 パートナ・リンクの一部として表示されたOracle RightNow参照アダプタ

4. invokeアクティビティを追加してServiceCloudCreateAccountパートナ・リンクを起動します。invokeアクティビティを追加するには、次の手順を実行します。

a. BPELコンストラクトからinvokeアクティビティをドラッグ・アンド・ドロップします。

図5-16 invokeアクティビティ

b. キャンバスにinvokeプロパティをドロップしたら、invokeアクティビティをServiceCloudAdapterパートナ・リンクにワイヤ接続します。

5. パートナ・リンクへの入力変数を作成するため、「変数」セクションの「入力」テキスト・ボックスの横にある「+」ボタンをクリックします。JDeveloperに「変数の作成」ダイアログが表示されます。

図5-17 パートナ・リンクの入力変数を作成するための「変数の作成」ダイアログ

6. パートナ・リンクからの出力変数を作成するため、「変数」セクションの「出力」テキスト・ボックスの横にある「+」ボタンをクリックします。ウィザードに「変数の作成」ダイアログが表示されます。

図5-18 出力変数を作成するための「変数の作成」ダイアログ

7. 2つのtransformアクティビティを、1つはinvokeアクティビティの前に、もう1つはその後に配置します。

図5-19 BPELダイアグラムでの2つのtransformアクティビティ

8. Transform1の値をreceiveアクティビティの入力変数からinvokeアクティビティの入力変数にマップします。

図5-20 Transform1の値をreceiveアクティビティの入力変数からinvokeアクティビティの入力変数にマップする方法

9. 「マッパー・ファイル」テキスト・ボックスの横にある「+」ボタンをクリックしてTransformation_1.xslファイルを開きます。

10. inputVariableとInvoke1_create_InputVariableを次のようにマップします。

- Account_NameとNameをマップします。

- PhoneとPhoneをマップします。

- WebsiteとWebsiteをマップします。

- DescriptionとDescriptionをマップします。

図5-21 inputVariableとInvoke1_create_InputVariableのマップ

11. Transform2の値をinvokeアクティビティの出力変数からreplyアクティビティの入力変数にマップします。

図5-22 Transform2の値をinvokeアクティビティの出力変数からreplyアクティビティの入力変数にマップする方法

12. 出力変数をマップします。

図5-23 出力変数のマップ

これで、プロジェクトの作成は完了です。JDeveloperにcomposite.xmlファイルが表示されます。

コンポジットのデプロイ

コンポジット・アプリケーションをデプロイするには、次の手順を実行します。

1. アプリケーション・ナビゲータ・ペインで、「Project1」を右クリックして「デプロイ」→「Project1」を選択します。

図5-24 プロジェクトのデプロイ

2. 「アプリケーション・サーバーへのデプロイ」オプションを選択して指示に従います。このオプションを使用すると、サーバーの詳細を指定してアプリケーション・サーバーにコンポジットをデプロイできます。

コンポジットのテスト

Oracle Fusion Middleware Controlコンソールで、デプロイしたSOAコンポジット・アプリケーションのインスタンスを実行およびテストできます。これを実行することで、コンポジット・アプリケーションの管理、コンポジットのインスタンスの開始と追跡、および詳細なコンポーネント・インスタンス監査証跡の表示を行うことができます。

次の手順は、コンポジットをテストする方法を示しています。

アウトバウンド・プロセスのテスト

アウトバウンド・プロセスをテストするには、次の手順を実行します。

1. プロジェクトをデプロイしたサーバーのFusion Middlewareコンソールにログインします。

2. 「デフォルト」パーティションの下のProject1を開きます。

3. 「テスト」ボタンをクリックしてWebサービスをテストします。

図5-25 「テスト」ボタン

4. 入力ペイロードを指定して「Webサービスのテスト」ボタンをクリックします。

図5-26 Webサービスのテスト

実行に成功すると、レスポンスに、RightNowで作成されたアカウントのIDと「success」というステータスが含まれます。

図5-27 RightNow Cxで作成されたアカウントのIDを含むテスト・レスポンス

6 Oracle RightNowアダプタとのOracle Service Bus統合の開発

この項では、Oracle Service Bus ConsoleとOracle JDeveloperを使用してOracle Service Busプロジェクトを作成する方法について説明します。これらのプロジェクトを作成するには、最初にOracle JDeveloper 12cを使用してOracle RightNowアダプタ・アーティファクトを生成し、次にそれらのアーティファクトを使用しながらOracle Service Bus ConsoleでOracle Service Busプロジェクトおよびサービスを作成する必要があります。

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

- Oracle Cloudアダプタ・アーティファクトの生成

Oracle Cloudアダプタ・アーティファクトの生成

Oracle Service Bus Consoleを使用してOracle Service Busプロジェクトを作成するには、Oracle JDeveloperによって生成されたOracle RightNowアダプタ・アーティファクトを使用する必要があります。BPELコンポジットを作成するには、「サービス統合のためのコンポジットの設計」を参照してください。

「Oracle RightNowアダプタの構成」で生成したアーティファクトを使用して、Oracle Service Bus ConsoleでOracle Service Busビジネス・サービスを作成します。

Oracle Service Bus Consoleを使用したOracle Service Busプロジェクトの作成

Oracle Service Bus Consoleを使用して、Oracle Service Busプロジェクトおよびサービスを作成します。

1. Oracle Service Bus Console (http://hostname:port/servicebus)にログインします。

2. ページの右側の「作成」をクリックします。これによって、Oracle Service Bus Consoleに新しいセッションが開かれ、変更が可能になります。

図6-1 Oracle Service Busセッションの作成

3. 「すべてのプロジェクト」を右クリックし、「作成」→「プロジェクト」をクリックします。

図6-2 Oracle Service Busへの新規プロジェクトの追加

4. Oracle Service Bus Consoleに、「新規プロジェクトの作成」ダイアログ・ボックスが表示されます。

5. 「リソース名」フィールドにプロジェクト名を入力し、「説明」フィールドに説明を指定します。

図6-3 新規プロジェクト・ページの作成

6. 「作成」をクリックします。RightNow Createという新しいプロジェクトが、「すべてのプロジェクト」の下に表示されます。

7. このプロジェクトにOracle RightNowアダプタ・アーティファクトをインポートします。作成されたプロジェクト名を右クリックします。「作成」→「WSDL」を選択します。

図6-4 WSDL参照の選択

コンソールにWSDLの作成ページが表示されます。

8. 「参照」をクリックし、Oracle JDeveloperから受け渡されたアーティファクトが格納されているディレクトリを参照します。RightNow WSDLのOracle Cloudアダプタを選択します。

図6-5 WSDLの作成

9. 「作成」をクリックします。

10. プロジェクト名を右クリックし、メニューから「作成」→「WSDL」を選択します。

11. WSDLの作成ページで、rightnowReference WSDLを検索します。

図6-6 rightnowReference WSDL

12. 「作成」をクリックします。

13. プロジェクト名の「作成」ドロップダウン・リストからJCAバインドを選択します。

図6-7 「作成」ドロップダウン・リストからのJCAバインドの選択

JCAバインドの作成ダイアログ・ボックスが表示されます。

14. 「参照」をクリックし、Oracle JDeveloper 12cから受け渡されたアーティファクトが格納されているディレクトリに移動します。RightNow JCAファイルのOracle Cloudアダプタを選択します。

図6-8 RightNowアダプタJCAファイルの選択

15. 「作成」をクリックします。「プロジェクト」ページに戻ります。「JCAバインド"rightnowReference_rightnow"が正常に作成されましたが、検証エラーが発生しています。JCAバインド/競合を表示して、詳細な診断メッセージを参照してください。」などのエラー・メッセージが表示されることがあります。

このエラーは、JCAバインドが関連するWSDLを検出できない場合にスローされます。エラーが発生した場合に修正するには、作成したJCAファイルをクリックしてから「編集」をクリックします。

16. 「参照」をクリックします。作成したWSDLを検索し、WSDLの選択後に「発行」をクリックします。

図6-9 JCAバインド参照の編集

17. 「保存」をクリックします。

18. プロジェクト・フォルダに移動します。作成したJCAバインドを右クリックし、WSDLとサービスの生成オプションをクリックします。

図6-10 JCAバインドからのWSDLとサービスの生成

19. 新規WSDL名フィールドにWSDLの新しい名前を入力し、新規サービス名フィールドにサービス名を入力します。

注意:

生成される新しいWSDLおよびサービスのための適切な場所を選択します。

20. 「生成」をクリックします。

図6-11 WSDLとサービスの生成

コンソールによって、新しいWSDLと新しいビジネス・サービスが生成されます。

21. 右隅の「アクティブ化」をクリックしてOracle Service Busセッションをアクティブ化します。

図6-12 セッションのアクティブ化

コンソールにセッションのアクティブ化の確認ダイアログ・ボックスが表示されます。

22. 「アクティブ化」をクリックしてセッションをアクティブ化します。

図6-13 セッションのアクティブ化の確認

23. 「アクティブ化」をクリックしてセッションをアクティブ化します。

Service Busプロジェクトの作成とOracle Service Bus JCAビジネス・サービスの生成

この項では、JDeveloperを使用してService Busプロジェクトを作成する方法について説明します。ここには、Oracle RightNowアダプタを使用してOracle Service Bus JCAビジネス・サービスを生成する場合の情報も含まれます。ここでは、最初にOracle Service Busの空のコンポジットを作成する方法について、次にOracle Service Busアウトバウンド・プロセスを定義する方法について、最後にそのOracle Service Busプロジェクトをサーバーにデプロイする方法について説明します。

Oracle Service Busの空のコンソールの作成と新しいService Busプロジェクトの作成

Oracle Service Busの空のコンポジットを作成するには、次の手順を実行します。

1. 新しいOracle Service Busアプリケーションを作成します。「ファイル」→「新規」→「アプリケーション」を選択します。「新規ギャラリ」が表示され、作成するアプリケーション・コンポーネントを選択できます。

図6-14 アプリケーションの選択

2. 「アプリケーションの名前付け」ページで、アプリケーションの名前とディレクトリの場所を任意に変更します。

図6-15 アプリケーションの名前付け

3. 新しいOracle Service Busプロジェクトを作成します。

図6-16 新しいプロジェクトの作成

4. 「プロジェクトの名前付け」ページで、必要に応じてOracle Service Busプロジェクトの名前を変更します。プロジェクト・ディレクトリがアプリケーション・ディレクトリ(これがデフォルトです)内にあることを確認します。

図6-17 「プロジェクトの名前付け」ページ

5. 「終了」をクリックします。

Oracle RightNowアダプタによるService Busビジネス・サービスの定義

この項では、Oracle RightNowアダプタを使用して、RightNow統合のためにOracle Service Busビジネス・サービスを定義する方法について説明します(次のステージで構成されます)。

- Oracle RightNowアダプタ・コンポーネントの構成

- プロキシ・サービスの構成

- アウトバウンドOracle Service Busプロセスのデプロイ

Oracle RightNowアダプタ・コンポーネントの構成

Oracle RightNowアダプタ・コンポーネントを構成するには、次の手順を実行します。

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

1. Service Bus概要エディタを開きます。

2. 「コンポーネント」パネルから「外部サービス」スイムレーンにOracle RightNowアダプタ・コンポーネントをドラッグ・アンド・ドロップします。

アダプタ構成ウィザードの基本情報ページが表示されます。

3. 名前フィールドにRightNowアダプタの接続名を入力し、「次へ」をクリックします。

4. 接続ページで、参照ボタンをクリックしてエンタープライズWSDLの場所を検索します。

5. 「WSDLチューザ」ダイアログが表示されます。ダウンロードしたエンタープライズWSDLを検索して選択し、「OK」をクリックします。

6. 「OK」をクリックします。

7. 「次へ」をクリックします。

8. 「終了」をクリックします。ウィザードは接続ページに戻ります。

9. ドロップダウンから認証キーを選択するか(使用可能な場合)、「+」ボタンをクリックして認証キーを作成します。

10. テスト・ボタンをクリックして認証キーを検証します。

11. 「次へ」をクリックします。「操作」ページが表示されます。

12. デフォルトの操作はCreateです。ビジネス要件に合致した操作名を選択してこの操作を変更できます。

13. 使用可能リストからAccountビジネス・オブジェクトを選択して、選択済リストに移動します。

14. 「次へ」をクリックすると、サマリーページが表示されます。

プロキシ・サービスの構成

Oracle Service Busプロジェクト・サービスを構成する手順:

1. Oracle Service Bus概要エディタで、「パイプライン/分割結合」レーンを右クリックして、「挿入」→「パイプライン」をクリックします。

図6-18 パイプライン・コンポーネント

「パイプライン・サービスの作成」ダイアログが表示されます。

図6-19 「パイプライン・サービスの作成」ダイアログ

2. 「サービス名」フィールドに、パイプライン名を識別するための名前を入力し、プロジェクトの対応する場所を選択します。

3. 「次へ」をクリックし、サービス・タイプとして「WSDL」を選択します。

図6-20 パイプラインの作成

4. WSDL URLの右側にある「参照」アイコンをクリックし、ファイル・システムからWSDLを選択します。

5. 「アプリケーション」→「リソース」から適切なWSDLファイルを選択します。

図6-21 WSDLの選択

6. 「OK」をクリックします。選択したWSDLと対応するバインディングが表示されます。プロキシ・サービスとして公開のチェック・ボックスが選択されていることを確認します。

図6-22 パイプライン・サービスの作成

7. 「プロキシ・トランスポート」としてhttpを選択します。

8. 「終了」をクリックします。パイプライン・コンポーネントが表示されます。

図6-23 パイプライン・コンポーネント

9. 「外部サービス」スイムレーンのOracle RightNowアダプタをパイプラインに接続します。

図6-24 パイプライン・コンポーネントにrightnowReferenceを接続

10. デフォルト・ルーティングを表すパイプラインを開きます。サービスと対応する操作がルーティング・プロパティに表示されることを確認します。

図6-25 ルーティング・プロパティ

これで、アウトバウンドService Busプロジェクトをデプロイできます。

アウトバウンドOracle Service Busプロセスのデプロイ

アウトバウンドOracle Service Busプロジェクトをデプロイするには、次の手順を実行します。

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

図6-26 デプロイ・アクション

2. 構成済のアプリケーション・サーバーを選択して「次へ」をクリックします。

図6-27 「サーバーの選択」ページ

3. デプロイメント・サマリーを確認して「終了」をクリックします。

図6-28 「サマリー」ページ

4. 成功メッセージ・ページに、プロジェクトが正常にデプロイされたことが示されます。

図6-29 成功メッセージ・ページ

正常にデプロイされたプロジェクトは、Service Bus Consoleからテストできます。

Oracle Service Bus ConsoleでのOracle Service Busプロジェクトのテスト

Oracle Service Bus ConsoleでOracle Service Busプロジェクトをテストする手順:

1. Oracle Service Bus Consoleを開き、ユーザーIDとパスワードを入力します。

図6-30 Service Bus Console

2. デプロイされたすべてのプロジェクトが「すべてのプロジェクト」の下に表示されます。

図6-31 Service Busデプロイ済プロジェクト

3. テストするプロジェクトを開き、そのプロジェクトのプロキシ・サービスをクリックします。たとえば、この場合はPipelineProxyServiceです(次の図を参照)。

図6-32 プロキシ・サービス定義

4. アウトバウンド・エンドポイントのテスト用に、「テスト・コンソールの起動」(緑色の矢印ボタン)のオプションが表示されます。

図6-33 テスト・コンソールを起動するオプション

5. テスト・コンソールを起動すると、プロキシ・サービスと、「実行」、実行-保存、「リセット」および「閉じる」ボタンによるテスト操作が表示された新しいウィンドウが開きます。

図6-34 プロキシ・サービス・テスト

リクエスト・ドキュメント・セクションには、リクエスト・ペイロードが含まれます。

6. 入力を指定して「実行」ボタンをクリックします。これによって、ペイロードがOracle RightNow Cxに送信され、レスポンスがレスポンス・ドキュメント・セクションに表示されます。

7 RightNowアダプタでのトラブルシューティングとエラー処理

この章では、Oracle RightNowアダプタの構成中に発生する可能性のあるトラブルシューティングの情報およびエラー・メッセージについて説明します。

この章の内容は次のとおりです。

- Oracle RightNowアダプタの設計時のJDeveloperエラーの理解

- APIフォルトとエラー処理の理解

- RightNow例外コードの理解

- アダプタのフォルト処理の理解

Oracle RightNowアダプタの設計時のJDeveloperエラーの理解

次の表は、JDeveloperでOracle RightNow Cxサーバーを使用する際に発生する一般的な設計時エラーとそれらに適用可能な解決策を示しています。

表7-1 JDeveloperでのOracle Cloud Adapter for RightNow Server CX

エラー

解決策

login()資格証明が無効であるか、最大ログイン数を超えました。詳細は、管理者に問い合せてください。

エンタープライズWSDLのメタデータはキャッシュにはありません。

有効なOracle Cx資格証明を指定します。CSFキーを削除し、それを再度追加して適切な資格証明を指定します。

インターネットに接続して「オフライン構成」チェック・ボックスを選択します。これによって、オフライン使用のためにメタデータがダウンロードされます。

RightNow Cxサーバーに接続できません。

インターネットに接続していることと、組織のファイアウォールの背後でブロックされていないことを確認します。

soa_serverでコンポジットのデプロイ中にエラーが発生しました: 同じリビジョンIDのコンポジットがすでに存在します。

プロジェクトがサーバーにすでにデプロイされているかどうかを確認します。同じリビジョン・ボックスを持つ上書きコンポジットを確認するか、リビジョン番号を変更します。

java.net.ConnectException: 接続が拒否されました: 接続; 宛先に使用できるルーターがありません。

SOAサーバーが起動して実行中であることを確認します。

APIフォルトとエラー処理の理解

通常、Oracle RightNow Connect Web Services for SOAP APIのエラー処理は、標準のWSDLフォルト・メカニズムを通じて実行されます。WSDLでは、RequestErrorFault、ServerErrorFaultおよびUnexpectedErrorFaultという3つの異なるタイプのWSDLフォルトが定義されます。

WSDLによって定義されるベース・フォルト・タイプはRNFaultで、RNFaultのインスタンスには例外コードとメッセージが含まれます。

リクエスト・エラーについて

リクエスト・エラーは、検証の失敗やインバウンド・リクエストのデータ関連エラーが存在する場合に生成されます。

サーバー・エラーについて

サーバー・エラーは、リクエストの処理中にサーバーで発生する可能性のある既知の(予期された)エラーが存在する場合に生成されます。

予期しないエラーについて

予期しないエラーは、リクエストの処理中にOracle RightNow Cxサーバーで予期せず発生するまれなエラーです。これらの予期しないエラーは、特定のエラー・コードまたはステータスにマップされる必要はありません。

RightNow例外コードの理解

3つのフォルト・タイプであるRequestErrorFault、ServerErrorFaultおよびUnexpectedErrorFaultは、すべて基本のRNFaultを拡張しますが、これは列挙型のExceptionCodeフィールドと文字列型のExceptionMessageで構成されます。

次のRightNow例外コードが定義されます。

- ACCESS_DENIED。サービスに対するリクエストが作成されたが、接続を有効にするビットがサイト・インタフェースで無効になっているか、指定された資格証明のアカウント・プロファイルで公開SOAPビットが無効になっている場合に返されます。

- INVALID_FIELD。リクエストが作成され、リクエスト内のオブジェクトのフィールドが存在しないか、特定のリクエスト(作成時の設定ID)でそれにアクセスできない場合に返されます。

- INVALID_LOGIN。リクエストが作成されたが、ユーザー資格証明が無効である場合に返されます(これは、ユーザー名またはパスワードのいずれかである可能性があります)。

- BAD_ID。リクエストに指定されたIDが無効の場合に返されます。

- MISSING_ARGUMENT。リクエストに必要な引数が欠落している場合に返されます。

- BAD_ID。リクエストに指定されたIDが無効の場合に返されます。

- QUERY_TIMEOUT。指定した問合せがサーバーでタイムアウトした場合に、問合せリクエストについて返されます。

- UNKNOWN_EXCEPTION。予期しない不明な例外が発生した場合に返されます。

アダプタのフォルト処理の理解

Oracle RightNowアダプタは、JCAアダプタです。そのため、フォルト処理は他のJCAアダプタの処理と同様です。

8 Oracle RightNowアダプタの使用例

この章では、Oracle RightNowアダプタの使用例について手順を追って説明します。

次の各使用例によって、Oracle RightNowアダプタを使用して、SOA SuiteからOracle RightNow Cxに統合するアクティビティを実行する方法を説明します。

これらの各使用例の手順に従う前に実行する一般的な操作に関する情報は、「JDeveloperでの一般的な構成手順の実行」を参照してください。

Oracle RightNowアダプタでは、次のことを実行できます。

- 単一のビジネス・オブジェクトに対する作成、読取り、更新および破棄(CRUD)操作の実行

- 複数のビジネス・オブジェクトに対するCRUD操作の実行

- 複数のビジネス・オブジェクトと複数の操作によるバッチ操作の実行

- ROQLを使用した任意のオブジェクトの問合せ

- カスタム・オブジェクトに対するCRUD操作の実行

- 1つのバッチ・リクエストによる複数の操作のチェーン

単一のビジネス・オブジェクトに対する作成、読取り、更新および破棄(CRUD)操作の実行

同期アウトバウンド通信の一部として、Oracle RightNowアダプタは、Connect Web Services for SOAP APIの支援によってRightNow Cxインスタンスに接続し、そのRightNow Cxインスタンスの単一オブジェクトにCRUD操作を実行します。

これは、同期リクエスト・レスポンス・シナリオであり、クライアントは、RightNow Cxインスタンスにオブジェクトを作成するようOracle RightNowアダプタ・サービスにリクエストします。

アダプタ構成ウィザードでOracle RightNowアダプタを使用してアウトバウンド・サービスを設計します(「JDeveloperでの一般的な構成手順の実行」を参照)。これらの手順は、操作画面から開始します。

1. RightNowアダプタでは、CRUDおよびROQL操作がサポートされます。最初の使用例を実行するには、操作画面で「CRUD」を選択します。

2. 画面でCreate操作を選択します。(使用可能な他のCRUDオプションは、Read、UpdateおよびDeleteです。)「次へ」をクリックします。

3. Oracle RightNowアダプタに、使用可能なRightNow Cxビジネス・オブジェクトが表示されます。

オブジェクトを選択するには、オブジェクトを「選択可能」リストから「選択済」リストに移動します。フィルタ・オプションを使用すると、基準に基づいてオブジェクトを見やすく表示できます。Oracle RightNowアダプタ構成ウィザードに、標準オブジェクトとカスタム・オブジェクトの両方が表示されます。

4. 実行する処理オプションを選択できます。これらを使用して、操作の実行時にサーバー側の処理機能を有効化または無効化できます。これには次のものがあります。

- 外部イベントの抑制。このオプションを選択して、Create、UpdateまたはDelete操作の完了後に外部イベントを実行しないことを指定します。

- ルールの抑制。このオプションを選択して、Create、UpdateまたはDelete操作の完了後にビジネス・ルールを実行しないことを指定します。
この使用例では、「外部イベントの抑制」および「ルールの抑制」オプションを選択します。

「終了」オプションを選択して、Service Cloudサービスの起動の構成を完了します。

「終了」オプションを選択すると、ウィザードによって次の処理が行われます。

- 統合中心型のWSDLが生成されます。

- 厳密に型指定されたスキーマ定義が生成されます。

- 接続情報を含むJCA構成ファイルが生成されます。

- SCAコンポジットの参照エンドポイントが生成されます。

複数のビジネス・オブジェクトに対するCRUD操作の実行

このシナリオでは、アウトバウンド通信の一部として、Oracle RightNowアダプタは、Connect Web Services for SOAP APIの支援によってOracle RightNow Cxインスタンスに接続し、そのRightNow Cxインスタンスの複数のビジネス・オブジェクトに作成操作を実行します。

この使用例は、同期リクエスト・レスポンス・シナリオであり、クライアントは、RightNow Cxインスタンスにオブジェクトのセットを作成するようアダプタ・サービスにリクエストします。

Oracle RightNowアダプタを使用して、複数のオブジェクトとともに動作するアウトバウンド・サービスを設計します。

複数のビジネス・オブジェクトに対してCRUD操作を実行するアウトバウンド・サービスを設計するには、次の手順を実行します。

1. 操作画面では、複数のビジネス・オブジェクトを選択できます。複数のオブジェクトを選択するには、それらを「選択可能」で選択し、矢印を使用して「選択済」に移動します。

2. 複数のオブジェクトの選択を完了したら、この画面の「次へ」をクリックします。

構成ウィザードにサマリー画面が表示されます。アダプタによって、BPELなどの他のコンポーネントからワイヤ接続できる参照エンドポイントも作成されます。アダプタによって、すべてのバッチ操作が構成された統合中心型のWSDLが生成されます。アダプタによって、BPELなどの他のコンポーネントからワイヤ接続できる参照エンドポイントも作成されます。

複数のビジネス・オブジェクトと複数の操作によるバッチ操作の実行

このシナリオでは、アウトバウンド通信の一部として、Oracle RightNowアダプタは、Connect Web Services for SOAP APIの支援によってRightNow Cxインスタンスに接続し、そのRightNow Cxインスタンスの複数のビジネス・オブジェクトが含まれるバッチ操作を実行します。これは同期リクエストです。複数のビジネス・オブジェクトと複数の操作によるバッチ操作を実行するには、次の手順を実行します。

1. 操作固有の詳細を構成します。操作画面で「バッチ操作」オプションを選択します。

2. 「リストに操作を追加」をクリックして複数の操作を追加します。

3. 操作タイプとビジネス・オブジェクトを選択します。

バッチ操作の構成は、単一操作(最初の使用例で説明)の構成と似ています。

バッチ操作の操作構成では、特定の操作に対してバッチ専用オプションの「後でコミット」を指定することもできます。この場合、「後でコミット」が指定されている操作の後にのみトランザクション全体がコミットされます。

4. 「OK」ボタンをクリックして操作の構成を完了します。

ROQLを使用した任意のオブジェクトの問合せ

Oracle RightNowアダプタを使用して、ROQL (RightNow Query Language)の支援によってRightNow Cxインスタンスの標準オブジェクトとカスタム・オブジェクトを問い合せるアウトバウンド・サービスを設計します。

Oracle RightNowアダプタを使用してROQL問合せを実行する方法の詳細は、「ROQLの使用」を参照してください。「JDeveloperでの一般的な構成手順の実行」に示された一般的な操作手順を完了した後で、次の手順を実行します。

1. 操作画面で、「操作タイプの選択」リストから「ROQL」を選択します。

2. 「問合せ文」テキスト・ボックスに、ROQL問合せを入力します。

3. ウィザードの手順を完了する前に問合せ構文をテストします。「問合せのテスト」をクリックします。

4. 問合せ操作の構成が完了したら、「次の手順」をクリックします。アダプタによって、問合せ操作と入力および出力メッセージを含む統合中心型のWSDLが生成されます。アダプタによって、BPELやメディエータなどの他のコンポーネントからワイヤ接続できる参照エンドポイントも作成されます。

カスタム・オブジェクトに対するCRUD操作の実行

Oracle RightNow Cxには、CRUD操作を実行できる標準ビジネス・オブジェクトとカスタム・オブジェクトという2つの異なるタイプの関連オブジェクトがあります。この使用例では、カスタム・オブジェクトに対してGet操作を実行し、適切なWSDLおよびJCAファイルを生成します。

カスタム・オブジェクトに対してGet操作を実行するには、次の手順を実行します。

1. 操作画面の「使用可能」の下で、CRUD操作のために選択するカスタム・オブジェクトを見つけます。表記規則では、標準オブジェクト名(Contactなど)の後にCustomObjが続きます(Contact_CustomObjなど)。

2. 「選択可能」の下で例としてContact_CustomObjを使用し、矢印を使用して選択したオブジェクトを「選択済」に移動します。

3. 選択したオブジェクトにGet操作を実行するようにCRUD操作をGetに変更します。

4. 「次の手順」をクリックします。ウィザードにサマリー画面が表示されます。

5. 「終了」をクリックしてWSDLおよびJCAファイルを生成します。

1つのバッチ・リクエストによる複数の操作のチェーン

チェーンは、単一のバッチ・リクエスト内で複数の操作を相互に関連付けるために使用できるOracle RightNowアダプタの機能です。

チェーンの基礎となる概念と結果のコードの詳細は、「チェーン」を参照してください。

チェーンの使用例では、次の手順の実行について説明します。

1. Contactの作成。

2. Incidentの作成(このIncidentのプライマリContactは最初の手順で作成したものです。)

3. Incidentの取得(作成したIncidentを返す必要があります。)

「チェーンの使用」では、Oracle RightNowアダプタのユーザー・インタフェースでチェーンを使用する方法と、それを行う場合の使用例について説明します。使用例では、変換中にチェーンを実行する方法について説明し、XSLTマッパーを使用します。

注意:

チェーンは、常にバッチとともに使用され、Oracle RightNowアダプタのバッチ構成ウィザードで特別の手順を必要としません。

9 Oracle RightNow Cloudプロパティの構成

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

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

トピック

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

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

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

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

- Oracle RightNow 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 HCM Cloudアダプタの「接続」ページで実行可能な操作

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

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

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

- 認証キーを作成します。1つの方向(アウトバウンドなど)に対して作成したキーは、反対の方向(インバウンドなど)でも選択できます。

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

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

要素

説明

WSDL URL

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

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

セキュリティ・ポリシー

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

- ウィザードにはすべてのポリシーが表示されますが、これには、適切でない可能性があるポリシーも含まれます。正しい選択を行うには、ポリシーに関する知識が必要です。たとえば、SAMLベースのポリシーを選択することはできませんが、これは、アイデンティティが伝播されないからです。

- クラウド・アダプタに適用するポリシーはクラウド・アダプタに固有のものであり、コンポジット内の他のエンドポイントには影響しません。

認証キー

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

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

- 編集: 認証キーを編集する場合にクリックします。

- 削除: 認証キーを削除する場合にクリックします。

テスト

認証キーを検証する場合にクリックします。

Oracle HCM Cloudアダプタの「CSFキー」ページで実行可能な操作

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

- CSFキー名

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

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

Oracle HCM 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 RightNow Cloudソース・リクエストのプロパティの構成

統合のOracle RightNow Cloudソース・リクエスト値を入力します。指定する値により統合を開始します。

トピック

- Oracle RightNow Cloudソースの「リクエスト」ページでできること

- Oracle RightNow Cloudソースの「リクエスト」ページの表示内容

Oracle RightNow Cloudソースの「リクエスト」ページでできること

Oracle RightNow Cloudに次のリクエスト値を構成できます。

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

- Oracle RightNowアプリケーションからのリクエストとしてイベント・サブスクリプションを受信するように選択します。この選択により、統合が呼び出されます。イベント・サブスクリプションは、Oracle RightNowアプリケーションのバージョンがリリース15.5 (2015年5月)か、それ以降の場合にのみサポートされます。そうでない場合は、ビジネス・オブジェクトのみがサポートされます。

注意:
Oracle RightNowアプリケーションでは、使用可能なイベント・サブスクリプションのそれぞれに、20サブスクリプションの制限があります。たとえば、顧客作成イベントの統合にすべてサブスクライブすることで最大20の統合を作成し、連絡先破棄イベントの統合にすべてサブスクライブすることで最大20の統合を作成できます。同じイベント・サブスクリプションに21番目の統合を作成すると、統合のアクティブ化中にエラーが発生することがあります。

Oracle RightNow Cloudソースの「リクエスト」ページの表示内容

次の表では、Oracle RightNow Cloudソースの「リクエスト」ページの主な情報について説明します。

要素

説明

リクエストの構成

ビジネス・オブジェクトまたはイベント・サブスクリプションを選択して、エンドポイント構成オプションを選択します。

- ビジネス・オブジェクトを使用: ビジネス・オブジェクトのリストを表示する場合に選択します。

- イベント・サブスクリプション: サブスクライブするイベント・サブスクリプションのリストを表示する場合に選択します。

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

(「ビジネス・オブジェクトを使用」を選択した場合に表示されます)

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

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

(「ビジネス・オブジェクトを使用」を選択した場合に表示されます)

表名の1文字目を入力して、ビジネス・オブジェクトの表示をフィルタリングします。フィルタ・タイプを選択することもできます。

- すべて: すべてのオブジェクトが表示されます。

- カスタム: 作成したオブジェクトが表示されます。これらのビジネス・オブジェクトは特別なアイコンで識別されます。ネーミング規則は、「.」によって結合されたパッケージ名とオブジェクト名の組合せです。たとえば、COというカスタム・オブジェクト・パッケージとPurchaseProductという名前のオブジェクトがある場合、ウィザードではカスタム・オブジェクトはCO.PurchaseProductとして表示されます。

- 標準: 標準のOracle RightNow Cloudアプリケーションの一部として提供されるビジネス・オブジェクトが表示されます。

イベントの選択

(「イベント・サブスクリプション」を選択した場合に表示されます)

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

注意: このリリースでは、イベント・サブスクリプションについて、Organizationビジネス・オブジェクトとContactビジネス・オブジェクトのみがサポートされます。

イベント名フィルタ

(「イベント・サブスクリプション」を選択した場合に表示されます)

最初の数文字を入力して、ビジネス・イベントの表示をフィルタ処理します。

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

統合のOracle RightNow Cloudソース・レスポンス値を入力します。

トピック

- Oracle RightNow Cloudソースの「レスポンス」ページでできること

- Oracle RightNow Cloudソースの「レスポンス」ページの表示内容

Oracle RightNow Cloudソースの「レスポンス」ページでできること

Oracle RightNow Cloudのレスポンス・タイプを構成する操作およびビジネス・オブジェクトを構成できます。

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

- レスポンスは不要: レスポンスが必要ないため、レスポンス・ページの送信チェック・ボックスの選択を解除します。

Oracle RightNow Cloudソースの「レスポンス」ページの表示内容

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

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

- 即時: 同期レスポンスが必要(説明は表9-1を参照)

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

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

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

要素

説明

即時レスポンス

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

フォルトも送信

リクエストの処理中に統合にエラーが発生した場合、フォルト情報をOracle RightNow Cloudアプリケーションに送信する場合は、このチェック・ボックスを選択します。これは「即時」レスポンス・タイプでのみ使用可能なオプションのチェック・ボックスです。

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

表名の1文字目を入力して、ビジネス・オブジェクトの表示をフィルタリングします。フィルタ・タイプを選択することもできます。

- すべて: すべてのオブジェクトが表示されます。

- カスタム: 作成したオブジェクトが表示されます。これらのビジネス・オブジェクトは特別なアイコンで識別されます。ネーミング規則は、「.」によって結合されたパッケージ名とオブジェクト名の組合せです。たとえば、COというカスタム・オブジェクト・パッケージとPurchaseProductという名前のオブジェクトがある場合、ウィザードではカスタム・オブジェクトはCO.PurchaseProductとして表示されます。

- 標準: 標準のOracle RightNow Cloudアプリケーションの一部として提供されるビジネス・オブジェクトが表示されます。

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

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

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

表9-2 レスポンス・タイプ - レスポンスは不要

要素

説明

送信

レスポンスが不要の場合に選択を解除します。必要なものがないので、このオプションではビジネス・オブジェクトの選択は無効です。

レスポンス・タイプ

「送信」チェック・ボックスの選択を解除した場合、このセクションは無効です。

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

「送信」チェック・ボックスの選択を解除した場合、このセクションは無効です。

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

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

トピック

- Oracle RightNow Cloudターゲットの「操作」ページでできること

- Oracle RightNow Cloudターゲットの「操作」ページの表示内容

Oracle RightNow Cloudターゲットの「操作」ページでできること

Oracle RightNow Cloudに次の値を構成できます。

- 1つの操作を構成するか複数操作のバッチを構成するかを選択します。

- 操作(CRUDまたはRightNow Object Query Language (ROQL))を選択します。

- ビジネス・オブジェクトを選択します。

- サーバー側の処理に関する様々な項目を有効化します

Oracle RightNow Cloudターゲットの「操作」ページの表示内容

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

要素

説明

操作モードの選択

ビジネス・オブジェクトを定義する操作モードを選択します。

- 単一操作: 1つの操作を構成することを選択します。

- バッチ操作: 複数の操作をバッチとして構成する場合に選択します。これにより、定義済シーケンス内の複数の操作を実行することができます。
このオプションを選択すると、ページがリフレッシュされて次のオプションが表示されます。

- 操作をリストに追加リンク: クリックしてバッチ操作およびそのビジネス・オブジェクトのリストを作成します。操作は、リストに表示される順(上から下へ)に実行されます。

- 「編集」アイコン: クリックして、表の操作行を編集またはバッチ操作の順番を変更します。

- 「削除」アイコン: クリックして、表から選択した操作行を削除します。

操作タイプの選択

Oracle RightNowアプリケーションのビジネス・オブジェクトで実行する操作のタイプを選択します。

- CRUD: Oracle RightNowビジネス・オブジェクトで実行する、作成、読取り、更新、削除または破棄操作を表します。各文字は、標準のSQL文、HTTPメソッドまたはDDS操作にマップされます。ビジネス・オブジェクトで実行するCRUD操作を選択します: 「作成」、「破棄」、「取得」または「更新」。

- MISC: Oracle RightNowアプリケーションの特別なタスク操作(ユーザーへの電子メールの送信など)のセットを表します。

- ROQL: (RightNow Object Query Language)を使用してROQLベースの問合せを定義して、Oracle RightNowアプリケーションで実行するリクエストとして送信することができます。このオプションを選択すると、ページがリフレッシュされて問合せを入力するフィールドが表示されます。

- ROQL問合せ文の入力: フィールドに有効なROQL問合せを入力します。次に例を示します。

SELECT contacts FROM organization WHERE name = 'RightNow'

問合せには、カスタム・フィールドおよびパラメータを含めることができます。

- パラメータ・バインディング: 指定した問合せに含まれるパラメータ・バインディングが表示されます。たとえば、orgIdは次の問合せのパラメータです。

SELECT Organization FROM Organization WHERE id = &orgId
パラメータを指定した問合せを入力し、ドロップダウン・リストからQueryObjectsを再度選択します。これにより、パラメータのテスト値を指定するテキスト・ボックスが表示されます。

- 問合せのテスト: クリックしてOracle RightNowアプリケーションに対する問合せを検証します。問合せ結果が表示されます。エラーが発生したら、問合せの修正方法についての結果を受信します。

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

オブジェクト名の1文字目を入力して、オブジェクトの範囲を表示します。フィルタ・タイプを選択することもできます。

- すべて: すべてのオブジェクトが表示されます。

- カスタム: 作成したオブジェクトが表示されます。これらのビジネス・オブジェクトは特別なアイコンで識別されます。ネーミング規則は、「.」によって結合されたパッケージ名とオブジェクト名の組合せです。たとえば、COというカスタム・オブジェクト・パッケージとPurchaseProductという名前のオブジェクトがある場合、ウィザードではカスタム・オブジェクトはCO.PurchaseProductとして表示されます。

- 標準: 標準のOracle RightNowアプリケーションの一部として提供されるビジネス・オブジェクトが表示されます。

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

Oracle RightNowアプリケーションから1つのビジネス・オブジェクトまたは複数のビジネス・オブジェクトを選択します。選択された操作がこれらのビジネス・オブジェクトで動作します。RightNowバージョン1.2 APIがサポートされています。

ターゲット操作の構成が完了すると、選択された操作およびビジネス・オブジェクトが統合集中型WSDLファイルに定義されます。

処理オプション

サーバー側の処理に関する様々な項目を有効化する場合に選択します。デフォルトでは、オプションは選択されていません。

- 外部イベントの抑制: Oracle RightNowアプリケーションが作成、更新または削除操作の完了後に発生する外部イベントを処理するのを防ぐ場合に選択します。

- ルールの抑制: ビジネス・ルールが作成、更新または削除操作の完了後に実行するのを防ぐ場合に選択します。ビジネス・ルールは共通のビジネス・タスクを簡略化し自動化するツールです。詳細は、RightNowのドキュメントを参照してください。

- レスポンスの抑制: CRUDの「作成」操作によりレスポンスIDを返さない場合に選択します。このチェック・ボックスを無効にすると、「作成」操作により作成されたオブジェクトのIDが返されます。

- 後でコミット: 1つのトランザクション内の複数の操作をグループ化するために選択します。実行時、バッチ内の一連の操作が1つの操作の一部として定義されている場合、そのトランザクション境界内の最後の操作後に「後でコミット」アクションが送信されます。バッチ操作のサブセットからの操作が失敗した場合、フォルトをクライアントにスローすることで処理されます。このオプションはバッチ操作でのみ使用できます。

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

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

トピック

- 「サマリー」ページでできること

- 「サマリー」ページの表示内容

「サマリー」ページでできること

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

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

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

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

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

「サマリー」ページの表示内容

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

要素

説明

サマリー

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

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

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

A RightNow資格証明を管理するための資格証明ストアの構成

Oracle RightNowアダプタを使用してRightNow Cxに対して統合を構成する前に、SOAまたはService BusサービスがデプロイされるWebLogicドメインの資格証明ストアで、設計時に指定した認証キーを使用可能にする必要があります。

認証キーは、SOAコンポジットまたはService Busプロジェクトのデプロイ時に、資格証明ストア内に自動的に作成されません。Oracle Enterprise Manager Fusion Middleware Controlを使用してWebLogicドメインに認証キー(別名CSFキー)を手動で作成する方法の詳細は、Oracle Cloudアダプタ・インストール後の構成ガイドを参照してください。

Oracleの法律上の注意点

コピーライト

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およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

Pre-General Availability (一般提供前)版のドキュメントについて

このドキュメントがPre-General Availability (一般提供前)版の場合:

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

非公開のPre-General Availability (一般提供前)版のドキュメントについて

このドキュメントが非公開のPre-General Availability (一般提供前)版の場合:

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

このドキュメントには、ソフトウェアまたは印刷物などの形式を問わず、オラクルが独占的な権利を有する財産的情報が含まれています。この機密資料へのアクセスと使用は、お客様とオラクルとの間で締結され、お客様が遵守に同意した、Oracle Master Agreement、Oracle License and Oracle Services Agreement (オラクル・ライセンスおよびサービスに関する契約書)、Oracle Partner Network 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)を参照してください。