MSMQ アダプター構成プロパティ
次の表に、MSMQ アダプターの受信場所に設定できる構成プロパティを示します。
| プロパティ名 | Type | 説明 | 制限 | 説明 |
|---|---|---|---|---|
| queue | VT_BSTR | 受信場所で監視する場所への有効なキューのパスを指定します。 | 送信ポートまたは受信場所の URI は 256 文字以内で指定してください。 | なし |
| batchSize | VT_BSTR | メッセージのバッチをメッセージ ボックス データベースに送信するときに、MSMQ アダプターが使用するバッチ サイズを指定します。 | 有効な値は 1 ~ 4294967295です。 | 既定値は 20 です。 |
| transactional | VT_BSTR | Microsoft 分散トランザクション コーディネーター (MSDTC) のコンテキストで、送信元のキューからメッセージを読み取るかどうかを指定します。 | 有効な値は次のとおりです。 - true - false アダプタは、リモート キューのトランザクションの読み込みをサポートしていません。 |
既定値は false です。 |
| serialProcessing | VT_BSTR | メッセージを順番に処理するかどうかを指定します。 | 有効な値は次のとおりです。 - true - false |
既定値は false です。 |
| onFailure | VT_BSTR | エラーに対するアダプターの対応方法を指定します。 | 有効な値は次のとおりです。 - stopOnFailure - suspendNonResumable - suspendResumable |
既定値は suspendResumable です。 |
| uri | VT_BSTR | 受信場所で監視するキューへの完全なパスを指定します。 | 送信ポートまたは受信場所の URI は 256 文字以内で指定してください。 | なし |
次のコードは、プロパティの設定に使用する文字列の形式を示しています。
<CustomProps><AdapterConfig vt="8"><Config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"><queue>FORMATNAME:DIRECT=OS:.\PRIVATE$\QUEUE</queue><batchSize>20</batchSize><transactional>false</transactional><serialProcessing>false</serialProcessing><onFailure>suspendResumable</onFailure><uri>FORMATNAME:DIRECT=OS:.\PRIVATE$\QUEUE</uri></Config></AdapterConfig></CustomProps>
次の表に、MSMQ アダプターの送信ポートに設定できる構成プロパティを示します。
| プロパティ名 | Type | 説明 | 制限 | 説明 |
|---|---|---|---|---|
| キュー | VT_BSTR | 送信先キューを指定します。 | 送信ポートまたは受信場所の URI は 256 文字以内で指定してください。 | なし |
| maximumMessageSiz | VT_BSTR | 指定したキューに送信するメッセージの最大サイズを KB 単位で指定します。 | segmentationSupport および transactional が true に設定されている場合の有効値は、1 ～ 4294967295 です。 その他の場合の有効値は、1 ～ 4095 です。 | 既定値は 1024 です。 |
| acknowledgeType | VT_BSTR | 1 つまたは複数の確認の種類を指定します。 | 有効な値は、.NET System.Messaging.AcknowledgeTypes 列挙のメンバーです 。 | 既定値は None です。 |
| administrationQueue | VT_BSTR | MSMQ 管理キューを指定します。 | なし | なし |
| timeOut | VT_BSTR | 送信先キューにメッセージが到達するまでの最大待機時間を指定します。 | このプロパティは、transactional プロパティが true に設定されている場合にのみ適用されます。 - timeOutUnits 値を Days に指定する場合、有効な値は 1 から10675199です。 - timeOutUnits 値を Hours に指定する場合、有効な値は 1 から596523です。 - timeOutUnits 値を Minutes に指定する場合、有効な値は 1 から35791394。 - timeOutUnits 値を Seconds に指定する場合、有効な値は 1 から2147483647。 |
なし |
| priority | VT_BSTR | メッセージの優先度を指定します。 | 有効な値は、.NET System.Messaging.MessagePriority 列挙体のメンバーです。 | なし |
| 回復可能 | VT_BSTR | メッセージの回復可能性を保証するかどうかを指定します。 | 有効な値は次のとおりです。 - true - false |
既定値は false です。 |
| encryptionAlgorithm | VT_BSTR | 使用する暗号化アルゴリズムを指定します。 | 有効な値は、.NET System.Messaging.EncryptionAlgorithm 列挙体のメンバーです。 | 既定値は None です。 |
| useAuthentication | VT_BSTR | 認証を使用するかどうかを指定します。 | メッセージを確認するには、certificate プロパティと組み合わせてこのプロパティを使用します。 キューにアクセスするには、userName プロパティおよび password プロパティを使用します。 | なし |
| 証明書 (certificate) | VT_BSTR | メッセージの確認に使用する証明書を指定します。 | 40 文字の証明書の拇印を入力します。 | なし |
| segmentationSupport | VT_BSTR | セグメント化をサポートするかどうかを指定します。 | 有効な値は次のとおりです。 - true - false |
既定値は false です。 |
| transactional | VT_BSTR | Microsoft 分散トランザクション コーディネーター (MSDTC) のコンテキストで、メッセージの送信をサポートするかどうかを指定します。 | 有効な値は次のとおりです。 - true - false |
既定値は false です。 |
| useJournalQueue | VT_BSTR | メッセージを処理する場合に常にメッセージのコピーを保存するかどうかを指定します。 | 有効な値は次のとおりです。 - true - false |
既定値は false です。 |
| useDeadLetterQueue | VT_BSTR | 障害が発生した場合に配信不能キューにメッセージを送信するかどうかを指定します。 | 有効な値は次のとおりです。 - true - false |
既定値は、true です。 |
| ackTypeEnumsValue | VT_BSTR | 指定した acknowledgeType 値に関連付けられている値のビット単位の OR 演算を指定します。 | なし | 既定値は 0 です。 |
| timeOutUnits | VT_BSTR | timeOut プロパティに指定された値と組み合わせて使用する単位を指定します。 | 有効な値は次のとおりです。 -日 -時間 -分 -秒 |
既定値は [日] です。 |
| userName | VT_BSTR | リモート キューのユーザー名を指定します。 | 既定値は空です。 | |
| password | VT_BSTR | リモート キューにアクセスするために userName プロパティに指定した値と組み合わせて使用するパスワードを指定します。 | バインド ファイルをエクスポートする場合、この値は常にマスクされます。 ターゲットの BizTalk Server 構成にバインド ファイルをインポートする前に、このフィールドにパスワードを手動で設定する必要があります。 | 既定値は空です。 |
| bodyType | VT_BSTR | MSMQ のメッセージ本文の種類を指定します。 | 有効な値は、.NET VarEnum 列挙体のメンバーです。 | 既定値は 8209 です。 |
| uri | VT_BSTR | 送信先キューの完全なパスを指定します。 | 送信ポートまたは受信場所の URI は 256 文字以内で指定してください。 | なし |
次のコードは、プロパティの設定に使用する文字列の形式を示しています。
<CustomProps><AdapterConfig vt="8"><Config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"><queue>FORMATNAME:DIRECT=OS:TESTSERVER\PRIVATE$\DESTQUEUE</queue><maximumMessageSize>1024</maximumMessageSize><acknowledgeType>None</acknowledgeType><administrationQueue>Direct=OS:TestServer\Private$\AdminQueue</administrationQueue><timeOut>4</timeOut><priority>Normal</priority><recoverable>false</recoverable><encryptionAlgorithm>None</encryptionAlgorithm><useAuthentication>false</useAuthentication><segmentationSupport>false</segmentationSupport><transactional>false</transactional><useJournalQueue>false</useJournalQueue><useDeadLetterQueue>true</useDeadLetterQueue><ackTypeEnumsValue>0</ackTypeEnumsValue><timeOutUnits>Days</timeOutUnits><userName>TestUser</userName><password>******</password><bodyType>8209</bodyType><uri>FORMATNAME:DIRECT=OS:TESTSERVER\PRIVATE$\DESTQUEUE</uri></Config></AdapterConfig>
Note
Adapter Framework を使用して構築されたアダプターの TransportTypeData 構成データを指定する場合、使用される名前と値のペアはすべて AdapterConfig> 要素に<格納する必要があります。 AdapterConfig> 要素は<VT_BSTR (vt="8") データ型を指定するため、<>データ内の文字をエスケープする必要があります。