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.
Puoi importare i dati senza mapparli con i dati del database utilizzando Import a list funzione . I dati possono quindi essere utilizzati esclusivamente nei flussi di lavoro tramite il Read list oggetto. Per ulteriori informazioni, consulta questa pagina.
La procedura guidata di importazione consente di configurare un’importazione, di definirne le opzioni (ad esempio la trasformazione dei dati) e di avviarne 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.
Viene visualizzata la procedura guidata di importazione dopo la creazione di un nuovo processo di importazione (consulta Creazione di processi di importazione ed esportazione.
Se utilizzi un server Web IIS, potrebbe essere necessaria una configurazione per autorizzare il caricamento di file di grandi dimensioni (>28 MB). Per ulteriori informazioni, consulta questa sezione.
Nel file di origine, ogni riga coincide con un record. I dati contenuti nei record sono separati da delimitatori (spazio, tabulazione, carattere, ecc.). Ciò significa che i dati vengono recuperati sotto forma di colonne e che ogni colonna è associata a un campo del database.
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, effettua le seguenti operazioni:
Seleziona la Profiles and Targets > Job > Generic imports and exports cartella.
Fai clic su Nuovo quindi fai clic su Importa per creare il modello di importazione.
Fai clic sulla freccia a destra della Import template per selezionare il modello, oppure fai clic su Select link per sfogliare l'albero.
Il modello nativo è New text import. Questo modello non deve essere modificato, ma puoi duplicarlo per configurarne uno nuovo in base ai tuoi requisiti. Per impostazione predefinita, i modelli di importazione vengono salvati in Profiles and targets > Templates > Job templates nodo.
Immettere un nome per l'importazione nella Label campo . Puoi aggiungere una descrizione.
Seleziona il tipo di importazione nel campo appropriato. Esistono due tipi possibili di importazione: Simple import per importare un solo file, e Multiple import per importare più file in una singola esecuzione.
Per un’importazione multipla, seleziona Multiple import dal Import type elenco a discesa nella prima schermata della procedura guidata di importazione.
Specifica i campi da importare facendo clic su Add.
Ogni volta che viene aggiunto un file, la schermata File to import viene visualizzata la procedura guidata. Vedere la sezione Passaggio 2: selezione dei file di origine e segui i passaggi della procedura guidata per definire le opzioni di importazione come per una semplice importazione.
Le importazioni multiple devono soddisfare solo esigenze specifiche e non sono raccomandate.
La Advanced parameters link consente di accedere alle seguenti opzioni:
General scheda
Stop execution if there are too many rejects
Questa opzione è selezionata per impostazione predefinita. Puoi deselezionare questa opzione se desideri continuare a eseguire l’importazione indipendentemente dal numero di rifiuti. Per impostazione predefinita, l’esecuzione viene interrotta se le prime 100 righe vengono rifiutate.
Trace mode
Seleziona 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. Ti consente di scollegare l’esecuzione dell’importazione in modo che non influisca sugli altri processi in corso sul database.
Do not update enumerations
Selezionare questa opzione per evitare di arricchire l’elenco dei valori enumerati nel database. Vedi Gestire le enumerazioni.
Variables scheda
Puoi definire le variabili associate al processo che saranno accessibili negli editor delle query e nei campi calcolati. Per creare una variabile, fai clic su Add e utilizza l'editor di variabili.
La Variables è solo per uso di programmazione di tipo Workflow e deve essere configurato solo da utenti esperti.
Il file di origine può essere in formato testo (txt, csv, tab, fixed columns) o xml.
Per impostazione predefinita, Upload file on the server è selezionato. Fai clic sulla cartella a destra del Local file per sfogliare il disco locale e selezionare il file da importare. È possibile 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. In questa anteprima vengono visualizzate le prime 200 righe del file di origine.
Utilizza le opzioni offerte in questa visualizzazione per configurare l’importazione. I parametri definiti tramite queste opzioni vengono trasferiti nell’anteprima. Sono disponibili le seguenti opzioni:
La 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 ti consente di descrivere la lettura dei valori dei campi 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, si verificheranno dei rifiuti durante l’importazione.
Puoi visualizzare il risultato della configurazione nella zona di anteprima nella parte inferiore della finestra.
Fai clic su OK per salvare la formattazione, fare clic su Next per visualizzare il passaggio successivo.
È quindi necessario selezionare lo schema di destinazione e mappare i dati di ciascuna colonna sui campi del database.
La Destination schema consente di selezionare lo schema in cui verranno importati i dati. Queste informazioni sono obbligatorie. Fai clic sul pulsante Select link per selezionare uno degli schemi esistenti. Fai 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, fai clic sulla casella di controllo per selezionare il campo di origine, quindi fai clic sulla seconda colonna per attivare la cella corrispondente al campo selezionato. Fai clic su Edit expression per visualizzare tutti i campi della tabella corrente. Seleziona il campo di destinazione e fai clic su OK per convalidare la mappatura.
Per associare automaticamente i campi di origine e di destinazione, fare clic sul pulsante Guess the destination fields a destra dell’elenco dei campi. Se necessario, i campi proposti possono essere modificati.
Il risultato di questa operazione deve sempre essere convalidato prima di procedere al passaggio successivo.
È possibile applicare una trasformazione ai campi importati. A questo scopo, fai clic nella cella del Transformation colonna relativa al campo interessato e selezionare la trasformazione da applicare.
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), questi vincoli hanno la priorità.
Puoi aggiungere campi calcolati utilizzando l’icona appropriata, situata 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.
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. Tuttavia, non è possibile effettuare operazioni di riconciliazione 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 "sì" 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, ecc.
Enumeration: il valore del campo viene attribuito in base a un valore contenuto nel file di origine. L’editor ti consente di specificare la colonna sorgente e di inserire l’elenco dei valori di enumerazione, come nell’esempio seguente:
La Preview consente di visualizzare il risultato della configurazione definita. Qui, il Subscription è stata aggiunta una colonna . Il valore viene calcolato dalla variabile Stato campo .
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 quelli 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 in cui verranno importati i dati.
Sono disponibili opzioni speciali per ciascun nodo (tabella o campo). Quando fai clic sul nodo interessato nell’elenco, sotto vengono visualizzati i relativi parametri e una breve descrizione. Il comportamento definito per ogni elemento viene visualizzato nel corrispondente Behavior colonna.
Per ogni tabella interessata dall’importazione, è necessario definire il tipo di operazione. Per l'elemento principale del database sono disponibili le seguenti operazioni:
Per ciascun campo della tabella interessata dall’importazione sono disponibili le seguenti opzioni:
La definizione di chiave di riconciliazione è sempre obbligatorio, tranne nel caso di inserimento senza deduplicazione.
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 specificare una seconda chiave di riconciliazione per la stessa tabella; viene utilizzato per le righe la cui prima chiave è vuota.
Evita di scegliere un campo che potrebbe essere modificato durante l'importazione; in questo caso, il motore potrebbe creare record aggiuntivi.
Per l’importazione di un destinatario, l’identificatore della cartella selezionata viene aggiunto implicitamente alla chiave.
La riconciliazione viene quindi eseguita solo su questa cartella (a meno che non sia selezionata alcuna cartella).
Un "doppio" è un elemento che esiste due o più volte nel file da importare.
Un 'duplicato' è un elemento presente sia nel file da importare che nel database.
La Management of doubles consente di configurare la deduplicazione dei dati. La deduplicazione riguarda i record che vengono visualizzati più volte nel file di origine (o file di origine in caso di importazione di più file), ovvero righe per le quali i campi della chiave di riconciliazione sono identici.
La deduplicazione viene eseguita solo in memoria. Le dimensioni di un’importazione con deduplicazione sono pertanto limitate. Il limite dipende da diversi parametri (capacità dell’application server, attività, numero di campi nella chiave, ecc.). La dimensione massima di una deduplicazione è dell’ordine di 1.000.000 righe.
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). La Duplicate management consente di aggiornare o ignorare il record se si trova sia nel file di origine che nel database. La Update or insert based on origin l’opzione appartiene al modulo facoltativo e non può essere utilizzata in un contesto standard.
Le opzioni Reject e Ignore funzionano come indicato sopra.
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 il Rejects scheda .
Esistono due tipi di rifiuti (il tipo viene visualizzato nel Connector colonna):
Nella pagina di riconciliazione dei dati puoi 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: l'importazione si interrompe e tutti gli elementi del record vengono rifiutati.
La struttura nella schermata di rifiuto di un'istanza di importazione indica quali campi sono stati rifiutati e dove si sono verificati gli errori.
Puoi generare un file contenente questi record tramite la Export rejects icona:
Il passaggio successivo della procedura guidata di importazione ti consente di selezionare o creare la cartella in cui verranno importati i dati, mappare automaticamente i destinatari importati con un elenco (nuovo o esistente) e abbonare i destinatari a un servizio.
Questo passaggio viene visualizzato solo durante l’importazione dei destinatari e quando si utilizza la tabella dei destinatari predefinita di Adobe Campaign (nms:recipient).
Fai clic sul pulsante Edit collegamenti per selezionare la cartella, l’elenco o il servizio a cui si desidera associare o sottoscrivere i destinatari.
Importazione in una cartella
La Edit… collegamento 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.
La cartella predefinita di un operatore è la prima cartella per la quale l’operatore dispone dell’accesso in scrittura. Ulteriori informazioni in Gestione dell'accesso alle cartelle.
Per selezionare la cartella di importazione, fai clic sulla freccia a destra della Folder e selezionare la cartella interessata. È inoltre possibile utilizzare Select link per visualizzare la struttura ad albero in una nuova finestra o crearne una nuova.
Per creare una nuova cartella, selezionare il nodo da cui si desidera aggiungere una cartella e fare clic con il pulsante destro del mouse su di essa. Seleziona Create a new ‘Recipients’ folder.
La cartella viene aggiunta sotto il nodo corrente. Immettere il nome della nuova cartella, premere Invio per confermare, quindi fare clic su OK.
Associazione a un elenco
La Edit… nel collegamento Add recipients to a list consente di selezionare o creare un elenco in cui importare i destinatari.
Puoi creare un nuovo elenco per questi destinatari facendo clic su Select link, quindi Create. La creazione e la gestione degli elenchi sono presentate in questa sezione.
Puoi decidere di aggiungere i destinatari a quelli già presenti in un elenco o 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.
Iscrizione a un servizio
Per abbonare tutti i destinatari importati a un servizio di informazioni, fai clic sul pulsante Edit… collegamento Subscribe recipients to a service per selezionare o creare il servizio informazioni a cui i destinatari verranno abbonati. È possibile selezionare la Send a confirmation message opzione: Il contenuto di questo messaggio è definito nel modello di consegna associato al servizio di abbonamento.
Puoi creare un nuovo servizio per questi destinatari facendo clic su Select link e poi Create icona. La gestione dei servizi di informazione è presentata in questa sezione.
Utilizza la Origin per aggiungere informazioni sull’origine dei destinatari ai loro profili. Tali informazioni sono particolarmente utili nel quadro di un’importazione multipla.
Fai clic su Next per convalidare questo passaggio e visualizzare il passaggio seguente.
L’ultimo passaggio della procedura guidata consente di avviare l’importazione dei dati. A questo scopo, fai clic sul pulsante Start pulsante .
Puoi quindi monitorare l’esecuzione del processo di importazione (vedi Monitorare l’esecuzione dei processi.