メッセージ エディター パイプライン コンポーネント
このコンポーネントにより、送信または受信パイプライン内のマルチパート メッセージの一部を自動的に編集できます。 このコンポーネントは既存のパイプラインに追加して、通常の処理の一部として置換のためのパイプラインを設定します。
既存のパイプラインへのメッセージ エディタ パイプライン コンポーネントの構築
メッセージ エディタ パイプライン コンポーネントを使用するには、既存のパイプラインにコンポーネントを追加する必要があります。 詳細については、BizTalk Server ヘルプの「パイプライン Designerを使用したパイプラインの作成」を参照してください。
メッセージ エディタ パイプライン コンポーネントを既存のパイプラインに追加するには
Visual Studio を起動します。
[ ファイル ] メニューの [ 開く] をポイントし、[ プロジェクト] をクリックします。
C:\Program Files (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\Message Editor Pipeline Component に移動し、[ MessageEditor.csproj] を選択し、[ 開く] をクリックします。
Visual Studio コマンド プロンプトを起動します。
コマンド プロンプトで、C:\Program Files (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\Message Editor Pipeline Component\obj\debug に移動します。
コマンド プロンプトで、「 sn -k MessageEditor.snk」 と入力してキーを作成し、Enter キーを押します。
Visual Studio のソリューション エクスプローラーで、[MessageEditor] を右クリックし、[プロパティ] をクリックします。
[MessageEditor プロパティ] ページで、[署名] タブをクリックし、[アセンブリの署名] チェック ボックスをオンにします。
[ 厳密な名前のキー ファイルの選択 ] ドロップダウンで、C:\Program Files (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\ SDK\Message Editor Pipeline Component\obj\debug に移動し、[ MessageEditor.snk ] を選択し、[ 開く] をクリックします。
ソリューション エクスプローラーで、[MessageEditor] を右クリックし、[ビルド] をクリックします。 出力ペインで、ビルドが成功したことを確認します。
[スタート] ボタンをクリックし、[すべてのプログラム] をポイントし、[アクセサリ] をポイントして、[Windows エクスプローラー] をクリックします。
Windows エクスプローラーで、C:\Program Files\Microsoft BizTalk 2013 Accelerator for RosettaNet\SDK\Message Editor Pipeline Component\obj\debug に移動し、[Microsoft.Solutions.BTARN.SDK.MessageEditor.dll] を右クリックし、[コピー] をクリックします。
C:\Program Files\Microsoft BizTalk Server 2013\Pipeline Components に移動し、[パイプライン コンポーネント] を右クリックし、[貼り付け] をクリックします。
Visual Studio の [ ファイル ] メニューの [ 開く] をポイントし、[ プロジェクト] をクリックします。
エディターを追加するパイプラインを含んでいるプロジェクトを開きます。
ソリューション エクスプローラーで、パイプライン名をクリックし、パイプライン デザイナーでパイプラインを開きます。
[ツールボックス] ウィンドウの [BizTalk パイプライン コンポーネント] ペインを右クリックし、[ 項目の追加と削除] をクリックします。
[ ツールボックスのカスタマイズ ] ダイアログ ボックスの [ BizTalk パイプライン コンポーネント ] タブで、[ BTARN メッセージ エディター コンポーネント] を選択し、[OK] をクリック します。
[ツールボックス] ウィンドウの [BizTalk パイプライン コンポーネント] ペインで、 BTARN メッセージ エディター コンポーネントをクリックしたまま、パイプライン内の目的の位置にコンポーネントをドラッグします。
[ツールボックス] ウィンドウの [BizTalk パイプライン コンポーネント] ペインで、 BTARN メッセージ エディター コンポーネントをクリックしたまま、パイプライン内の目的の位置にコンポーネントをドラッグします。
Note
メッセージ エディター パイプライン コンポーネントは、受信パイプライン コンポーネントの逆アセンブル ステージ、または送信パイプライン コンポーネントのプリアセンブル ステージの後で追加することをお勧めします。
Visual Studio の [パイプライン Designer] で、[BTARN メッセージ エディター コンポーネント] 図形を選択します。
[プロパティ] ペインの XPath Query に関連付けられているテキスト ボックスに、値を変更する XPath 要素の名前を入力します。
XPath Value に関連付けられているテキスト ボックスに、XPath 要素を設定する値を入力します。
[ソリューション] エクスプローラーで、プロジェクト名を右クリックし、[ビルド] をクリックします。 ビルドが成功することを確認します。
[ソリューション] エクスプローラーで、プロジェクト名を右クリックし、[配置] をクリックします。 展開が成功することを確認します。
例
0C1 PIP スキーマの要素 ProprietaryDocumentIdentifier
の値を変更するには、次のコード セクションに示す XPath クエリを、メッセージ エディター パイプライン コンポーネントの XPath Query プロパティに追加します。
/*[local-name()='Pip0C1AsynchronousTestNotification' and namespace-uri()='http://schemas.microsoft.com/biztalk/btarn/2004/0C1_MS_R01_02_AsynchronousTestNotification.dtd']/*[local-name()='thisDocumentIdentifier' and namespace-uri()='http://schemas.microsoft.com/biztalk/btarn/2004/0C1_MS_R01_02_AsynchronousTestNotification.dtd']/*[local-name()='ProprietaryDocumentIdentifier' and namespace-uri()='http://schemas.microsoft.com/biztalk/btarn/2004/0C1_MS_R01_02_AsynchronousTestNotification.dtd']
完全な XPath クエリを取得するには、BizTalk エディターでスキーマを開き、プロパティ ウィンドウの下の Instance XPath
プロパティから Xpath をコピーします。 指定する XPath クエリには、すべての名前空間参照が含まれている必要があります。