この章では、Siebelへの接続時の制限事項および回避方法について説明します。項目は次のとおりです。
このトピックでは、Siebelのトラブルシューティング情報を次の4つのカテゴリにわけて説明します。
OracleAS Adapter for Siebelの一般的な使用方法における注意事項
Application Explorer
Siebel
OracleAS Adapter J2CA
OracleAS Adapter Business Services Engine(BSE)
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の起動」を参照してください。
Siebel
リストされたエラー・メッセージは、アダプタをBSEまたはOracleAS Adapter J2CAのリポジトリ・プロジェクトとともに使用しているときに発生する可能性があります。
OracleAS Adapter J2CA
エラー | 解決方法 |
---|---|
Application ExplorerでOracleAS Adapter J2CA構成に接続しようとすると、次のエラー・メッセージが表示される。
|
右ペインの「詳細」タブで、「ホーム」フィールドに指定したディレクトリが適切なディレクトリ(OracleAS_home \adapters\applicationなど)を指していることを確認してください。 |
BPEL Process Manager
エラー | 解決方法 |
---|---|
JDeveloperでのSiebelイベント処理プロジェクト(インバウンド)のデプロイ時にエンドポイントのアクティブ化エラーが発生する。 | Application ExplorerでこのインバウンドJ2CAサービスに使用されるチャネルが停止していることを確認してください。テストまたはデバッグのためにこのチャネルを開始した場合、BPEL PMサーバーの起動前に停止する必要があります。エンドポイントのアクティブ化はBPEL Process Managerによって管理されます。 |
BPEL PMサーバー・コンソールに次のエラー・メッセージが表示される。
| 指定したWSDLファイルがそのURLに存在し、このファイルが有効であることを確認してください。
回避策: WSDLの場所を 代替回避策: |
実行時に2回目のメッセージの呼出しに失敗する。 | 必須パッチをすべてインストールしたことを確認してください。必須パッチは、Oracle Technology NetworkのWebサイト(http://www.oracle.com/technology/index.html )でリストおよび更新されています。 |
BPELプロセスのデプロイ時にJDeveloperで次の例外がスローされる。
|
必須パッチをすべてインストールしたことを確認してください。必須パッチは、Oracle Technology NetworkのWebサイト(http://www.oracle.com/technology/index.html )でリストおよび更新されています。 |
このトピックでは、BSEを介してWebサービスを処理する際に発生する可能性がある各種のエラーについて説明します。
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>