Utilizzare l'attività MQ - Acquisisci messaggio per richiamare i messaggi da una coda MQ durante il runtime.
Una volta completate le attività Configura, Associazione di input e Associazione di output dell'attività.
Campo | Descrizione |
---|---|
Nome coda * | Specifica il nome della coda MQ da cui il dispositivo di integrazione tenta di richiamare il messaggio. |
Timeout | L'intervallo di tempo (in secondi) tra la richiesta di richiamo di un messaggio dalla coda da parte dell'attività MQ - Acquisisci messaggio
e la restituzione del messaggio, prima che si verifichi un
timeout.
Se questo periodo di timeout scade e la
coda non restituisce alcun messaggio, il dispositivo di integrazione attende
che venga eseguito il numero di tentativi specificato prima di tentare di richiamare un messaggio. Per una spiegazione dettagliata dei timeout e delle opzioni dei tentativi, consultare Opzioni Timeout e Riprova. Per specificare il numero di secondi durante i quali il dispositivo di integrazione deve attendere prima che venga visualizzato un timeout, selezionare l'opzione Dopo e immettere i secondi nel campo Secondi. Per impostazione predefinita, è selezionata l'opzione Mai; questa opzione specifica che il dispositivo di integrazione attende per un tempo indefinito per richiamare un messaggio dalla coda - non è impostato alcun periodo di timeout. |
Tipo di dati payload | Specifica il tipo di dati del payload del messaggio, binario o stringa. |
Frammento schema per intestazione MQRFH2 | Specifica se un'intestazione MQRFH2 è inclusa nel messaggio.
Se il messaggio include un'intestazione MQRFH2, selezionare questa casella di spunta e
fare clic su [...]. Nella finestra di dialogo Cerca elemento tipo di schema
individuare lo schema XML che definisce l'intestazione, selezionare l'elemento NameValueData
in tale schema XML e fare clic su OK. Il
frammento schema è l'elemento NameValueData e tutti i relativi elementi child. Nota: per poterlo selezionare, lo
schema XML che definisce l'intestazione deve essere prima creato e caricato nel progetto. Per ulteriori informazioni, consultare Definizione e caricamento di uno schema XML per un'intestazione MQRFH2.
|
Campo | Descrizione |
---|---|
Consegna messaggi | Le opzioni qui disponibili dipendono dalla selezione o meno della casella di
spunta ID univoci. Se selezionata, tutte e tre le opzioni
sono disponibili. In caso contrario, viene visualizzata solo l'opzione Almeno una volta.
|
Dove i messaggi hanno ID univoci | Specifica se i messaggi sulla coda dispongono di ID univoci. |
Configurare le opzioni dei tentativi per richiamare un messaggio dalla coda MQ, come descritto nella seguente tabella:
Opzioni dei tentativi | Descrizione |
---|---|
1) Attendere __ secondo/i tra un tentativo e l'altro. | Il numero di secondi durante i quali il dispositivo di integrazione resta in attesa prima di provare a richiamare un messaggio dalla coda. Per ulteriori informazioni su come questa opzione sia correlata al campo Timeout nel pannello Configura o al parametro di input timeout, consultare Opzioni Timeout e Riprova. |
2) Tentare di connettersi ___ volte prima di dare errore. | Specifica il numero massimo di volte in cui il dispositivo
di integrazione tenta di richiamare un messaggio dalla coda prima di emettere
un errore e di arrestare l'elaborazione del lavoro di orchestrazione corrente. Se si distribuisce un'orchestrazione che contiene un'attività MQ - Acquisisci messaggio e il dispositivo di integrazione non riesce a connettersi al server MQ specificato o non riesce ad acquisire un messaggio dalla coda, il dispositivo di integrazione registra gli errori come avvertenze nei log di sistema e dell'orchestrazione finché non viene raggiunto il valore relativo al numero di tentativi. Una volta raggiunto il numero di tentativi, il dispositivo di integrazione registra un errore nei log di sistema e di orchestrazione e smette di elaborare il lavoro di orchestrazione corrente. Ad esempio, se si imposta il numero di tentativi su 3, il primo, il secondo e il terzo errore vengono visualizzati nel log di sistema come avvertenze. Il dispositivo di integrazione registra il quarto errore come errore e smette di elaborare il lavoro di orchestrazione corrente. Per ulteriori informazioni su come questa opzione sia correlata al campo Timeout nel pannello Configura o al parametro di input timeout, consultare Opzioni di timeout e dei tentativi. |
I parametri di input dell'attività vengono visualizzati nel pannello A attività.
Durante il runtime, l'attività viene ripetuta in modo sequenziale nei messaggi presenti nella coda. Se a questi nodi non viene associato alcun elemento, non è presente alcun vincolo, quindi, il primo messaggio nella coda viene restituito dall'attività MQ - Acquisisci messaggio e viene elaborata l'attività successiva nell'orchestrazione.
Se uno qualsiasi di questi nodi viene associato, durante il runtime l'attività MQ - Acquisisci messaggio viene ripetuta in ciascun messaggio nella coda finché non individua il primo messaggio che corrisponde ai valori di runtime di tutti i nodi associati. Il primo messaggio corrispondente viene restituito dall'attività MQ - Acquisisci messaggio e viene elaborata l'attività successiva nell'orchestrazione.
Facoltativamente, è possibile sovrascrivere dinamicamente le impostazioni specificate per Nome coda e Timeout nell'attività Configura dell'Elenco di controllo durante il runtime, utilizzando i parametri di input definiti nella seguente tabella.
Ad esempio, il nome della coda MQ viene impostata, nell'attività Configura, su poqueue. Durante il runtime, il nome della coda MQ: newqueue viene trasmesso all'attività utilizzando il parametro di input queuename. Il nome della coda specificato dinamicamente durante il runtime sovrascrive l'impostazione originale specificata nel pannello Configura. In questo esempio, il dispositivo di integrazione cerca i messaggi nella coda MQ denominata newqueue.
Nodo/Nome parametro di input | Descrizione | Sovrascrive l'impostazione nell'attività? |
---|---|---|
timeout | Specifica l'intervallo di tempo durante il quale il dispositivo di integrazione
attende dopo aver richiamato un messaggio dalla coda prima di
ritentare. Se non si desidera impostare un periodo di timeout, specificare un numero negativo — il dispositivo di integrazione attende per un tempo indefinito per richiamare un messaggio dalla coda. La specifica di un numero negativo equivale alla specifica dell'opzione Mai nell'attività Configura. |
Il parametro di input timeout sovrascrive il campo Timeout dell'attività Configura. |
queuename | Specifica il nome della coda MQ in cui il dispositivo di integrazione cerca i messaggi. | Il parametro di input queuename sovrascrive la codifica specificata nel campo Nome coda dell'attività Configura. |
Per istruzioni generiche relative alle associazioni, consultare Creazione di un'associazione.
Non è necessario associare i parametri di output per questa attività. Per istruzioni generiche relative alle associazioni, consultare Creazione di un'associazione.
Il timeout specificato nel campo Timeout nell'attività Configura o il parametro di input timeout specifica l'intervallo di tempo, in secondi, che deve trascorrere tra la richiesta di richiamo di un messaggio dalla coda da parte dell'attività MQ - Acquisisci messaggio e la restituzione del messaggio, prima che si verifichi un timeout. Se questo periodo di timeout scade e la coda non restituisce alcun messaggio, il dispositivo di integrazione attende che trascorra l'intervallo di tempo specificato nell'opzione 1) Attendere ___ secondo/i tra un tentativo e l'altro prima di tentare di richiamare di nuovo un messaggio. Il dispositivo di integrazione continua a tentare di richiamare il messaggio fino a quando non viene raggiunto il numero specificato di tentativi. Il numero di tentativi è specificato con l'opzione 2) Tentare di connettersi ___ volte prima di dare errore. Le opzioni 1) Attendere ___ secondo/i tra un tentativo e l'altro e 2) Tentare di connettersi ___ volte prima di dare errore sono specificate nell'attività Opzioni dei tentativi.