Configurazione dei processi di importazione

Adobe Campaign consente di importare dati nel database da uno o più file in formato testo, CSV, TAB o XML. Questi file sono associati a una tabella (principale o collegata) e ogni campo dei file di origine è associato a un campo del database.

La procedura guidata di importazione consente di configurare un'importazione, definirne le opzioni (come la trasformazione dei dati) e avviare l'esecuzione. Si tratta di una serie di schermate il cui contenuto dipende dal tipo di importazione (semplice o multipla) e dai diritti dell'operatore.

La procedura guidata di importazione viene visualizzata dopo la creazione di un nuovo processo di importazione (vedere Creazione di processi di importazione ed esportazione.

File di origine

Nel file di origine, ogni riga coincide con un record. I dati contenuti nei record sono separati da delimitatori (spazio, scheda, carattere e così via). Ciò significa che i dati vengono recuperati sotto forma di colonne e ogni colonna è associata a un campo del database.

Passaggio 1 - Scelta del modello di importazione

Quando si avvia la procedura guidata di importazione, è innanzitutto necessario selezionare un modello. Ad esempio, per configurare l’importazione dei destinatari che hanno ricevuto una newsletter, effettuate le seguenti operazioni:

1. Selezionare la cartella Profiles and Targets > Job > Generic imports and exports.

2. Fate clic su Nuovo, quindi fate clic su Importa per creare il modello di importazione.

   

3. Fare clic sulla freccia a destra del campo Import template per selezionare il modello, oppure fare clic su Select link per sfogliare la struttura.

   Il modello nativo è New text import. Questo modello non deve essere modificato, ma può essere duplicato per configurare un nuovo modello in base ai requisiti. Per impostazione predefinita, i modelli di importazione vengono salvati nel nodo Profiles and targets > Templates > Job templates.

4. Immettere un nome per l'importazione nel campo Label. Potete aggiungere una descrizione.

5. Selezionate il tipo di importazione nel campo appropriato. Esistono due tipi di importazione possibili: Simple import per importare un solo file e Multiple import per importare più file in una singola esecuzione.

   Per un'importazione multipla, selezionate Multiple import dall'elenco a discesa Import type nella prima schermata della procedura guidata di importazione.

   

6. Specificate i campi da importare facendo clic su Add.

   

   Ogni volta che viene aggiunto un file, viene visualizzata la schermata della procedura guidata File to import. Consultate la sezione Passaggio 2 - Selezione del file di origine e seguite i passaggi della procedura guidata per definire le opzioni di importazione come per una semplice importazione.

   NOTA

   Le importazioni multiple devono soddisfare solo esigenze specifiche e non sono raccomandate.

Parametri avanzati

Il collegamento Advanced parameters consente di accedere alle seguenti opzioni:

• General tab

  • Stop execution if there are too many rejects

    Questa opzione è selezionata per impostazione predefinita. Potete deselezionare questa opzione se desiderate continuare a eseguire l'importazione indipendentemente dal numero di rifiutamenti. Per impostazione predefinita, l'esecuzione viene arrestata se le prime 100 righe vengono rifiutate.

  • Trace mode

    Selezionate questa opzione per tenere traccia dell’esecuzione dell’importazione per ogni riga.

  • Start the job in a detached process

    Questa opzione è selezionata per impostazione predefinita. Consente di scollegare l’esecuzione dell’importazione in modo che non influisca sugli altri processi in corso nel database.

  • Do not update enumerations

    Selezionate questa opzione per evitare di arricchire l'elenco dei valori enumerati nel database. Vedere Gestione delle enumerazioni.

• Variables tab

  È possibile definire le variabili associate al processo che saranno accessibili negli editor di query e nei campi calcolati. Per creare una variabile, fare clic su Add e utilizzare l'editor di variabili.

  IMPORTANTE

  La scheda Variables è destinata solo all'uso di programmazione di tipo Workflow e deve essere configurata solo da utenti esperti.

Passaggio 2 - Selezione del file di origine

Il file di origine può essere in formato testo (txt, csv, tab, fixed Columns) o xml.

Per impostazione predefinita, è selezionato Upload file on the server. Fare clic sulla cartella a destra del campo Local file per individuare il disco locale e selezionare il file da importare. Potete deselezionare questa opzione per immettere il percorso di accesso e il nome del file da importare, se presente sul server.

Quando il file è stato specificato, è possibile visualizzarne i dati nella sezione inferiore della finestra facendo clic su Auto-detect format. Questa anteprima mostra le prime 200 righe del file sorgente.

Utilizzate le opzioni offerte sopra questa visualizzazione per configurare l'importazione. I parametri definiti tramite queste opzioni vengono trasferiti nell'anteprima. Sono disponibili le seguenti opzioni:

• Click here to change the file format… consente di controllare il formato del file e perfezionare la configurazione.
• Update on server… consente di trasferire il file locale al server. Questa opzione è disponibile solo se è selezionato Upload file on the server.
• Download è disponibile solo se il file è stato caricato sul server.
• Auto-detect format viene utilizzato per reinizializzare il formato dell'origine dati. Questa opzione consente di riapplicare i formati originali ai dati formattati tramite l'opzione Click here to change the file format….
• Il collegamento Advanced parameters consente di filtrare i dati di origine e accedere alle opzioni avanzate. Da questa schermata potete scegliere di importare solo una parte del file. Potete anche definire un filtro, ad esempio per importare solo gli utenti di tipo 'Prospect' o 'Customer', in base al valore della riga corrispondente. Queste opzioni devono essere utilizzate solo dagli utenti JavaScript esperti.

Modifica del formato di file

L'opzione Click here to change the file format… consente di formattare i dati del file di origine, in particolare per specificare il separatore di colonna e il tipo di dati per ciascun campo. Questa configurazione viene eseguita tramite la finestra seguente:

Questo passaggio consente di descrivere come devono essere letti i valori dei campi del file. Ad esempio, nel caso di una data, i dati Data o Data + Ora possono essere associati a un formato (gg/mm/aaaa, mm/gg/aa, ecc.). Se i dati di input non corrispondono al formato previsto, durante l'importazione si verificheranno dei rifiuti.

Potete visualizzare il risultato della configurazione nella zona di anteprima nella parte inferiore della finestra.

Fare clic su OK per salvare la formattazione, quindi fare clic su Next per visualizzare il passaggio successivo.

Passaggio 3 - Mappatura dei campi

È quindi necessario selezionare lo schema di destinazione e mappare i dati di ciascuna colonna sui campi del database.

• Il campo Destination schema consente di selezionare lo schema in cui verranno importati i dati. Queste informazioni sono obbligatorie. Fate clic sull'icona Select link per selezionare uno degli schemi esistenti. Fare clic su Edit link per visualizzare il contenuto della tabella selezionata.

• La tabella centrale mostra tutti i campi definiti nel file di origine. Selezionare i campi da importare per associare un file di destinazione. Questi campi possono essere mappati manualmente o automaticamente.

  Per mappare manualmente un campo, fare clic sulla casella di controllo per selezionare il campo di origine, quindi fare clic sulla seconda colonna per attivare la cella corrispondente al campo selezionato. Fare clic sull'icona Edit expression per visualizzare tutti i campi della tabella corrente. Selezionate il campo di destinazione e fate clic su OK per convalidare la mappatura.

  Per associare automaticamente i campi di origine e di destinazione, fare clic sull'icona Guess the destination fields a destra dell'elenco dei campi. Se necessario, i campi proposti possono essere modificati.

  IMPORTANTE

  Il risultato di questa operazione deve sempre essere convalidato prima di procedere con il passaggio successivo.

• È possibile applicare una trasformazione ai campi importati. A tal fine, fare clic nella cella della colonna Transformation relativa al campo in questione e selezionare la trasformazione da applicare.

  

  IMPORTANTE

  La trasformazione viene applicata al momento dell'importazione. Tuttavia, se sono stati definiti vincoli per il campo di destinazione (nell'esempio precedente, nel campo @lastname), tali vincoli hanno la priorità.

• È possibile aggiungere campi calcolati utilizzando l'icona appropriata, a destra della tabella centrale. I campi calcolati consentono di eseguire trasformazioni complesse, aggiungere colonne virtuali o unire i dati di più colonne. Per informazioni dettagliate sulle varie possibilità, fare riferimento alle sezioni seguenti.

Campi calcolati

I campi calcolati sono nuove colonne aggiunte al file di origine e calcolate da altre colonne. I campi calcolati possono quindi essere associati ai campi del database Adobe Campaign . Le operazioni di riconciliazione, tuttavia, non sono possibili sui campi calcolati.

Esistono quattro tipi di campi calcolati:

• Fixed string: il valore del campo calcolato è lo stesso per tutte le righe del file di origine. Consente di impostare il valore di un campo dei record inseriti o aggiornati. Ad esempio, puoi impostare un marcatore su "yes" per tutti i record importati.

• String with JavaScript tags: il valore del campo calcolato è una stringa di caratteri contenente comandi JavaScript.

• JavaScript expression: il valore del campo calcolato è il risultato della valutazione di una funzione JavaScript. Il valore restituito può essere un numero, una data e così via.

• Enumeration: il valore del campo viene attribuito in base al valore contenuto nel file di origine. L'editor consente di specificare la colonna di origine e immettere l'elenco dei valori di enumerazione, come nell'esempio seguente:

  

  La scheda Preview consente di visualizzare il risultato della configurazione definita. Qui è stata aggiunta la colonna Subscription. Il valore viene calcolato dal campo Status.

  

Passaggio 4 - Riconciliazione

Il passaggio di riconciliazione della procedura guidata di importazione consente di definire la modalità di riconciliazione dei dati del file con i dati esistenti nel database e di impostare le regole di priorità tra i dati del file e i dati del database. La finestra di configurazione si presenta così:

La sezione centrale della schermata contiene una struttura ad albero con i campi e le tabelle del database Adobe Campaign a cui verranno importati i dati.

Sono disponibili opzioni speciali per ciascun nodo (tabella o campo). Quando si fa clic sul nodo interessato nell'elenco, i relativi parametri e una breve descrizione sono visualizzati di seguito. Il comportamento definito per ciascun elemento viene visualizzato nella colonna Behavior corrispondente.

Tipi di operazione

Per ogni tabella interessata dall'importazione, è necessario definire il tipo di operazione. Per l'elemento principale del database sono disponibili le seguenti operazioni:

• Update or insertion: aggiorna il record, se presente nel database, e lo crea in caso contrario.
• Insertion: inserisce i record nel database.
• Update: aggiorna solo i record esistenti (ignora gli altri record).
• Reconciliation only: cerca il record nel database, ma non esegue un aggiornamento. Ad esempio, consente di associare la cartella dei destinatari da importare in base a una colonna del file senza aggiornare i dati nelle cartelle.
• Deletion: consente di eliminare i record nel database.

Per ciascun campo della tabella interessata dall’importazione sono disponibili le seguenti opzioni:

• Update (empty) if source value is empty: in caso di aggiornamento, il valore nel campo rimuoverà il valore del database se il campo è vuoto nel file di origine. In caso contrario, il campo del database viene mantenuto.
• Update only if destination is empty: il valore del file di origine non sovrascrive il valore nel campo del database, a meno che il campo del database non sia vuoto. In tal caso, prende il valore del file di origine.
• Update the field only when the record is inserted: durante un'operazione di aggiornamento o inserimento, verranno importati solo i record del file di origine nuovi.

Tasti di riconciliazione

Per gestire la deduplicazione è necessario compilare almeno una chiave di riconciliazione.

Una chiave di riconciliazione è un insieme di campi utilizzati per identificare un record. Ad esempio, per importare i destinatari, la chiave di riconciliazione può essere il numero di account, il campo "e-mail" o i campi "Cognome, Nome, Società" ecc.

In questo caso, per verificare se una riga di un file corrisponde a un destinatario esistente nel database, il motore di importazione confronta i valori del file con quelli del database per tutti i campi della chiave. Quando i campi sono specifici di un record, è possibile eseguire un confronto preciso tra i dati di origine e di destinazione, garantendo l'integrità dei dati dopo l'importazione. È possibile inserire una seconda chiave di riconciliazione per la stessa tabella; viene utilizzata per le righe la cui prima chiave è vuota.

evitare di scegliere un campo che potrebbe essere modificato durante l'importazione; in tal caso, il motore potrebbe creare record aggiuntivi.

Deduplication

Il campo Management of doubles consente di configurare la deduplicazione dei dati. Deduplicazione riguarda i record che vengono visualizzati più volte nel file di origine (o i file di origine nel caso di un'importazione di più file), vale a dire righe per le quali i campi della chiave di riconciliazione sono identici.

• La gestione duplicata in modalità Update (modalità predefinita) non esegue la deduplicazione. L'ultimo record ha quindi priorità (perché aggiorna i dati dei record precedenti). Il conteggio dei duplicati non viene eseguito in questa modalità.
• La gestione duplicata in modalità Ignore o Reject entity esclude i duplicati dall'importazione. In questo caso, non viene importato alcun record.
• In modalità Reject entity, l'elemento non viene importato e nei registri di importazione viene generato un errore.
• In modalità Ignore, l'elemento non viene importato, ma non viene mantenuta alcuna traccia dell'errore. Questa modalità consente di ottimizzare le prestazioni.

La deduplicazione riguarda un record presente sia nel file di origine che nel database. Riguarda solo le operazioni con aggiornamento (cioè Update and insertion o Update). L'opzione Duplicate management consente di aggiornare o ignorare il record se si trova sia nel file di origine che nel database. L'opzione Update or insert based on origin appartiene al modulo facoltativo e non può essere utilizzata in un contesto standard.

Le opzioni Reject e Ignore funzionano come illustrato sopra.

Comportamento in caso di errore

La maggior parte delle operazioni di trasferimento dei dati genera vari tipi di errori (formato di riga incoerente, indirizzo e-mail non valido, ecc.). Tutti gli errori e tutti gli avvisi generati dal motore di importazione vengono memorizzati e collegati all’istanza di importazione.

I dettagli di questi rifiuti possono essere visualizzati tramite la scheda Rejects.

Esistono due tipi di rifiuti (il tipo viene visualizzato nella colonna Connector):

• I rifiuti del connettore di testo riguardano errori che si verificano durante l'elaborazione della riga del file (campo calcolato, analisi dei dati, ecc.). In questo caso, in caso di errore, l'intera riga viene sempre rifiutata.
• I rifiuti del connettore del database riguardano errori che si verificano durante la riconciliazione dei dati o la scrittura nel database. Nel caso di un'importazione in più tabelle, il rifiuto può riguardare solo una parte del record (ad esempio, per un'importazione di destinatari ed eventi associati, un errore può impedire l'aggiornamento di un evento senza rifiutare il destinatario).

Nella pagina di riconciliazione dei dati è possibile definire il campo del tipo di gestione degli errori desiderato per campo e tabella per tabella.

• Ignore and log a warning: tutti i campi vengono importati nel database tranne quello che ha generato un errore.

• Reject parent element: l'intera riga del record viene rifiutata, non solo il campo che ha causato un errore.

• Reject all elements: gli arresti dell'importazione e tutti gli elementi del record vengono rifiutati.

  

La struttura ad albero nella schermata di rifiuto di un'istanza di importazione indica quali campi sono stati rifiutati e dove si sono verificati gli errori.

È possibile generare un file contenente questi record tramite l'icona Export rejects:

Passaggio 5 - Passaggio aggiuntivo durante l'importazione di destinatari

Il passaggio successivo della procedura guidata di importazione consente di selezionare o creare la cartella in cui importare i dati, mappare automaticamente i destinatari importati con un elenco (nuovo o esistente) e i destinatari della sottoscrizione a un servizio.

• Fate clic sui collegamenti Edit per selezionare la cartella, l'elenco o il servizio al quale desiderate associare o sottoscrivere i destinatari.

  1. Importazione in una cartella

     Il collegamento Edit… della sezione Import into a folder consente di selezionare o creare la cartella in cui verranno importati i destinatari. Per impostazione predefinita, se non è definita alcuna partizione, i dati vengono importati nella cartella predefinita dell'operatore.

     NOTA

     La cartella predefinita per un operatore è la prima cartella a cui l'operatore ha accesso in scrittura. Vedere Gestione dell'accesso alle cartelle.

     Per selezionare la cartella di importazione, fate clic sulla freccia a destra del campo Folder e selezionate la cartella in questione. È inoltre possibile utilizzare l'icona Select link per visualizzare la struttura ad albero in una nuova finestra o per creare una nuova cartella.

     

     Per creare una nuova cartella, selezionate il nodo da cui desiderate aggiungere una cartella e fate clic con il pulsante destro del mouse. Seleziona Create a new ‘Recipients’ folder.

     

     La cartella viene aggiunta sotto il nodo corrente. Immettete il nome della nuova cartella, premete Invio per confermare, quindi fate clic su OK.

     

  2. Associazione a un elenco

     Il collegamento Edit… nella sezione Add recipients to a list consente di selezionare o creare un elenco in cui importare i destinatari.

     

     Per creare un nuovo elenco per questi destinatari, fare clic su Select link, quindi su Create. La creazione e la gestione di elenchi sono presentate in Creazione e gestione di elenchi.

     

     Potete decidere di aggiungere i destinatari a quelli già presenti in un elenco, oppure di ricreare l’elenco con i nuovi destinatari. In questo caso, se l’elenco conteneva già dei destinatari, questi verranno eliminati e sostituiti dai destinatari importati.

  3. Iscrizione a un servizio

     Per iscrivere tutti i destinatari importati a un servizio di informazione, fate clic sul collegamento Edit… della sezione Subscribe recipients to a service per selezionare o creare il servizio di informazioni a cui verranno sottoscritti i destinatari. È possibile selezionare l'opzione Send a confirmation message: Il contenuto di questo messaggio è definito nel modello di consegna associato al servizio di iscrizione.

     

     Per creare un nuovo servizio per questi destinatari, fai clic su Select link e quindi sull'icona Create. La gestione dei servizi di informazione è presentata in questa sezione.

• Utilizzare il campo Origin per aggiungere informazioni sull'origine dei destinatari ai propri profili. Tali informazioni sono particolarmente utili nel quadro di un’importazione multipla.

Fare clic su Next per convalidare questo passaggio e visualizzare il passaggio seguente.

Passaggio 6 - Avvio dell'importazione

L'ultimo passaggio della procedura guidata consente di avviare l'importazione dei dati. A tale scopo, fare clic sul pulsante Start.

È quindi possibile monitorare l'esecuzione del processo di importazione (vedere Esecuzione dei processi di monitoraggio.