パイプラインは、ソリューションのビルドおよびデプロイ プロセスの一部としてコンパイルおよびデプロイされます。 コンパイラは各コンポーネントで Validate メソッドを呼び出し、構成された情報に対するコンパイル エラーをコンポーネントが返せるようにします。 ビルド後、ソリューションのデプロイ時に、ソリューションの残りの部分と同じアセンブリにパイプラインがデプロイされます。
インスタンスごとのパイプライン構成
インスタンスごとのパイプライン構成は、デプロイされたパイプライン内のパイプライン コンポーネントのプロパティを送信ポートまたは受信場所レベルで変更するために使用されます。 インスタンスごとのパイプライン構成は、インスタンスごとにいくつかのパイプライン コンポーネント プロパティのみを変更する必要がある場合に便利です。 たとえば、複数の受信場所で異なるメッセージの種類をサポートする必要があり、1 つのカスタム XML 受信パイプラインがある場合、インスタンスごとのパイプライン構成を使用すると、パイプラインをデプロイし、既定の構成をオーバーライドできます (異なるエンベロープとドキュメント スペック名の指定を含む)。 このメカニズムは、BizTalk 管理コンソールで、Explorer オブジェクト モデルを使用してプログラムによってサポートされます。
Per-Instance BizTalk 管理コンソールを使用したパイプライン構成
BizTalk 管理コンソールを使用して、インスタンスごとのパイプライン構成を実行できます。 カスタム パイプラインをデプロイしたら、必要な数の受信場所を作成するか、ポートを送信します。 次に、受信場所または送信ポートごとに、[パイプラインの構成] ダイアログ ボックスで既定のプロパティ値をオーバーライドします。 たとえば、別のドキュメント スキーマを指定するには、 EnvelopeDocSpecNames プロパティのスキーマ名を入力します。
Warnung
受信場所または送信ポートで指定された構成値の検証は実行されません。 構成が正しくない場合、パイプラインを通過するときに実行時にメッセージが失敗します。
Per-Instance Explorerオブジェクトモデルを使用したパイプラインの構成
パイプライン コンポーネントのインスタンスごとの構成を記述する XML ファイルを読み取ると、パイプライン ファイルで設定されたプロパティがオーバーライドされます。
インスタンスごとのパイプライン構成は、BizTalk Explorer オブジェクト モデルを使用して設定されます。 BizTalk Explorer オブジェクト モデルは、受信パイプライン コンポーネントの構成を設定するための IReceiveLocation インターフェイスと ISendPort インターフェイスに ReceivePipelineData プロパティを提供します。 BizTalk Explorer オブジェクト モデルには、送信パイプライン コンポーネントの構成を設定するための IReceivePort インターフェイスと ISendPort インターフェイスに SendPipelineData メソッドも用意されています。
インスタンスごとのパイプライン構成では、次の機能はサポートされません。
パイプライン内のステージの並べ替え
ステージの追加または削除
ステージ内のコンポーネントの再配置
コンポーネントの追加または削除
サポートされている変更は、パイプライン コンポーネントの構成のみです。 パイプライン コンポーネントのインスタンスごとの構成は、一般的なパイプライン コンポーネントの構成をオーバーライドします。 コンポーネントのパラメーターがインスタンスごとのパイプライン構成で指定されていない場合は、そのパラメーターの共通構成 (パイプライン デザイナーで構成) が使用されます。
インスタンスごとの構成データの例を次に示します。
<?xml version="1.0" encoding="utf-16"?>
<Root xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Stages>
<Stage CategoryId="9d0e4103-4cce-4536-83fa-4a5040674ad6">
<Components>
<Component Name=Microsoft Microsoft.BizTalk.Component.MIME_SMIME_Decoder>
<Properties>
<AllowNonMIMEMessage vt=11>true</AllowNonMIMEMessage>
</Properties>
</Component>
</Components>
</Stage>
<Stage CategoryId="9d0e4105-4cce-4536-83fa-4a5040674ad6">
<Components>
<Component Name=Microsoft.BizTalk.Component.XmlDasmComp>
<Properties>
<EnvelopeSpecNames vt=8>MySchemas.EnvelopeSpecNames</EnvelopeSpecNames>
<AllowUnrecognizedMessage vt=11>false</AllowUnrecognizedMessage>
</Properties>
</Component>
</Components>
</Stage>
<Stage CategoryId="9d0e410d-4cce-4536-83fa-4a5040674ad6" ExecutionSequence="2">
<Components>
<Component Name=Microsoft.BizTalk.Component.XmlValidator >
<Properties>
<DocumentSpecName vt=8>MySchemas.DocspecName</DocumentSpecName>
</Properties>
</Component>
</Components>
</Stage>
</Stages>
</Root>