Attività MQ - Inserisci messaggio

Utilizzare l'attività MQ - Inserisci messaggio per inviare un messaggio alla coda specificata durante il runtime.

Nota: prima di configurare l'attività, è necessario aver creato un endpoint per l'attività MQ.
L'attività Configura è suddivisa in tre sezioni:

Una volta completate le attività Configura e Associazione di input per l'attività.

Nota: la dimensione massima dei messaggi è di 100 MByte.

Dettagli della coda e del messaggio

Specificare i dettagli della coda e del messaggio utilizzando i campi presenti nella seguente tabella. I campi obbligatori sono contrassegnati con un asterisco.
Campo Descrizione
Nome coda * Specifica il nome della coda in cui vengono inseriti i messaggi.
Tipo di dati payload Specifica il tipo di dati del payload del messaggio, binario o stringa.
Tipo di messaggio Datagramma - Selezionare questo tipo se il messaggio deve essere inviato e non è richiesta alcuna risposta.

Richiesta - Selezionare questo tipo se il messaggio richiede una risposta. Assicurarsi di impostare la proprietà Coda Rispondi a per i messaggi di richiesta.

Risposta - Selezionare questo tipo se il messaggio rappresenta una risposta a una precedente richiesta.

Coda Rispondi a Specifica la coda a cui deve essere inviata la risposta per i messaggi di richiesta.
Gestore coda Rispondi a Specifica il nome del gestore code a cui appartiene la coda (specificata nel campo Coda Rispondi a).
Persistente
  • True - I messaggi vengono ripristinati nelle code se il gestore code si blocca.
  • False - È possibile che i messaggi vengano persi dalla coda se il gestore code si blocca.
  • Impostazione predefinita - I messaggi utilizzano l'impostazione di persistenza per la coda (questo è il valore predefinito).
Priorità Specifica la priorità del messaggio.  Per impostazione predefinita, la priorità del messaggio utilizza come valore predefinito la priorità predefinita per la coda. Se la coda utilizza le priorità per ordinare i messaggi e per questo messaggio essere impostata una priorità specifica, selezionare Specifica e immettere la priorità. Le priorità possono essere comprese tra 1 (valore inferiore) e 9 (valore superiore).
Nota: la priorità non dovrebbe superare il numero massimo di priorità impostato per la coda MQ. Contattare l'amministratore di sistema MQ per queste informazioni.
Scadenza del messaggio Il numero di secondi in cui i messaggi vengono conservati nella coda prima della scadenza. Viene utilizzato il valore predefinito Mai; tale valore assicura che il messaggio viene consegnato e attende sulla coda fino a quando non viene richiamato, indipendentemente dal tempo che dovrà trascorrere prima del richiamo.

Se i messaggi per questa coda devono scadere ed essere eliminati dopo un determinato periodo di tempo, selezionare Specifica e immettere il numero massimo di secondi durante i quali il messaggio deve essere conservato nella coda.

Frammento schema per intestazione MQRFH2 Specifica se un'intestazione MQRFH2 è inclusa nel messaggio. Se il messaggio è un messaggio XML e 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.

Regole di consegna

Campo Descrizione
Consegna messaggi Di seguito vengono indicate le opzioni disponibili:
  • Almeno una volta - Specifica che il messaggio viene consegnato almeno una volta, ma è possibile consegnarlo più di una volta. Gli errori relativi alla connessione o al dispositivo di integrazione possono avere come risultato il richiamo dei messaggi e la relativa elaborazione per più di una volta. Questa opzione di consegna viene di solito utilizzata quando il sistema di ricezione può rilevare o tollerare messaggi duplicati.
  • Al massimo una volta - Specifica che il messaggio viene consegnato solo una volta oppure che non viene affatto consegnato. Gli errori relativi alla connessione o al dispositivo di integrazione possono avere come risultato la mancata presenza dei messaggi. Questa opzione di consegna viene di solito utilizzata quando il sistema di ricezione non può tollerare i messaggi duplicati, ma può tollerare quelli persi.

Opzioni dei tentativi

Configurare le opzioni dei tentativi per la connessione a un server MQ. La seguente tabella descrive le opzioni dei tentativi per la connessione a un server MQ:

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 contattare il gestore code per inviare nuovamente un messaggio al server MQ.
2) Tentare di connettersi ___ volte prima di dare errore. Specifica il numero massimo di volte in cui il dispositivo di integrazione tenta di contattare il gestore code per inviare un messaggio al server MQ 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 - Inserisci messaggio e il dispositivo di integrazione non riesce a connettersi al gestore code del server MQ specificato, 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 di connessione 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.

Associazione di input

Viene richiesto di associare i parametri di input per questa attività. I seguenti parametri sono richiesti e devono essere associati per consentire il completamento della configurazione. Tutti gli altri parametri sono facoltativi. Per ulteriori informazioni, consultare Creazione di un'associazione.
Parametri di input richiesti:
payload

Per visualizzare i parametri di input facoltativi nel pannello A attività del pannello Associa input, selezionare Associa > Mostra parametri facoltativi dal menu della barra degli strumenti oppure fare clic con il tasto destro del mouse nel pannello A attività e selezionare l'opzione Mostra parametri facoltativi. Se l'opzione Associa > Mostra parametri facoltativi non è selezionabile nel menu della barra degli strumenti, fare clic su un nodo nel pannello Associa input per attivare questa opzione.