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