Mapping

Le Action di Mapping permettono di collegare i dati provenienti da una piattaforma con quelli di un'altra, assicurando che ogni campo sia nel formato corretto prima dell'invio effettivo alla piattaforma di destinazione.

In pratica, il mapping consente di rinominare, aggiungere o rimuovere campi automaticamente, senza interventi manuali o codice esterno.

Configurazione

Accedendo alla pagina di dettaglio dell'Action è possibile:

• Modificare il nome dell'Action.
• Aggiornare le impostazioni.
• Testare la mappatura.
• Salvare le modifiche apportate.

Tramite il bottone Settings, è possibile:

• Importare un JSON di input per facilitare la mappatura.
• Importare un JSON di output di esempio.

Definizione del mapping

1. Cliccare su Add per ogni campo che si vuole includere nell'output.
2. Selezionare il campo dal menu a tendina o inserirlo manualmente.
3. Definire una regola di mapper per ogni campo, scegliendo tra:
   • convert to int → conversione a intero
   • convert to decimal → conversione a decimale
   • convert to string → conversione a stringa
   • constant → definire un valore costante
   • '-' → nessuna conversione

informazioni

Nota: come visibile anche dall'intestazione della tabella, l'ordine dei campi è: Destinazione → Mapper → Sorgente.

Testing

Una volta definita la mappatura, è possibile testarla fornendo un esempio di JSON di input.

• Prima di eseguire il test, è necessario salvare tutte le modifiche apportate.
• La piattaforma segnala eventuali errori, permettendo di correggerli subito.

💡 Suggerimento: esegui sempre un test con un piccolo campione di dati prima di applicare il mapping a tutto il flusso.

Vantaggi

• Garantisce coerenza dei dati tra piattaforme.
• Riduce errori manuali.
• Facilita l’integrazione automatica tra sistemi diversi.