Trasformazioni (operazioni di mappatura)

Nell' editor Mappatura di dati grafici, è possibile definire le operazioni di mappatura come le trasformazioni, le funzioni cast o le funzioni XPath 2.0 . Le operazioni di associazione definiscono le azioni di trasformazione sui dati di input e impostano il risultato sull'elemento di output.

Operazioni di mappatura per trasformare graficamente i dati

È possibile utilizzare una delle seguenti trasformazioni per mappare graficamente i dati nell' editor Mappatura dati grafici:
  • Trasformazioni di mappatura principale: è possibile utilizzare le operazioni di mappatura strutturale e funzionale integrate per creare graficamente le trasformazioni del messaggio richieste per creare il messaggio di output. Per ulteriori informazioni, consultare Tipi di trasformazione nell'editor Associazione dati grafici.
  • Trasformazioni personalizzate: è possibile definire trasformazioni specializzate per creare funzioni ESQL personalizzate, XPath 2.0o Java™. Per ulteriori informazioni, consultare Tipi di trasformazione nell'editor Mapping dei dati grafici.
  • Funzioni XPath: è possibile utilizzare le funzioni XPath 1.0 e XPath 2.0 per trasformare i dati in una mappa del messaggio. È inoltre possibile creare espressioni XPath composte utilizzando la trasformazione XPath personalizzato ; consultare XPath personalizzato.

    Tutte le funzioni XPath 2.0 sono supportate nel formato fn:functionName.

    Per ulteriori informazioni su XPath, consultare il documento in linea W3C XML Path Language (XPath) 2.0.

  • App Connect Enterprise funzioni di associazione. È possibile utilizzare un insieme di funzioni di mappatura ` IBM® App Connect Enterpriseiib:functionName`, ad esempio, per accedere al valore di una proprietà definita dall'utente. Per ulteriori informazioni, vedere XPath personalizzato.
  • Trasformazioni database:
    • È possibile utilizzare la trasformazione Seleziona per interrogare una o più tabelle di database e richiamare i dati. È possibile utilizzare i dati nella mappa del messaggio per impostare i valori degli elementi di output, definire condizioni o utilizzare come input per creare altre condizioni di trasformazione. Le tabelle di database possono essere impostate come output supplementari di un' associazione del messaggio. Per ulteriori informazioni, consultare Selezione dei dati da una tabella.
    • È possibile utilizzare una trasformazione di routine database per richiamare una procedura memorizzata da un database e richiamare i dati. È possibile utilizzare i dati nella mappa del messaggio per impostare i valori degli elementi di output, definire condizioni o utilizzare come input per creare altre condizioni di trasformazione.
      Nota: per informazioni sul supporto per le procedure memorizzate, consultare Supporto per le procedure memorizzate.
  • Trasformazioni cache: utilizzando le trasformazioni Cache è possibile interagire con i dati memorizzati in una cache globale . Per ulteriori informazioni, consultare Accesso a una cache globale utilizzando un nodo Mapping.
    È possibile utilizzare le seguenti trasformazioni:

Operazioni di associazione per modificare i dati in un database

Le tabelle del database possono essere impostate come ulteriori output di una mappa del messaggio.

È possibile utilizzare una delle seguenti trasformazioni per modificare i dati in un database:
  • Trasformazione Inserisci : utilizzare la trasformazione Inserisci per aggiungere una nuova riga di dati o più righe di dati in una tabella di database. Per ulteriori informazioni, consultare Inserimento di dati in una tabella.
  • Trasformazione Aggiorna : utilizzare la trasformazione Aggiorna per modificare una riga di dati o più righe di dati in una tabella di database. Per ulteriori informazioni, consultare Aggiornamento dei dati in una tabella.
  • Trasformazione Elimina : utilizzare la trasformazione Elimina per eliminare una riga di dati o più righe di dati in una tabella di database. Per ulteriori informazioni, consultare Eliminazione di dati da una tabella.
  • Trasformazione routine del database : utilizzare una trasformazione routine del database per richiamare una procedura memorizzata o una funzione definita dall'utente da un database per inserire, eliminare o aggiornare i dati in una tabella del database. Per ulteriori informazioni, consultare Richiamo di una procedura memorizzata da una mappa.

In fase di progettazione, è necessario disporre di un file di definizione database (file.dbm ) in un progetto Data Design disponibile per ciascun database a cui si desidera accedere. Un file di definizione dati contiene una connessione per sistema di database.

Al runtime, è necessario disporre di una connessione JDBC di tipo 4 definita per ogni database utilizzato dalla mappa del messaggio . È necessario configurare una politica JDBC Providers per database. Il nome della politica dei provider JDBC per un database di runtime deve avere lo stesso nome del database di sviluppo utilizzato nella mappa del messaggio.

Per ulteriori informazioni, consultare Modifica dei dati in un database utilizzando la mappatura.

Funzione cast per definire un tipo di schema

Nell' editor di associazione dati grafici, è possibile utilizzare la funzione Cast per eseguire il cast dei tipi di schema.

È necessario eseguire il cast di uno schema in una delle seguenti istanze:
  • Eseguire il cast del valore assegnato a un elemento di output in modo che corrisponda al tipo di definizione dello schema dell'elemento di output.
  • Eseguire il cast del valore di un elemento utilizzato come parametro in una funzione in cui il parametro è di tipo differente.
  • Eseguire il cast del valore di un elemento che si utilizza come condizione su una trasformazione in cui il tipo è differente.
  • Eseguire il cast del valore di un elemento quando si lavora con un database e i tipi differiscono.

Per eseguire il cast di uno schema, è possibile utilizzare le funzioni xs:castOperation , dove castOperation è il nome della funzione cast.

Funzionamento della mappatura guidato dal tipo di operazione

Quando vengono create le trasformazioni nella mappa del messaggio , i valori per gli elementi del messaggio di output possono essere derivati da uno qualsiasi dei seguenti componenti:
  • Elementi del messaggio di input, mediante una delle seguenti operazioni di mappatura:
  • Funzioni supplementari, che consentono a più valori di input di produrre il valore di output, come concat e join.
  • Il risultato delle trasformazioni Seleziona, Inserisci, Aggiorna, Eliminae Routine database del database.
  • Valori costanti, tramite un'operazione Assegna che utilizza un valore fornito.
  • Funzioni personalizzate, XPath definito dall'utente, Java o ESQL.

La logica per derivare i valori può essere semplice o complessa. Oltre alle operazioni di trasformazione che impostano un valore di output, vengono fornite trasformazioni strutturali per consentire istruzioni condizionali, loop e nidificazione della logica di trasformazione in mappe locali.

Per informazioni sui tipi di trasformazione supportati, consultare Tipi di trasformazione nell'editor Mapping dei dati grafici.