Questo argomento contiene le seguenti sezioni:
Il nodo TimeoutControl riceve un messaggio di input che contiene una richiesta di timeout. Consultare Messaggio di richiesta di timeout per una descrizione del messaggio di richiesta di timeout. Il nodo convalida la richiesta, memorizza il messaggio e lo trasmette (senza modificarlo) al nodo successivo nel flusso di messaggi.
Il nodo TimeoutControl è rappresentato nel workbench dalla seguente icona:
Utilizzare un nodo TimeoutControl e un nodo TimeoutNotification insieme in un flusso di messaggi per un'applicazione che richiede che gli eventi si verifichino in orari particolari o ad intervalli regolari.
E' possibile associare più di un nodo TimeoutControl ad un nodo TimeoutNotification. Le richieste di timeout elaborate da quei nodi TimeoutControl sono elaborate tutte dallo stesso nodo TimeoutNotification. Questo si verifica se è utilizzato lo stesso Identificativo univoco per il nodo TimeoutNotification e per ciascuno dei nodi TimeoutControl.
Fare riferimento alla sezione Esempio Elaborazione timeout per ulteriori dettagli su come utilizzare i nodi di elaborazione timeout.
Una volta inserita un'istanza del nodo TimeoutControl in un flusso di messaggi, è possibile configurarla.
Fare clic con il tasto destro del mouse sul nodo nella vista dell'editor e fare clic su Proprietà. Vengono visualizzate le proprietà Base del nodo.
Identificativo univoco è la sola proprietà obbligatoria. Essa non ha un valore predefinito.
Configurare le proprietà Base del nodo procedendo nel seguente modo:
Configurare ora le proprietà del nodo relative al messaggio:
Lasciare vuoto il campo Serie di messaggi per i programmi di analisi XML, XMLNS, XMLNSC, JMS, MIME e BLOB.
Lasciare il campo Tipo messaggio vuoto per i programmi di analisi XML, XMLNS, XMLNSC, JMS, IDOC, MIME e BLOB.
Lasciare vuoto il campo Formato del messaggio per i programmi di analisi XML, XMLNS, XMLNSC, JMS, MIME e BLOB.
Una volta completata la configurazione, fare clic su Applica. In questo modo si apportano modifiche al nodo TimeoutControl senza chiudere la finestra di dialogo delle proprietà. Fare clic su OK per applicare le modifiche e chiudere la finestra di dialogo delle proprietà. Fare clic su Annulla per chiudere la finestra di dialogo ed eliminare tutte le modifiche apportate alle proprietà.
I terminali del nodo TimeoutControl sono descritti nella seguente tabella.
Terminale | Descrizione |
---|---|
In | Il terminale di input che accetta una struttura ad albero del messaggio per l'elaborazione (che include la convalida della richiesta di timeout specificata nella struttura ad albero del messaggio in Ubicazione richiesta) e l'aggiunge alla coda di controllo. |
Failure | Il terminale di output a cui è trasmesso il messaggio di input se viene rilevato un errore durante l'elaborazione in questo nodo. Se questo terminale non è connesso ad un altro nodo, le informazioni relative all'errore sono ritrasmesse al nodo precedente nel flusso di messaggi. |
Out | Il terminale di output a cui sono trasmessi i messaggi in entrata, immutati, dopo che l'elaborazione della richiesta di timeout ha avuto esito positivo. Se questo terminale non è connesso ad un altro nodo, non ha luogo alcuna trasmissione. Se la trasmissione del messaggio ha esito negativo, il messaggio è trasmesso al terminale Failure. |
Le seguenti tabelle descrivono le proprietà del nodo; la colonna con l'intestazione O indica se la proprietà è obbligatoria (contrassegnata con un asterisco nella finestra di dialogo delle proprietà, se è necessario immettere un valore quando non è specificato un valore predefinito), la colonna con l'intestazione C indica se la proprietà è configurabile (è possibile modificare il valore quando si aggiunge un flusso di messaggi a un file bar per distribuirlo).
Le proprietà Base del nodo TimeoutControl sono descritte nella seguente tabella.
Proprietà | O | C | Valore predefinito | Descrizione |
---|---|---|---|---|
Identificativo univoco | Sì | Sì | Nessuno | Questa è l'unica proprietà obbligatoria per il nodo. Il suo valore deve essere univoco all'interno del broker. La proprietà equivalente del nodo TimeoutNotification a cui è associato deve avere lo stesso valore. La lunghezza massima di questo identificativo è di 12 caratteri. |
Ubicazione richiesta | No | No | Nessuno | Questa proprietà descrive dove trovare le informazioni relative alla richiesta di timeout. Deve trattarsi di un'ubicazione valida nella struttura ad albero del messaggio. Questa è convalidata durante il runtime. Se non viene specificata alcuna ubicazione richiesta, si presuppone sia LocalEnvironment.TimeoutRequest. Consultare Messaggio di richiesta di timeout per una descrizione del messaggio di richiesta di timeout. |
Permanenza richiesta | No | No | Automatico | Questa proprietà stabilisce se la richiesta di timeout in entrata debba sopravvivere al riavvio di un broker o di un flusso di messaggi. Il valore di questa proprietà può essere Automatico, Sì o No. Se il valore è Automatico, è utilizzata l'impostazione Permanenza nella cartella delle proprietà del messaggio in entrata. |
Le proprietà Messaggio del nodo TimeoutControl sono descritte nella seguente tabella.
Proprietà | O | C | Valore predefinito | Descrizione |
---|---|---|---|---|
Ubicazione dei messaggi memorizzati | No | No | Nessuno | L'ubicazione della sezione del messaggio di richiesta che si desidera memorizzare per la trasmissione da parte del nodo TimeoutNotification a cui questo nodo è associato. |
Dominio messaggi | No | No | Nessuno | Il dominio che sarà utilizzato dal nodo TimeoutNotification per analizzare il messaggio di richiesta di timeout memorizzato. |
Serie di messaggi | No | No | Nessuno | Il nome o identificativo della serie di messaggi in cui è definito il messaggio di richiesta di timeout memorizzato. |
Tipo messaggio | No | No | Nessuno | Il nome del messaggio di richiesta di timeout memorizzato. |
Formato del messaggio | No | No | Nessuno | Il nome del formato fisico del messaggio di richiesta di timeout memorizzato. |
Le proprietà Descrizione del nodo TimeoutControl sono descritte nella seguente tabella.
Proprietà | O | C | Valore predefinito | Descrizione |
---|---|---|---|---|
Descrizione breve | No | No | Una breve descrizione del nodo. | |
Descrizione completa | No | No | Testo che descrive lo scopo del nodo nel flusso di messaggi. |