Rimuovi

È possibile utilizzare la trasformazione Rimuovi per eliminare un elemento dalla albero Environment o per rimuovere un elemento all'interno di un gruppo Sovrascritture .

Panoramica

Ad esempio, è possibile utilizzare la trasformazione Rimuovi per rimuovere gli elementi child dalla struttura di destinazione se si copia una struttura complessa dall'origine alla destinazione.

La trasformazione Rimuovi non ha alcun input collegato alla trasformazione.

È possibile definire una trasformazione Rimuovi su un elemento di output semplice, complesso o ripetuto.

La trasformazione Rimuovi è disponibile nell'elenco di trasformazioni disponibili quando si definisce una trasformazione su un elemento nella struttura ad albero dell'ambiente o quando si definisce una trasformazione su un elemento in un gruppo Sovrascritture .
Nota: una trasformazione Rimuovi in un gruppo Sovrascritture non può essere utilizzata per rimuovere uno specifico elemento di tipo xsi; la trasformazione Rimuovi utilizza solo il nome dell'elemento per identificare l'elemento di destinazione da rimuovere.

Definire quando la trasformazione viene applicata al runtime

È possibile definire più connessioni tra gli elementi di input e la trasformazione Rimuovi . È quindi possibile utilizzare questi elementi di input in un'espressione condizionale che definisca la condizione in cui viene applicata la trasformazione. Se la condizione viene valutata come true, viene applicata la trasformazione.

In alternativa, per definire l'espressione condizionale, è possibile richiamare un metodo statico su una classe Java™ importata. Puoi anche creare un'espressione complessa comprendente XPath, Java e funzioni di estensione come iib:getUserDefinedProperty("propertyname").

Per aggiungere gli input alla trasformazione, è possibile definire le connessioni supplementari tra gli elementi di input e la trasformazione.

Configurare l'espressione nella scheda Condizione disponibile nella pagina Proprietà della trasformazione.

Per ulteriori informazioni, consultare Configurazione delle proprietà di una trasformazione, Definizione di un'espressione condizionale XPath per una trasformazione e Definizione di un'espressione condizionale Java per una trasformazione.

Modifica degli elementi ripetuti

Se è necessario rimuovere alcuni elementi di una struttura che si ripete, utilizzare la trasformazione For Each e definire le espressioni condizionali per ogni indice per determinare se l'elemento viene spostato o rimosso.

Per ulteriori informazioni, consultare Per ogni.

Esempio

Questo esempio mostra come copiare una struttura di input nell'output ed eliminare un elemento dalla struttura del messaggio di output.

Definire una mappa con una trasformazione Sposta tra l'elemento di input e l'elemento di output.

Questa figura mostra la mappa principale man mano che viene creata, con una trasformazione Move.

È possibile fare clic sull'elemento che si desidera eliminare (H2) dalla struttura di output, quindi trascinare e rilasciare il mouse nell'area. Viene aggiunta una trasformazione Assegna . Modificare la trasformazione Assegna nella trasformazione Rimuovi .

Questa figura mostra la finestra a comparsa in cui è possibile selezionare la trasformazione Rimuovi.

Appena si seleziona la trasformazione Rimuovi , l' editor Graphical Data Mapping aggiunge una funzione Sovrascritture che raggruppa la trasformazione Sposta e la trasformazione Rimuovi . La funzione Sovrascritture specifica che l'elemento di input H viene copiato senza modifiche, quindi l'elemento H2 viene eliminato dalla struttura di output.

Questa figura mostra la funzione di sovrascritture aggiunta alla mappa.