XML アセンブラー パイプライン コンポーネントの処理命令

処理命令は、XML ドキュメントを処理するアプリケーションに対する情報を提供します。 この情報には、ドキュメントの処理方法や表示方法などの命令が含まれます。

処理命令は、処理 命令の追加 プロパティ (またはメッセージ コンテキストの同等の XMLNorm.ProcessingInstructionOption プロパティ) によって XML ドキュメントに追加されます。 処理命令テキストは、 [処理命令の追加] テキスト プロパティ (または、メッセージ コンテキストの同等の XMLNorm.ProcessingInstruction プロパティ) で指定します。

処理命令の追加プロパティ (または XMLNorm.ProcessingInstructionOption プロパティ) には、次の表に示す 3 つの可能な値があります。

値	値	説明
追加する	0	XML アセンブラーからの新しい処理命令は、ドキュメントの最初の処理命令に追加されます。
新規作成	1	XML アセンブラーからの新しい処理命令は、ドキュメントの最初の既存の処理命令を上書きします。
Ignore	2	ドキュメントの最初の処理命令は、削除されます。

メッセージ コンテキストで指定される処理命令 (またはメッセージ コンテキスト プロパティ) のペアは、パイプライン デザイナーで指定されるプロパティ ペアよりも優先されます。 たとえば、 XMLNorm.ProcessingInstructionOption が Create new (1) として指定され、 XMLNorm.ProcessingInstruction が指定されていない場合、空の処理命令によって既存の処理命令が置き換えられます。

別の例として、 XMLNorm.ProcessingInstruction が指定されていても 、XMLNorm.ProcessingInstructionOption が指定されていない場合、メッセージ コンテキストのプロパティは使用されません。 この場合、パイプライン デザイナーからの処理命令が使用されます。

既定では、 処理命令の追加 は Append に設定され、 処理命令の追加テキスト は空です。

プロパティおよびエンベロープの処理

処理命令はエンベロープ用に維持されないので、フラット ファイル アセンブラー設定の次の組み合わせは、処理命令を持つ最も外側にあるエンベロープのみに適用されます。

• 処理命令スコープ プロパティを "Envelope" に設定します。

• 処理命令 プロパティを "Append" に設定して追加します。

  エンベロープは、アセンブラーの [処理命令の追加] テキスト プロパティで指定された 処理命令を 使用します。

  受信メッセージで指定されている外部エンベロープまたは内部エンベロープ内の既存の処理命令は、出力メッセージに存在しません。

参照

XML アセンブラー パイプライン コンポーネント
XML アセンブラー パイプライン コンポーネントを構成する方法
Pipelines-AssemblerDisassembler (BizTalk Server サンプル フォルダー)