Proprietà di configurazione dell'adapter MQSeries
Nella tabella seguente vengono illustrate le proprietà di configurazione che è possibile impostare per l'indirizzo di ricezione dell'adapter MQSeries:
| Nome proprietà | Type | Descrizione | Restrizioni | Commenti |
|---|---|---|---|---|
| Uri | VT_BSTR | Specificare il percorso completo 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 |
| queueDetails | VT_BSTR | Specificare le informazioni relative alla coda MQSeries di origine, incluso il server, il gestore code e la coda. | -Nessuno | Questa proprietà è preceduta da MQS:// per creare la proprietà uri. |
| transactionSupported | VT_BSTR | Specificare se l'adapter MQSeries avvia una transazione DTC (Distributed Transaction Coordinator) Microsoft tra BizTalk Server e il server MQSeries. | I valori validi sono: -Sì -No |
Se impostato su no, non vi è garanzia del recapito dei messaggi. Il valore predefinito è sì. |
| suspendAsNonResumable | VT_BSTR | Specificare se i messaggi sospesi devono essere contrassegnati come ripristinabili o meno. | I valori validi sono: -Sì -No |
Il valore predefinito è no. |
| dataOffsetForHeaders | VT_BSTR | I valori delle intestazioni MQSeries (le strutture MQXQH, MQIIH e MQCIH) vengono utilizzati dall'adapter per inserire i valori corrispondenti nelle proprietà di contesto di BizTalk Server. Per impostazione predefinita queste proprietà MQSeries vengono rimosse dal corpo del messaggio. | I valori validi sono: -Sì -No |
Impostare questa proprietà su no per mantenere le proprietà nel corpo del messaggio. Il valore predefinito è sì. |
| pollingInterval | VT_BSTR | Specificare l'intervallo utilizzato dal componente di ricezione per eseguire il polling della coda MQSeries. | I valori validi sono compresi tra 1 e 10000. | pollingInterval viene utilizzato insieme all'intervallo di attesa hardcoded di tre secondi specificato nell'adapter. Se il valore di pollingInterval è minore di tre (3) secondi, l'intervallo di attesa viene impostato sul valore di pollingInterval. Il valore predefinito è 3. |
| pollingUnit | VT_BSTR | Specificare l'unità di tempo per l'intervallo di polling. | I valori validi sono: -Ore -Minuti -Secondi |
Il valore predefinito è secondi. |
| maximumBatchSize | VT_BSTR | Specificare le dimensioni massime di un batch di messaggi in kilobyte (KB). | I valori validi sono compresi tra 1 e 10485760 | Il valore predefinito è 100. |
| maximumNumberOfMessages | VT_BSTR | Specificare il numero massimo di messaggi in un batch. | I valori validi sono compresi tra 1 e 100000 | Il valore predefinito è 100. |
| threadCount | VT_BSTR | Specificare il numero di thread utilizzati per ogni indirizzo di ricezione. | I valori validi sono compresi tra 1 e 64. | Il valore predefinito è 2. |
| fragmentationSize | VT_BSTR | Specificare la dimensione blocco messaggi in kilobyte (KB) per i messaggi trasmessi tra MQSAgent e l'adapter. | I valori validi sono compresi tra 1 e 1048576. | Il valore predefinito è 500. |
| characterSet | VT_BSTR | Specificare il set di caratteri e se deve essere eseguita la conversione dei caratteri prima della trasmissione del messaggio all'indirizzo di ricezione. | I valori validi sono: -Nessuno. La conversione non viene eseguita. - UCS-2 e UTF-16. Viene eseguita la conversione a questi set di caratteri. In MQSeries non viene fatta distinzione tra essi. - UTF-8. Viene eseguita la conversione al set di caratteri UTF-8. |
Il valore predefinito è none. |
| errorThreshold | VT_BSTR | Specificare il numero massimo di errori da registrare. L'adapter continuerà a funzionare e, se verrà ripristinato, registrerà l'evento nel registro eventi. | I valori validi sono compresi tra 1 e 1000. | Il valore predefinito è 10. |
| segmentazione | VT_BSTR | Specificare se assemblare i messaggi segmentati o riceverli così come sono. | I valori validi sono: -Nessuno -Completo |
Specificare none per leggere i messaggi della coda MQSeries senza attivare la segmentazione. Specificare complete se si desidera che i messaggi segmentati vengano assemblati da MQSeries prima di venire passati all'adapter. Il valore predefinito è none. |
| ordered | VT_BSTR | Specificare se mantenere l'ordine dei messaggi man mano che vengono ricevuti dalla coda MQSeries. | I valori validi sono: -No - noStop - sìStop - SìSuspend |
Specificare no per ignorare l'ordine dei messaggi. Specificare noStop per ignorare l'ordine dei messaggi e disattivare l'indirizzo di ricezione in caso di errore. Specificare yesStop per attivare l'ordinamento. La transazione viene terminata e l'indirizzo di ricezione viene disabilitato in caso di errore. Specificare yesSuspend per attivare l'ordinamento. Il messaggio viene spostato nella coda sospesa in caso di errore. L'ordine non viene mantenuto in caso di errore, ma l'indirizzo di ricezione può continuare a ricevere messaggi. Il valore predefinito è no. |
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"><uri>MQS://TESTMQServer/DQM1/RQ0</uri><queueDetails>TESTMQServer/DQM1/RQ0</queueDetails><transactionSupported>yes</transactionSupported><suspendAsNonResumable>no</suspendAsNonResumable><dataOffsetForHeaders>yes</dataOffsetForHeaders><pollingInterval>1</pollingInterval><pollingUnit>seconds</pollingUnit><maximumBatchSize>100</maximumBatchSize><maximumNumberOfMessages>100</maximumNumberOfMessages><threadCount>2</threadCount><fragmentationSize>500</fragmentationSize><characterSet>none</characterSet><errorThreshold>10</errorThreshold><segmentation>none</segmentation><ordered>no</ordered></Config></AdapterConfig></CustomProps>
Nella tabella seguente vengono illustrate le proprietà di configurazione che è possibile impostare per la porta di trasmissione dell'adapter MQSeries:
| Nome proprietà | Type | Descrizione | Restrizioni | Commenti |
|---|---|---|---|---|
| Uri | VT_BSTR | Specificare il percorso completo dell'indirizzo a cui trasmettere i dati. | L'URI per una porta di trasmissione o un indirizzo di ricezione non può essere superiore a 256 caratteri. | Nessuno |
| queueDetails | VT_BSTR | Specificare le informazioni relative alla coda MQSeries di destinazione, incluso il server, il gestore code e la coda. | L'URI per una porta di trasmissione o un indirizzo di ricezione non può essere superiore a 256 caratteri. | Questa proprietà è preceduta da MQS:// per creare la proprietà uri. |
| transactionSupported | VT_BSTR | Specificare se l'adapter MQSeries avvia una transazione DTC (Distributed Transaction Coordinator) Microsoft tra BizTalk Server e il server MQSeries. | I valori validi sono: -Sì -No |
Se impostato su no, non vi è garanzia del recapito dei messaggi. Il valore predefinito è sì. |
| dataConversion | VT_BSTR | Specificare se convertire il messaggio nella tabella codici ANSI di MQSeries per Windows Server. | I valori validi sono: -Sì -No |
Il valore predefinito è no. |
| segmentationAllowed | VT_BSTR | Specificare se utilizzare la segmentazione del gestore code MQSeries nel caso in cui un messaggio superi la lunghezza massima consentita per la coda MQSeries. | Valori validi: -Sì -No |
Il valore predefinito è no. |
| fragmentationSize | VT_BSTR | Specificare la dimensione blocco messaggi in kilobyte (KB) per i messaggi trasmessi tra l'adapter e MQSAgent. | I valori validi sono compresi tra 1 e 1048576. | Il valore predefinito è 500. |
| ordered | VT_BSTR | Specificare se mantenere l'ordine dei messaggi man mano che vengono trasmessi alla coda MQSeries. | I valori validi sono: -Sì -No |
Il valore predefinito è no. |
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"><uri>MQS://TESTMQServer/DQM1(QM1)/SQ0</uri><queueDetails>TESTMQServer/DQM1(QM1)/SQ0</queueDetails><transactionSupported>yes</transactionSupported><dataConversion>no</dataConversion><segmentationAllowed>no</segmentationAllowed><fragmentationSize>500</fragmentationSize><ordered>no</ordered></Config></AdapterConfig></CustomProps>
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.