次の方法で共有

メッセージ コンテキスト プロパティを使用する方法

システム プロパティは、ほとんどの場合、BizTalk メッセージング エンジンとそのコンポーネントによって内部的に使用されます。 一般に、これらのプロパティに対してエンジンによって設定された値を変更することは、エンジンの実行ロジックに影響を与える可能性があるため、推奨されません。 ただし、変更できるプロパティは多数あります。

次の表に、メッセージング エンジンが昇格できるメッセージ コンテキスト プロパティの一覧を示します。 これらのプロパティは、Microsoft BizTalk Server の送信ポートとオーケストレーションでフィルター式を作成するために使用できます。 たとえば、

PortName = MyMessage(BTS.ReceivePortName);  
MyFileName = MyMessage(FILE.ReceivedFileName);  
MySubject= MyMessage(POP3.Subject);

別の表に、昇格できない一部の BizTalk アプリケーションで使用できる可能性がある追加のプロパティを示します。

プロパティ 昇格のタイミングと場所 タイプ 説明
BTS。AckFailureCategory メッセージ ボックス データベースに受信確認メッセージを発行する前に、メッセージング エンジンによって昇格されます。 xs:int 中断の場所と理由を示す ErrorCategory を識別します。
BTS.AckFailureCode メッセージ ボックス データベースに受信確認メッセージを発行する前に、メッセージング エンジンによって昇格されます。 xs:string 中断の場所と理由を示す ErrorCode を識別します。
BTS.AckID メッセージ ボックス データベースに受信確認メッセージを発行する前に、メッセージング エンジンによって昇格されます。 xs:string 元の メッセージの MessageID を識別します。
BTS.AckInboundTransportLocation メッセージ ボックス データベースに受信確認メッセージを発行する前に、メッセージング エンジンによって昇格されます。 xs:string 元のメッセージから InboundTransportLocation を識別します。
BTS.AckOutboundTransportLocation メッセージ ボックス データベースに受信確認メッセージを発行する前に、メッセージング エンジンによって昇格されます。 xs:string 元のメッセージから OutboundTransportLocation を識別します。
BTS.AckOwnerID メッセージ ボックス データベースに受信確認メッセージを発行する前に、メッセージング エンジンによって昇格されます。 xs:string 元のメッセージからインスタンス ID を識別します。
BTS.AckReceivePortID メッセージ ボックス データベースに受信確認メッセージを発行する前に、メッセージング エンジンによって昇格されます。 xs:string 元のメッセージから ReceivePortID を識別します。
BTS.AckReceivePortName 受信確認メッセージのメッセージング エンジンによって昇格されます。 xs:string 元のメッセージから ReceivePortName を識別します。
BTS.AckSendPortID メッセージ ボックス データベースに受信確認メッセージを発行する前に、メッセージング エンジンによって昇格されます。 xs:string 元のメッセージから SendPortID を識別します。
BTS.AckSendPortName メッセージ ボックス データベースに受信確認メッセージを発行する前に、メッセージング エンジンによって昇格されます。 xs:string 元のメッセージから SendPortName を識別します。
BTS.AckType メッセージ ボックス データベースに受信確認メッセージを発行する前に、メッセージング エンジンによって昇格されます。 xs:string オーケストレーションによる受信確認と非受信確認の監視を許可します。 値は、受信確認の場合は ACK、否定受信確認の場合は NACK になります。
BTS.ActionOnFailure このプロパティは、IBTTTransportBatch::SubmitMessage() API を呼び出して BizTalk にメッセージを送信する前に、アダプターによって設定できます。 xs:int 受信パイプラインでエラーが発生した場合のメッセージング エンジンの動作を制御します。 通常、メッセージング エンジンは失敗したメッセージを中断します。ただし、特定のアダプター (HTTP など) は、受信パイプラインの障害時にメッセージを中断するのではなく、クライアントにエラーを報告します。

有効な値:

-デフォルト。 プロパティが存在しない場合、メッセージング エンジンは自動的にメッセージの中断を試みます。
- 0. メッセージング エンジンが自動的にエンジンを中断しないことを示します。

その他の値は、将来使用するために予約されています。
BTS.CorrelationToken このプロパティがメッセージ コンテキストに設定されている場合は、メッセージング エンジンによって昇格されます。 このプロパティは、要求応答アダプターまたはオーケストレーションがメッセージ ボックス データベースに要求メッセージを送信するときに、コンテキストに暗黙的に設定されます。 xs:string 要求応答ポートへの応答のルーティングを有効にします。
BTS。EpmRRCorrelationToken 要求/応答メッセージの実行時にメッセージング エンジンによって昇格されます。 このプロパティは、メッセージが MessageBox データベースに送信される前に昇格されます。 xs:int メッセージング エンジンによって内部的に使用されます。 メッセージの要求応答ストリームのサーバー名、プロセス ID、および一意の GUID を指定します。
BTS.InboundTransportLocation 受信アダプターからメッセージを受信した後、メッセージ ボックス データベースに発行する前に、メッセージング エンジンによって昇格されます。 xs:string ハンドラーがメッセージを受信した場所 (URI) を指定します。
BTS.InboundTransportType 受信アダプターからメッセージを受信した後、メッセージ ボックス データベースに発行する前に、メッセージング エンジンによって昇格されます。 xs:string このメッセージを受信してサーバーに送信したアダプターの種類 (FILE、HTTP など) を指定します。
BTS。InterchangeSequenceNumber 受信アダプターからメッセージを受信した後、メッセージをメッセージボックスデータベースに公開する前に、メッセージングエンジンによって昇格されます。 xs:int インターチェンジ内のドキュメントのシーケンス番号を示します。 ドキュメントが個々のドキュメントに逆アセンブルされたインターチェンジの一部でない場合、この値は 1 になります。 プロパティは、オーケストレーション、送信パイプライン、および送信アダプターで読み取ることができます。
BTS.IsDynamicSend このプロパティは、メッセージ コンテキストで設定できます。 昇格されず、送信操作にのみ適用されます。 xs:boolean 送信操作が動的送信ポート上にある場合は、値が true のメッセージ コンテキストにメッセージング エンジンによって書き込まれます。 送信パイプラインで静的送信ポートのプロパティを動的に設定する場合は、この値を true に設定する必要があります。
BTS。MessageDestination このプロパティは、GetNext() からメッセージを返すときに、逆アセンブラー パイプライン コンポーネントによって受信パイプラインで設定できます。 xs:string 逆アセンブラーで回復可能なインターチェンジ処理をサポートするために主に使用されるこのプロパティは、メッセージがメッセージ ボックスに発行されるか、中断キューに中断されるかを制御します。 インターチェンジで不適切なメッセージが検出され、メッセージを中断して処理を続行する必要がある場合は、MessageDestination = SuspendQueue を設定して、エンジンが逆アセンブラーで GetNext() を呼び出したときにメッセージを返します。

有効な値:

-デフォルト。 プロパティが存在しない場合、メッセージは適切であると見なされ、メッセージ ボックスに発行されます。
- SuspendQueue. メッセージを中断するようにメッセージング エンジンに指示します。 手記： 中断されたメッセージは、アダプターによって送信されたメッセージ (つまり、ワイヤ メッセージ) ではなく、パイプライン/マッピング後のメッセージになります。
BTS。MessageType メッセージの解析中に逆アセンブラー パイプライン コンポーネントによって進行されます。 xs:string メッセージの種類を指定します。 メッセージ型は、ドキュメント スキーマ名前空間とドキュメント ルート ノード (http://<MyNamespace>#<MyRoot> の連結として定義されます。
BTS。OutboundTransportLocation このプロパティがメッセージ コンテキストに設定されている場合は、メッセージング エンジンによって昇格されます。 このプロパティは、オーケストレーションがメッセージを送信ポートに送信するときに、メッセージ コンテキストで暗黙的に設定されます。 このプロパティは、オーケストレーションまたはパイプラインで明示的に設定することもできます。 xs:string メッセージが送信される宛先の場所 URI を指定します。 URI には、 http:// などのアダプター プレフィックスが含まれている場合があります。 アダプター プレフィックスは、メッセージの送信時に使用するアダプターの種類を決定するためにメッセージング エンジンによって使用されます。 アダプター プレフィックスとBTS.OutboundTransportTypeプロパティの両方が設定されている場合、BTS.OutboundTransportTypeからのアダプターの種類は、プレフィックスから決定されたアダプターの種類よりも常に優先されます。

有効な値:

BizTalk メッセージ キュー: DIRECT=、 PRIVATE=、 PUBLIC=

ファイル: file://

FTP: FTP://

HTTP: http:// と https://

SMTP: mailto:

SOAP: SOAP://

SQL: SQL://
BTS.OutboundTransportType このプロパティがメッセージ コンテキストに設定されている場合は、メッセージング エンジンによって昇格されます。 このプロパティは、オーケストレーションがメッセージを送信ポートに送信するときに、コンテキストに暗黙的に設定されます。 このプロパティは、オーケストレーションまたはパイプラインで明示的に設定することもできます。 xs:string メッセージの送信に使用するアダプターの種類を指定します。 使用可能なアダプターの種類は、 FILE、 FTP、 HTTP、 SMTP、 SOAP、 SQL です。

このプロパティに設定する値や、アドレスで指定するアダプタープレフィックスは、大文字と小文字を区別しません。
BTS。PropertiesToUpdate アダプターは、再送信または中断されている失敗したメッセージのプロパティ値の一部を保持する必要がある場合に、このプロパティを設定します。

つまり、メッセージが再送信または再開されると、指定されたプロパティがコンテキストに設定されます。		 xs:string プロパティ名、名前空間、および値を表す要素を含む XML 文字列が含まれています。
BTS。ReceivePortID 受信アダプターからメッセージを受信した後、メッセージ ボックス データベースに発行する前に、メッセージング エンジンによって昇格されます。 xs:int メッセージが受信された受信ポートを識別します。
BTS.ReceivePortName 受信アダプターからメッセージを受信した後、メッセージ ボックス データベースに発行する前に、メッセージング エンジンによって昇格されます。 xs:string メッセージを受信した受信ポートのわかりやすい名前。
BTS.RouteDirectToTP メッセージのループ バックまたは要求/応答の実行のためにメッセージング エンジンによって昇格されます。 このプロパティは、メッセージが MessageBox データベースに送信される前に昇格されます。 xs:boolean メッセージング エンジンによって内部的に使用され、ループ バックシナリオと要求応答シナリオを有効にします。
BTS.SPGroupID メッセージがオーケストレーションから送信ポートに送信されるときに、メッセージング エンジンによって昇格されます。 xs:string 送信ポート グループの ID を指定します。
BTS.SPID メッセージがオーケストレーションから送信ポートに送信されるときに、メッセージング エンジンによって昇格されます。 xs:string 送信ポートの ID を指定します。
BTS.SPName Solicit-Response 送信ポートから応答メッセージを発行するとき、メッセージング エンジンによってプロモートされます。 xs:string Solicit-Response 送信ポートからの応答メッセージをサブスクライブするために使用されます。 値は送信ポートの名前です。
BTS.SPTransportBackupID メッセージがオーケストレーションから送信ポートに送信されるときに、メッセージング エンジンによって昇格されます。 xs:string 送信ポートのバックアップ アダプターの ID を指定します。
BTS.SPTransportID メッセージがオーケストレーションから送信ポートに送信されるときに、メッセージング エンジンによって昇格されます。 xs:string 送信ポートのプライマリ アダプターの ID を指定します。
BTS.SuspendAsNonResumable このプロパティは、送信ポートにメッセージを送信する前に、SubmitMessage() を呼び出す前またはオーケストレーションでアダプターによって設定できます。 手記： SubmitRequestMessage() はこのプロパティを無視します。双方向メッセージは、常に再開不可として中断されます。 xs:boolean メッセージ の失敗時に、メッセージ エンジンがメッセージを再開不可として中断するかどうかを制御します。 通常、メッセージは再開可能として中断されますが、不適切な場合があります。たとえば、順序付けされた送受信ポートのメッセージを再開すると、メッセージの順序が中断されます。

有効な値:

-偽。 メッセージは再開可能として中断されます (これが既定です)。
-真。 メッセージは再開不可として中断されます。
BTS。SuspendMessageOnRoutingFailure 受信アダプターからメッセージを受信した後、メッセージ ボックス データベースに発行する前に、メッセージング エンジンによって昇格されます。 xs:boolean 受信メッセージでルーティングエラーが発生したときの動作を指定します。

有効な値:

- 既定値/ False。 プロパティが存在しないか False に設定されている場合、エンジンはルーティングエラーが発生したときにエラーをアダプターに通知します。
-真。 ルーティング エンジンは、ルーティングエラーが発生したときにメッセージを自動的に中断します。 手記： 中断されたメッセージは、アダプターによって送信されたメッセージ (つまり、ワイヤ メッセージ) ではなく、パイプライン/マッピング後のメッセージになります。

この名前空間には、一部の BizTalk アプリケーションに役立つ可能性のある情報を含むプロパティが他にも多数あります。

プロパティ 昇格のタイミングと場所 タイプ 説明
BTS。AckDescription メッセージ ボックス データベースに受信確認メッセージを発行する前に、メッセージング エンジンによって設定されます。 xs:string 中断の場所と理由を示す ErrorDescription を識別します。
BTS.EncryptionCert 昇格できません。 xs:int 暗号化証明書に対応する拇印を識別します。 署名された暗号化されたメッセージを受信している要求/応答ポートで応答暗号化を実行するには、パイプライン内の MIME/SMIME Encoder パイプライン コンポーネントの前に配置されたオーケストレーションまたはカスタム パイプライン コンポーネントでこのプロパティを設定します。
BTS.インターチェンジID サーバーに到着するメッセージごとにメッセージング エンジンによって設定されます。 xs:string 同じインターチェンジ メッセージから生成されたドキュメントをグループ化するために使用される一意の ID を定義します。
BTS。ループバック ループ バック実行の要求メッセージを送信するときにアダプターによって設定されます。 xs:boolean ループ バック実行のためにメッセージをサーバーに送信するかどうかを定義します。 ループ バック実行では、要求メッセージは MessageBox データベースに発行され、そこで応答として受信アダプターに直接ルーティングされます。
BTS。SignatureCertificate サーバーにメッセージを送信するときに、一部のアダプターによって設定されます。 このプロパティは、Party Resolution パイプライン コンポーネントによって使用されます。 xs:string BizTalk Server で受信したメッセージの署名に使用された署名証明書の拇印を識別します。
BTS。SourcePartyID 受信メッセージのパーティが識別された後、Party Resolution パイプライン コンポーネントによって設定されます。 xs:string BizTalk パーティーの ID。
BTS.SSOTicket 受信アダプターがこのプロパティをサポートしている場合は、サーバーにメッセージを発行するときに設定されます。 xs:string チケットには、現在のユーザーの暗号化されたドメインとユーザー名、およびチケットの有効期限が含まれます。 このチケットは、SSO 対応アダプターが、宛先エンドポイントで認証するときにユーザーの資格情報を取得するために使用されます。
BTS。WindowsUser サーバーにメッセージを送信するときに、一部のアダプターによって設定されます。 このプロパティは、Party Resolution パイプライン コンポーネントによって使用されます。 xs:string メッセージがサーバーに送信されるユーザーのアカウントを指定します。

パイプライン コンポーネントとアダプターに関連付けられているプロパティとプロパティ スキーマの詳細については、次を参照してください。

こちらもご覧ください

BizTalk メッセージ コンテキストプロパティについて
式を使用して動的ポートに値を割り当てる方法