ヘッダーをスキップ
Oracle Application Server Adapter for Siebelユーザーズ・ガイド
10g リリース3(10.1.3.4.0)
B53282-01
  目次
目次
索引
索引

戻る
戻る
 
次へ
次へ
 

2 Oracle Application Server Adapter for Siebelの構成

この章では、OracleAS Adapter for Siebelを構成し、Siebelビジネス・オブジェクトのスキーマを作成する方法について説明します。

この章の項目は次のとおりです。

UNIXプラットフォームでのエンコーディングのサポート

重要(すべてのUNIXプラットフォーム): UNIX環境でBSEまたはJ2CA構成を使用してSiebelターゲットへの接続を試行する前に、「必要なエンコーディング・オプションの追加(すべてのUNIXプラットフォーム)」で説明されている追加手順を実行する必要があります。 この項で説明するエンコーディング・オプションの追加に失敗すると、エラーが発生し、Siebelターゲットに接続できなくなります。 エラー・メッセージは、次のようにそのエンコーディングがサポートされていないことを示している可能性があります。

Error: Problem activating adapter -- UTF-8 is not supported. Check logs for more information.

Error: Error getting target [Siebel] -- UTF-8 is not supported.

必要なエンコーディング・オプションの追加(すべてのUNIXプラットフォーム)

Siebelターゲットへの接続を試行する前に、次の手順を実行します。

  1. iwae.shに次のJavaファイル・エンコーディング・オプションを追加します。

    -Dfile.encoding="ISO8859_1"
    

    iwae.shファイルは次のディレクトリにあります。

    $oracle_home/adapters/application/tools
    
  2. Oracle Application Serverコンソールにログインし、OC4JContainerのホーム・ページに移動して、「管理」「サーバー・プロパティ」を順番にクリックします。次に、「コマンドライン・オプション」の下で、「Javaオプション」フィールドを編集して、次のオプションを追加します。

    -Dfile.encoding="ISO8859_1"
    

Siebel接続の前提条件

J2CA構成用にCOM接続を使用してSiebelシステム(バージョン6.2以前)に接続するには、次の手順を実行する必要があります。

  1. アダプタがインストールされているシステムにSiebel thickクライアントをインストールします。

  2. 同じシステムにデータベース・クライアント(Microsoft SQL ServerまたはOracle)をインストールします。

  3. アダプタのlibフォルダ内のSiebel .DLLファイル(iwsiebel.local.dllおよびiwsiebel.core.dll)を、アプリケーション・サーバーのパスに追加する必要があります。

  4. uagent.cfgファイルを編集し、データ・ソース・パラメータ値を「local」から「server」に変更します。

    uagent.cfgファイルはSiebel thickクライアントの次のフォルダにあります。

    c:\sea\client\bin
    
  5. SEA MSQlのデータ・ソースを、適切なパラメータを使用して編集します。

    Windowsでデータ・ソースを編集するには、「コントロール パネル」→「管理ツール」→「データ ソース (ODBC)」の順にアクセスします。

  6. アダプタ・ターゲット接続を作成する際には、次のターゲット・タイプを使用します。

    Siebel 6.2 - (Local COM Access Implementation)
    
  7. アダプタ・ターゲット接続を作成する際には、uagent.cfgファイルのフルパスを指定します。次に例を示します。

    c:\sea\client\bin\uagent.cfg
    

Application Explorerの起動

前提条件

OracleAS Adapter Application Explorer(Application Explorer)を起動してOracle Application Server Adapter for Siebel(OracleAS Adapter for Siebel)を使用する前に、OracleAS_homeディレクトリの下に\endorsedディレクトリを作成し、このディレクトリの下にxalan.jarファイルのコピーを入れる必要があります。 それ以外の場合、Application Explorerで統合オブジェクトの下にIOノードを追加したときに、トランスフォーメーション・エラーが発生します。

  1. OracleAS_home\j2ee\home\connectors\jca-app-adapter\jca-app-adapterディレクトリにナビゲートし、xalan.jarファイルをコピーします。

  2. システム上で次のディレクトリを検索し、次の各ディレクトリの下に\endorsedサブディレクトリを作成します。

    • OracleAS_home\

    • OracleAS_home\jdk\lib\

    • OracleAS_home\jdk\lib\

    • OracleAS_home\jdk\jre\lib\

    • OracleAS_home\j2ee\oc4j_soa\connectors\Appsadapter\AppsAdapter

  3. 手順1でコピーしたxalan.jarファイルを、新しい各\endorsedサブディレクトリにコピーします。

    重要:: 前述のディレクトリがすべて存在するとはかぎらないことに注意してください。これは、個別の環境によって異なります。

Application Explorerを起動します。

Application Explorerを起動する手順は、次のとおりです。

  1. Application Explorerがデプロイされているサーバーを起動します。

  2. Windowsの「スタート」メニューから、「プログラム」、「OracleAS_home」、「Adapters」「Application Explorer」を順番に選択します。

    Windowsの場合、iaexplorer.batOracleAS_home\adapters\application\toolsの下にあります。OracleAS_homeは、Oracle Application Serverがインストールされているディレクトリです。

    UNIXの場合は、OracleAS_home/adapters/application/toolsの下にあるスクリプトiwae.shをロードします。OracleAS_homeは、Oracle Application Serverがインストールされているディレクトリです。

    Application Explorerが起動します。これで、Siebelシステムに対して新規ターゲットを定義できます。

BSEまたはJ2CA用の設定の構成

構成を作成する前に、OracleAS Adapter Business Services Engine(BSE)を構成する必要があります。ra.xmlファイルはインストール時に自動的に構成されるため、OracleAS Adapter J2CAを構成する必要はありません。

BSEの構成

BSEをOracle Application Serverにデプロイした後、BSE構成ページを使用してBSEを構成できます。

BSEを構成する手順は、次のとおりです。

  1. ブラウザで次のページを表示します。

    http://host name:port/ibse
    

    host nameはOracle Application Serverのホスト名、portはOracle Application ServerのHTTPポートです。

    次に例を示します。

    http://localhost:7777/ibse
    

    注意:


    初めてアクセスする場合、このページのロードには時間がかかる可能性があります。

  2. プロンプトからログオンします。

    初期インストール時には、ユーザーIDとパスワードが次のように設定されます。

    • ユーザー名: iway

    • パスワード: iway

    BSE構成ページが表示されます。

    Business Services Engine構成ページ
    図bse_config.gifの説明

  3. 「アダプタ・ライブラリ・ディレクトリ」パラメータで、libディレクトリへのパスが次のように指定されていることを確認します。

    OracleAS_home\adapters\application\lib
    

    パスを指定すると、libディレクトリ内のアダプタがBSEで使用可能になります。

  4. セキュリティのために、「管理パスワード」フィールドに新規パスワードを入力します。


    注意:


    「リポジトリURL」フィールドには、ファイル・システム・リポジトリの場所を指定します。データベース・リポジトリを使用するには、リポジトリ接続情報を入力する必要があります。初期検証には、ファイル・システム・リポジトリを使用します。データベース・リポジトリへの切替方法は、「Oracleリポジトリの構成」を参照してください。

  5. 「保存」をクリックします。

BSEシステム設定の構成

BSEシステム設定を構成する手順は、次のとおりです。

  1. 次のURLを使用してBSE構成ページを表示します。

    http://host name:port/ibse/IBSEConfig
    

    host nameはBSEがインストールされているシステム、portはBSEがリスニングしているポート番号です。

    重要: BSEがデプロイされているサーバーが稼働中である必要があります。

    BSE設定ウィンドウが表示されます。

    BSEのシステム設定ペイン
    図ibse_config_page.gifの説明

  2. 次の表に従ってパラメータの情報を指定し、システム設定を構成します。

    パラメータ 説明
    言語 必要な言語を指定します。
    アダプタ・ライブラリ・ディレクトリ アダプタのjarファイルがあるディレクトリへのフルパスを入力します。
    エンコーディング UTF-8のみがサポートされます。
    デバッグ・レベル デバッグ・レベルを次のオプションから1つ指定します。
    • なし

    • FATAL

    • ERROR

    • WARNING

    • INFO

    • DEBUG

    非同期プロセッサの数 非同期プロセッサの数を選択します。

    次の図は、ウィンドウの「セキュリティ」ペインを示します。

    BSEセキュリティ設定ペイン
    図security.gifの説明

  3. 次の表に従ってパラメータの情報を指定し、セキュリティ設定を構成します。

    パラメータ 説明
    管理ユーザー BSE管理者IDを入力します。
    管理パスワード BSE管理者IDに関連付けられているパスワードを入力します。
    ポリシー このチェック・ボックスを選択すると、ポリシー・セキュリティが有効になります。

    このイメージは、「リポジトリ」ペインのすべてのフィールドとチェック・ボックスを示しています。

    「リポジトリ」ペイン
    図ibse_config_repos_loc.gifの説明

  4. 次の表に従ってパラメータの情報を指定して、リポジトリ設定を構成します。

    BSEには、Webサービスの配信に必要なトランザクションとメタデータを格納するためのリポジトリが必要です。

    詳細は、「ファイル・システム・リポジトリの構成」および「Oracleリポジトリの構成」を参照してください。

    パラメータ 説明
    リポジトリ・タイプ リストから次のリポジトリを1つ選択します。
    • Oracle

    • ファイル(本番環境ではBSEのファイル・リポジトリを使用しないでください)

    リポジトリURL データベースへの接続をオープンするときに使用するURLを入力します。
    リポジトリ・ドライバ データベースへの接続をオープンするときに使用するドライバ・クラスを入力します(オプション)。
    リポジトリ・ユーザー データベースへの接続をオープンするときに使用するユーザーIDを入力します。
    リポジトリ・パスワード ユーザーIDに関連付けられているパスワードを入力します。
    リポジトリ・プーリング このチェック・ボックスを選択すると、プーリングが有効になります。

  5. 「保存」をクリックします。

ファイル・システム・リポジトリの構成

リポジトリ・データベースへのアクセス権がない場合、リポジトリ情報をローカル・システム上のXMLファイルに格納できます。ただし、データベース・リポジトリに比べると、ファイル・システム・リポジトリは安全性も効率も低くなります。BSEの初回インストール時に、ファイル・システム・リポジトリを使用するように自動的に構成されます。


注意:


本番環境では、BSE用のファイル・リポジトリを使用しないでください。

Windowsの場合、リポジトリのデフォルト位置は次のとおりです。

OracleAS_home\j2ee\OC4J_CONTAINER\applications\ws-app-adapter \ibse\ibserepo.xml

他のプラットフォームの場合は、対応する位置を使用します。

ファイル・システム・リポジトリを使用する場合、追加のBSEコンポーネントを構成する必要はありません。

Oracleリポジトリの構成

Oracleリポジトリを構成する手順は、次のとおりです。

  1. データベース管理者に連絡し、BSEリポジトリの作成に使用するOracleユーザーIDとパスワードを取得します。

    このユーザーIDには、表の作成および変更権限とストアド・プロシージャの作成および実行権限が付与されている必要があります。

  2. コマンド・プロンプトを開いてsetupディレクトリにナビゲートします。Windowsの場合、デフォルト位置は次のとおりです。

    OracleAS_home\adapters\application\etc\setup
    

    他のプラットフォームの場合は、対応する位置を使用します。

    このディレクトリには、次のファイルにリポジトリ表を作成するためのSQLが格納されています。

    iwse.ora
    

    注意:


    OracleデータベースがOracle Application Serverとは異なるマシンにインストールされている場合は、iwse.oraファイルを、Oracleデータベースがインストールされているシステムにコピーします。 次に、Oracleシステムのコマンド・プロンプトで、iwse.oraファイルがあるディレクトリにナビゲートします。

  3. 次のコマンドを入力します。

    sqlplus userid/password @database @ iwse.ora
    

J2CAの構成

OracleAS Adapter for SiebelをJ2CAにデプロイするときに、OC4Jによってoc4j-ra.xmlというデプロイメント・ディスクリプタが生成されます。このディスクリプタは、リソース・アダプタに関するOC4J固有のデプロイ情報を提供します。J2CAのデプロイおよび構成の詳細は、第3章「OC4Jのデプロイおよび統合」を参照してください。

J2CAデプロイでデフォルト・ファイル・ベースのリポジトリを使用している場合、構成を変更する必要はありません。

J2CA用のデータベース・リポジトリの構成

J2CA用のデータベース・リポジトリを構成する手順は、次のとおりです。

  1. データベースがインストールされているシステムで、iwse.ora SQL文を実行します。

  2. jcatransport.propertiesファイルを作成し、次のディレクトリに保存します。

    OracleAS_HOME\adapters\application\config\jca_sample
    
  3. 新規作成されたjcatransport.propertiesファイルのiwafjca.repo.urliwafjca.repo.userおよびiwafjca.repo.passwordの各フィールドに値を入力します。次に例を示します。

    iwafjca.repo.url=jdbc:oracle:thin:@90.0.0.51:1521:orcl
    iwafjca.repo.user=scott
    iwafjca.repo.password=scott1
    
  4. oc4j-ra.xmlファイルをテキスト・エディタで開きます。

  5. IWAYRepo_URLプロパティの値として、JDBC接続情報を指定します。

  6. IWAYRepo_Userプロパティに有効なユーザー名を指定します。

  7. IWAYRepo_Passwordプロパティに有効なパスワードを指定します。

  8. 変更内容をoc4j-ra.xmlファイルに保存します。

  9. OracleデータベースのJDBCドライバ(Classes12.jar、Classes12.zipおよびnls_charset12.jar)を次のディレクトリにコピーします。

    OracleAS_home\adapters\application\lib
    

    OracleAS_homeはOracle Application Serverがインストールされているディレクトリです。

パスワード暗号化

J2CA構成を作成するときに、Application Explorerを使用してパスワードを暗号化し、jcatransport.propertiesおよびoc4j-ra.xmlファイルでこの値を使用して、セキュリティを強化することもできます。

パスワード暗号化の構成

パスワードを暗号化する手順は、次のとおりです。

  1. Application Explorerを開きます。

  2. 「ヘルプ」をクリックし、「暗号化」を選択します。

    「暗号化」ダイアログ・ボックスが開きます。

  3. 「パスワード」フィールドにパスワードを入力し、「OK」をクリックします。

    暗号化されたパスワードが「暗号化」フィールドに表示されます。

  4. パスワードをコピーします。

  5. jcatransport.propertiesファイル(設計時に使用されます)で、既存のパスワードを暗号化された値に置き換えます。

    パスワードが置換されるjcatransport.propertiesファイルのサンプルを次に示します。

    iwafjca.log.level=DEBUGiwafjca.repo.url=jdbc:oracle:thin:@172.30.166.100:1521:orcliwafjca.repo.user=scottiwafjca.repo.password=ENCR (318931973183297321831293164323332123227)
    
  6. oc4j-ra.xmlファイル(実行時に使用されます)で、既存のパスワードをIWayRepoPassword要素の暗号化された値に置き換えます。

  7. Oracle Application Serverを再起動します。

リポジトリ構成の作成

OracleAS Adapter for SiebelでApplication Explorerを使用する前に、リポジトリ構成を作成する必要があります。アダプタがデプロイされているコンテナに応じて、2種類のリポジトリ構成を作成できます。1つはWebサービス、もう1つはJ2CAです。設計時に、Application Explorerを使用してアダプタ接続の構成、EISオブジェクトの参照、サービスの構成およびEISイベントをリスニングするリスナーの構成を行うときに、作成されたメタデータがリポジトリに格納されます。 リポジトリ内の情報は、実行時にも参照されます。

デフォルトのManagedConnectionFactoryについては、デフォルトのJ2CAリポジトリが作成されます。この構成の名前はjca_sampleです。

WebサービスとBSEは、同じデプロイメント・タイプを指します。詳細は、「アダプタの機能」を参照してください。

BSE用の構成の作成

Application Explorerを使用してBSE用の構成を作成するには、最初に新規構成を定義する必要があります。

BSE用の新規構成の定義

BSE用の新規構成を作成する手順は、次のとおりです。

  1. 「構成」を右クリックして「新規」を選択します。

    「新規構成」ダイアログ・ボックスが表示されます。

  2. 新規構成の名前(SampleConfigなど)を入力して「OK」をクリックします。

    次のダイアログ・ボックスが表示されます。

    新規構成
    図app_exp_new_config_type.gifの説明

  3. 「サービス・プロバイダ」リストから「iBSE」を選択します。

  4. 「iBSE URL」フィールドで、デフォルトのURLを受け入れるか、次の書式を使用して別のURLで置き換えます。

    http://host name:port/ibse/IBSEServlet
    

    host nameはアプリケーション・サーバーが常駐するシステム、portはアプリケーション・サーバーがリスニングしているHTTPポート番号です。

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

    「構成」ルート・ノードの下に、新規構成を表すノードが表示されます。

    新規構成
    図newconfig_a.gifの説明

BSE構成ファイルは、OracleAS_home\j2ee\oc4j_container\applications\ws-app-adapter\ibseに格納されます。

J2CA用の構成の作成

Application Explorerを使用してOracleAS Adapter J2CA用の構成を作成するには、最初に新規構成を定義する必要があります。

J2CA用の新規構成の定義

J2CA用の新規構成を定義する手順は、次のとおりです。

  1. 「構成」を右クリックして「新規」を選択します。

    「新規構成」ダイアログ・ボックスが表示されます。

    新規構成の定義
    図selectnewconfig.gifの説明

  2. 新規構成の名前(SampleConfigなど)を入力して「OK」をクリックします。

    「新規構成」ダイアログ・ボックスが表示されます。

    JCA構成
    図jcaconfig.gifの説明

  3. 「サービス・プロバイダ」リストから「JCA」を選択します。

  4. 「ホーム」フィールドに、リポジトリ、スキーマおよびその他の情報が格納されているJ2CA構成ディレクトリへのパスを入力します。次に例を示します。

    OracleAS_home\adapters\application
    
  5. 「OK」をクリックします。

    「構成」ルート・ノードの下に、新規構成を表すノードが表示されます。

    新規構成
    図newconfig_a.gifの説明

OracleAS Adapter J2CA構成ファイルは、OracleAS_home\adapters\application\config\configuration_nameに格納されます。

configuration_nameは、SampleConfigなど、作成した構成の名前です。

HTTPリポジトリ接続

J2CAユーザーは、HTTPリポジトリ接続を作成することで、WSDL文書をリモートから生成および格納できます。 HTTPリポジトリ接続を作成するには、Application Explorerで次の手順を実行します。 作成したHTTPリポジトリを使用するには、iwjcaivpテスト・ツール(jca-app-adapter-test)が正常にデプロイされ、実行中であることを確認してください。

  1. Application Explorerを起動します。

  2. 左ペインで「コンフィギュレーション」ノードを右クリックし、「新規」を選択します。

    「新規コンフィギュレーション」ダイアログ・ボックスが開きます。

  3. コンフィギュレーションの名前を入力し、「OK」をクリックします。

  4. 「サービス・プロバイダ」リスト・ボックスから「JCA」を選択して、「ホーム」フィールドにHTTPのターゲット値を入力します。

    HTTPのターゲット値には次の書式を使用します。

    http://host name:port/iwafjca/JCAServlet
    

    次に例を示します。

    http://iwserv14:7777/iwafjca/JCAServlet
    
  5. 「OK」をクリックします。

    新規のHTTPリポジトリ接続が「コンフィギュレーション」ノードに追加されます。

    リモート・サーバーへの接続後は、新規アダプタ・ターゲットの作成、WSDL文書の生成およびWSDL文書のリモート・サーバーへの格納ができます。

    注意: J2CA HTTPリポジトリを使用してアダプタ・ターゲットを構成した場合は、実行時の準備としてOracle Application Serverを再起動しておく必要はありません。

BSEまたはJ2CA構成への接続

新規構成に接続する手順は、次のとおりです。

  1. 接続先の構成(SampleConfigなど)を右クリックします。

  2. 「接続」を選択します。

    「アダプタ」、「イベント」および「ビジネス・サービス」(Webサービスとも呼びます)の各ノードが表示されます。「ビジネス・サービス」ノードは、BSE構成でのみ使用できます。J2CA構成に接続する場合、「ビジネス・サービス」ノードは表示されません。SampleConfigという名前のBSE構成の例を次に示します。

    接続状態のSampleConfigターゲット
    図wlw_newconfig8.gifの説明

  • 「アダプタ」フォルダを使用して、Siebelとのインバウンド相互作用を作成します。たとえば、「アダプタ」フォルダの「Siebel」ノードを使用して、Siebelを更新するサービスを構成します。

  • 「イベント」フォルダを使用して、Siebelでのイベントをリスニングするリスナーを構成します。

  • 「ビジネス・サービス」フォルダ(BSE構成の場合のみ使用できます)を使用して、「アダプタ」フォルダで作成したWebサービスをテストします。また、「ビジネス・サービス」フォルダのセキュリティ機能を使用して、Webサービスのセキュリティ設定を制御できます。

これで、Siebelに対して新規ターゲットを定義できます。

Siebel用の接続(ターゲット)の確立

Siebelのビジネス・サービス、ビジネス・コンポーネントおよび統合オブジェクトを参照するには、Siebelへのターゲットを定義する必要があります。ターゲットを定義すると、パラメータは自動的に保存されます。ただし、ターゲットに接続するたびにSiebelのパスワードを指定する必要があります。

重要(すべてのUNIXプラットフォーム): UNIX環境でBSEまたはJ2CA構成を使用してSiebelターゲットへの接続を試行する前に、"「必要なエンコーディング・オプションの追加(すべてのUNIXプラットフォーム)」で説明されている追加手順を実行する必要があります。 この項で説明するエンコーディング・オプションの追加に失敗すると、エラーが発生し、Siebelターゲットに接続できなくなります。 エラー・メッセージは、次のようにそのエンコーディングがサポートされていないことを示している可能性があります。

Error: Problem activating adapter -- UTF-8 is not supported. Check logs for more information.

Error: Error getting target [Siebel] -- UTF-8 is not supported.

必要なエンコーディング・オプションの追加(すべてのUNIXプラットフォーム)

Siebelターゲットへの接続を試行する前に、次の手順を実行します。

  1. iwae.shに次のJavaファイル・エンコーディング・オプションを追加します。

    -Dfile.encoding="ISO8859_1"
    

    iwae.shファイルは次のディレクトリにあります。

    $oracle_home/adapters/application/tools
    
  2. Oracle Application Serverコンソールにログインし、OC4JContainerのホーム・ページに移動して、「管理」「サーバー・プロパティ」を順番にクリックします。次に、「コマンドライン・オプション」の下で、「Javaオプション」フィールドを編集して、次のオプションを追加します。

    -Dfile.encoding="ISO8859_1"
    

Siebelへのターゲットの定義

Siebelターゲットの定義に必要な接続パラメータは、eapps.cfgファイルから取得できます。このファイルは、次のディレクトリにあります。

drive:\SiebelRoot\SWEApp\BIN

Siebelrootは、Siebelインストール・ディレクトリです。

Siebelへのターゲットを定義する手順は、次のとおりです。

  1. 左ペインで「アダプタ」ノードを開きます。

    「アダプタ」リストを開いた状態
    図adapterexpandedpartial.gifの説明

  2. 「Siebel」ノードを右クリックして「ターゲットの追加」を選択します。

    「ターゲットの追加」ダイアログ・ボックスが表示されます。次の情報を指定します。

    1. 「名前」フィールドに新規ターゲットの名前を入力します。

    2. 「説明」フィールドに説明を入力します(オプション)。

    3. 「ターゲット・タイプ」リストからターゲットのタイプを選択します。Siebel 6.0の場合は、Siebel 6.2以下(COM)を選択します。Siebel 6.3以上の場合は、「Java Beanデータ接続」を選択します。

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

    「Siebel 6.2以下(COM)」を選択した場合:

    1. 「ユーザー・エージェント・ファイル」フィールドに、構成ファイルの名前を入力します。

    2. 「ユーザー名」フィールドにユーザー名を入力します。

    3. 「パスワード」フィールドに、ユーザー名に関連したパスワードを入力します。

    4. 「リポジトリ」フィールドに、ビジネス・サービス、ビジネス・オブジェクトおよび統合オブジェクトを説明したメタデータをApplication Explorerで検索するSiebelリポジトリを入力します。

      リポジトリを指定しない場合、利用可能なすべてのリポジトリからオブジェクトの全リストが戻されます。指定したリポジトリが見つからない場合は、空のオブジェクト・リストが戻されます。

    Siebel 6.3以上用の「Java Beanデータ接続」を選択した場合:

    1. 「ゲートウェイ・サーバー」フィールドに、サーバーの名前を入力します。デフォルト(通常は2320)以外のポートを使用するゲートウェイ・サーバーを指定するには、コロンとポート番号を追加します(gateway name:port numberなど)。

    2. 「企業名」フィールドに適切な名前を入力します。

    3. 「Siebelサーバー」フィールドに、Siebelサーバーの名前を入力します。 Siebel 7.7、7.8または8のシステムに接続する場合は、このフィールドに値を指定しないでください。

    4. 「ユーザー」フィールドにユーザー名を入力します。

    5. 「パスワード」フィールドに、ユーザー名に関連したパスワードを入力します。

    6. 「詳細」タブをクリックし、次の項目を確認します。

      言語

      オブジェクト・マネージャ

      Siebel 7.0.3の場合、デフォルトのオブジェクト・マネージャはEAIObjMgrです。Siebel 7.7の場合、デフォルトはEAIObjMgr_enuです。Siebel 7.7では、オブジェクト・マネージャ名の末尾に言語拡張子(_enuなど)を追加する必要があります。システムに適用される特定の名前については、Siebel管理者に確認してください。

      リポジトリを指定しない場合、利用可能なすべてのリポジトリからオブジェクトの全リストが戻されます。指定したリポジトリが見つからない場合は、空のオブジェクト・リストが戻されます。

      指定するパラメータは、Siebelクライアント・アプリケーションがSiebelシステムに接続するために使用します。これらのパラメータの詳細は、Siebelのドキュメントを参照するか、Siebelシステム管理者に問い合せてください。

      リポジトリ・マネージャ

      リポジトリを指定しない場合、利用可能なすべてのリポジトリからオブジェクトの全リストが戻されます。指定したリポジトリが見つからない場合は、空のオブジェクト・リストが戻されます。

      指定するパラメータは、Siebelクライアント・アプリケーションがSiebelシステムに接続するために使用するパラメータです。これらのパラメータの詳細は、Siebelのドキュメントを参照するか、Siebelシステム管理者に問い合せてください。


    注意:


    通常、これらのパラメータは、Siebelサーバーのroot/bin/<language>ディレクトリに格納されるSiebel構成ファイルにあります。languageは、インストールした言語のSiebelコードです(アメリカ英語の場合enu)。たとえば、Windowsプラットフォーム上のSiebelバージョン7以上の場合、Siebel Call Centerモジュールについては、これらの値はuagent.cfgファイルにあります。詳細は、Siebel管理者に確認するか、Siebel Bookshelfのドキュメントを参照してください。

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

    作成したターゲットが、左ペインの「Siebel」ノードの下に表示されます。

定義済のターゲットへの接続

定義済のターゲットに接続する手順は、次のとおりです。

  1. 「Siebel」ノードを開き、接続するターゲットの名前をクリックします。

    Siebelターゲット
    図siebel_target.gifの説明

  2. 右ペインで、そのターゲットのパスワードを入力します。

  3. 左ペインで、ターゲット名を右クリックして「接続」を選択します。

    ターゲット・アイコンが変化し、Siebelシステムに接続されたことを示します。

    接続状態のSiebelターゲット
    図siebel_objects.gifの説明

Siebelシステムで使用可能なビジネス・オブジェクト、ビジネス・サービスおよび統合オブジェクトを参照できます。

Siebelとの接続の切断

異なるアプリケーション・システムへの複数のオープン接続を維持できますが、使用していない接続は切断することをお薦めします。

Siebelとの接続を切断する手順は、次のとおりです。

  1. 左ペインで、接続先のターゲットを選択します。

  2. ターゲット名を右クリックして「切断」を選択します。

    アプリケーション・システムから切断すると、ターゲットは削除されますが、ノードは残ります。左ペインの「SiebelConnection」ノードが変更され、ターゲットが切断されたことが反映されます。

    Siebelターゲット
    図siebel_target.gifの説明

ターゲットの編集

ターゲットを編集する手順は、次のとおりです。

  1. 左ペインで、編集するターゲットが切断されていることを確認します。

  2. 切断されたターゲットを右クリックして「編集」を選択します。

    ターゲットの編集
    図edit_target.gifの説明

    右側に「編集」ペインが表示されます。

  3. ターゲットの情報を変更します。

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

Siebelへのターゲットの削除

ターゲットは、切断して閉じるだけではなく、削除することもできます。ターゲットを削除すると、Application Explorerの左ペインのSiebelターゲットのリストからそのノードが消去されます。

ターゲットを削除する場合は、実行時の準備としてOracle Application Serverを再起動してリポジトリを更新しておく必要があります。

ターゲットを削除する手順は、次のとおりです。

  1. 左ペインでターゲットを選択します。

  2. ターゲットを右クリックして「削除」を選択します。

    確認ダイアログ・ボックスが表示されます。

  3. 選択したターゲットを削除するには、「OK」をクリックします。

    「Siebel接続」ノードが左ペインから削除されます。

アプリケーション・システム・オブジェクトの表示

Application Explorerでは、Siebelアプリケーション・システムのすべてのオブジェクトを表示できます。これにより、Siebelデータ構造を理解できます。パラメータ、データ型およびSiebelデータのその他の属性を右ペインで確認できます。

メタデータの表示

メタデータを表示する手順は、次のとおりです。

  1. Application Explorerを起動していない場合は起動し、Siebelシステムに接続します。

  2. 左ペインで、スキーマの生成対象のコンポーネントを含む「ビジネス・オブジェクト」または「ビジネス・サービス」を開きます。

  3. 「ビジネス・オブジェクト」または「ビジネス・サービス」ノードを開きます。

  4. 「ビジネス・コンポーネント」または「ビジネス・サービス」ノードを開き、その下にあるオブジェクトを表示します。

  5. 右ペインで、プロパティ表の「表」行にある省略記号(...)をクリックします。

    メータデータ表が右ペインに表示されます。

    Siebelオブジェクトのメタデータ表
    図app_exp_showmetadata.gifの説明

XMLスキーマの作成

Application Explorerを使用して、ビジネス・サービスおよびビジネス・コンポーネントのサービス・スキーマを作成できます。

次のトピックでは、J2CA環境またはWebサービス環境で使用するためにOracleAS Adapter for Siebelをデプロイするときに、アダプタ用のスキーマを作成する方法について説明します。OracleAS Adapter for SiebelをWebサービス環境にデプロイする場合は、「Webサービスの作成およびテスト(BSE構成のみ)」を参照してください。

Siebelのビジネス・オブジェクトまたはビジネス・サービス用のXMLスキーマの作成

Siebelのビジネス・サービス・メソッド(Addメソッドなど)およびビジネス・コンポーネント用のスキーマは、Application Explorerを使用して作成します。 スキーマを作成した後、スキーマを使用して、ビジネス・サービスまたはビジネス・コンポーネントのサービス・リクエスト・スキーマとレスポンス・スキーマを生成できます。

Siebelビジネス・オブジェクトには、1つ以上のSiebelビジネス・コンポーネントが含まれます。ビジネス・コンポーネントは、関連するビジネス・オブジェクトをクリックすると表示できます。

次の図は、Accountビジネス・オブジェクトを開いてすべてのビジネス・コンポーネントを表示したものです。

SiebelのAccountビジネス・オブジェクトが開かれた状態
図account_expanded.gifの説明

Siebelのビジネス・コンポーネントまたはビジネス・サービス用のXMLスキーマの作成

ビジネス・コンポーネントまたはビジネス・サービスに対してサービスのリクエスト・スキーマとレスポンス・スキーマを生成する手順は、次のとおりです。

  1. Application Explorerを起動していない場合は起動し、Siebelシステムに接続します。

  2. 左ペインで「ビジネス・オブジェクト」または「ビジネス・サービス」ノードを開きます。

  3. 「ビジネス・コンポーネント」または「ビジネス・サービス」を開き、その下にあるオブジェクトを表示します。

    • 「ビジネス・コンポーネント」の場合は、「ビジネス・オブジェクト」ノードを開き、使用するビジネス・コンポーネントを開いてから、使用するノードを開き、スキーマを作成する方法を選択します。

      insertメソッド
      図app_exp_select_busobject.gifの説明

    • 「Siebelビジネス・サービス」の場合は、スキーマの作成対象のオブジェクトを含む「ビジネス・サービス」ノードを開きます。

      addAccountオブジェクト
      図simple_add_ac.gifの説明

  4. ノードを右クリックして「スキーマの生成」を選択します。

    Application ExplorerがSiebelリポジトリにアクセスし、スキーマを作成します。

    次のようなスキーマ・タブが右ペインに表示されます。

    「スキーマ」タブ
    図app_exp_bus-obj_schema_t.gifの説明

  5. スキーマを表示するには、表示するスキーマに対応するタブをクリックします。

    右側にスキーマが表示されます。

    アダプタにより生成されるスキーマの例
    図app_exp_sieb_acct_schema.gifの説明

特定のSiebelオブジェクトの検索

Application Explorerの検索機能を使用すると、Siebelオブジェクトまたはノードをすばやく検索できます。

  1. Application Explorerを起動していない場合は起動し、ターゲットを介してSiebelシステムに接続します。

  2. ターゲットを開き、ビジネス・オブジェクト、ビジネス・サービスまたは統合オブジェクトを選択します。

  3. 右ペインで、カーソルを「操作」の上に置いて「検索」を選択します。

  4. 検索するノードまたはオブジェクトの名前(Accountなど)をテキスト・エントリ・ボックスに入力します。

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

    検索に一致するSiebel項目を含むリストが表示されます。

  6. 該当する項目を選択します。

    Application Explorerによって該当する項目が検索されます。

指定した順序でフィールドを戻す

XMLスキーマからリクエスト・ドキュメントを作成してSiebelシステムを問い合せる場合、予想されるレスポンスを、問合せで指定した特定のフィールドに制限できます。レスポンスには、指定した順序でフィールドが含まれます。フィールドのセットを指定しない場合、レスポンス・ドキュメントにはセット全体が含まれます。

たとえば、次の問合せはすべてのフィールドを戻します。

<m:Siebel location="S/BO/Account/Account/queryWithView" view="AllView">
  <m:select>
   <m:Name>Yelena*</m:Name>
  </m:select>
</m:Siebel>

次の問合せは、「名前」、「場所」およびアカウント・ステータスの各フィールドのみを含むレスポンスを返します。

<m:Siebel location="S/BO/Account/Account/queryWithView" view="AllView">
  <m:select>
    <m:Name>Yelena*</m:Name>
  </m:select>
  <m:field>Name</m:field>
  <m:field>Location</m:field>
  <m:field>Account Status</m:field>
</m:Siebel>

QueryWithViewの使用

ビジネス・コンポーネントの場合、iWay Application Adapter for SiebelによりInsert、Update、DeleteおよびQueryが有効になります。QueryWithViewというメソッドも有効になります。Viewモードは、Siebelが提供する表示機能です。

QueryWithViewを使用すると、Siebel Viewモードをパラメータとして指定できます。APIパラメータを使用すると、ユーザーが構成したSiebel環境に応じて、様々な方法でデータを表示できます。

様々な表示モードに基づいてユーザーがレコードを取得できるようにする場合を除いて、Queryを使用できます。この場合、QueryWithViewを使用します。QueryWithViewモードまたはSiebelの表示の概念の詳細は、Siebel管理者に確認してください。

次のレベルを使用できます。

Siebel統合オブジェクト用のスキーマの作成

Siebel統合オブジェクト用のXMLスキーマを作成するには、Siebel ToolsのSchema Wizardを使用して最初にXDRスキーマを生成する必要があります。

XDRスキーマは、統合オブジェクト用のスキーマを生成するときにApplication Explorerへの入力として使用されます。XDRスキーマを生成した後、Application ExplorerではXDRファイルを使用してXMLスキーマを生成します。

次の点に注意してください。

OracleAS Adapter for Siebelでは、イベントの処理にSiebel XMLを使用して、Siebel統合オブジェクトへのアクセスをサポートします。サポートされているトランスポートを介してSiebel統合オブジェクトを使用するには、Siebelワークフローが必要です。

Siebel統合オブジェクト用のSiebel XDRまたはXSDスキーマの作成

Siebel XDRまたはXSDスキーマを生成する手順は、次のとおりです。

  1. Siebel Toolsにログオンします。

    Siebelのログオン・ウィンドウ
    図sibu_04_logon.gifの説明

    次の手順を実行します。

    1. ユーザーIDとパスワードを入力します。

    2. リストからデータベースを選択します。

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

    「Siebel Tools」ウィンドウが表示されます。右ペインに統合オブジェクトが表示されます。

    「Siebel Tools」ウィンドウ
    図sibu_04_integobj.gifの説明

  3. スキーマを作成するには、統合オブジェクト(Sample Accountなど)を選択します。

  4. 「Generate Schema」をクリックします。

    「Generate XML Schema」ウィザードが表示されます。

    Siebelの「Generate XML Schema」の開始ウィンドウ
    図sibu_genxmlschema.gifの説明

    次の手順を実行します。

    1. 「Select a Business Service」リストから、「EAI XML XSD Generator」(XDRスキーマの場合)または「EAI XML XSD Generator」(XSDスキーマの場合)を選択します(Siebel 7.5以上の場合)。

    2. 「Select an envelope type」リストから「Siebel Message envelope」を選択します。

    3. 「Choose the file name」フィールドに、XDRスキーマのファイル名とApplication Explorerでアクセスできるディレクトリを指定します。


      注意:


      XDRスキーマ・ファイルは、Application Explorerと同じコンピュータ上のディレクトリに保存する必要があります。

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

    これで、Application Explorerを使用してSiebel統合オブジェクトの(IO)ノードを作成できます。

Siebelの統合オブジェクト(IO)ノードの作成

Siebelの「統合オブジェクト」ノードを作成するには、次の手順を実行します。

  1. Application Explorerで、定義済のターゲットに接続します。ターゲットへの接続方法の詳細は、「定義済のターゲットへの接続」を参照してください。

    アイコン上に「X」が表示されなくなります。これは、ターゲットが接続状態であることを示します。

    「Siebel」ノードの選択
    図siebel_objects.gifの説明

  2. 「統合オブジェクト」を開き、「Sample Account」を選択します。

  3. 「Sample Account」ノードを右クリックして「IOノードの追加」を選択します。

    IOノードの追加ダイアログ・ボックスが表示されます。

    IOノードの追加
    図add_io_node.gifの説明

    次の点に注意してください。

    • Siebel 7.5以上の場合: Siebelツールから直接XSDスキーマを生成します。Application ExplorerでWebサービスを作成する場合、XSDスキーマを使用します。Siebelツールを使用してXSDスキーマを生成した後、そのXSDスキーマを使用してIOノードおよびWebサービスを作成します。

    • Siebel 7.0の場合: Siebelツールから直接XSDスキーマを生成することはできません。XDRスキーマのみ作成できます。Webサービスを作成する前に、まずApplication Explorerを使用してXDRスキーマからXSDスキーマを生成する必要があります。

  4. 「ノード名」フィールドにノード名(SampleAccountなど)を入力し、「スキーマの場所」フィールドにSample AccountのXDRファイルへのパスを入力します。

  5. XSDスキーマがすでに生成されている場合は、XSDスキーマを選択します。Siebelが生成したXDRスキーマを使用している場合は、XSDスキーマ・オプションを選択しないでください。

  6. 「プロトコル」リストからプロトコルを選択します。

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

    次のダイアログ・ボックスが表示されます。

    IOノードの追加ダイアログ・ボックス
  8. 次の手順を実行します。

    1. 「SWE URL」フィールドにベースSWE URLを入力します。次に例を示します。

      http://web_server/eai/start.swe
      

      ここで、web_serverは、Siebel SWEをホストしているWebサーバーの名前です。

    2. 「SWE External Source」フィールドで、実行するeai.cfgファイル内のセクションである[HTTP Services]セクションを入力します。

    3. 「SWE External Command」フィールドで、「Execute」など、使用するコマンドを入力します。

    4. 「ユーザー名」および「パスワード」フィールドで、Siebel SWEに接続するための有効なユーザー名とパスワードを入力します。

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

    新しいIOノードが統合オブジェクトの「Sample Account」ノードの下にリストされます。

    新しいIOノード

    これで、XMLスキーマを作成できます。

Siebel統合オブジェクト用のXMLスキーマの作成

Siebel用の「統合オブジェクト」ノードを作成した後、Application Explorerを使用してXMLスキーマを作成できます。

XMLスキーマを作成する手順は、次のとおりです。

  1. Application Explorerで「統合オブジェクト」ノードを開き、Siebelシステムの統合オブジェクトを参照します。

    「Siebel統合オブジェクト」ノードが開かれた状態
    図sampleaccount.gifの説明

  2. 下にスクロールし、統合オブジェクト(Sample Accountなど)を選択します。

    統合オブジェクト用のXMLイベント・スキーマが自動的に作成されます。

  3. 右ペインの「イベント・スキーマ」タブをクリックします。

    次の図に示すように、右ペインにXMLイベント・スキーマが表示されます。

    Siebel統合オブジェクト用に生成されたスキーマ
    図app_exp_sampacct_bo_schema.gifの説明

Webサービスの作成およびテスト(BSE構成のみ)

サーブレットBSEを正しく構成した後、アダプタで使用するSiebelオブジェクト用のビジネス・サービス(Webサービスとも呼びます)を生成できます。


注意:


アダプタのJ2EE Connector Architecture(J2CA)実装では、Webサービスは使用できません。アダプタがOracleAS Adapter J2CAを使用するようにデプロイされている場合は、共通クライアント・インタフェースがアダプタを使用して統合サービスを提供します。

この項のトピックは次のとおりです。

統合オブジェクト階層タイプのメソッド引数を持つビジネス・サービス用のサービスの作成(Siebelメッセージ)

OracleAS Adapter for Siebelを使用すると、階層データ型のメソッド引数を持つメソッドを含むビジネス・サービス用のサービス・ノードを追加できます。

重要な制限:

  • アダプタでサポートされるのは、統合オブジェクト階層データ型のみです。

  • 「サービス」ノードを追加するには、統合オブジェクトのXSDスキーマを事前に生成しておく必要があります。Siebel統合オブジェクト用のXSDスキーマ生成の詳細は、「Siebel統合オブジェクト用のスキーマの作成」を参照してください。

  • 階層データ型に設定できるのは、サービス・ノードに追加するビジネス・サービス・メソッドのメソッド引数の1つのみです。

  • メソッド引数XMLCharEncodingはサポートされていません。XMLペイロードでこの要素を空白にします。 UTF-8またはUTF-16など、有効なXMLCharEncoding値を入力すると、次のエラーが表示されます。

    Invocation of Service failed.
    

サービスを作成する手順は、次のとおりです。

  1. 該当する「ビジネス・サービス」ノードを選択します。

  2. サービスを作成するビジネス・サービス・メソッド引数を右クリックし、サービス・ノードの追加を選択します。

    サービス・ノードの追加ダイアログ・ボックスが表示されます。

    「サービス・ノードの追加」ダイアログ・ボックス
    図add_servnode_dialog.gifの説明

  3. 次の手順を実行します。

    1. サービス・ノード名を指定します。

    2. 説明を入力します(オプション)。

    3. XSDスキーマ・ファイルへのフルパス(ファイル名を含む)を指定します。

    4. XSDスキーマ・ファイルのルート要素を指定します。統合オブジェクトの多くのXSDスキーマでは、ルート要素はSiebelMessageです。

    5. XSDスキーマが統合オブジェクト用かどうかを指定します。

      重要: このチェック・ボックスが選択されていることを確認する必要があります。

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

    ビジネス・サービス・オブジェクトの下に「サービス」ノードが表示されます。

    ビジネス・サービス・オブジェクトの下に表示される「サービス」ノード
    図servnodeadded.gifの説明

    このノードを右クリックすると、Webサービスを作成できます。リクエスト・スキーマおよびレスポンス・スキーマは、右ペインに表示されます。

次の手順は、ビジネス・オブジェクト用のWebサービスを作成する手順を説明しています。

Webサービスの作成

Siebelビジネス・オブジェクト用のWebサービスを生成する手順は次のとおりです。

  1. Siebelシステムに接続します。

  2. 「ビジネス・オブジェクト」ノードを開きます。

  3. Webサービスを作成する「ビジネス・コンポーネント」を開きます。

    Accountビジネス・コンポーネントが開かれた状態
    図busobject_query.gifの説明

  4. オブジェクトを開き、Webサービスを作成するメソッド(Accountの下のQueryWithViewなど)を選択します。

  5. ビジネス・サービスの作成元となるノードを右クリックし、「ビジネス・サービスの作成」を選択します。

    「Webサービスの作成」ダイアログ・ボックスが表示されます。

    ビジネス・オブジェクトを新規または既存のWebサービスのメソッドとして追加できます。次の手順を実行します。

    1. 「既存のサービス名」リストから「<新規サービス>」または既存のサービスを選択します。

    2. 新規サービスを作成する場合はサービス名を指定します。この名前により、「ビジネス・サービス」ノードの下のサービス・リストでWebサービスが識別されます。

    3. サービスの説明を入力します(オプション)。

    4. 使用可能なライセンスを1つ選択します。

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

    「ライセンスおよびメソッド」ダイアログ・ボックスが表示されます。次の手順を実行します。

    1. 「ライセンス」フィールドで、Webサービスに割り当てるライセンス・コードを1つ以上選択します。複数のライセンス・コードを選択するには、[Ctrl]キーを押しながらライセンスをクリックします。

    2. 「メソッド名」フィールドに、わかりやすいメソッド名を入力します。

    3. 「説明」フィールドにメソッドの簡潔な説明を入力します。

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

    Application Explorerのビューが「ビジネス・サービス」ノードに切り替わり、左ペインに新規Webサービスが表示されます。

Webサービスのテスト

Siebelビジネス・オブジェクトに対してWebサービスを作成した後は、サービスをテストして正常に機能することを確認します。Application ExplorerにはWebサービスをテストするためのテスト・ツールが含まれています。

ビジネス・オブジェクト用のWebサービスのテスト

  1. Application Explorerの左ペインで「ビジネス・サービス」ノードを開きます。

  2. 「サービス」ノードを開きます。

  3. テストするビジネス・サービスの名前を選択します。

    新規Webサービスが「ビジネス・サービス」タブ上に追加された状態
    図app_exp_test_select_busobj.gifの説明

  4. サービスの下の「メソッド」ノードを開き、テストするメソッドを選択します。

    右ペインにテスト・オプションが表示されます。

    XML入力が必要なWebサービスをテストする場合は、入力フィールドが表示されます。

  5. 「起動」をクリックします。

    Application Explorerの結果ペインに結果が表示されます。

    Webサービスのテストの正常終了
    図querywithview_results.gifの説明

ビジネス・サービス用のWebサービスのテスト

Siebelビジネス・サービスに対してWebサービスを作成した後は、サービスをテストして正常に機能することを確認します。Application ExplorerにはWebサービスをテストするためのテスト・ツールが含まれています。

  1. 「ビジネス・サービス」ノードが開かれていない場合は開きます。

  2. 「サービス」ノードを開きます。

  3. テストするビジネス・サービスの名前を選択します。

  4. 「メソッド」ノードを開き、テストするメソッドの名前を選択します。

    右ペインにテスト・オプションが表示されます。

    XML入力が必要なWebサービスをテストする場合は、入力フィールドが表示されます。

  5. 適切な情報を指定します。

  6. 「起動」をクリックします。

    Application Explorerの結果ペインに結果が表示されます。

IDの伝播

サード・パーティ製のXMLエディタ(XMLSPYなど)を使用してWebサービスをテストまたは実行する場合、SOAPヘッダーに指定するユーザー名とパスワードは、有効な値である必要があり、Siebelへの接続に使用されます。Application Explorerを使用してターゲットを作成するときにSiebelに指定するユーザー名とパスワードの値は、このWebサービス・リクエストに対して上書きされます。Webサービス用のWSDLファイルに含まれるSOAPヘッダーの例を次に示します。

<SOAP-ENV:Header>
  <m:ibsinfo xmlns:m="urn:schemas-iwaysoftware-com:iwse">
    <m:service>String</m:service>
    <m:method>String</m:method>
    <m:license>String</m:license>
    <m:disposition>String</m:disposition>
    <m:Username>String</m:Username>
    <m:Password>String</m:Password>
    <m:language>String</m:language>
  </m:ibsinfo>
</SOAP-ENV:Header>

<m:disposition>タグと<m:language>タグは不要なため、SOAPヘッダーから削除できます。

WSDLの生成(J2CA構成のみ)

WebサービスのWeb Service Definition Language(WSDL)の記述を使用すると、ホスト・サーバー内の他のサービスでそのサービスを使用できます。アダプタのリクエスト/レスポンス(アウトバウンド)JCAサービスおよびイベント通知(インバウンド)JCAサービスを作成するには、Application Explorerを使用します。


注意:


「インバウンドJCAサービスの作成(イベント)」オプションは、選択したノードがイベントをサポートしている場合のみ使用できます。

リクエスト/レスポンス・サービス用のWSDLファイルを生成する手順は、次のとおりです。

  1. 接続状態のSiebelターゲットの下で、「ビジネス・オブジェクト」「アカウント」「アカウント」を開きます。オブジェクトにナビゲートし、右クリックします。

    次のメニューが表示されます。

    WSDL生成
    図wlae_exportwsdl.gifの説明

  2. 「アウトバウンドJCAサービスの作成(リクエスト/レスポンス)」を選択します。

    「WSDLのエクスポート」ダイアログ・ボックスが表示されます。

    「WSDLのエクスポート」ダイアログ・ボックス
    図export_wsdl.gifの説明

  3. ファイルのデフォルト名を受け入れます。

    .wsdlファイル拡張子が自動的に追加されます。デフォルトでは、リクエスト/レスポンス・サービスに対して生成されるWSDLファイル名の最後には_invokeが付き、イベント通知に対して生成されるWSDLファイル名の最後には_receiveが付きます。

    サブフォルダ内のWSDLファイルを整理して、独自のWSDL階層構造を作成できます。OracleAS_home\adapters\application\wsdls\の下にフォルダを作成します。JDeveloperのWSILブラウザには、WSDL階層の完全なツリー構造が表示されます。

  4. 修飾された名前がデフォルトの要素フォームとして選択されていることを確認します。

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

    WSDLファイルは指定した場所に保存されます。

    イベント通知用のWSDLを生成する手順は、リクエスト/レスポンスの場合に似ています。イベント通知用のWSDLを生成するには、まずイベントごとにチャネルを作成する必要があります。

イベント・アダプタの構成

イベントは、Siebelシステムで特定のビジネス条件が満たされるかトリガーされることにより、生成されます。イベントを使用して、アプリケーション内でアクションをトリガーできます。たとえば、顧客情報への更新を反映してデータベースが更新されるようにすることができます。この時点でアプリケーションを実行する必要がある場合、アプリケーションはこのイベントのコンシューマです。

アプリケーション・システムへの接続を作成した後、Application Explorerを使用してイベントを追加できます。 イベントを構成するには、チャネルを作成する必要があります。


注意:


J2CA構成を使用している場合は、イベントごとに新しいチャネルを作成し、WSDLを生成するときにこのチャネルを選択する必要があります。チャネルの作成は、J2CA構成の場合のみ必要です。

チャネルは、バックエンド・システムの特定インスタンスへの構成済の接続を表します。 チャネルにより、1つ以上のイベント・ポートが、アダプタにより管理されている特定のリスナーにバインドされます。 詳細は、「チャネルの作成および変更」を参照してください。

IOノードの追加機能は、イベント構成では適用されないことに注意してください。

チャネルの作成および変更

次の手順では、イベント用チャネルの作成方法について説明します。すべての定義済イベント・ポートを1つのチャネルに関連付ける必要があります。

チャネルを作成、変更または削除する場合は、実行時の準備としてOracle Application Serverを再起動して変更を認識させ、リポジトリを更新しておく必要があります。


注意:


J2CA構成を使用している場合は、イベントごとに新しいチャネルを作成し、WSDLを生成するときにこのチャネルを選択する必要があります。チャネルの作成は、J2CA構成の場合のみ必要です。

OracleAS Adapter for SiebelをBPEL Process Managerと統合する場合、チャネルはBPEL PM Serverによって管理されているため、チャネルを開始しないでください。 テストおよびデバッグのためにチャネルを開始する場合は、実行に移行する前にチャネルを停止してください。


次の3タイプのチャネルを使用できます。

  • HTTP

  • MQSeries

  • File


注意:


チャネルは、OracleAS Adapter for Siebelがインストールされているシステムでのみ構成できます。

HTTPチャネルの作成

チャネルを作成する手順は、次のとおりです。

  1. 「イベント」ノードをクリックします。

    「イベント」ウィンドウが表示されます。左ペインに表示されるアダプタが、イベントをサポートしています。

  2. 左ペインで「Siebel」ノードを開きます。

    「ポート」および「チャネル」ノードが表示されます。

  3. 「チャネル」を右クリックして「チャネルの追加」を選択します。

    「チャネルの追加」ダイアログ・ボックスが表示されます。

    「チャネルの追加」ダイアログ・ボックス
    図add_channel2.gifの説明

    次の手順を実行します。

    1. NewChannelなどのチャネル名を入力します。

    2. 簡潔な説明を入力します。

    3. 「プロトコル」ドロップダウン・リストから「HTTPリスナー」を選択します。

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

  5. 表示されたダイアログ・ボックスに、次の表に示すシステム情報を入力します。

    パラメータ 説明
    ポート Siebelイベント・データをリスニングするポート。
    サーバー・ポート ホスト・データベースがリスニングしているポート。
    同期タイプ 同期タイプはSiebelイベントには適用されません。

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

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

    チャネルの説明、ステータスおよび使用可能なポートが表示されます。すべての情報は、作成したチャネルに関連しています。このチャネルは、左ペインの「チャネル」ノードの下にも表示されます。

    「チャネル」ノードの下に新規チャネルが追加された状態
    図app_exp_new_channel_added.gifの説明

    アイコン上に表示される「X」は、そのチャネルが切断状態になっていることを示します。イベント構成をアクティブ化するには、チャネルを開始する必要があります。

  7. チャネル・ノードを右クリックして「開始」を選択します。

    作成したチャネルがアクティブになります。左ペインでアイコン上に表示されていた「X」が消えます。

  8. チャネルを停止するには、チャネルを右クリックして「停止」を選択します。

MQSeriesリスナーの作成

MQSeriesリスナーを作成する手順は、次のとおりです。

  1. 「イベント」ノードをクリックします。

    「イベント」ウィンドウが表示されます。左ペインに表示されるアダプタが、イベントをサポートしています。

  2. 左ペインで「Siebel」ノードを開きます。

    「ポート」および「チャネル」ノードが表示されます。

  3. 「チャネル」ノードを右クリックして「チャネルの追加」を選択します。

    「チャネルの追加」ペインが表示されます。次の手順を実行します。

    1. NewChannelなどのチャネル名を入力します。

    2. 簡潔な説明を入力します。

    3. 「プロトコル」ドロップダウン・リストから「MQSeriesリスナー」を選択します。

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

  5. 表示されたダイアログ・ボックスに、システム情報を次のように入力します。

    1. 「リクエスト」タブで、次のパラメータの値を入力します。

      パラメータ 説明
      キュー・マネージャ名 MQサーバーが配置されているホスト(MQクライアントのみ)。
      MQClient運用のためのMQサーバー・ホスト ホスト・データベースがリスニングしているポート。
      MQClient運用のためのMQサーバー・ポート MQサーバーのキュー・マネージャに接続する番号(MQクライアントのみ)。
      REQUEST
      REQUEST_RESPONSE
      REQUEST_ACK
      
      MQClient運用のためのMQサーバー・チャネル リモートのMQサーバー・キュー・マネージャに接続するチャネルの大/小文字を区別した名前(MQクライアントのみ)。MQSeriesのデフォルト・チャネル名は、SYSTEM.DEF.SVRCONNです。
      ドキュメント・タイプXML デフォルト選択のままにします。
      リクエスト・キュー名 メッセージがルーティングされ、リクエスト・ドキュメントが受け取られるキュー。キューの名前には大/小文字区別があり、次の書式に従います。
      Host\queue type$\qName
      

      Host

      MQSeriesのキューイング・システムが実行されているシステムの名前です。

      queue type

      プライベート・キューはActive Directoryに公開されていないキューで、自身が配置されているローカル・コンピュータ上にのみ表示されます。プライベート・キューにアクセスできるのは、キューのフルパス名または書式名を認識するMessage Queuingアプリケーションのみです。

      qName

      メッセージが配置されるキューの名前です。次に例を示します。

      iwaykxc1\Private$\siebel
      

    2. 「レスポンス」タブで、次のパラメータの値を入力します。

      パラメータ 定義
      同期タイプ 同期タイプはSiebelイベントには適用されません。

    3. 「詳細」タブで、次のパラメータの値を入力します。

      パラメータ 定義
      メッセージ待機間隔(ミリ秒) 新規入力を検査する間隔(ミリ秒単位)。デフォルトは3秒です。オプション。
      操作モード 「逐次」または「スレッド化」を選択します。
      • 「逐次」は、リクエストが1つずつ処理されることを示します。

      • 「スレッド化」は、同時に複数のリクエストが処理されることを示します。

      スレッド制限 スレッド化処理を選択した場合は、同時に処理できるリクエストの最大数を指定します。

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

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

    チャネルの説明、ステータスおよび使用可能なポートが表示されます。すべての情報は、作成したチャネルに関連付けられています。チャネルは、左ペインの「チャネル」ノードの下にも表示されます。

    アイコン上に表示される「X」は、そのチャネルが切断状態になっていることを示します。イベント構成をアクティブ化するには、チャネルを開始する必要があります。

  7. チャネル・ノードを右クリックして「開始」を選択します。

    作成したチャネルがアクティブになります。左ペインでアイコン上に表示されていた「X」が消えます。

  8. チャネルを停止するには、チャネルを右クリックして「停止」を選択します。

ファイル・リスナーの作成

  1. 「イベント」ノードをクリックします。

    「イベント」ウィンドウが表示されます。左ペインに表示されるアダプタが、イベントをサポートしています。

  2. 左ペインで「Siebel」ノードを開きます。

    「ポート」および「チャネル」ノードが表示されます。

  3. 「チャネル」ノードを右クリックして「チャネルの追加」を選択します。

    「チャネルの追加」ダイアログ・ボックスが表示されます。次の手順を実行します。

    1. NewChannelなどのチャネル名を入力します。

    2. 簡潔な説明を入力します。

    3. 「プロトコル」ドロップダウン・リストから「ファイル・リスナー」を選択します。

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

  5. 表示されたダイアログ・ボックスに、システム情報を次のように入力します。

    1. 「リクエスト」タブで、次のパラメータの値を入力します。

      パラメータ 説明
      ポーリング場所 Siebel XMLファイルのターゲット・ファイル・システムの場所。
      ファイル・マスク この操作によって生成される出力ファイルに使用するファイル名。

    2. 「レスポンス」タブで、次のパラメータの値を入力します。

      パラメータ 定義
      同期タイプ 同期タイプはSiebelイベントには適用されません。
      レスポンス/確認ディレクトリ レスポンスまたは確認が送信されるディレクトリ。

    3. 「詳細」タブで、次のパラメータの値を入力します。

      パラメータ 定義
      エラー・ディレクトリ エラーのあるドキュメントが書き込まれるディレクトリ。
      ポーリング間隔(ミリ秒) 新規入力を検査する間隔(ミリ秒単位)。デフォルトは3秒です。オプション。
      処理モード 「逐次」または「スレッド化」を選択します。
      • 「逐次」は、リクエストが1つずつ処理されることを示します。

      • 「スレッド化」は、同時に複数のリクエストが処理されることを示します。

      スレッド制限 スレッド化処理を選択した場合は、同時に処理できるリクエストの最大数を指定します。

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

    「サマリー」ペインが表示されます。 チャネルの説明およびステータスが表示されます。すべての情報は、作成したチャネルに関連付けられています。チャネルは、左ペインの「チャネル」ノードの下にも表示されます。

    アイコン上に表示される「X」は、そのチャネルが切断状態になっていることを示します。イベント構成をアクティブ化するには、チャネルを開始する必要があります。

  7. チャネル・ノードを右クリックして「開始」を選択します。

    作成したチャネルがアクティブになります。

    左ペインでアイコン上に表示されていた「X」が消えます。

  8. チャネルを停止するには、チャネルを右クリックして「停止」を選択します。

チャネルの編集

チャネルを編集する手順は、次のとおりです。

  1. 左ペインで、編集するチャネルを選択します。

  2. チャネルを右クリックして「編集」を選択します。

    「チャネルの編集」ペインが表示されます。

  3. チャネル構成を必要に応じて変更し、「OK」をクリックします。

チャネルの削除

チャネルを削除する手順は、次のとおりです。

  1. 左ペインで、削除するチャネルを選択します。

  2. チャネルを右クリックして「削除」を選択します。

    確認ダイアログ・ボックスが表示されます。

  3. 選択したチャネルを削除するには、「OK」をクリックします。

    チャネルが左ペインのリストから削除されます。