Questo argomento contiene le seguenti sezioni:
Utilizzare il nodo AggregateReply per contrassegnare la fine di un fan-in di aggregazione. Questo nodo raccoglie le repliche e le combina in un singolo messaggio composto.
L'aggregazione è un'estensione del modello di applicazione di richiesta/replica. Essa unisce la creazione e il fan-out di un numero di richieste correlate al fan-in delle repliche corrispondenti e compila tali repliche in un singolo messaggio di replica aggregato.
La funzione di aggregazione è fornita dai tre seguenti nodi:
Il nodo AggregateReply è rappresentato nel workbench dalla seguente icona:
Quando i messaggi in entrata sono memorizzati dal nodo AggregateReply prima che siano state ricevute tutte le risposte per l'aggregazione, la permanenza del messaggio determina se il messaggio sopravvive al riavvio.
Se durante un'aggregazione il nodo AggregateReply non riceve uno o più messaggi di risposta, il timeout normale o l'elaborazione di messaggi sconosciuti gestisce le risposte che sono già state ricevute.
Una volta inserita un'istanza del nodo AggregateReply 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.
Tutte le proprietà obbligatorie, per le quali è necessario immettere un valore (quelle per le quali non è specificato un valore predefinito), sono contrassegnate con un asterisco nella finestra di dialogo delle proprietà.
Configurare il nodo AggregateReply come segue:
Se si immette 0 oppure non si immette un valore, il timeout è disabilitato e i messaggi sconosciuti sono trasmessi al terminale unknown al momento della ricezione.
Fare clic su Annulla per chiudere la finestra di dialogo ed eliminare tutte le modifiche apportate alle proprietà.
I terminali del nodo AggregateReply sono descritti nella seguente tabella.
Terminale | Descrizione |
---|---|
Control | Il terminale di input che accetta i messaggi di controllo inviati da un nodo
AggregateControl corrispondente. Nota: il terminale Control è considerato obsoleto nella Versione 6.0;
per utilizzare le connessioni al terminale Control, consultare Utilizzo dei messaggi di controllo nei flussi di aggregazione.
|
In | Il terminale di input che accetta un messaggio affinché venga elaborato dal nodo. |
Failure | Il terminale di output a cui è instradato il messaggio se si rileva un errore durante l'elaborazione. |
Unknown | Il terminale di output a cui sono instradati i messaggi, quando non possono essere identificati come messaggi di replica validi. |
Out | Il terminale di output a cui è instradato il messaggio composto quando l'elaborazione viene completata con esito positivo. |
Timeout | Il terminale di output a cui è instradato il messaggio composto incompleto, quando l'intervallo di timeout specificato nel nodo AggregateControl corrispondente è scaduto. |
Catch | Il terminale di output a cui è instradato il messaggio se viene generata un'eccezione nel proseguimento dell'elaborazione e questo nodo la rileva. |
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 AggregateReply sono descritte nella seguente tabella.
Proprietà | O | C | Valore predefinito | Descrizione |
---|---|---|---|---|
Nome aggregazione | Sì | Sì | Un nome che può essere utilizzato per associare il flusso di messaggi fan-in al flusso di messaggi fan-out. Questa proprietà è obbligatoria. | |
Timeout messaggio sconosciuto | No | No | 0 | Il periodo di tempo in cui i messaggi che non possono essere identificati come repliche sono conservati prima di essere trasmessi al terminale unknown. |
Modalità transazione | Sì | No | Selezionata | Indica se i messaggi trasmessi da questo nodo sono inseriti in modo transazionale. Questa azione viene eseguita se si seleziona la casella di spunta. |
Le proprietà Descrizione del nodo AggregateReply 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. |