Oracle Application Server Adapter for PeopleSoftユーザーズ・ガイド 10g リリース3(10.1.3.4.0) B53281-01 |
|
戻る |
次へ |
この章では、PeopleSoftへの接続時の制限事項および回避方法について説明します。項目は次のとおりです。
この章に示すアダプタ固有のエラーは、アダプタをOracleAS Adapter J2CAで使用しているかOracleAS Adapter Business Services Engine(BSE)構成で使用しているかに関係なく発生する可能性があります。
このトピックでは、PeopleSoftのトラブルシューティング情報を次の4つのカテゴリにわけて説明します。
Application Explorer
PeopleSoft
OracleAS Adapter J2CA
BSE
Application Explorer
デバッグとテストの目的でWindows上でApplication Explorerを使用する場合は、次の場所にあるバッチ・スクリプトae.bat
をロードします。
OracleAS_home\adapters\application\tools
UNIXの場合は、次のディレクトリにあるシェル・スクリプトiwae.sh
をロードします。
OracleAS_home/adapters/application/tools
PeopleSoft
OracleAS Adapter J2CA
エラー | 解決方法 |
---|---|
Application ExplorerでOracleAS Adapter J2CA構成に接続しようとすると、次のエラー・メッセージが表示される。 | 右ペインの「詳細」タブで、「ホーム」フィールドに指定したディレクトリが適切なディレクトリ(OracleAS_home ¥adapters¥application など)を指していることを確認してください。 |
BPEL Process Manager
エラー | 解決方法 |
---|---|
JDeveloperでPeopleSoftイベント処理プロジェクト(インバウンド)のデプロイ時にエンドポイント・アクティブ化エラーが発生する。 | このインバウンドJ2CAサービスに使用しているチャネルが、Application Explorerで停止されていることを確認してください。このチャネルをテストまたはデバッグのために開始した場合は、BPEL PMサーバーの起動前に停止する必要があります。エンドポイントのアクティブ化は、BPEL Process Managerにより管理されます。 |
BPEL PMサーバー・コンソールに次のエラー・メッセージが表示される。
|
指定したWSDLがそのURLに存在することと、ファイルが有効であることを確認してください。
回避方法: WSDLのロケーションを 代替回避方法: |
BPELプロセスのデプロイ中に、JDeveloperで次の例外がスローされる。
|
必須パッチをすべてインストール済であることを確認してください。必須パッチは、Oracle Technology NetworkのWebサイトにリスト表示され、更新されます。 |
このトピックでは、Oracle Application Server Adapter Business Services Engine(BSE)を介してWebサービスを処理する際に発生する各種のエラーについて説明します。
BSEには、アダプタ・フレームワークへのSOAPゲートウェイとしての機能、および一部アダプタ用のエンジンとしての機能があります。 デザインタイムおよびランタイムには、アダプタを使用するWebサービスの実行中に、様々な条件が原因となってBSEにエラーが発生する可能性があります。これらの条件とそれに伴うエラーの一部には、アダプタに関係なく同様に表示されるものと、使用中のアダプタに応じて異なる方法で表示されるものがあります。このトピックでは、いくつかのより一般的なエラー条件が発生した場合に予想できる状況についてアダプタ別に説明します。通常、BSE内のSOAPゲートウェイ(エージェント)は、SOAPリクエスト・メッセージをWebサービスに必要なアダプタに渡します。エラーが発生した場合の表示方法は、アダプタおよびアダプタで使用されているAPIまたはインタフェースに応じて異なります。各APIはPeopleToolsから生成され、PeopleToolsのリリース固有です。一部の使用例では、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 PeopleSoftの無効なSOAPリクエスト
PeopleSoftエージェントが実行中のWebサービスのWSDLに準拠しない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:CARRIERResponse xmlns:m="urn:schemas-iwaysoftware-com:iwse" xmlns="urn:schemas-iwaysoftware-com:iwse" cid="2A3CB42703EB20203F91951B89F3C5AF"> <PS8> <error>Cannot find Component Interface {VARRIER} (91,2)Initialization failed (90,7)Not Authorized (90,6)Failed to execute PSSession request Cannot find Component Interface {VARRIER} (91,2)</error> </PS8> </m:CARRIERResponse> </SOAP-ENV:Body> </SOAP-ENV:Envelope>
PeopleSoftリクエストからの空の結果
OracleAS Adapter for PeopleSoftがSOAPリクエストで渡された入力パラメータを使用してコンポーネント・インタフェースをWebサービスとして実行する場合に、その入力パラメータがPeopleSoft内のレコードと一致しないと、次の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:CARRIERResponse xmlns:m="urn:schemas-iwaysoftware-com:iwse" xmlns="urn:schemas-iwaysoftware-com:iwse" cid="2A3CB42703EB20203F91951B89F3C5AF"> <PS8> <error>No rows exist for the specified keys. {CARRIER} (91,50)Failed to execute PSBusComp request</error> </PS8> </m:CARRIERResponse> </SOAP-ENV:Body> </SOAP-ENV:Envelope>
PeopleSoftへの接続失敗
OracleAS Adapter for PeopleSoftがPeopleSoftに接続できない場合は、次の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>java.lang.Exception: Error Logon to PeopleSoft System<faultstring> </SOAP-ENV:Fault> </SOAP-ENV:Body> </SOAP-ENV:Envelope>
無効なSOAPリクエスト
Oracle Application Server Adapterが実行中のWebサービスのWSDLに準拠しないSOAPリクエスト・メッセージを受信すると、次の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のリクエストからの空の結果
渡された入力パラメータを使用してアダプタで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>