妥当性検査プロパティー

以下の表にリストされているノードの「妥当性検査」タブと「パーサー・オプション」タブのプロパティーを設定すると、妥当性検査を制御できます。

妥当性検査オプションは、以下のノード上で使用できます。

ノード・タイプ	妥当性検査オプションを持つノード
Input ノード	ファイル入力, FTE 入力, HTTP 入力, JMS 入力, カフカコンシューマー, MQ 入力, MQTTSubscribe, .NETInput, SCA 入力, SOAP 入力,TCPIPClientInput, TCP/IP クライアント受信, TCPIP サーバー入力, TCPIP サーバー受信タイムアウト通知
Output ノード	E メール出力, ファイル出力, FTE 出力, HTTP 応答, _ 翻訳不要 _JMSOutput, JMS 応答, カフカプロデューサー, MQOutput, MQ応答, MQTTPublish, SCA 応答, _ 翻訳不要 _SOAPReply, TCPIPClientOutput, TCP/IP サーバー出力
その他のノード	計算, CICS要求, データベース取得, HTTP 要求, ファイル読み取り, JavaCompute (計算), マッピング, MQGET, コンテンツ・ディスクリプターのリセット, SCAA同期応答, SCA 要求, SOAP 要求, SOAPAsync応答, 検証, XSL変換

統合ノードでのメッセージ妥当性検査の概要については、メッセージの検証を参照してください。

以下の表に示されているプロパティーを設定できます。

タブ	妥当性検査に影響を与えるプロパティー
妥当性検査	妥当性検査、失敗処置
パーサー・オプション	構文解析のタイミング

「妥当性検査」タブのプロパティー

妥当性検査

妥当性検査が必要かどうかを設定します。すべてのノードは、以下のオプションを提供します。

なし: デフォルト値。妥当性検査は実行されません。
Content: 内容の検証や構成など、内容のチェックを実行するよう指定します。
内容と値: 内容の検証や構成などの内容チェック、および値がデータ・タイプ、長さ、範囲、列挙などと一致するかどうかなどの値チェックを実行するよう指定します。

注: 内容が選択されている場合でも、SOAP、DFDL、および XMLNSC ドメインは常に内容と価値妥当性検査を実行します。

次のオプションを提供するノードもあります。

継承: ノードで提供されているどの妥当性検査オプションよりも優先的に、入力メッセージ・ツリーに備えられているすべての妥当性検査オプションを使用するようノードに指示します。そのため、「継承」は「なし」、「内容」、または「内容と値」に解決されます。「継承」が選択される場合、タブ上の他の妥当性検査プロパティーは選択できません。

失敗時の処置

妥当性検査に失敗したときに行う処置。これは次のいずれかの値に設定できます。

例外

デフォルト値。最初の妥当性検査の失敗で例外がスローされます。その結果として生成される例外リストを以下に示します。メッセージ・フローのユーザー・トレースを要求している場合は、失敗のユーザー・トレースへの記録も行われ、妥当性検査が停止します。失敗の発生時にただちにメッセージの処理を停止したい場合は、この設定を使用します。

MRM および IDOC 失敗アクションが「例外」に設定された場合の例外リスト

XMLNSC および SOAP 失敗アクションが「例外」に設定された場合の例外リスト

例外リスト (Exception List)

妥当性検査が失敗した場合 (ただし現行の構文解析または書き込み操作が完了した場合のみ) に例外をスローします。その結果として生成される例外リストを以下に示します。メッセージ・フローのユーザー・トレースを要求している場合は、各失敗のユーザー・トレースへの記録も行われ、妥当性検査が停止します。妥当性検査が失敗したときにメッセージの処理を停止したい場合、しかし発生した失敗のリストをすべて見たい場合にこの設定を使用します。このプロパティーは「構文解析のタイミング」プロパティーによって影響を受けます。部分構文解析が選択される場合、現行の構文解析操作は入力メッセージの一部のみを構文解析するため、メッセージのその部分の妥当性検査の失敗のみが報告されます。

MRM および IDOC 失敗アクションが「例外リスト」に設定されたときの例外リスト

XMLNSC および SOAP 失敗アクションが「例外リスト」に設定されたときの例外リスト

ユーザー・トレース

メッセージ・フローのユーザー・トレースを要求していない場合でも、妥当性検査の失敗をすべてユーザー・トレースに記録します。妥当性検査の失敗に関係なくメッセージの処理を続行できるようにするには、この設定を使用します。

ローカル・エラー・ログ

すべての検証の失敗をエラー・ログ (Windows のイベント・ログなど) に記録します。妥当性検査の失敗に関係なくメッセージの処理を続行できるようにするには、この設定を使用します。

「パーサー・オプション」タブのプロパティー

構文解析のタイミング

「構文解析のタイミング」プロパティーは、メッセージの構文解析時に要求時構文解析を使用するかどうかを決定します。このプロパティーを使用すると、入力メッセージの妥当性検査のタイミングを制御することもできます。

「構文解析のタイミング」値として「要求時」を選択する場合、メッセージ内のフィールドが要求時構文解析によって解析されるまで、それらの妥当性検査が遅延します。
「構文解析のタイミング」値として「即時」を選択した場合、要求時構文解析はオーバーライドされて、メッセージ・ドメインが MRM の場合は、構成が「選択」または「メッセージ」の、その時点では解決できない複合タイプを除く、メッセージ内のすべてのものが構文解析され、妥当性検査されます。
「構文解析のタイミング」の値として「完全」を選択する場合、要求時構文解析はオーバーライドされ、すべてのものが構文解析され、妥当性検査されます。メッセージ・ドメインが MRM の場合、構成が「選択」または「メッセージ」の、その時点では解決できない複合タイプがあると、妥当性検査は失敗します。

メッセージの妥当性検査が使用可能になっていて、「構文解析のタイミング」に「要求時」または「即時」を選択した場合、メッセージ・フローによるメッセージの処理において、妥当性検査エラーがすぐには検出されないことがあります。またはメッセージの一部が解析されない場合は、エラーがまったく検出されないこともあります。メッセージ内のすべてのフィールドが確実に妥当性検査されるようにするには、「完全」を選択します。ただし、メッセージ・ドメインが MRM の場合は、「即時」を選択してメッセージ・フローの開始時に、構成が「選択」または「メッセージ」のすべての未解決タイプを確実に解決しておいてください。

「構文解析のタイミング」プロパティーは、出力メッセージの妥当性検査には影響を与えません。