XI
メッセージヘッダのクエリ 
用途
このプロトコルを使用して、プロキシ呼出の後にメッセージヘッダの項目に関するクエリを実行することができます。
統合
マッピング時またはインテグレーションディレクトリの技術コンテキストオブジェクトを使用してメッセージヘッダの項目に対してクエリを実行することもできます。参照: コンテナオブジェクト(メッセージマッピング)、Java マッピング、XSLT マッピング。
機能
呼出状況に応じたプロトコルの使用
プロキシ呼出 |
読込可能なメッセージヘッダ |
送信側の非同期プロキシ呼出 |
リクエストメッセージのメッセージヘッダ |
送信側の同期プロキシ呼出 |
応答メッセージのメッセージヘッダ |
受信側の同期/非同期プロキシ呼出 |
リクエストメッセージのメッセージヘッダ |
メッセージヘッダ内の項目
GET_HEADER_FIELD メソッドは、メッセージヘッダ内の項目の値を文字列として戻します。メッセージヘッダの読込可能な各項目の IF_WSPROTOCOL_XI_HEADER インタフェースに定数があります。
定数を使用したメッセージヘッダ項目へのアクセス
定数 |
意味 |
MESSAGE_CLASS |
メッセージの分類。使用可能な値: ●
ApplicationMessage: ●
ApplicationResponse: ●
SystemAck, ApplicationAck, SystemError, ApplicationError: |
VERSION_MAJOR |
XI メッセージプロトコルバージョン。例: XI 3.0 メッセージプロトコルの場合は、VERSION_MAJOR = 3 および VERSION_MINOR = 0 です。 |
VERSION_MINOR |
|
PROCESSING_MODE |
メッセージモードは同期または非同期です。これに応じて、これらの定数は、値 synchronous または asynchronous になります。 |
MESSAGE_ID |
メッセージ ID。メッセージ ID は、通信中に変更される可能性があります。 応答メッセージは新規メッセージ ID を取得します。 あるメッセージから新規メッセージが作成される場合 (メッセージが複数受信者でコピーされる)、新規メッセージによって新規メッセージ ID が取得されます。 |
REF_TO_MESSAGE_ID |
意味的にこのメッセージに属している参照メッセージの ID。たとえば、応答メッセージでは、この項目を使用して、どの要求メッセージに属しているかを示します。 |
CONVERSATION_ID |
この項目は、メッセージで必須ではありません。この項目を使用すると、同じグループに属するメッセージを ID を使用してグループ化することができます。この項目は、メッセージのシリアル化用ではなく、シリアル化コンテキスト (コンテキストオブジェクト QueueId を参照) とは無関係です。 |
TIME_SENT |
送信者がメッセージを送信した時刻を示すタイムスタンプ。タイムスタンプの書式は、以下のとおりです。 YYYY-MM-DDTHH:MM:SSZ 日付と時刻は、文字 ‘T’ によって区切ります。日時は、通常、UTC で示されます。ローカルタイムの場合、末尾の ‘Z’ は省略されます。 |
INTERFACE |
送信側インタフェースの名称。 |
INTERFACE_NAMESPACE |
送信側インタフェースの名前空間。 |
SENDER_PARTY |
メッセージを送信した通信パーティ。 |
SENDER_PARTY_AGENCY |
メッセージ送信者の発行機関。 |
SENDER_PARTY_SCHEME |
送信者によって使用される ID スキーム。 |
SENDER_SERVICE |
メッセージを送信した送信者側のサービス。たとえば、ビジネスシステム名などです。 |
RECEIVER_PARTY |
メッセージを受信する通信パーティ。 |
RECEIVER_PARTY_AGENCY |
メッセージ受信者の発行機関。 |
RECEIVER_PARTY_SCHEME |
|
RECEIVER_SERVICE |
メッセージを受信する受信者側のサービス。たとえば、ビジネスシステム名などです。
|
QUALITY_OF_SERVICE |
メッセージの処理に使用される |
QUEUE_ID |
QUALITY_OF_SERVICE = ”ExactlyOnceInOrder” にのみ関連。 この項目の値は、送信者が、関連する非同期メッセージをバンドルする場合に使用するシリアル化コンテキストに対応しています (ABAP ランタイム、Java プロキシランタイムを参照)。 |
以下のメッセージヘッダ項目は、MessageClass=”ApplicationMessage” および ProcessingMode=”asynchronous” (上記参照) にのみ関連しています。これらの項目の値は、ブール値 trueまたは false です。参照: 通知
応答のメッセージヘッダの項目
定数 |
意味 |
SYSTEM_ACK_REQUESTED |
この項目の値が true の場合、送信者はシステムからの成功応答を要求しました。 |
SYSTEM_ERROR_ACK_REQUESTED |
この項目の値が true の場合、送信者はシステムからの失敗応答を要求しました。 |
APPLICATION_ACK_REQUESTED |
この項目の値が true の場合、送信者はアプリケーションからの成功応答を要求しました。 |
APPLICATION_ERROR_ACK_REQUESTD |
この項目の値が true の場合、送信者はアプリケーションからの失敗応答を要求しました。 |
例
以下の例では、受信側の応答メッセージのメッセージヘッダ内の MESSAGE_CLASS 項目にアクセスするために IF_WSPROTOCOL_XI_HEADER プロトコルが使用されます。
DATA:
interface TYPE REF
TO co_sxidag_fsa_query,
request
TYPE sxidag_fsa_query_mt,
response TYPE
sxidag_fsa_response_mt,
xi_header_protocol TYPE REF TO
if_wsprotocol_xi_header,
xi_header_value
TYPE string.
* インスタンスの登録
CREATE
OBJECT interface
* 要求データの設定
request-flight_seat_availability_query-flight_id-airline_id
= 'LH'.
TRY.
*
xi_header プロトコルの取得
xi_header_protocol
?= interface->get_protocol(
if_wsprotocol=>xi_header
).
* クライアントプロキシの呼出
CALL
METHOD interface->execute_synchronous
EXPORTING
output = request
IMPORTING
input =
response.
* ヘッダ項目の取得
xi_header_value
= xi_header_protocol->get_header_field(
if_wsprotocol_xi_header=>message_class ).
CATCH cx_ai_system_fault
.
CATCH cx_ai_application_fault
.
ENDTRY.