7.7.1　Webサービス（SOAP通信）実行時の障害対策

(a)　標準受付の場合

エラーの伝わり方は，エラーの種類やビジネスプロセスの有無によって異なります。

サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用しないとき）

サービス部品からユーザ定義例外のエラーがリターンした場合でビジネスプロセスを使用しないときのSOAP通信でのエラーの伝わり方を次の図に示します。

図7‒43　サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用しないとき）のSOAP通信でのエラーの伝わり方

サービス部品側の通信基盤にサービスプラットフォームが提供しているSOAP通信基盤またはJAX-WSエンジンを使用している場合で，サービス部品で例外をスローするコーディングをしているとき，サービス部品のWSDLにはユーザ定義例外がSOAPフォルトで定義されます。サービス部品でユーザ定義例外が発生すると，SOAPフォルトの内容が標準受付からサービスリクエスタに応答されます。

サービスリクエスタが使用するWSDLはサービスプラットフォームが提供するWSDLで，このWSDLにはCSCMsgServerFaultException^※がSOAPフォルトとして定義されています。サービスリクエスタは，HCSCサーバがリターンするSOAPフォルトをCSCMsgServerFaultException^※オブジェクトでキャッチできます。キャッチした例外オブジェクトのgetterを使用することで，サービス部品側で発生した例外名やフォルト情報（エラーの詳細）を取得できます。CSCMsgServerFaultException^※の詳細については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「9.3.8　エラー情報を取得する」を参照してください。

注※

SOAP1.2の場合は，CSCMsgServerFault12Exceptionとなります。

サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用しないとき）

サービス部品からユーザ定義例外以外のエラーがリターンした場合でビジネスプロセスを使用しないときのSOAP通信でのエラーの伝わり方を次の図に示します。

図7‒44　サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用しないとき）のSOAP通信でのエラーの伝わり方

サービス部品側の通信基盤にサービスプラットフォームが提供しているSOAP通信基盤またはJAX-WSエンジンを使用している場合で，サービス部品でWSDLに定義していない想定外の例外（システム例外）が発生したときは，RuntimeExceptionとしてSOAPメッセージが伝わります。また，サービス部品側の通信基盤にJAX-WSエンジンを使用している場合や，サービスプラットフォームが提供しているSOAP通信基盤を使用していない場合は，WSDLにSOAPフォルトを定義していてもHCSCサーバ内では例外として扱われます。

サービスアダプタからサービス部品を呼び出したときに発生したシステム例外は，サービスアダプタでフォルト電文に変換することもできます。システム例外をフォルト電文に変換する方法については，「7.11　サービスアダプタでの例外発生時の運用」を参照してください。

サービスリクエスタが使用するWSDLはサービスプラットフォームが提供するWSDLで，このWSDLにはCSCMsgServerFaultException^※がSOAPフォルトとして定義されています。サービスリクエスタは，HCSCサーバがリターンするSOAPフォルトをCSCMsgServerFaultException^※オブジェクトでキャッチできます。キャッチした例外オブジェクトのgetterを使用することで，発生したフォルト情報（エラーの詳細）を取得できます。CSCMsgServerFaultException^※の詳細については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「9.3.8　エラー情報を取得する」を参照してください。

なお，サービス部品が応答したSOAPフォルトをHCSCサーバ内で例外ではなくSOAPフォルトのまま伝えたい場合は，SOAP Fault動作定義ファイルで定義します。SOAP Fault動作定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.6.1　SOAP Fault動作定義ファイル」を参照してください。

注※

SOAP1.2の場合は，CSCMsgServerFault12Exceptionとなります。

HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用しないとき）

HCSCサーバからエラーがリターンした場合でビジネスプロセスを使用しないときのSOAP通信でのエラーの伝わり方を次の図に示します。

図7‒45　HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用しないとき）のSOAP通信でのエラーの伝わり方

図中の各エラーには，次に示すケースが該当します。

• エラー1：要求パラメタ不正，指定文字コード不正，各種フォーマット不正など

• エラー2：宛先（ロケーション）が見つからない，サービスアダプタが停止しているなど

• エラー3：データ変換に失敗したなど

• エラー4：宛先不正，サービス部品が停止，通信障害など

HCSCサーバで図中のエラー1〜エラー3のどれかを検知した場合，発生したエラーの例外をサービスリクエスタにリターンします。

図中のエラー4を検知した場合，発生したエラーの例外をサービスリクエスタにそのままリターンするか，サービスアダプタでエラーの例外をフォルト電文に変換するか選択できます。例外発生時に取得するエラーの選択方法については，「7.11　サービスアダプタでの例外発生時の運用」を参照してください。

サービスリクエスタは，HCSCサーバがリターンするSOAPフォルトをCSCMsgServerFaultException^※オブジェクトでキャッチできます。キャッチした例外オブジェクトのgetterを使用することで，発生したフォルト情報（エラーの詳細）を取得できます。CSCMsgServerFaultException^※の詳細については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「9.3.8　エラー情報を取得する」を参照してください。

注※

SOAP1.2の場合は，CSCMsgServerFault12Exceptionとなります。

サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用するとき）

サービス部品からユーザ定義例外のエラーがリターンした場合でビジネスプロセスを使用するときのSOAP通信でのエラーの伝わり方を次の図に示します。

図7‒46　サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用するとき）のSOAP通信でのエラーの伝わり方

サービス部品側の通信基盤にサービスプラットフォームが提供しているSOAP通信基盤またはJAX-WSエンジンを使用している場合で，サービス部品で例外をスローするコーディングをしているとき，サービス部品のWSDLにはユーザ定義例外がSOAPフォルトで定義されます。サービス部品でユーザ定義例外が発生すると，そのエラーは，一度ビジネスプロセスでキャッチできます。

サービスリクエスタは，HCSCサーバがリターンするSOAPフォルトをCSCMsgServerFaultException^※オブジェクトでキャッチできます。キャッチした例外オブジェクトのgetterを使用することで，発生した例外名やフォルト情報（エラーの詳細）を取得できます。ビジネスプロセスでフォルト名を定義することで，サービスリクエスタで発生した例外が切り分けやすくなります。CSCMsgServerFaultException^※の詳細については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「9.3.8　エラー情報を取得する」を参照してください。

注※

SOAP1.2の場合は，CSCMsgServerFault12Exceptionとなります。

サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用するとき）

サービス部品からユーザ定義例外以外のエラーがリターンした場合でビジネスプロセスを使用するときのSOAP通信でのエラーの伝わり方を次の図に示します。

図7‒47　サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用するとき）のSOAP通信でのエラーの伝わり方

サービス部品側の通信基盤にサービスプラットフォームが提供しているSOAP通信基盤またはJAX-WSエンジンを使用している場合で，サービス部品でWSDLに定義していない想定外の例外（システム例外）が発生したときは，RuntimeExceptionとしてSOAPメッセージが伝わります。また，サービス部品側の通信基盤にJAX-WSエンジンを使用している場合や，サービスプラットフォームが提供しているSOAP通信基盤を使用していない場合は，WSDLにSOAPフォルトを定義していてもHCSCサーバ内では例外として扱われます。

サービスアダプタからサービス部品を呼び出したときに発生したシステム例外は，サービスアダプタでフォルト電文に変換することもできます。

例外をフォルト電文に変換しない場合，ビジネスプロセスでは例外として処理して，標準受付にスローします。例外をフォルト電文に変換した場合，フォルトとしてビジネスプロセスでキャッチできます。システム例外をフォルト電文に変換する方法については，「7.11　サービスアダプタでの例外発生時の運用」を参照してください。

サービスリクエスタは，HCSCサーバがリターンするSOAPフォルトをCSCMsgServerFaultException^※オブジェクトでキャッチできます。キャッチした例外オブジェクトのgetterを使用することで，発生したフォルト情報（エラーの詳細）を取得できます。CSCMsgServerFaultException^※の詳細については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「9.3.8　エラー情報を取得する」を参照してください。

なお，サービス部品が応答したSOAPフォルトをHCSCサーバ内で例外ではなくSOAPフォルトのまま伝えたい場合は，SOAP Fault動作定義ファイルで定義します。SOAP Fault動作定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.6.1　SOAP Fault動作定義ファイル」を参照してください。

注※

SOAP1.2の場合は，CSCMsgServerFault12Exceptionとなります。

HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用するとき）

HCSCサーバからエラーがリターンした場合でビジネスプロセスを使用するときのSOAP通信でのエラーの伝わり方を次の図に示します。

図7‒48　HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用するとき）のSOAP通信でのエラーの伝わり方

図中の各エラーには，次に示すケースが該当します。

• エラー1：要求パラメタ不正，指定文字コード不正，各種フォーマット不正など

• エラー2：宛先（ロケーション）が見つからない，サービスアダプタが停止しているなど

• エラー3：データ変換に失敗したなど

• エラー4：宛先不正，サービス部品が停止，通信障害など

• エラー5：ビジネスプロセス処理上での例外エラーなど

HCSCサーバで図中のエラー1〜エラー3およびエラー5のどれかを検知した場合，発生したエラーの例外をサービスリクエスタにリターンします。図中のエラー4を検知した場合，発生したエラーの例外をサービスリクエスタにそのままリターンするか，サービスアダプタでエラーの例外をフォルト電文に変換するか選択できます。例外発生時に取得するエラーの選択方法については，「7.11　サービスアダプタでの例外発生時の運用」を参照してください。

サービスリクエスタは，HCSCサーバがリターンするSOAPフォルトをCSCMsgServerFaultException^※オブジェクトでキャッチできます。キャッチした例外オブジェクトのgetterを使用することで，発生したフォルト情報（エラーの詳細）を取得できます。CSCMsgServerFaultException^※の詳細については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「9.3.8　エラー情報を取得する」を参照してください。

注※

SOAP1.2の場合は，CSCMsgServerFault12Exceptionとなります。

サービスリクエスタでエラーを検知した場合

サービスリクエスタでエラーを検知した場合のSOAP通信でのエラーの伝わり方を次の図に示します。

図7‒49　サービスリクエスタでエラーを検知した場合のSOAP通信でのエラーの伝わり方（標準受付の場合）

サービスリクエスタからHCSCサーバを呼び出せなかった場合や，サービス部品の呼び出しは完了したが何らかの原因でHCSCサーバからサービスリクエスタへの応答が返らなかった場合などは，サービスリクエスタ側（クライアント側）のSOAP通信基盤またはJAX-WSエンジンがエラーをリターンします。

サービスリクエスタ側の通信基盤にサービスプラットフォームが提供しているSOAP通信基盤を使用している場合は，C4Faultオブジェクトで例外をキャッチできます。キャッチした例外オブジェクトのgetterを使用することで，発生したフォルト情報（エラーの詳細）を取得できます。C4Faultの詳細については，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「13.2　C4Faultクラス（SOAP Fault情報の保持）」を参照してください。

なお，サービスリクエスタ側の通信基盤にJAX-WSエンジンを使用している場合は，SOAPFaultExceptionオブジェクトで例外をキャッチできます。また，サービスプラットフォームが提供しているSOAP通信基盤を使用していない場合は，それぞれの通信基盤の実装に依存します。

(b)　ユーザ定義受付の場合

エラーの伝わり方は，エラーの種類やビジネスプロセスの有無によって異なります。

サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用するとき）

サービス部品からユーザ定義例外のエラーがリターンした場合でビジネスプロセスを使用するときのSOAP通信でのエラーの伝わり方を次の図に示します。

図7‒50　サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用するとき）のSOAP通信でのエラーの伝わり方

サービス部品側の通信基盤にサービスプラットフォームが提供しているSOAP通信基盤またはJAX-WSエンジンを使用している場合で，サービス部品で例外をスローするコーディングをしている場合，サービス部品のWSDLにはユーザ定義例外が定義されます。サービス部品でユーザ定義例外が発生すると，そのエラーは，一度ビジネスプロセスでキャッチできます。

サービスリクエスタは，ユーザ定義受付に定義したWSDLを使用しますが，ビジネスプロセスから応答するフォルトをWSDLに定義することで，サービスリクエスタでもユーザ定義例外のSOAPフォルトとしてキャッチできます。これによって，サービスリクエスタでもサービス部品がリターンするSOAPフォルトと同じ名称および形式でキャッチすることができます。

キャッチした例外オブジェクトを解析するための情報は，サービス部品側のプログラムで作成する必要があります。なお，ビジネスプロセスでフォルト名を定義することで，サービスリクエスタで発生した例外が切り分けやすくなります。

SOAP受付に要求を出すサービスリクエスタでエラー情報を取得する方法については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「9.7.6　エラー情報を取得する」を参照してください。

サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用するとき）

サービス部品からユーザ定義例外以外のエラーがリターンした場合でビジネスプロセスを使用するときのSOAP通信でのエラーの伝わり方を次の図に示します。

図7‒51　サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用するとき）のSOAP通信でのエラーの伝わり方

サービス部品側の通信基盤にサービスプラットフォームが提供しているSOAP通信基盤を使用している場合で，サービス部品でWSDLに定義していない想定外の例外（システム例外）が発生したときは，RuntimeExceptionとしてSOAPメッセージが伝わります。また，サービス部品側の通信基盤にJAX-WSエンジンを使用している場合や，サービスプラットフォームが提供しているSOAP通信基盤を使用していない場合は，WSDLにSOAPフォルトを定義していてもHCSCサーバ内では例外として扱われます。

サービスアダプタからサービス部品を呼び出したときに発生したシステム例外は，サービスアダプタでフォルト電文に変換することもできます。

例外をフォルト電文に変換しない場合，ビジネスプロセスでは例外として処理して，ユーザ定義受付にスローします。例外をフォルト電文に変換した場合，フォルトとしてビジネスプロセスでキャッチできます。システム例外をフォルト電文に変換する方法については，「7.11　サービスアダプタでの例外発生時の運用」を参照してください。

HCSCサーバはCSCMsgServerFaultExceptionのSOAPフォルトでサービスリクエスタにリターンしますが，サービスリクエスタが使用するWSDLはユーザ定義受付に定義したWSDLで，このWSDLにはCSCMsgServerFaultExceptionが定義されていません。そのため，サービスリクエスタ側の通信基盤にサービスプラットフォームが提供しているSOAP通信基盤を使用している場合は，C4Faultオブジェクトで例外をキャッチします。キャッチした例外オブジェクトのgetterを使用することで，発生したフォルト情報（エラーの詳細）を取得できます。C4Faultの詳細については，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「13.2　C4Faultクラス（SOAP Fault情報の保持）」を参照してください。

なお，サービスリクエスタ側の通信基盤にJAX-WSエンジンを使用している場合は，SOAPFaultExceptionオブジェクトで例外をキャッチできます。また，サービスプラットフォームが提供しているSOAP通信基盤を使用していない場合は，それぞれの通信基盤の実装に依存します。

サービス部品が応答したSOAPフォルトをHCSCサーバ内で例外ではなくSOAPフォルトのままで伝え，ビジネスプロセスでフォルトをキャッチしたい場合は，SOAP Fault動作定義ファイルで定義します。SOAP Fault動作定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.6.1　SOAP Fault動作定義ファイル」を参照してください。

HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用するとき）

HCSCサーバからエラーがリターンした場合でビジネスプロセスを使用するときのSOAP通信でのエラーの伝わり方を次の図に示します。

図7‒52　HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用するとき）のSOAP通信でのエラーの伝わり方

図中の各エラーには，次に示すケースが該当します。

• エラー1：指定文字コード不正，各種フォーマット不正など

• エラー2：宛先（ロケーション）が見つからない，サービスアダプタが停止しているなど

• エラー3：データ変換に失敗したなど

• エラー4：宛先不正，サービス部品が停止，通信障害など

• エラー5：ビジネスプロセス処理上での例外エラーなど

HCSCサーバで図中のエラー1〜エラー3およびエラー5のどれかを検知した場合，発生したエラーの例外をサービスリクエスタにリターンします。図中のエラー4を検知した場合，発生したエラーの例外をサービスリクエスタにそのままリターンするか，サービスアダプタでエラーの例外をフォルト電文に変換するか選択できます。例外発生時に取得するエラーの選択方法については，「7.11　サービスアダプタでの例外発生時の運用」を参照してください。

HCSCサーバはCSCMsgServerFaultExceptionのSOAPフォルトでサービスリクエスタにリターンしますが，サービスリクエスタが使用するWSDLはユーザ定義受付に定義したWSDLで，このWSDLにはCSCMsgServerFaultExceptionが定義されていません。そのため，サービスリクエスタ側の通信基盤にサービスプラットフォームが提供しているSOAP通信基盤を使用している場合は，C4Faultオブジェクトで例外をキャッチします。キャッチした例外オブジェクトのgetterを使用することで，発生したフォルト情報（エラーの詳細）を取得できます。C4Faultの詳細については，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「13.2　C4Faultクラス（SOAP Fault情報の保持）」を参照してください。

なお，サービスリクエスタ側の通信基盤にJAX-WSエンジンを使用している場合は，SOAPFaultExceptionオブジェクトで例外をキャッチできます。また，サービスプラットフォームが提供しているSOAP通信基盤を使用していない場合は，それぞれの通信基盤の実装に依存します。

サービスリクエスタでエラーを検知した場合

サービスリクエスタでエラーを検知した場合のSOAP通信でのエラーの伝わり方を次の図に示します。

図7‒53　サービスリクエスタでエラーを検知した場合のSOAP通信でのエラーの伝わり方（ユーザ定義受付の場合）

宛先不正，HCSCサーバが停止，通信障害などで，サービスリクエスタからHCSCサーバを呼び出せなかった場合や，サービス部品の呼び出しは完了したが何らかの原因でHCSCサーバからサービスリクエスタへの応答が返らなかった場合などでは，サービスリクエスタ側（クライアント側）のSOAP通信基盤またはJAX-WSエンジンがエラーをリターンします。

サービスリクエスタ側の通信基盤にサービスプラットフォームが提供しているSOAP通信基盤を使用している場合は，C4Faultオブジェクトで例外をキャッチできます。キャッチした例外オブジェクトのgetterを使用することで，発生したフォルト情報（エラーの詳細）を取得できます。C4Faultの詳細については，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「13.2　C4Faultクラス（SOAP Fault情報の保持）」を参照してください。

なお，サービスリクエスタ側の通信基盤にJAX-WSエンジンを使用している場合は，SOAPFaultExceptionオブジェクトで例外をキャッチできます。また，サービスプラットフォームが提供しているSOAP通信基盤を使用していない場合は，それぞれの通信基盤の実装に依存します。

(a)　標準受付の場合

サービスリクエスタから標準受付（Webサービス）を使用してサービス部品を呼び出した場合の問題発生個所の切り分け方について次の図に示します。

(i)サービス部品に障害の要因がある場合（サービス部品で定義したユーザ定義例外の場合）

サービス部品に障害の要因があるおそれがあります。次のメソッドを使用してサービス部品が返したSOAP Faultの内容を取得できます。

<SOAP1.1の場合>

• getCscmsgFaultCode：FaultCode情報を取得します。

• getCscmsgFaultString：FaultString情報を取得します。

• getCscmsgFaultActor：FaultActor情報を取得します。

• getCscmsgFaultDetail：FaultDetail情報を取得します。

<SOAP1.2の場合>

• getCscmsgFaultCode：Code情報を取得します。

• getCscmsgFaultReason：Reason情報を取得します。

• getCscmsgFaultRole：Role情報を取得します。

• getCscmsgFaultNode：Node情報を取得します。

• getCscmsgFaultDetail：Detail情報を取得します。

要因は，次の観点で調査してください。

• サービスリクエスタから要求したユーザ電文

• サービス部品稼働マシン

• サービス部品のプログラム

サービス部品の呼び出しを再送するかどうかは，HCSCサーバを介したサービスリクエスタとサービス部品間（エンドツーエンド）の取り決めとなります。

(ii)ビジネスプロセスに障害の要因がある場合（ビジネスプロセスで定義したフォルトの場合）

ビジネスプロセスで実行したアクティビティの処理に障害の要因があるおそれがあります（サービス呼出アクティビティの場合，呼び出したサービス部品に障害の要因があるおそれがあります）。

次のメソッドを使用してビジネスプロセスまたはサービス部品が返したSOAP Faultの内容を取得できます。

<SOAP1.1の場合>

• getCscmsgFaultCode：FaultCode情報を取得します。

• getCscmsgFaultString：FaultString情報を取得します。

• getCscmsgFaultActor：FaultActor情報を取得します。

• getCscmsgFaultDetail：FaultDetail情報を取得します。

<SOAP1.2の場合>

• getCscmsgFaultCode：Code情報を取得します。

• getCscmsgFaultReason：Reason情報を取得します。

• getCscmsgFaultRole：Role情報を取得します。

• getCscmsgFaultNode：Node情報を取得します。

• getCscmsgFaultDetail ：Detail情報を取得します。

要因は，次の観点で調査してください。

• サービスリクエスタから要求したユーザ電文

• サービス部品稼働マシン

• サービス部品のプログラム

• ビジネスプロセスの定義内容

サービス部品の呼び出しを再送するかどうかは，HCSCサーバを介したサービスリクエスタとサービス部品間（エンドツーエンド）の取り決めとなります。

また，ビジネスプロセスをどのようなプロセスに設計したかによって，再送（ビジネスプロセスの再実行）をするかどうかサービスリクエスタを含むシステム設計する必要があります。

(iii)HCSCサーバでエラーを検知した場合（例外名が設定されていない場合）

次のメソッドを使用してエラーの内容を取得できます。取得したエラーコードおよびエラーメッセージの対策に従って対処します。また，サービスプラットフォームが出力するメッセージログも参照して，調査します。

• getErrorMessage：HCSCサーバ内で検知したエラーのエラーメッセージを取得します。

• getErrorCode：HCSCサーバ内で検知したエラーのエラーコードを取得します。

要因は，次の観点で調査してください。

• サービスリクエスタから要求した引数の内容

• HCSCサーバの設定または状態

• サービスアダプタの定義内容査

• ビジネスプロセスの定義内容

• サービスリクエスタから要求したユーザ電文

• サービス部品稼働マシン

• サービス部品のプログラム

• ネットワークの状態

また，次に示す処理が常に実行されているかを確認することで，問題発生個所を絞り込めます。

1. サービスアダプタ（クライアント）からSOAPメッセージが正しく出力されているか。

2. SOAPメッセージはサービス部品稼働マシン（サーバ）のSOAP通信基盤またはJAX-WSエンジンに届いているか。

3. サービス部品稼働マシン（サーバ）のサービス部品でメッセージが処理できているか。

4. サービス部品稼働マシン（サーバ）のサービス部品からの返信用SOAPメッセージは正しく出力されているか。

5. サービス部品稼働マシン（サーバ）のサービス部品からの返信用SOAPメッセージはサービスアダプタ（クライアント）のSOAP通信基盤またはJAX-WSエンジンに届いているか。

確認するときはSOAP通信基盤またはJAX-WSエンジンが出力する障害情報を参照します。障害情報の取得方法については，「7.3.3(3)　SOAP通信基盤またはJAX-WSエンジンが出力する障害情報の取得方法」を参照してください。

SOAP通信基盤が出力する障害情報の形式については，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「14.　障害対策」を参照してください。JAX-WSエンジンが出力する障害情報の形式については，マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「39.　障害対策」を参照してください。

なお，SOAP通信基盤またはJAX-WSエンジンが出力するアプリケーションログを取得することで，サービスアダプタとサービス部品間で送受信している電文データを確認できます。

サービス部品の呼び出しを再送するかどうかは，エラーの内容によって異なります。

一時的な障害の場合は，再送を試みることで成功することがありますが，次に示すエラーの場合は，再送を試みてもエラーとなります。

• サービスリクエスタから要求した引数の内容が誤っている場合

• HCSCサーバの設定に誤りがある場合

• サービスアダプタやビジネスプロセスの定義に誤りがある場合

• サービスリクエスタから要求したユーザ電文に誤りがある場合など

(iv)通信基盤でエラーを検知した場合（C4Faultの場合）

SOAP通信基盤が提供するC4Faultからエラーの内容を取得できます。取得したエラーコードおよびエラーメッセージの対策に従って対処します。

C4Faultの詳細については，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「13.2　C4Faultクラス（SOAP Fault情報の保持）」を参照してください。

要因は，次の観点で調査してください。

• サービスリクエスタで使用しているWSDL

• サービスリクエスタ稼働マシンのSOAP通信基盤の設定または状態

• HCSCサーバの設定または状態

• ネットワークの状態

また，次に示す処理が常に実行されているかを確認することで，問題発生個所を絞り込めます。

1. サービスリクエスタ（クライアント）からSOAPメッセージが正しく出力されているか。

2. SOAPメッセージはHCSCサーバ稼働マシン（サーバ）のSOAP通信基盤に届いているか。

3. HCSCサーバ稼働マシン（サーバ）のサービス部品からの返信用SOAPメッセージは正しく出力されているか。

4. HCSCサーバ稼働マシン（サーバ）のサービス部品からの返信用SOAPメッセージはサービスリクエスタ（クライアント）のSOAP通信基盤に届いているか。

確認するときはSOAP通信基盤が出力する障害情報を参照します。障害情報の取得方法については，「7.3.3(3)　SOAP通信基盤またはJAX-WSエンジンが出力する障害情報の取得方法」を参照してください。

SOAP通信基盤が出力する障害情報の形式については，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「14.　障害対策」を参照してください。

なお，SOAP通信基盤が出力するアプリケーションログを取得することで，サービスリクエスタとHCSCサーバ間で送受信している電文データを確認できます。

サービス部品の呼び出しを再送するかどうかは，エラーの内容によって異なります。一時的な障害の場合は，再送を試みることで成功することがありますが，次に示すエラーの場合は，再送を試みてもエラーとなります。

• サービスリクエスタで使用しているWSDLが誤っている場合

• サービスリクエスタ稼働マシンのSOAP通信基盤の設定に誤りがある場合

• HCSCサーバの設定に誤りがある場合

(b)　ユーザ定義受付の場合

サービスリクエスタからSOAP受付を使用してサービス部品を呼び出した場合の問題発生個所の切り分け方について次の図に示します。

(i)サービス部品に障害の要因がある場合（サービス部品で定義したユーザ定義例外の場合）

サービス部品に障害の要因があるおそれがあります。エラーの情報は，サービス部品で定義した内容になります（キャッチした例外オブジェクトの解析するための情報は，サービス部品側のプログラムで作成する必要があります）。

要因は，次の観点で調査してください。

• サービスリクエスタから要求したユーザ電文

• サービス部品稼働マシン

• サービス部品のプログラム

サービス部品の呼び出しを再送するかどうかは，HCSCサーバを介したサービスリクエスタとサービス部品間（エンドツーエンド）の取り決めとなります。

(ii)ビジネスプロセスに障害の要因がある場合（ビジネスプロセスで定義したフォルトの場合）

ビジネスプロセスで実行したアクティビティの処理に障害の要因があるおそれがあります（サービス呼出アクティビティの場合，呼び出したサービス部品に障害の要因があるおそれがあります）。

エラーの情報は，ビジネスプロセスで定義したフォルトの内容になります（キャッチした例外オブジェクトを解析するための情報は，ビジネスプロセスを定義するときに設定しておく必要があります）。

要因は，次の観点で調査してください。

• サービスリクエスタから要求したユーザ電文

• サービス部品稼働マシン

• サービス部品のプログラム

• ビジネスプロセスの定義内容

サービス部品の呼び出しを再送するかどうかは，HCSCサーバを介したサービスリクエスタとサービス部品間（エンドツーエンド）の取り決めとなります。

また，ビジネスプロセスの設計内容によっても，再送（ビジネスプロセスの再実行）するかどうかシステム設計する必要があります。

(iii)HCSCサーバでエラーを検知した場合（CSCMsgServerFaultExceptionの場合）

SOAP通信基盤が提供するC4Faultからエラーの内容を取得できます。取得したエラーコードおよびエラーメッセージの対策に従って対処します。サービスリクエスタでC4Faultからエラー情報を取得するときの実装方法については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「9.7.6　エラー情報を取得する」を参照してください。C4Faultの詳細については，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「13.2　C4Faultクラス（SOAP Fault情報の保持）」を参照してください。また，サービスプラットフォームが出力するメッセージログも参照して，調査します。

要因は，次の観点で調査してください。

• サービスリクエスタから要求した引数の内容

• HCSCサーバの設定または状態

• サービスアダプタの定義内容

• ビジネスプロセスの定義内容

• サービスリクエスタから要求したユーザ電文

• サービス部品稼働マシン

• サービス部品のプログラム

• ネットワークの状態

また，次に示す処理が常に実行されているかを確認することで，問題発生個所を絞り込めます。

1. サービスアダプタ（クライアント）からSOAPメッセージが正しく出力されているか。

2. SOAPメッセージはサービス部品稼働マシン（サーバ）のSOAP通信基盤に届いているか。

3. サービス部品稼働マシン（サーバ）のサービス部品でメッセージが処理できているか。

4. サービス部品稼働マシン（サーバ）のサービス部品からの返信用SOAPメッセージは正しく出力されているか。

5. サービス部品稼働マシン（サーバ）のサービス部品からの返信用SOAPメッセージはサービスアダプタ（クライアント）のSOAP通信基盤に届いているか。

確認するときはSOAP通信基盤が出力する障害情報を参照します。障害情報の取得方法については，「7.3.3(3)　SOAP通信基盤またはJAX-WSエンジンが出力する障害情報の取得方法」を参照してください。

SOAP通信基盤が出力する障害情報の形式については，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「14.　障害対策」を参照してください。

なお，SOAP通信基盤が出力するアプリケーションログを取得することで，サービスアダプタとサービス部品間で送受信している電文データを確認できます。

サービス部品の呼び出しを再送するかどうかは，エラーの内容によって異なります。一時的な障害の場合は，再送を試みることで成功することがありますが，次に示すエラーの場合は，再送を試みてもエラーとなります。

• サービスリクエスタから要求した引数の内容が誤っている場合

• HCSCサーバの設定に誤りがある場合

• サービスアダプタやビジネスプロセスの定義に誤りがある場合

• サービスリクエスタから要求したユーザ電文に誤りがある場合など

(iv)通信基盤でエラーを検知した場合（(i)〜(iii)以外の場合）

SOAP通信基盤が提供するC4Faultからエラーの内容を取得できます。取得したエラーコードおよびエラーメッセージの対策に従って対処してください。

サービスリクエスタでC4Faultからエラー情報を取得するときの実装方法については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「9.7.6　エラー情報を取得する」を参照してください。C4Faultの詳細については，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「13.2　C4Faultクラス（SOAP Fault情報の保持）」を参照してください。また，サービスプラットフォームが出力するメッセージログも参照して，調査します。

要因は，次の観点で調査してください。

• サービスリクエスタで使用しているWSDL

• サービスリクエスタ稼働マシンのSOAP通信基盤の設定または状態

• HCSCサーバの設定または状態

• ネットワークの状態

また，次に示す処理が常に実行されているかを確認することで，問題発生個所を絞り込めます。

1. サービスリクエスタ（クライアント）からSOAPメッセージが正しく出力されているか。

2. SOAPメッセージはHCSCサーバ稼働マシン（サーバ）のSOAP通信基盤に届いているか。

3. HCSCサーバ稼働マシン（サーバ）のサービス部品からの返信用SOAPメッセージは正しく出力されているか。

4. HCSCサーバ稼働マシン（サーバ）のサービス部品からの返信用SOAPメッセージはサービスリクエスタ（クライアント）のSOAP通信基盤に届いているか。

確認するときはSOAP通信基盤が出力する障害情報を参照します。障害情報の取得方法については，「7.3.3(3)　SOAP通信基盤またはJAX-WSエンジンが出力する障害情報の取得方法」を参照してください。

SOAP通信基盤が出力する障害情報の形式については，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「14.　障害対策」を参照してください。

なお，SOAP通信基盤が出力するアプリケーションログを取得することで，サービスリクエスタとHCSCサーバ間で送受信している電文データを確認できます。

サービス部品の呼び出しを再送するかどうかは，エラーの内容によって異なります。一時的な障害の場合は，再送を試みることで成功することがありますが，次に示すエラーの場合は，再送を試みてもエラーとなります。

• サービスリクエスタで使用しているWSDLが誤っている場合

• サービスリクエスタ稼働マシンのSOAP通信基盤の設定に誤りがある場合

• HCSCサーバの設定に誤りがある場合など

(a)　SOAP1.1の場合

SOAP1.1を利用している場合のSOAP Faultの要素と，エラー時に設定される情報の対応を次の表に示します。

エラーのケースの番号は「7.7.1(2)　問題発生個所の切り分け方」で示す番号に相当します。

(b)　SOAP1.2の場合

SOAP1.2を利用している場合のSOAP Faultの要素と，エラー時に設定される情報の対応を次の表に示します。

エラーのケースの番号は「7.7.1(2)　問題発生個所の切り分け方」で示す番号に相当します。

(a)　サービスリクエスタから指定したクライアント相関IDからたどる方法

サービスリクエスタから指定したクライアント相関IDからたどる手順を次に示します。

1. クライアント相関IDを調査します。

   クライアント相関IDは，サービス部品呼び出しを要求するサービスリクエスタ側のプログラムで，要求時（呼び出し時）に設定する情報です。サービスリクエスタからの要求電文と，HCSCサーバで管理しているログおよびトレースとを対応づけるために使用します。そのため，HCSCサーバに送信した要求ごとに異なるIDを指定することを推奨します（サービスリクエスタ作成時に指定が必要です）。

   サービス部品呼び出し要求の実行履歴を追跡する場合，サービスリクエスタ側の要求者からシステム管理者に障害調査を依頼するとき，クライアント相関IDを伝え，システム管理者はその情報を基に実行履歴を追跡します。

   サービスリクエスタでのクライアント相関IDを指定するコーディングの例を次に示します。ここでは，標準受付（Webサービス）を呼び出すときの引数に，クライアント相関ID（"ClientID0001"）を設定しています。

   

2. クライアント相関IDを基にリクエストトレースを調査し，エラーが発生したときのメッセージ共通IDを取得します。メッセージ共通IDによって，障害が発生したビジネスプロセスのインスタンスを特定できます。

   なお，クライアント相関IDは重複しているおそれがあります。そのため，適宜実行時刻やビジネスプロセス名（サービス名）を取得しておくことで，該当個所を特定します。

   リクエストトレースの例を次に示します。リクエストトレースの"message"列にクライアント相関IDやビジネスプロセス名（サービス名）があり，先頭にメッセージ共通IDが出力されています。

   

3. 取得したメッセージ共通IDを基に，プロセスインスタンスの実行履歴を参照してビジネスプロセスのプロセスIDを取得します。プロセスIDを取得するには，プロセスインスタンスの検索（cscpiselect）コマンドを使用します。

   cscpiselectコマンドでは，開始日時とビジネスプロセス名（サービス名）を条件に，プロセスインスタンスの実行履歴を検索します。

   また，-tableオプションに"relation"を指定し，検索条件（where句）にSQL条件を指定して，該当するメッセージ関連情報を表示します。

   

   cscpiselectコマンドの使い方については「6.1.2　プロセスインスタンスの実行履歴を検索する」を，コマンドの文法については，マニュアル「サービスプラットフォーム リファレンス」の「cscpiselect（プロセスインスタンスの検索）」を参照してください。

4. 取得したプロセスIDを基に，プロセスインスタンスの実行履歴を参照して，ビジネスプロセスのアクティビティとその状態を取得します。アクティビティの情報を取得するには，プロセスインスタンスの検索（cscpiselect）コマンドを使用します。

   cscpiselectコマンドでは，開始日時とビジネスプロセス名（サービス名）を条件に，プロセスインスタンスの実行履歴を検索します。

   また，-tableオプションに"activity"を指定し，検索条件（where句）にSQL条件を指定して，該当するアクティビティ情報を表示します。

   状態が"Executing"となっている個所が現在実行中のアクティビティです。状態を確認することで，どのアクティビティで止まっているかがわかります。

   

   cscpiselectコマンドの使い方については「6.1.2　プロセスインスタンスの実行履歴を検索する」を，コマンドの文法については，マニュアル「サービスプラットフォーム リファレンス」の「cscpiselect（プロセスインスタンスの検索）」を参照してください。

5. ユーザ電文トレースを採取する設定をしている場合，ユーザ電文の内容を確認できます。

   ユーザ電文トレースでは，メッセージ共通IDを基にユーザ電文を検索します（クライアント相関IDや日時からも検索できます）。ユーザ電文トレースの出力先や出力内容については，「7.4.4　ユーザ電文トレース」を参照してください。

   ユーザ電文トレースの採取は，HCSCサーバランタイム定義ファイルで設定します。詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

(b)　ユーザ電文に指定したビジネスプロセスの相関セットからたどる方法

ユーザ電文に指定したビジネスプロセスの相関セットからたどる手順を次に示します。

1. 相関セットを調査します。

   相関セットは，サービス部品呼び出しを要求するサービスリクエスタ側のプログラムで，要求時のユーザ電文に設定する情報です。サービスリクエスタからHCSCサーバを介してサービス部品に送信する要求電文を一意に識別するために利用する文字列です。

   HCSCサーバからの応答は，相関セットを含んだ応答電文をサービスリクエスタに返信します。その結果，サービスリクエスタは受信した応答電文が，どの要求電文に対する応答であるのかを一意に識別できます。

   相関セットを使用するには，開発環境でのビジネスプロセス定義時に定義する必要があります。詳細については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「5.5.2　相関セットの定義」を参照してください。

   サービス部品呼び出し要求の実行履歴を追跡する場合，サービスリクエスタ側の要求者からシステム管理者に障害調査を依頼するときに，相関セットと要求したビジネスプロセス名（サービス名）を伝え，システム管理者はその情報を基に実行履歴を追跡します。

   注意事項

   サービスリクエスタ利用者が相関セットの値をとらえていない場合は，HCSCサーバにインポートしたリポジトリを開発環境で参照して，該当のビジネスプロセスの相関セットを調査する必要があります。相関セットの調査方法は次のとおりです。

   1. ビジネスプロセス定義画面の［変数・相関セット］アイコンをダブルクリックします。

      変数・相関セット一覧ダイアログが表示されます。

   2. 変数・相関セット一覧ダイアログの「表示」ボタンをクリックします。

      変数の表示ダイアログが表示されます。

   3. ユーザ電文と変数表示ダイアログのXMLスキーマを突き合わせて，相関セットへのパスを取得します。

   4. 変数・相関セット一覧ダイアログを使って，パス名から変数名や部分名を取得し，変数・相関セット一覧ダイアログから同じ変数名や部分名を持つ相関セットを探して相関セット名を取得します。

2. 取得した相関セットを基に，プロセスインスタンスの実行履歴を参照して，ビジネスプロセスのプロセスIDを取得します。プロセスIDを取得するには，プロセスインスタンスの検索（cscpiselect）コマンドを使用します。

   cscpiselectコマンドでは，相関セットを条件としてプロセスインスタンスの実行履歴を検索します。

   また，-tableオプションに"process_set"を指定し，検索条件（where句）にSQL条件を指定し，該当するプロセス概要情報を表示します。

   

   cscpiselectコマンドの使い方については「6.1.2　プロセスインスタンスの実行履歴を検索する」を，コマンドの文法については，マニュアル「サービスプラットフォーム リファレンス」の「cscpiselect（プロセスインスタンスの検索）」を参照してください。

3. 取得したプロセスIDを基に，プロセスインスタンスの実行履歴を参照して，ビジネスプロセスのアクティビティとその状態を取得します。アクティビティの情報を取得するには，プロセスインスタンスの検索（cscpiselect）コマンドを使用します。

   cscpiselectコマンドでは，開始日時とビジネスプロセス名（サービス名）を条件としてプロセスインスタンスの実行履歴を検索します。

   また，-tableオプションに"activity"を指定し，検索条件に該当するアクティビティ情報を表示します。

   状態が"Executing"となっている個所が現在実行中のアクティビティです。状態を確認することで，どのアクティビティで止まっているかがわかります。

   

   cscpiselectコマンドの使い方については「6.1.2　プロセスインスタンスの実行履歴を検索する」を，コマンドの文法については，マニュアル「サービスプラットフォーム リファレンス」の「cscpiselect（プロセスインスタンスの検索）」を参照してください。