Import Mappers
Categoria:
Argomenti in questo documento:
- Dove trovare i mappers
- Tipi di Import Mapper
- Aggiungere un nuovo Import Mapper
- Esempio di caso d’uso
- Panoramica delle schede disponibili
- Best practice
Gli import mappers in Tridens Monetization consentono di trasformare e allineare dati esterni (CSV, flat file e così via) in formati compatibili con il sistema. Che si importino dati di pagamento, eventi o transazioni bancarie, gli import mappers assicurano che il sistema interpreti e acquisisca correttamente dati strutturati da piattaforme esterne.
Dove trovare i mappers
Vai a:
Business Configuration > Import
Figura 1: Pagina predefinita Import Mappers
Tipi di Import Mapper
Nella parte superiore della schermata Import Mappers sono presenti quattro schede, ciascuna relativa a un diverso dominio di dati. Tutte le schede condividono la stessa struttura di configurazione:
- Payment Mappers
- Direct Debit Mappers
- Event Mappers
- Bank Mappers
Ogni scheda consente di aggiungere un nuovo mapper usando un form simile a quello mostrato nello screenshot.
Aggiungere un nuovo Import Mapper
Fai clic sul pulsante Add in una delle quattro schede per aprire il form Create Mapper. I campi da compilare sono identici per tutti i tipi di mapper.
Campi obbligatori
Tabella 1: Campi obbligatori
| Campo | Descrizione |
|---|---|
| Name | Nome univoco e descrittivo del mapper, ad esempio Bankart Payment Mapper |
| Code | Identificatore di sistema usato internamente, ad esempio BANKART_01 |
| Description | Facoltativo. Note sullo scopo o sulla fonte del mapper |
| Prefix | Facoltativo. Usato per aggiungere valori univoci durante il mapping |
| Import Mode | Definisce la struttura del file di input. Opzioni: Single o Multi |
| Delimiter | Delimitatore del file, in genere virgola ,, tab \t o punto e virgola ; |
| File | Caricamento del file template di mapping, di solito in formato CSV o TXT |
Figura 2: Pagina Create Import Mapper
Esempio di caso d’uso
Stai importando un file CSV da un provider di pagamento, ad esempio Stripe, che include colonne per ID transazione, ID cliente, importo e stato. Crea un Payment Mapper per allineare queste colonne ai campi previsti da Tridens.
Panoramica delle schede disponibili
Ogni scheda in Import Mappers accetta gli stessi campi:
1. Payment Mappers
Usato per importare dati grezzi delle transazioni da sistemi di pagamento esterni.
2. Direct Debit Mappers
Mappa dati di ordini di addebito o mandati provenienti da banche o PSP.
3. Event Mappers
Importa eventi, ad esempio eventi di utilizzo e trigger, che influenzano la logica di rating o charging.
4. Bank Mappers
Usato per integrare estratti conto bancari importati o file di riconciliazione.
Best practice
Info “Suggerimento” - Usa convenzioni di denominazione coerenti per codici e prefissi. - Testa sempre il file di mapping in un ambiente sandbox prima dell’uso in production. - Scegli il delimitatore corretto in base alla sorgente dati (CSV, TSV, ecc.). - Conserva copie di backup dei template di mapping e dei file di test.
