図形の変換
変換はメッセージを作成するときにのみ使用されるため、 変換 図形は常に メッセージ構築 図形内に表示されます。 デザインサーフェイスに メッセージの構築 図形をドロップし、その中に 変換 図形をドロップするか、デザインサーフェイスに 変換 図形をドロップするだけで、オーケストレーション デザイナーによって囲まれた メッセージの構築 図形が作成されます。
注
変換の送信元または送信先のメッセージは、スキーマに基づいている必要があります。
プロシージャ
変換図形を設定するには
[プロパティ] ウィンドウで、[入力メッセージ]、[出力メッセージ]、または [マップ名] プロパティの省略記号 (...) ボタンをクリックします。
[変換の構成] ダイアログ ボックスを使用して、変換図形を構成します。
注
Transform 図形は、メッセージ構築図形内にのみ存在できます。 デザインサーフェイスの他の場所に メッセージ割り当て 図形をドラッグすると、新しい メッセージ構築 図形が作成されます。
パフォーマンスに関する重要な考慮事項
BizTalk Server は、ドキュメント全体を一度にメモリに読み込むのではなく、変換を適用しながらドキュメントをメモリにストリーミングすることで、大きなメッセージに対して変換を実行する機能を最適化します。 この最適化により、以前のバージョンの BizTalk Server で可能であったよりもはるかに大きなドキュメントのマッピング/変換が可能になります。 この最適化の制限は、オーケストレーションが複数の入力または出力を受け入れて図形を変換する場合に発生します。
オーケストレーションが複数の入力や出力を受け入れて図形を変換する場合、ドキュメント ストリーミングは実行されず、メモリ使用量が大幅に増加します。 この問題に対する回避策のひとつとして、1 つの入力または 1 つの出力しか変換シェイプに受け入れないように、受信パイプラインで変換を適用する方法があります。
新規/既存のマップファイル
このセクションでは、[ 新しいマップ ] または [ 既存のマップ ] オプション ボタンをクリックして、 変換 図形に割り当てるマップを選択できます。
選択したオプション ボタンの下にある [名前 ] フィールドを使用して、マップを指定します。 [新しいマップ] を選択した場合は、割り当てるマップの指定を入力できます。 [新しいマップ] オプションを使用する場合は、テキスト ボックスにマップの完全修飾名を指定する必要があります。 既定では、このような名前の例がテキスト ボックスに表示されます。プロジェクトの名前空間と 変換 図形名に基づく一意の識別子名が事前に設定されているためです: <Project 名前空間>.<図形名>_Map変換 (例: MyProject.Transform3_Map)。
[既存のマップ] を選択した場合は、[名前] フィールドの下矢印をクリックして、使用するマップ ファイルを選択します。 このリスト ボックスには、プロジェクトで使用可能なすべての既存のマップのアルファベット順に並べ替えられた一覧が表示されます。 この一覧で、テキスト <参照アセンブリから選択>をクリックすると、[ 成果物の種類の選択 ] ダイアログ ボックスが表示されます。 使用可能な選択の詳細については、「 成果物の種類の選択] ダイアログ ボックスを使用する方法」を参照してください。
送信元メッセージと宛先メッセージの選択
[ 変換の構成] ダイアログ ボックスのこの部分を使用して、[ 新規/既存のマップ ファイル] セクションで選択したマップを構成します。 そのセクションで [新しいマップ ] を選択した場合は、このセクションでマップを構成してマップを作成します。
[既存のマップ] を選択した場合は、このセクションを使用して、次の 2 つのいずれかを実行できます。
現在の変換で as-is を再利用するには、既存のマップを選択します。
既存のマップを変更 (再構成) するために選択し、現在の変換の新しい構成で使用します。
[送信元メッセージ] グリッドコントロールと [宛先メッセージ] グリッド コントロールを使用して 、送信元メッセージ と 送信先メッセージ を指定します。 これらのグリッド コントロールを使用すると、いくつかの方法でマップ ファイルを変更できます。 メッセージ (いずれかのグリッド コントロールの行) を削除したり、メッセージを追加したり、別の種類のメッセージを選択したりする場合は、マップの構造を変更します。 マップの構造を変更する場合、それを使用する他のすべての変換は、マップの新しい構造に合わせて変更する必要があります。 メッセージの削除や同じ型のメッセージの挿入など、その他の変更によってマップの構造は変更されません。
[送信元メッセージ] グリッドコントロールと [宛先メッセージ] グリッド コントロールの外観と動作は同じです。 各グリッド コントロールには、Message と Type の 2 つの列があります。 グリッド コントロールを設定するには、[メッセージ] 列でメッセージを選択します。 ([種類] 列は読み取り専用であるため、[メッセージ] 列にのみデータを追加します)。[メッセージ] 列のセルには、現在のオーケストレーションのスコープ内にあるメッセージ インスタンスが設定されたドロップダウン リストがあります。
グリッド コントロールの左側にある 右矢印 (>) ボタンをクリックして、いずれかのグリッド コントロールで行を選択できます。 行を選択したら、DELETE キーを押して削除できます。 行 (メッセージ) を削除すると、その行を含むマップ ファイルの構造が変更されます。 変更できるのは、プロジェクトに対してローカルなマップ ファイルのみです。
[OK] をクリックすると、BizTalk マッパーが起動します。
OK をクリックすると、BizTalk マッパーが自動的に開き、変換の構成 ダイアログ ボックスが閉じられて変更が保存されます。 ただし、必要な情報がない場合は、変更を保存できません。 この場合は、ダイアログ ボックスのフィールドの入力を完了し、[OK] をクリック します。