[Applicabile anche a v8]{class="badge positive" title="Applicabile anche a Campaign v8"}
Configurare i processi di importazione executing-import-jobs
Adobe Campaign consente di importare nel database dati 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.
L’importazione guidata consente di configurare un’importazione, definirne le opzioni (ad esempio, la trasformazione dei dati) e 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.
L’Importazione guidata viene visualizzata dopo la creazione di un nuovo processo di importazione (consulta Creare processi di importazione ed esportazione.
File sorgente source-file
Nel file di origine, ogni riga coincide con un record. I dati 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.
Passaggio 1: scegliere il modello di importazione step-1---choosing-the-import-template
Quando si avvia l'importazione guidata, è 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.
-
Clic Nuovo e quindi fare clic su Importa per creare il modello di importazione.
-
Fare clic sulla freccia a destra della Import template per selezionare il modello, oppure fare 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 a seconda delle tue esigenze. Per impostazione predefinita, i modelli di importazione vengono salvati in Profiles and targets > Templates > Job templates nodo.
-
Immetti un nome per questa importazione in Label campo. Puoi aggiungere una descrizione.
-
Seleziona il tipo di importazione nel campo appropriato. Esistono due possibili tipi 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 nella prima schermata dell'importazione guidata.
-
Specificare 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 del file di origine e segui i passaggi della procedura guidata per definire le opzioni di importazione come per un’importazione semplice.
note note NOTE Le importazioni multiple devono soddisfare solo esigenze specifiche e non sono consigliate.
Parametri avanzati advanced-parameters
Il Advanced parameters Il collegamento ti consente di accedere alle seguenti opzioni:
-
General scheda
-
Stop execution if there are too many rejects
Questa opzione è selezionata per impostazione predefinita. Puoi deselezionarla 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
Selezionare 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 su altri processi in corso nel database.
-
Do not update enumerations
Selezionare questa opzione per evitare di arricchire l'elenco dei valori enumerati nel database. Consulta 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 delle variabili.
note important IMPORTANT Il Variables La scheda è solo per l’utilizzo di programmazione di tipo Flusso di lavoro e deve essere configurata solo da utenti esperti.
Passaggio 2: selezione del file di origine step-2---source-file-selection
Il file di origine può essere in formato testo (txt, csv, tab, colonne fisse) o xml.
Per impostazione predefinita, Upload file on the server è selezionato. Fai clic sulla cartella a destra della 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 si trova sul server.
Una volta specificato il file, è possibile visualizzarne i dati nella sezione inferiore della finestra facendo clic su Auto-detect format. Questa anteprima mostra le prime 200 righe del file di origine.
Utilizza le opzioni offerte sopra questa vista 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 Upload file on the server è selezionato.
- 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 il Click here to change the file format… opzione.
- Il Advanced parameters consente di filtrare i dati di origine e di accedere alle opzioni avanzate. Da questa schermata, puoi scegliere di importare solo una parte del file. Puoi anche definire un filtro, ad esempio per importare solo gli utenti di tipo "Potenziale cliente" o "Cliente", in base al valore della riga corrispondente. Queste opzioni devono essere utilizzate solo da utenti JavaScript esperti.
Modificare il formato del file changing-the-file-format
Il 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 seguente finestra:
Questo passaggio ti consente di descrivere come leggere 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.
È possibile visualizzare il risultato della configurazione nella zona di anteprima nella parte inferiore della finestra.
Clic OK per salvare la formattazione, fai clic su Next per visualizzare il passaggio successivo.
Passaggio 3: mappatura dei campi step-3---field-mapping
È quindi necessario selezionare lo schema di destinazione e mappare i dati di ciascuna colonna sui campi del database.
-
Il Destination schema consente di selezionare lo schema in cui importare i dati. Queste informazioni sono obbligatorie. Fai clic su Select link per selezionare uno degli schemi esistenti. Clic 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 ad essi 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. Quindi, 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.
note important IMPORTANT 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 su nella cella del Transformation che si riferisce al campo in questione e selezionare la trasformazione da applicare.
note important IMPORTANT La trasformazione viene applicata al momento dell’importazione. Tuttavia, se sono stati definiti vincoli sul campo di destinazione (nell’esempio precedente, sul campo di @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à, consulta le sezioni seguenti.
Campi calcolati calculated-fields
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 di 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, potete 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 a un valore contenuto nel file di origine. L’editor consente di specificare la colonna di origine e di immettere l’elenco dei valori di enumerazione, come nell’esempio seguente:
Il Preview Questa scheda ti consente di visualizzare il risultato della configurazione definita. Ecco, il Subscription è stata aggiunta la colonna. Il valore viene calcolato dalla Stato campo.
Passaggio 4 - Riconciliazione step-4---reconciliation
Il passaggio di riconciliazione dell’importazione guidata 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 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, di seguito vengono visualizzati i relativi parametri e una breve descrizione. Il comportamento definito per ciascun elemento viene visualizzato nel Behavior colonna.
Tipi di operazioni types-of-operation
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 esiste nel database e, in caso contrario, lo crea.
- 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, ti 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 ogni 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 rimuove il valore del database se il campo è vuoto nel file di origine. In caso contrario, viene mantenuto il campo del database.
- Update only if destination is empty: il valore del file di origine non sovrascrive il valore del campo del database a meno che il campo del database non sia vuoto. In tal caso, assume 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 dei file di origine nuovi.
Chiavi riconciliazione reconciliation-keys
Per gestire la deduplicazione è necessario specificare 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 dell’account, il campo "e-mail" o i campi "Cognome, Nome, Società" e così via.
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. Una seconda chiave di riconciliazione può essere compilata per la stessa tabella; viene utilizzata 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.
Deduplica deduplication
Il Management of doubles consente di configurare la deduplicazione dei dati. La deduplicazione riguarda i record 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.
- Gestione duplicata in Update (modalità predefinita) non esegue la deduplicazione. L'ultimo record ha quindi la priorità (in quanto aggiorna i dati dei record precedenti). Il conteggio dei duplicati non viene eseguito in questa modalità.
- Gestione duplicata in Ignore modalità o Reject entity esclude i duplicati dall’importazione. In questo caso, non viene importato alcun record.
- In entrata Reject entity , l’elemento non viene importato e nei registri di importazione viene generato un errore.
- In entrata Ignore , l’elemento non viene importato, ma non viene mantenuta alcuna traccia dell’errore. Questa modalità ti 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 (ovvero Update and insertion o Update). Il Duplicate management consente di aggiornare o ignorare il record se si trova sia nel file di origine che nel database. Il Update or insert based on origin L'opzione appartiene al modulo opzionale e non può essere utilizzata in un contesto standard.
Le opzioni Reject e Ignore operare come indicato sopra.
In caso di errore behavior-in-the-event-of-an-error
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 gli avvisi generati dal motore di importazione vengono memorizzati e collegati all’istanza di importazione.
I dettagli di questi rifiuti possono essere visualizzati tramite Rejects scheda.
Esistono due tipi di rifiuto (il tipo viene visualizzato nel Connector colonna):
- I rifiuti del connettore di testo riguardano errori che si verificano durante l’elaborazione della riga di 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. In caso di 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, puoi definire il tipo di gestione degli errori desiderato, campo 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: viene rifiutata l’intera riga del record, non solo il campo che ha causato l’errore.
-
Reject all elements: l’importazione viene interrotta 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 Export rejects icona:
Passaggio 5: passaggio aggiuntivo durante l’importazione dei destinatari step-5---additional-step-when-importing-recipients
Il passaggio successivo dell’importazione guidata 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.
-
Fai clic su Edit collegamenti per selezionare la cartella, l'elenco o il servizio a cui si desidera associare o sottoscrivere i destinatari.
-
Importazione in una cartella
Il Edit… collegamento del 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.
note note NOTE 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, fare clic sulla freccia a destra della Folder e selezionare la cartella interessata. È inoltre possibile utilizzare Select link per visualizzare la struttura in una nuova finestra o creare una nuova cartella.
Per creare una nuova cartella, seleziona il nodo da cui desideri aggiungere una cartella e fai clic con il pulsante destro del mouse. Seleziona Create a new ‘Recipients’ folder.
La cartella viene aggiunta sotto il nodo corrente. Inserisci il nome della nuova cartella, premi Invio per confermare, quindi fai clic su OK.
-
Associazione a un elenco
Il Edit… collegamento in Add recipients to a list consente di selezionare o creare un elenco in cui verranno importati i destinatari.
Per creare un nuovo elenco per questi destinatari, fai 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 ricrearlo 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 del Subscribe recipients to a service per selezionare o creare il servizio di informazioni a cui i destinatari saranno abbonati. È possibile selezionare Send a confirmation message opzione: il contenuto di questo messaggio è definito nel modello di consegna associato al servizio di abbonamento.
Per creare un nuovo servizio per questi destinatari, fai clic su Select link e quindi il Create icona. La gestione dei servizi di informazione è presentata in questa sezione.
-
-
Utilizza il Origin per aggiungere informazioni sull’origine dei destinatari ai loro profili. Queste informazioni sono particolarmente utili nel quadro di un’importazione multipla.
Clic Next per convalidare questo passaggio e visualizzare il passaggio seguente.
Passaggio 6: avviare l’importazione step-6---launching-the-import
L’ultimo passaggio della procedura guidata consente di avviare l’importazione dei dati. A questo scopo, fai clic su Start pulsante.
Puoi quindi monitorare l’esecuzione del processo di importazione (consulta Monitorare l’esecuzione dei processi.