手順 11: オーケストレーション変数の作成
この手順では、オーケストレーションによって送受信されるメッセージ インスタンスのオーケストレーション変数を作成します。
BizTalk Accelerator for HL7 (BTAHL7) シリアライザーには、次のパーツ名が必要です。 他のパーツ名を含むマルチパート メッセージを作成すると、シリアライザーはメッセージを拒否します。 メッセージ パーツ名は次のとおりです。
MSHSegment
BodySegments
Z セグメント
Z セグメント パーツに関する重要な情報を次に示します。
すべてのメッセージには、Z セグメントが存在するかどうかに関係なく、上記のように 3 つの部分が含まれます。
Z セグメント部分を使用して、メッセージ インスタンスのデータを格納します。これは、末尾であり、スキーマで定義されていません (これは宣言されていないことも意味します)。
宣言されていないデータがない場合、Z セグメント パーツは空白になります。 BizTalk マッパー内で中間 XML を表示するときに、Z セグメントパーツは表示されません。ただし、BizTalk Health and Activity Tracking (HAT) ツールでは、各メッセージに対して 3 つの部分が表示されます。
オーケストレーション変数を作成するには
[ソリューション] エクスプローラーの下にある [ソリューション エクスプローラー] タブの横にある [オーケストレーション ビュー] タブをクリックします。
[ オーケストレーション ビュー ] ウィンドウで、[ メッセージ] を右クリックし、[ 新しいメッセージ] をクリックします。
[プロパティ] ウィンドウの [識別子] プロパティを DoorbellInputMessage に変更し、Enter キーを押します。
[ プロパティ ] ウィンドウの [ メッセージの種類] のドロップダウン リストで、[ スキーマ] を展開し、[ BTAHL7_Project.Doorbell] をクリックします。
手順 2 と 3 を繰り返して 、DoorbellOutputMessage という名前の別のメッセージを作成します。
[ プロパティ ] ウィンドウの [ メッセージの種類] のドロップダウン リストで、[ スキーマ] を展開し、[ BTAHL7Schemas.ADT_A04_22_GLO_DEF] をクリックします。
[ オーケストレーション ビュー ] ウィンドウで、[ 種類 ] ノードを展開します。 [ マルチパート メッセージの種類] を右クリックし、[ 新しいマルチパート メッセージの種類] をクリックします。
注意
Visual Studio 2013は、MultipartType_1 という名前の新しいメッセージ型と、MessagePart_1という名前の新しいメッセージを作成します。
[MultipartType_1] をクリックし、[プロパティ] ウィンドウで [識別子] をクリックし、新しい名前 DoorbellFinalMessageType を入力して、Enter キーを押します。
注意
手順 9 から 15 では、マルチパート メッセージの部分を作成します。 マルチパート メッセージの部分を作成する順序は重要です。 常にヘッダー、本文、Z セグメントを作成します。
注意
メッセージ パーツを作成して名前を付けたら、名前を変更しないでください。 必要に応じて、古いボディ パーツを削除し、新しい名前で新しいボディ パーツを作成します。
[ 種類 ] ウィンドウの [ マルチパート メッセージの種類] で、[ DoorbellFinalMessageType] を展開し、[ MessagePart_1] をクリックします。 [プロパティ] ウィンドウで、[識別子] に「MSHSegment」と入力し、Enter キーを押します。 [種類] のドロップダウン リストで、[.NET クラス] を展開し、[参照先アセンブリ>から選択] をクリックします<。
[ 成果物の種類の選択 ] ダイアログ ボックスの左側のウィンドウで、[ System.Xml] をクリックします。 右側のウィンドウで [ XmlDocument] をクリックし、[ OK] をクリックします。
[オーケストレーション ビュー] ウィンドウで、[ DoorbellFinalMessageType] を右クリックし、[ 新しいメッセージ パーツ ] をクリックしてMessagePart_1を作成します。
[プロパティ] ウィンドウで、[識別子] に「BodySegments」と入力し、Enter キーを押します。 [ 種類] のドロップダウン リストで、[ スキーマ] を展開し、ドロップダウン リストから [BTAHL7Schemas.ADT_A04_22_GLO_DEF ] を選択します。
[メッセージ本文パーツ] プロパティを True に設定します。
[ オーケストレーション ビュー ] ウィンドウで、[ DoorbellFinalMessageType] を右クリックし、[ 新しいメッセージ パーツ] をクリックします。
[プロパティ] ウィンドウで、[識別子] に「ZSegments」と入力し、Enter キーを押します。 [ 種類] をクリックし、[ .NET クラス] を展開し、ドロップダウン リストから [ System.String ] をクリックします。
注意
Z セグメントにはスキーマに準拠する必要のない文字列データが含まれているため、Z セグメントメッセージ部分には System.String を使用します。
[ オーケストレーション ビュー ] ウィンドウで、[ メッセージ] を右クリックし、[ 新しいメッセージ] をクリックします。
[プロパティ] ウィンドウで、[識別子] に「DoorbellFinalMessage」と入力し、Enter キーを押します。 [メッセージの種類] のドロップダウン リストで、[マルチパート メッセージの種類] を展開し、[BTAHL7_Project.DoorbellFinalMessageType] をクリックします。
[ オーケストレーション ビュー ] ウィンドウで、[ 変数] を右クリックし、[ 新しい変数] をクリックします。
[プロパティ] ウィンドウで、[識別子] に「HeaderInfo」と入力し、Enter キーを押します。 [種類] のドロップダウン リストで、[.NET クラス>] をダブルクリックします<。
[ 成果物の種類の選択 ] ウィンドウの左側のウィンドウで、[ System.Xml] をクリックします。 右側のウィンドウで [ XmlDocument] をクリックし、[ OK] をクリックします。
[ ファイル ] メニューの [ すべて保存] をクリックします。