Nell' editor di associazione dati grafici, è possibile associare elementi e attributi tra gli oggetti di input e di output. È possibile applicare una trasformazione all'associazione che specifica l'azione da eseguire sui dati di input. Il risultato della trasformazione viene memorizzato nell'elemento di output.
La seguente tabella mostra le trasformazioni di mappatura standard fornite dall'editor Mappatura dati grafici:
Tabella 1. La mappatura principale si trasforma nell'editor Mappatura dati grafici:
| Trasforma |
Descrizione |
| Assegna |
Imposta un valore nell'elemento di emissione. Non è presente alcun elemento di input. I valori delle colonne impostati tramite la conversione Assegna verranno sempre passati come stringa di caratteri. |
| Impostazione del valore di un elemento di output semplice su un valore predefinito o fisso |
Imposta un tipo di valore specifico nell'elemento di output. Il cast può anche spostare e convertire un elemento di immissione in modo che diventi un tipo di valore specifico nell'elemento di emissione. |
| Concatena |
Crea una concatenazione di stringhe che consente di richiamare i dati da due o più entità e collegarli in un unico risultato. |
| Converti |
Copia l'elemento di input nell'elemento di output e modifica il tipo. La trasformazione prende un singolo input semplice e crea un singolo output semplice con un tipo diverso. |
| Crea |
Crea un elemento vuoto, un elemento nil o un elemento di tipo semplice utilizzando un valore predefinito basato sul tipo di elemento. |
| XPath personalizzato |
Consente di immettere le espressioni XPath e le funzioni integrate IBM® Integration Bus da utilizzare nella trasformazione. |
| Java personalizzato |
Consente di immettere il proprio codice Java da utilizzare nella trasformazione. |
| ESQL personalizzato |
Consente di immettere il proprio codice ESQL da utilizzare nella trasformazione. |
| sposta |
Copia i dati dall'elemento di input all'elemento di output. |
| Normalizza |
Normalizza la stringa di input rimuovendo lo spazio vuoto come spazi, tabulazioni e restituzioni e sposta la stringa normalizzata risultante nell'elemento di output. |
| SUBSTRING |
Estrae le informazioni come richiesto e sposta la stringa estratta nell'elemento di output. |
| Attività |
Descrive un'attività manuale o un punto di interesse che potrebbe essere necessario esaminare o risolvere prima che una mappa del messaggio possa essere utilizzata nella propria soluzione. |
| Trasformazioni XPath integrate |
Sono supportate tutte le funzioni XPath 2.0 , nel formato fn:<function_name>. |
Oltre alle trasformazioni di mappatura principale, vengono fornite diverse trasformazioni strutturali. Le trasformazioni strutturali controllano il modo in cui gli elementi nidificati vengono visualizzati nell'
editor Mappatura dati grafici, ma non hanno alcun effetto sui dati stessi. Le trasformazioni strutturali sono descritte nella seguente tabella:
Tabella 2. Trasformazioni di mappatura strutturale nell'editor Mappatura di dati grafici:
| Trasforma |
Descrizione |
| Accoda |
Aggiunge le ricorrenze di un array di output nell'ordine degli input. |
| Rimuovi |
Rimuove un elemento. |
| For-each |
Esegue l'iterazione su un elemento array di input (un tipo semplice o un tipo complesso). |
| Gruppo |
Acquisisce un singolo array di input e produce un insieme di array di output nidificati che raccolgono elementi dell'array di input. |
| If, Else if e Else |
È possibile controllare il flusso dell'associazione impostando condizioni. |
| Unisci |
Unisce gli elementi da due o più input. |
| Mappa locale |
Fornisce una vista gerarchica delle trasformazioni di elementi nella mappa del messaggio. |
| Sottomappa |
Fa riferimento a un'altra mappa. Richiama una mappa da questo file di mappa o da un altro file di mappa, che può essere archiviato in una libreria, un'applicazione, un servizio di integrazioneo un progetto di integrazione . |
La tabella seguente mostra le trasformazioni del database fornite dall' editor Mapping dei dati grafici:
Tabella 3. Trasformazioni database nell'editor Mapping dei dati grafici:
| Trasforma |
Descrizione |
| Routine database |
Richiama una procedura memorizzata o una funzione definita dall'utente da un database. |
| Elimina |
Elimina una o più righe in una tabella di database che corrisponde a una clausola Where. |
| errore |
Abilita la gestione degli errori della mappa per tutte le eccezioni generate dal server di database in una trasformazione del database, invece di far sì che tali eccezioni arrestino la mappa e vengano riportate. |
| INSERT |
Inserisce una riga in una tabella di database. |
| RETURN |
Abilita un'ulteriore elaborazione dopo un'operazione di inserimento, aggiornamento o eliminazione del database o una chiamata Routine database . Fornisce i risultati dell'operazione del database o della chiamata come input. |
| Seleziona |
Richiama i dati dalle righe in una tabella di database, in modo che i dati possano essere utilizzati come input in una mappa del messaggio. |
| UPDATE |
Aggiorna una o più righe in una tabella di database che corrisponde a una clausola Where con una singola serie di valori di dati. |
È possibile utilizzare le trasformazioni
Cache per interagire con i dati memorizzati in
cache globale. Le trasformazioni
Cache sono descritte nella seguente tabella:
Tabella 4. Cache trasforma nell' editor Mappatura dati grafici:
| Trasforma |
Descrizione |
| Immetti cache |
Aggiunge una coppia chiave - valore ad una associazione in una cache globale. |
| Ottieni cache |
Ottiene un valore da una mappa in una cache globale, fornendo la chiave associata al valore. |
| Rimuovi cache |
Rimuove una coppia chiave - valore da un'associazione in una cache globale. |
| Restituisci cache |
Restituisce o trasforma i valori se la trasformazione Cache ha esito positivo. |
| Errore cache |
Restituisce o trasforma i valori se la trasformazione Cache ha esito negativo. |
È possibile utilizzare le funzioni integrate di `
IBM App Connect Enterprise ` per recuperare i dati da `
IBM App Connect Enterprise ` ed eseguire la conversione dei tipi di dati e la formattazione. Le funzioni
iib: sono descritte nella tabella seguente e sono disponibili tramite l'assistente ai contenuti nella trasformazione
XPath personalizzato :
Tabella 5. Funzioni App Connect Enterprise integrate nell' editor di associazione dati grafici:
| Funzione |
Descrizione |
| iib:getUserDefinedProperty(' nome della proprietà ') |
Accesso alle proprietà definite dall'utente da un nodo Mapping |
| iib:hexBinaryValue($<var> ) |
Converte il valore in una stringa in formato binario esadecimale |
| iib:base64BinaryValue( $< var>) |
Convertire il valore in una stringa di formato binario base64 |
| iib:nullValue() |
Crea un elemento di output null / nil |
| iib:uuidValue() |
Crea un nuovo valore UUID |