Proprietà di configurazione di adapter MSMQ

Nella tabella seguente vengono illustrate le proprietà di configurazione che è possibile impostare per l'indirizzo di ricezione di un adapter MSMQ.

Nome proprietà	Type	Descrizione	Restrizioni	Commenti
coda	VT_BSTR	Specificare un percorso coda valido dell'elemento monitorato dall'indirizzo di ricezione.	L'URI per una porta di trasmissione o un indirizzo di ricezione non può essere superiore a 256 caratteri.	Nessuno
batchSize	VT_BSTR	Specificare le dimensioni batch utilizzate dall'adapter MSMQ per l'invio di un batch di messaggi al database MessageBox.	I valori validi sono compresi tra 1 e 4294967295.	Il valore predefinito è 20.
transactional	VT_BSTR	Specificare se i messaggi devono essere letti dalla coda di origine nel contesto di un servizio Microsoft Distributed Transaction Coordinator (MSDTC).	I valori validi sono: - true - false L'adapter non supporta letture transazionali nelle code remote.	Il valore predefinito è false.
serialProcessing	VT_BSTR	Specificare se i messaggi devono essere elaborati in ordine.	I valori validi sono: - true - false	Il valore predefinito è false.
onFailure	VT_BSTR	Specificare la modalità di risposta dell'adapter agli errori.	I valori validi sono: - StopOnFailure - suspendNonResumable - suspendResumable	Il valore predefinito è suspendResumable.
Uri	VT_BSTR	Specificare il percorso completo della coda monitorata dall'indirizzo di ricezione.	L'URI per una porta di trasmissione o un indirizzo di ricezione non può essere superiore a 256 caratteri.	Nessuno

Nel codice seguente viene illustrato il formato della stringa utilizzata per impostare le proprietà:

<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>  

Nella tabella seguente vengono illustrate le proprietà di configurazione che è possibile impostare per la porta di trasmissione di un adapter MSMQ:

Nome proprietà	Type	Descrizione	Restrizioni	Commenti
Coda	VT_BSTR	Specificare la coda di destinazione.	L'URI per una porta di trasmissione o un indirizzo di ricezione non può essere superiore a 256 caratteri.	Nessuno
maximumMessageSiz	VT_BSTR	Specificare la dimensione massima in kilobyte (KB) dei messaggi inviati alla coda specificata.	I valori validi sono compresi tra 1 e 4294967295 se i valori segmentationSupport e transactional sono impostati su true. In caso contrario, i valori validi sono compresi tra 1 e 4095.	Il valore predefinito è 1024.
acknowledgeType	VT_BSTR	Specificare uno o più tipi di riconoscimento.	I valori validi sono i membri dell'enumerazione .NET System.Messaging.AcknowledgeTypes .	Il valore predefinito è None (Nessuna).
administrationQueue	VT_BSTR	Specificare la coda di amministrazione MSMQ.	Nessuno	Nessuno
timeOut	VT_BSTR	Specificare il tempo da attendere prima che i messaggi raggiungano la coda di destinazione.	Questa proprietà viene applicata solo quando la proprietà transazionale è impostata su true. - I valori validi sono da 1 a 10675199 quando si specifica un valore timeOutUnits di Days. - I valori validi sono da 1 a 596523 quando si specifica un valore timeOutUnits di Ore. - I valori validi sono da 1 a 35791394 quando si specifica un valore timeOutUnits di Minuti. - I valori validi sono da 1 a 2147483647 quando si specifica un valore timeOutUnits di Secondi.	Nessuno
priority	VT_BSTR	Specificare la priorità del messaggio.	I valori validi sono i membri dell'enumerazione .NET System.Messaging.MessagePriority .	Nessuno
ripristinabili	VT_BSTR	Specificare se deve essere garantita o meno la possibilità di recuperare un messaggio.	I valori validi sono: - true - false	Il valore predefinito è false.
encryptionAlgorithm	VT_BSTR	Specificare l'algoritmo di crittografia da utilizzare.	I valori validi sono i membri dell'enumerazione .NET System.Messaging.EncryptionAlgorithm .	Il valore predefinito è None (Nessuna).
useAuthentication	VT_BSTR	Specificare se utilizzare l'autenticazione.	Utilizzare questa proprietà insieme alla proprietà relativa al certificato per verificare il messaggio. Utilizzare le proprietà userName e password per ottenere l'accesso alle code.	Nessuno
certificato	VT_BSTR	Specificare il certificato utilizzato per verificare i messaggi.	Immettere l'identificazione personale (lunghezza massima 40 caratteri).	Nessuno
segmentationSupport	VT_BSTR	Specificare se la segmentazione è supportata.	I valori validi sono: - true - false	Il valore predefinito è false.
transactional	VT_BSTR	Specificare se fornire il supporto per i messaggi in uscita nel contesto di un servizio Microsoft Distributed Transaction Coordinator (MSDTC).	I valori validi sono: - true - false	Il valore predefinito è false.
useJournalQueue	VT_BSTR	Specificare se salvare una copia del messaggio ogni volta che il messaggio viene elaborato.	I valori validi sono: - true - false	Il valore predefinito è false.
useDeadLetterQueue	VT_BSTR	Specificare se inviare i messaggi alla coda dei messaggi non recapitabili in caso di errore.	I valori validi sono: - true - false	Il valore predefinito è true.
ackTypeEnumsValue	VT_BSTR	Specificare l'operatore OR bit per bit dei valori associati ai valori acknowledgeType specificati.	Nessuno	Il valore predefinito è 0.
timeOutUnits	VT_BSTR	Specificare l'unità da utilizzare in combinazione con il valore specificato per la proprietà timeOut.	I valori validi sono: -Giorni -Ore -Minuti -Secondi	Il valore predefinito è Giorni.
userName	VT_BSTR	Specificare il nome utente per una coda remota.	Il valore predefinito è vuoto.
password	VT_BSTR	Specificare la password da utilizzare insieme al valore specificato per la proprietà userName per l'accesso a una coda remota.	Quando si esporta un file di associazione, questo valore è sempre mascherato. Questo campo deve essere compilato manualmente con la password prima di importare il file di associazione nella configurazione di BizTalk Server di destinazione.	Il valore predefinito è vuoto.
bodyType	VT_BSTR	Specificare il tipo del corpo messaggio in MSMQ.	I valori validi sono membri dell'enumerazione VarEnum .NET.	Il valore predefinito è 8209.
Uri	VT_BSTR	Specificare il percorso completo della coda di destinazione.	L'URI per una porta di trasmissione o un indirizzo di ricezione non può essere superiore a 256 caratteri.	Nessuno

Nel codice seguente viene illustrato il formato della stringa utilizzata per impostare le proprietà:

<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>  

Nota

Quando si specificano i dati di configurazione TransportTypeData per una scheda compilata tramite Adapter Framework, le coppie nome/valore utilizzate devono essere tutte archiviate nell'elemento <AdapterConfig> . Poiché l'elemento <AdapterConfig> specifica il tipo di dati VT_BSTR (vt="8"), i <> caratteri nei dati devono essere preceduti da un carattere di escape.