Nodo Extract

Questo argomento contiene le seguenti sezioni:

Scopo

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:

Icona del nodo Extract

Utilizzo di questo nodo in un flusso di messaggi

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.

Configurazione del nodo Extract

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:

  1. In Modulo mappatura, identificare la routine di mappatura associata che deve essere eseguita in questo nodo. Per impostazione predefinita, il nome assegnato alla routine di mappatura è identico al nome del file di mappature in cui è definita la routine. Il nome predefinito per il file è il nome del flusso di messaggi concatenato al nome del nodo, quando questo è incluso nel flusso di messaggi (ad esempio, MFlow1_Extract.mfmap per il primo nodo Extract nel flusso di messaggi MFlow1). Non è possibile specificare un valore che includa degli spazi.

    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.

  2. Selezionare Descrizione nel Navigator della finestra di dialogo delle proprietà per immettere una descrizione breve, una descrizione completa o entrambe.
  3. Fare clic su Applica per effettuare le modifiche al nodo Extract 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à.

Terminali e 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 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.
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
ac04710_