Questo argomento contiene le seguenti sezioni:
Utilizzare il nodo Extract per estrarre il contenuto del messaggio di input che si desidera venga elaborato da nodi successivi nel flusso di messaggi. Utilizzando il nodo Extract, è possibile creare un nuovo messaggio di output che contenga solo una serie secondaria del contenuto del messaggio di input. Il messaggio di output comprende solo quegli elementi del messaggio di input che sono stati specificati per l'inclusione durante la configurazione del nodo Extract, definendo le istruzioni di mappatura.
Il nodo Extract è rappresentato nel workbench dalla seguente icona:
Questo nodo potrebbe essere utile se si richiede solo una serie secondaria del messaggio dopo l'elaborazione iniziale di tutto il messaggio. Ad esempio, si potrebbe memorizzare l'intero messaggio ai fini della revisione contabile (nel nodo Warehouse), ma trasmettere solo una piccola parte del messaggio (informazioni relative agli ordini, ad esempio) per un'ulteriore elaborazione.
Si ricevono ordini da nuovi clienti e si desidera raccogliere i nomi e gli indirizzi dei clienti per le promozioni future. Per fare ciò, si utilizza il nodo Extract per ricavare queste informazioni da ciascun ordine e inviarle come nuovo messaggio alla sede principale. Tali messaggi vengono elaborati nella sede principale in modo che i dettagli relativi al cliente possano essere inclusi nella successiva campagna di marketing.
Una volta inserita un'istanza del nodo Extract in un flusso di messaggi, è possibile configurarla. Fare clic con il tasto destro del mouse sul nodo nella vista dell'editor e selezionare 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 Extract come segue:
Facendo clic su Sfoglia accanto a questo campo di immissione, viene visualizzata una finestra di dialogo che elenca tutte le routine di mappatura disponibili a cui può accedere questo nodo. Selezionare la routine desiderata e fare clic su OK. Il nome della routine è impostato in Modulo mappatura.
Per gestire la routine di mappatura associata a questo nodo, fare clic con il tasto destro del mouse sul nodo e selezionare Apri mappature. Se la routine di mappatura non esiste, essa viene creata con il nome predefinito nel file predefinito. Se il file già esiste, è possibile anche aprire <flow_name>_<node_name>.mfmap nella vista Navigator.
Una routine di mappatura è specifica al tipo di nodo a cui è associata; non è possibile utilizzare una routine di mappatura sviluppata per un nodo Extract con un qualsiasi altro nodo che utilizza le mappature (ad esempio, un nodo DataInsert). Se si crea una routine di mappatura, non è possibile richiamarla da altre routine di mappatura, sebbene la si possa richiamare da una routine ESQL.
Fare clic su Annulla per chiudere la finestra di dialogo ed eliminare tutte le modifiche apportate alle proprietà.
I terminali del nodo Extract sono descritti nella seguente tabella.
Terminale | Descrizione |
---|---|
In | Il terminale di input che accetta un messaggio affinché venga elaborato dal nodo. |
Failure | Il terminale di output a cui è instradato il messaggio di input se viene rilevato un errore durante l'estrazione. |
Out | Il terminale di output a cui è instradato il messaggio trasformato se il messaggio di input è elaborato con esito positivo. |
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 Extract sono descritte nella seguente tabella.
Proprietà | O | C | Valore predefinito | Descrizione |
---|---|---|---|---|
Modulo mappatura | Sì | No | Extract | Il nome della routine di mappatura che contiene le istruzioni da eseguire sulla struttura ad albero del messaggio. La routine è univoca per questo tipo di nodo. |
Le proprietà Descrizione del nodo Extract 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. |