Konfigurationseigenschaften des MSMQ-Adapters
In der folgenden Tabelle sind die Konfigurationseigenschaften aufgelistet, die Sie für einen MSMQ-Adapterempfangsspeicherort festlegen können:
| Eigenschaftenname | type | BESCHREIBUNG | Beschränkungen | Kommentare |
|---|---|---|---|---|
| queue | VT_BSTR | Geben Sie einen gültigen Warteschlangenpfad zu dem Speicherort an, der vom Empfangsspeicherort überwacht wird. | Der URI für einen Sendeport oder Empfangsspeicherort darf nicht länger als 256 Zeichen sein. | Keine |
| batchSize | VT_BSTR | Geben Sie die Batchgröße an, die der MSMQ-Adapter beim Übermitteln eines Nachrichtenbatches an die MessageBox-Datenbank verwendet. | Gültige Werte liegen zwischen 1 und 4294967295. | Der Standardwert lautet 20. |
| transactional | VT_BSTR | Geben Sie an, ob Nachrichten aus der Quellwarteschlange im Kontext einer verteilten Microsoft-Transaktion (MSDTC) gelesen werden sollen. | Gültige Werte sind: - true - false Der Adapter unterstützt keine transaktionalen Lesevorgänge in Remotewarteschlangen. |
Der Standardwert ist „FALSE“. |
| serialProcessing | VT_BSTR | Geben Sie an, ob Nachrichten nacheinander verarbeitet werden sollen. | Gültige Werte sind: - true - false |
Der Standardwert ist „FALSE“. |
| onFailure | VT_BSTR | Geben Sie an, wie der Adapter auf einen Fehler reagieren soll. | Gültige Werte sind: - stopOnFailure – suspendNonResumable – suspendResumable |
Der Standardwert ist suspendResumable. |
| uri | VT_BSTR | Geben Sie den vollständigen Pfad der Warteschlange an, die vom Empfangsspeicherort überwacht wird. | Der URI für einen Sendeport oder Empfangsspeicherort darf nicht länger als 256 Zeichen sein. | Keine |
Im folgenden Code wird das Format der Zeichenfolge dargestellt, die zum Festlegen der Eigenschaften verwendet wird:
<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>
In der folgenden Tabelle sind die Konfigurationseigenschaften aufgelistet, die Sie für den Sendeport eines MSMQ-Adapters festlegen können:
| Eigenschaftenname | type | BESCHREIBUNG | Beschränkungen | Kommentare |
|---|---|---|---|---|
| Warteschlange | VT_BSTR | Geben Sie die Zielwarteschlange an. | Der URI für einen Sendeport oder Empfangsspeicherort darf nicht länger als 256 Zeichen sein. | Keine |
| maximumMessageSiz | VT_BSTR | Geben Sie die maximale Größe von Nachrichten in Kilobytes (KB) an, die an die angegebene Warteschlange gesendet werden. | Die gültigen Werte liegen zwischen 1 und 4294967295, wenn segmentationSupport und transactional auf true festgelegt sind. Andernfalls liegen die gültigen Werte zwischen 1 und 4095. | Der Standardwert ist 1024. |
| acknowledgeType | VT_BSTR | Geben Sie einen oder mehrere Bestätigungstypen an. | Gültige Werte sind die Member der .NET System.Messaging.AcknowledgeTypes-Enumeration . | Der Standardwert lautet „Keine“. |
| administrationQueue | VT_BSTR | Geben Sie die MSMQ-Verwaltungswarteschlange an. | Keine | Keine |
| timeOut | VT_BSTR | Geben Sie an, wie lange maximal auf den Eingang der Nachrichten in der Zielwarteschlange gewartet werden soll. | Diese Eigenschaft wird nur angewendet, wenn die Eigenschaft transactional auf wahr festgelegt ist. – Gültige Werte sind 1 bis 10675199, wenn ein timeOutUnits-Wert von Days angegeben wird. – Gültige Werte sind 1 bis 596523, wenn ein timeOutUnits-Wert von Hours angegeben wird. – Gültige Werte sind 1 bis 35791394, wenn der timeOutUnits-Wert Minuten angegeben wird. – Gültige Werte sind 1 bis 2147483647, wenn der timeOutUnits-Wert Sekunden angegeben wird. |
Keine |
| priority | VT_BSTR | Legen Sie die Nachrichtenpriorität fest. | Gültige Werte sind die Member der .NET System.Messaging.MessagePriority-Enumeration . | Keine |
| Wiederherstellbar | VT_BSTR | Geben Sie an, ob die Wiederherstellbarkeit einer Nachricht garantiert werden soll. | Gültige Werte sind: - true - false |
Der Standardwert ist „FALSE“. |
| encryptionAlgorithm | VT_BSTR | Geben Sie den zu verwendenden Verschlüsselungsalgorithmus an. | Gültige Werte sind die Member der .NET System.Messaging.EncryptionAlgorithm-Enumeration . | Der Standardwert lautet „Keine“. |
| useAuthentication | VT_BSTR | Legen Sie fest, ob eine Authentifizierung verwendet werden soll. | Mit dieser Eigenschaft können Sie in Kombination mit der Eigenschaft certificate die Nachricht überprüfen. Mit den Eigenschaften userName und password erhalten Sie Zugriff auf Warteschlangen. | Keine |
| Zertifikat | VT_BSTR | Geben Sie das Zertifikat an, das zum Überprüfen von Nachrichten verwendet werden soll. | Geben Sie den 40 Zeichen umfassenden Zertifikatfingerabdruck an. | Keine |
| segmentationSupport | VT_BSTR | Geben Sie an, ob die Segmentierung unterstützt wird. | Gültige Werte sind: - true - false |
Der Standardwert ist „FALSE“. |
| transactional | VT_BSTR | Geben Sie an, ob Nachrichten im Kontext einer verteilten Microsoft-Transaktion (MSDTC) gesendet werden sollen. | Gültige Werte sind: - true - false |
Der Standardwert ist „FALSE“. |
| useJournalQueue | VT_BSTR | Geben Sie an, ob beim Verarbeiten der Nachricht grundsätzlich eine Kopie der Nachricht gespeichert werden soll. | Gültige Werte sind: - true - false |
Der Standardwert ist „FALSE“. |
| useDeadLetterQueue | VT_BSTR | Geben Sie an, ob Nachrichten bei einem Fehler an die Warteschlange der unzustellbaren Nachrichten gesendet werden sollen. | Gültige Werte sind: - true - false |
Der Standardwert lautet „true“. |
| ackTypeEnumsValue | VT_BSTR | Geben Sie das bitweise ODER der Werte an, die den angegebenen acknowledgeType-Werten zugeordnet sind. | Keine | Der Standardwert ist 0. |
| timeOutUnits | VT_BSTR | Geben Sie die Einheit für den Wert an, der in der Eigenschaft timeOut angegeben wurde. | Gültige Werte sind: -Tage -Stunden -Minuten -Sekunden |
Der Standardwert ist Tage. |
| userName | VT_BSTR | Geben Sie den Benutzernamen für eine Remotewarteschlange an. | Der Standardwert ist leer. | |
| password | VT_BSTR | Geben Sie das Kennwort an, das zusammen mit dem in der Eigenschaft userName angegebenen Wert für den Zugriff auf eine Remotewarteschlange verwendet werden soll. | Dieser Wert ist beim Exportieren einer Bindungsdatei immer maskiert. In dieses Feld muss das Kennwort manuell eingegeben werden, bevor die Bindungsdatei in die Konfiguration des BizTalk-Zielservers importiert wird. | Der Standardwert ist leer. |
| bodyType | VT_BSTR | Geben Sie den Typ des Nachrichtentextes in MSMQ an. | Gültige Werte sind Member der .NET VarEnum-Enumeration . | Der Standardwert ist 8209. |
| uri | VT_BSTR | Geben Sie den vollständigen Pfad der Zielwarteschlange an. | Der URI für einen Sendeport oder Empfangsspeicherort darf nicht länger als 256 Zeichen sein. | Keine |
Im folgenden Code wird das Format der Zeichenfolge dargestellt, die zum Festlegen der Eigenschaften verwendet wird:
<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>
Hinweis
Wenn Sie TransportTypeData-Konfigurationsdaten für einen Adapter angeben, der mit dem Adapter Framework erstellt wird, müssen die verwendeten Name-Wert-Paare alle im <AdapterConfig-Element> gespeichert werden. Da das <AdapterConfig-Element> den Datentyp VT_BSTR (vt="8") angibt, müssen die <> Zeichen in den Daten mit Escapezeichen versehen werden.