メッセージ検証の制御

d 検証フラグ

d フラグが [検証] 文字列に含まれている場合は、(ビジネス・サービスによって設定された) メッセージ内で指定された [スキーマ・カテゴリ] が検査され、メッセージの DocType と比較されます。メッセージ内の [スキーマ・カテゴリ] が空の場合は、自動的に、そのメッセージが不正として宣言されます。ただし、[スキーマ・カテゴリ] が空白ではないが、メッセージの DocType と一致しない場合は、m などの別の [検証] フラグが定義されていれば、検証が続行されます。

m 検証フラグ

m フラグが [検証] 文字列に含まれている場合は、メッセージを検証する方法と不正として宣言する方法のどちらかが検索されます。詳細は、仮想ドキュメント・タイプによって異なります。

ルーティング・プロセス・クラス内の検証ロジックの上書き

Ensemble クラスのサブクラスを作成してから、OnValidate() メソッドを上書きする場合は、次の手順を実行する必要があります。

• [検証] 設定で受け入れられた値のリストを拡張または置換すること。

• ルーティング・プロセスによるドキュメントの検証方法を決定すること。[検証] のオプションで制御できます。

OnValidate() メソッドをオーバーライドする場合は、同じサブクラス内の [検証] プロパティの定義もオーバーライドできます。以下のような詳細情報に注意してください。

• InitialExpression 値は、[検証] 構成設定のデフォルトを指定します。

• [検証] プロパティ定義に先行するコメントは、[検証] 設定のツール・ヒントとして使用されます。/// 規則を使用し、最後のコメントとプロパティ定義の間には空白行を残さないでください。これにより、管理ポータル・ユーザは入力されたコメントをツール・ヒントとして表示できます。

  例として、以下の引用には、EnsLib.HL7.MsgRouter.RoutingEngineOpens in a new tab クラスの [検証] プロパティ定義と共に表示されるいくつかのコメントが示されています。

  /// 'd' - require DocType
  /// 'm' - don't tolerate BuildMap errors (includes 'z' by default;
  ///       specify '-z' to tolerate unrecognized trailing Z-segments)
  /// 'z' - don't tolerate unrecognized trailing Z-segments
  Property Validation As %String(MAXLEN = 20) [ InitialExpression = "dm-z", Transient ];
  
  

  

ビジネス・サービス・クラスまたはビジネス・オペレーション・クラス内の検証ロジックの上書き

仮想ドキュメントのビジネス・サービス・クラスとビジネス・オペレーション・クラスのそれぞれで、上書きが可能な Validation プロパティと OnValidate() メソッドが提供されます。デフォルトで、このプロパティがいずれかのビジネス・サービスまたはビジネス・オペレーションの設定として公開されることはなく、これらのクラス内で OnValidate() アクティビティが実行されることはありません。ドキュメントを、いつものようにルーティング・エンジンで検証するのではなく、インタフェースの受信側または送信側で検証する場合は、この動作を変更できます。変更を実行するには、以下の手順に従います。

1. 上記の [検証] プロパティと OnValidate() メソッドをオーバーライドするための手順を実行します。

2. ユーザが検証のタイプを選択できるようにする場合は、Validation プロパティも設定として追加します。"Ensemble プロダクションの開発" の “設定の追加と削除” を参照してください。