6 トラブルシューティングとエラー・メッセージ

この章では、Siebelへの接続時の制限事項および回避方法について説明します。項目は次のとおりです。

トラブルシューティング
BSEエラー・メッセージ

トラブルシューティング

このトピックでは、Siebelのトラブルシューティング情報を次の4つのカテゴリにわけて説明します。

OracleAS Adapter for Siebelの一般的な使用方法における注意事項
Application Explorer
Siebel
OracleAS Adapter J2CA
OracleAS Adapter Business Services Engine（BSE）

注意:

トラブルシューティングに関連するログ・ファイル情報は、次の場所にあります。

OracleAS Adapter J2CAのトレース情報は、OracleAS_home\opmn\logsディレクトリにあります。
BSEのトレース情報は、OracleAS_home\j2ee\home\applications\ws-app-adapter\ibse\ibselogsディレクトリにあります。
Application Explorerのログ・ファイルは、OracleAS_home\adapters\application\toolsディレクトリにあります。

OracleAS Adapter for Siebelの一般的な使用方法における注意事項

OracleAS Adapter for Siebelには、次の制限事項があります。

サービスおよびイベントでは、HTTPSプロトコルはサポートされていません。
結合仕様による複数値（MVG）フィールドの更新はサポートされていません。
接続が失われた場合、アダプタはSiebelに自動的に再接続しません。

Application Explorer

デバッグとテストの目的でWindows上でApplication Explorerを使用する場合は、次の場所にあるバッチ・スクリプトae.batをロードします。

OracleAS_home\adapters\application\tools

UNIXの場合は、次の場所にあるシェル・スクリプトiwae.shをロードします。

OracleAS_home/adapters/application/tools

重要な前提条件:

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

エラー	解決方法
Application Explorerの「アダプタ」ノード・リストに「Siebel」が表示されない。	Siebelの配布メディアとともに提供されているSiebel jarファイルが`OracleAS_home\adapters\application\lib`ディレクトリにあることを確認してください。たとえばSiebel 7.03環境の場合は、`SiebelJI_Common.jar`と`SiebelJI_enu.jar`が`OracleAS_home\adapters\application\lib`ディレクトリに置かれている必要があります。
「ターゲット・タイプ」ドロップダウンに「JavaデータBean接続」しか含まれていないが、COM接続タイプが必要である。	Application Explorerのホストとなるシステム上にSiebelシン・クライアントが正しくインストールされ、適切なCOM環境が使用可能なことを確認してください。
Siebelターゲットに接続しようとすると、Siebel Gatewayサーバーの名前を含んだエラー・メッセージが次に例を示します。 `Problem activating adapter (<server_name>). 詳細はログを確認してください。`	使用するターゲットに対してSiebel Gatewayサーバーの名前が正しく定義されていることを確認してください。
Siebelターゲットへ接続しようとすると次のエラーを受信する。 `アダプタのアクティブ化で問題が発生しました。（無効なログオン・パラメータ・セットを入力しました。ログオン・パラメータを再入力してください。）詳細はログを確認してください。`	Siebelシステムへ接続するためのユーザーIDおよびパスワード・パラメータの値が正しいことを確認してください。
Siebelターゲットへ接続しようとすると次のエラーを受信する。 `アダプタのアクティブ化で問題が発生しました。（ネームサーバー接続を取得できませんでした）詳細はログを確認してください。`	Siebel環境へのネットワークの接続性を調べてください。ネットワークの問題を訂正して接続をやり直してください。
Siebelターゲットへ接続しようとすると次のエラーを受信する。 `アダプタのアクティブ化で問題が発生しました。（NSReadKeyリクエストが失敗しました（エラー情報なし）...）詳細はログを確認してください。`	「Siebelサーバー」、「企業名」および使用中のターゲットの「オブジェクト・マネージャ」に対して定義された値が正しいことを確認し、接続をやり直してください。
Siebelターゲットへ接続しようとすると次のエラーを受信する。 `アダプタのアクティブ化で問題が発生しました。(Error loading translatable messages: com.siebel.locale.enux.messages.SSAMessages_enux).詳細はログで確認してください。`	使用中のSiebelシステムへの接続に使用しているターゲットに対して、「詳細」タブの「言語」パラメータの値が正しく定義されていることを確認してください（たとえば英語の場合は`enu`）。
Siebel環境への接続には成功したが、「Application Explorer」ツリーの「ビジネス・オブジェクト」、「ビジネス・サービス」および「統合オブジェクト」の各ノードで使用可能な値がない。	Siebelのターゲット構成の「詳細」タブで指定した「リポジトリ名」にターゲットのSiebel環境のコンポーネントがないか、その「リポジトリ名」がターゲットのSiebel環境に対して有効ではありません。「リポジトリ名」が有効でコンポーネントを含んでいることを確認し、再接続してください。
実行時にログオンできずエラーが発生する。	ターゲットの作成時、またはApplication Explorerの「編集」オプションで、Siebelシステムに接続するためのパスワードを指定していない場合、Siebelに接続できません。接続パスワードは`repository.xml`に保存されていません。Application Explorerの「編集」オプションを使用してパスワードを更新してから、アプリケーション・サーバーを再起動します。
`ae.bat`（`iaexplorer.exe`ではない）をアクティブ化してApplication Explorerを起動すると、次の例外が発生する。 `java.lang.ClassNotFoundException: org.bouncycastle.jce.provider.BouncyCastleProvider`	これは害のない例外です。アダプタの機能には影響しません。次の場所からBouncyCastleファイルをダウンロードします。 `ftp://ftp.bouncycastle.org/pub`
Solaris環境でApplication Explorerを起動できない。コンソールで次の例外がスローされる。 `javax.resource.ResourceException: IWAFManagedConnectionFactory: License violation.at com.ibi.afjca.spi.IWAFManagedConnectionFactory.createConnectionFactory(IWAFManagedConnectionFactory.java:98)at com.iwaysoftware.iwae.common.JCATransport.getConnectionFactory(JCATransport.java:133)` `at com.iwaysoftware.iwae.common.JCATransport.initJCA(JCATransport.java:69)at com.iwaysoftware.iwae.common.JCATransport.<init>(JCATransport.java:62)at com.iwaysoftware.iwae.common.AdapterClient.<init>(AdapterClient.java:85)at com.ibi.bse.ConfigWorker.run(ConfigWorker.java:41)at java.lang.Thread.run(Thread.java:534)` `Could not create the connection factory.`	ユーザー・システムで`JAVACMD`が設定されていません。Application Explorerを起動する前に、次のようにして`JAVACMD`をエクスポートします。 `JAVACMD=/<jdk_home>/bin/java`（`<jdk_home>`は、JDKがインストールされているシステム上のディレクトリです。）

Siebel

リストされたエラー・メッセージは、アダプタをBSEまたはOracleAS Adapter J2CAのリポジトリ・プロジェクトとともに使用しているときに発生する可能性があります。

エラー	解決方法
Siebel環境への接続には成功したが、「Application Explorer」ツリーの「ビジネス・オブジェクト」、「ビジネス・サービス」および「統合オブジェクト」の各ノードで使用可能な値がない。	Siebelのターゲット構成の「詳細」タブで指定した「リポジトリ名」にターゲットのSiebel環境のコンポーネントがないか、その「リポジトリ名」がターゲットのSiebel環境に対して有効ではありません。「リポジトリ名」が有効でコンポーネントを含んでいることを確認し、再接続してください。
リクエストの実行中に次のエラー・メッセージが表示される。 `AdapterException: Unsupported Action: {0} Tquery`	スキーマを検証して特定のリクエストに対するメソッドが使用可能なことを確認してください。
リクエストの実行中に次のエラー・メッセージが表示される。 `AdapterException: フィールド「NFame」がビジネス・コンポーネント「Account」の定義内にありません。システム管理者にアプリケーション構成のチェックを依頼してください。`	その特定のオブジェクトに対するスキーマを参照してフィールド名がリクエスト・ドキュメント内で有効であることを確認した後、リクエストを再発行してください。
Java Data Bean Interfaceを使用してSiebel 7.7より前のリリースに接続しているとき、初回の接続損失後に再接続できない。これは、Application Explorerで短時間のネットワーク接続損失があったか、Application ExplorerがSiebelアプリケーションにログインしている間にSiebelサーバーまたはゲートウェイ・サービスが再起動した場合に発生することがあります。	Siebelアプリケーションに正常にログインするために、OC4JとApplication Explorerを再起動してください。これはSiebel APIの既知の問題です。詳細はSiebel Alert 984を参照してください。
階層データ型のメソッド引数を持つメソッドが含まれるビジネス・サービスに対してサービス・ノードを追加すると、次のエラーが発生する場合がある。 UTF-8またはUTF-16など、有効な`XMLCharEncoding`値を入力すると、次のエラーが表示されます。 Invocation of Service failed.	メソッド引数`XMLCharEncoding`はサポートされていません。XMLペイロードでこの要素を空白にします。

OracleAS Adapter J2CA

エラー	解決方法
Application ExplorerでOracleAS Adapter J2CA構成に接続しようとすると、次のエラー・メッセージが表示される。 `JCAを初期化できませんでした`	右ペインの「詳細」タブで、「ホーム」フィールドに指定したディレクトリが適切なディレクトリ（`OracleAS_home`\adapters\applicationなど）を指していることを確認してください。

BPEL Process Manager

エラー	解決方法
JDeveloperでのSiebelイベント処理プロジェクト（インバウンド）のデプロイ時にエンドポイントのアクティブ化エラーが発生する。	Application ExplorerでこのインバウンドJ2CAサービスに使用されるチャネルが停止していることを確認してください。テストまたはデバッグのためにこのチャネルを開始した場合、BPEL PMサーバーの起動前に停止する必要があります。エンドポイントのアクティブ化はBPEL Process Managerによって管理されます。
BPEL PMサーバー・コンソールに次のエラー・メッセージが表示される。 Process "TestSiebel" (revision "1.0") compilation failed. <2005-05-18 10:49:53,285> <ERROR><default.collaxa.cube.engine.deployment> <Cube ProcessLoader::create> Failed to read wsdl.Error happened when reading wsdl at "http://127.0.0.1:7777/BPELConsole/wsil/adapters/applications/QueryWithView_invoke.wsdl?wsdl", because "WSDLException: faultCode=INVALID_WSDL: Invalid XML in document at: http://127.0.0.1:7777/BPELConsole/wsil/adapters/applications/QueryWithView_invoke.wsdl?wsdl: The element type "P" must be terminated by the matching end-tag "</P>".	指定したWSDLファイルがそのURLに存在し、このファイルが有効であることを確認してください。回避策: WSDLの場所を`localhost:7777`に変更してください。デフォルトは`127.0.0.1:7777`です。代替回避策: `obsetenv.bat`（Windows）または`obsetenv.sh`（UNIX）にある`Dhttp.nonProxyHosts`リストにIPアドレスを追加してください。
実行時に2回目のメッセージの呼出しに失敗する。	必須パッチをすべてインストールしたことを確認してください。必須パッチは、Oracle Technology NetworkのWebサイト（`http://www.oracle.com/technology/index.html`）でリストおよび更新されています。
BPELプロセスのデプロイ時にJDeveloperで次の例外がスローされる。 `java.io.FileNotFoundException: \BPELConsole\wsil\adapters\applications\SampleAccount_receive.wsdl?wsdl (The system cannot find the path specified)`	必須パッチをすべてインストールしたことを確認してください。必須パッチは、Oracle Technology NetworkのWebサイト（`http://www.oracle.com/technology/index.html`）でリストおよび更新されています。

BSEエラー・メッセージ

このトピックでは、BSEを介してWebサービスを処理する際に発生する可能性がある各種のエラーについて説明します。

BSEでの一般的なエラー処理

BSEには、アダプタ・フレームワークへのSOAPゲートウェイとしての機能、および一部アダプタ用のエンジンとしての機能があります。設計時および実行時には、アダプタを使用するWebサービスの実行中に、様々な条件が原因となってBSEにエラーが発生する可能性があります。これらの条件とそれに伴うエラーの一部には、アダプタに関係なく同様に表示されるものと、使用中のアダプタに応じて異なる方法で表示されるものがあります。このトピックでは、いくつかのより一般的なエラー条件が発生した場合に予想できる状況についてアダプタ別に説明します。通常、BSE内のSOAPゲートウェイ（エージェント）は、Webサービスに必要なアダプタに SOAPリクエスト・メッセージを渡します。エラーが発生した場合の表示方法は、アダプタおよびアダプタで使用されているAPIまたはインタフェースによって異なります。一部の使用例では、SOAPゲートウェイによりSOAP障害が発生します。通常は、BSE内のSOAPエージェントが無効なSOAPリクエストを受信すると、SOAPレスポンス内でSOAP障害要素が生成されます。SOAP障害要素には、障害文字列と障害コードの要素が含まれます。障害コードには、SOAPエージェント・エラーの説明が含まれています。BSEが無効なSOAPリクエストを受信すると、次のSOAPレスポンス・ドキュメントが生成されます。

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
 <SOAP-ENV:Body>
      <SOAP-ENV:Fault>
         <faultcode>SOAP-ENV:Client</faultcode>
         <faultstring>Parameter node is missing</faultstring>
      </SOAP-ENV:Fault>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

この例では、BSEはこのWebサービスのWSDLに必須の要素をSOAPリクエスト・メッセージで受信していません。

アダプタ固有のエラー処理

アダプタの実行中に例外が発生すると、BSE内の SOAPエージェントが生成SOAPレスポンスにSOAP障害要素を生成します。SOAP障害要素には、障害コードと障害文字列の要素が含まれます。障害文字列には、アダプタ・ターゲット・システム固有のエラー記述が含まれています。アダプタはターゲット・システムのインタフェースとAPIを使用するため、例外が発生するかどうかは、ターゲット・システムのインタフェースまたはAPIがエラー条件を処理する方法によって決定します。SOAPリクエスト・メッセージがBSE内のSOAPエージェントによりアダプタに渡され、そのリクエストが該当サービスのWSDLに基づいて無効となる場合は、アダプタに例外が発生してSOAP障害となる可能性があります。アダプタに発生するエラー条件をすべて予想するのはほとんど不可能ですが、ここではアダプタにおける一般的なエラー条件の処理方法と、Webサービスのコンシューマ・アプリケーションへの表示方法について説明します。

OracleAS Adapter for Siebelの無効なSOAPリクエスト

実行中のWebサービスのWSDLに準拠しないSOAPリクエスト・メッセージをOracleAS Adapter for Siebelが受信すると、次のSOAPレスポンスが生成されます。

<?xml version="1.0" encoding="ISO-8859-1" ?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Body>
 <SOAP-ENV:Fault>
  <faultcode>SOAP-ENV:Server</faultcode>
<faultstring>XD[FAIL] Parse failure (IS) 3: org.xml.sax.SAXParseException: Premature end of file.</faultstring>
 </SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Siebelリクエストからの空の結果

Webサービスの実行時にOracleAS Adapter for SiebelがSiebelに接続できない場合、次のSOAPレスポンスが生成されます。

<?xml version="1.0" encoding="ISO-8859-1" ?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
 <SOAP-ENV:Body>
  <SOAP-ENV:Fault>
  <faultcode>SOAP-ENV:Server</faultcode>
  <faultstring><Exception> - major:4096 minor: -1 message:NSReadKey request 11 was abandoned
after 37846ms connection:12a due to Connection shutdown request
Connection reset by peer:JVM_recv in socket input stream
stream read DetailedMessage:Unknown</Exception></faultstring>
  </SOAP-ENV:Fault>
 </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Oracle Application Server Integration Adapter

OracleAS Adapterは、エンジンが他のOracleサーバーであるアダプタにBSEを接続します。したがって、このタイプのアダプタは多くの異なるターゲット・システムへのBSEの接続に使用されるため、エラー処理の動作には一貫性があります。使用中のアダプタのユーザーズ・ガイドで、Webサービスの実行時にOracle Application Server Integration Adapterが必要かどうかを調べてください。

無効なSOAPリクエスト

実行中のWebサービスのWSDLに準拠しないSOAPリクエスト・メッセージをOracleAS Adapter for Siebelが受信すると、次のSOAPレスポンスが生成されます。

<?xml version="1.0" encoding="ISO-8859-1" ?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Body>
 <SOAP-ENV:Fault>
  <faultcode>SOAP-ENV:Server</faultcode>
  <faultstring>RPC server connection failed: Connection refused: connect</faultstring>
 </SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Oracle Application Server Adapterのリクエストからの空の結果

渡された入力パラメータを使用してOracleAS Adapter for SiebelでSOAPリクエストを実行する場合に、入力パラメータがターゲット・システム内のレコードと一致しないと、次のSOAPレスポンスが生成されます。

注意:

このアダプタの条件では、SOAP障害は生成されません。

<SOAP-ENV:Envelope xmlns:xsi="http://www.w3.org/1999/XMLSchema-instance"
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/1999/XMLSchema">
   <SOAP-ENV:Body>
      <m:RunDBQueryResponse xmlns:m="urn:schemas-iwaysoftware-com:iwse"
        xmlns="urn:schemas-iwaysoftware-com:iwse"
        cid="2A3CB42703EB20203F91951B89F3C5AF">
        <RunDBQueryResult run="1" />
     </m:RunDBQueryResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>