Caricamento dati (file) data-loading-file

Utilizzare use

L'attività Data loading (File) ti consente di accedere direttamente a un'origine di dati esterni e di utilizzarla in Adobe Campaign. Infatti, tutti i dati necessari per le operazioni di targeting non sempre si trovano nel database di Adobe Campaign: possono essere resi disponibili in file esterni.

Il file da caricare può essere specificato dalla transizione o calcolato durante l’esecuzione di questa attività. Ad esempio, può essere l’elenco dei 10 prodotti preferiti di un cliente i cui acquisti vengono gestiti in un database esterno.

La sezione superiore della finestra di configurazione per questa attività ti consente di definire il formato del file. A questo scopo, utilizza un file di esempio con lo stesso formato di quello da importare. Questo file può essere archiviato localmente o sul server.

CAUTION
Sono supportati solo i file con struttura "flat" (ad esempio CSV, TXT, ecc.). Non è consigliabile utilizzare il formato XML.

Applica fase di pre-elaborazione pre-processing

È possibile definire un pre-processo da eseguire durante l'importazione dei file, ad esempio per non dover decomprimere il file sul server (e quindi risparmiare spazio per il file decompresso) ma per includere la decompressione nell'elaborazione dei file. Scopri come decomprimere o decrittografare un file prima dell'elaborazione.

A tale scopo, selezionare l'opzione Pre-process the file e scegliere una delle tre opzioni seguenti: None, Decompression (zcat) o Decrypt (gpg).

CAUTION
Se si utilizza una distribuzione ibrida o on-premise, i comandi di pre-elaborazione potrebbero non funzionare come preconfigurati, in quanto la configurazione predefinita utilizza 'zcat', che non è disponibile in Windows. In tal caso, è necessario modificare il nodo preProcessCommand nel file di configurazione del server (serverConf.xml) in base alle proprie esigenze. Scopri come configurare i comandi di pre-elaborazione nel file di configurazione del server

Definizione del formato del file defining-the-file-format

Quando si carica un file, il formato colonna viene rilevato automaticamente con i parametri predefiniti per ogni tipo di dati. È possibile modificare questi parametri predefiniti al fine di specificare i processi specifici da applicare ai dati, in particolare in caso di errore o di valore vuoto.

A tale scopo, selezionare Click here to change the file format… nella finestra principale dell'attività Data loading (file). Viene visualizzata la finestra dei dettagli del formato.

È quindi possibile modificare la formattazione generale del file e la formattazione di ogni colonna.

La formattazione generale del file consente di definire il modo in cui le colonne verranno riconosciute (codifica file, separatori utilizzati, ecc.).

La formattazione della colonna ti consente di definire il valore di elaborazione di ciascuna colonna:

NOTE
Puoi aggiungere tutte le colonne che desideri. La lunghezza massima dei valori in ogni colonna è determinata dal tipo di dati scelto.
  • Ignore column: non elabora questa colonna durante il caricamento dei dati.

  • Data type: specifica il tipo di dati previsto per ogni colonna.

  • Allow NULLs: specifica come gestire i valori vuoti.

    • Adobe Campaign default: genera un errore solo per i campi numerici, altrimenti inserisce un valore NULL.
    • Empty value allowed: autorizza valori vuoti. Pertanto, viene inserito il valore NULL.
    • Always populated: se un valore è vuoto, genera un errore.
  • Length: specifica il numero massimo di caratteri per il tipo di dati string.

  • Format: definisce il formato di data e ora.

  • Data transformation: definisce se è necessario applicare un processo relativo alle maiuscole/minuscole dei caratteri a una stringa.

    • None: la stringa importata non è modificata.
    • First letter in upper case: la prima lettera di ogni parola della stringa inizia con una maiuscola.
    • Upper case: tutti i caratteri nella stringa sono in maiuscolo.
    • Lower case: tutti i caratteri nella stringa sono in minuscolo.
  • White space management: specifica se alcuni spazi devono essere ignorati in una stringa. Il valore Ignore spaces consente di ignorare solo gli spazi all'inizio e alla fine di una stringa.

  • Error processings: definisce il comportamento in caso di errore.

    • Ignore the value: il valore viene ignorato. Nel registro di esecuzione del flusso di lavoro viene generato un avviso.
    • Reject line: l’intera linea non viene elaborata.
    • Use a default value in case of error: sostituisce il valore che causava l’errore con uno predefinito, definito nel campo Default value.
    • Reject the line when there is no remapping value: l'intera riga viene elaborata solo se è stata definita una mappatura per il valore errato (vedere l'opzione Mapping di seguito).
    • Use a default value in case the value is not remapped: sostituisce il valore che causava l'errore con un valore predefinito, definito nel campo Default value, a meno che non sia stata definita una mappatura per il valore errato (vedere l'opzione Mapping di seguito).
  • Default value: specifica il valore predefinito in base all’elaborazione dell’errore selezionata.

  • Mapping: questo campo è disponibile solo nella configurazione dei dettagli delle colonne (accessibile tramite un doppio clic o tramite le opzioni a destra dell'elenco delle colonne). Questo trasforma alcuni valori quando vengono importati. Ad esempio, puoi trasformare "tre" in "3".

Esempio: raccolta dei dati e caricamento nel database example--collecting-data-and-loading-it-in-the-database

L'esempio seguente consente di raccogliere un file sul server ogni giorno, caricarne il contenuto e aggiornare i dati nel database in base alle informazioni in esso contenute. Il fascicolo da raccogliere contiene informazioni sui clienti che possono aver effettuato acquisti (per un valore superiore o inferiore a 3,000 euro), chiesto un rimborso su un acquisto o visitato il negozio senza acquistare nulla. A seconda di queste informazioni, vari processi verranno applicati al loro profilo nel database.

  1. Il raccoglitore di file consente di recuperare i file memorizzati in una directory, a seconda della frequenza specificata.

    La scheda Directory contiene informazioni sui file da recuperare. Nel nostro esempio, verranno recuperati tutti i file in formato testo i cui nomi contengono la parola "clienti" e che sono memorizzati nella directory tmp/Adobe/Data/files del server.

    L'utilizzo di File collector è descritto nella sezione Raccoglitore file.

    La scheda Schedule consente di pianificare l'esecuzione dell'agente di raccolta, ovvero di specificare la frequenza con cui verrà verificata la presenza di questi file.

    In questo caso, vogliamo attivare il raccoglitore ogni giorno alle 21.

    A tale scopo, fare clic sul pulsante Change… situato nella sezione inferiore destra dello strumento di modifica e configurare la pianificazione.

    Per ulteriori informazioni, consulta Scheduler.

  2. Quindi configura l’attività di caricamento dei dati (file) per indicare come devono essere letti i file raccolti. A questo scopo, seleziona un file di esempio con la stessa struttura dei file da caricare.

    In questo caso, il file contiene cinque colonne:

    • la prima colonna contiene un codice che coincide con l’evento: acquisto (più o meno di 3.000 euro), nessun acquisto o rimborso per uno o più acquisti.
    • le quattro colonne seguenti contengono il nome, il cognome, l’e-mail e il numero di account del cliente.

    La configurazione del formato del file da caricare coincide con quella definita durante un’importazione di dati in Adobe Campaign. Per ulteriori informazioni, consulta questa sezione.

  3. Nell'attività divisa, specificare i sottoinsiemi da creare, in base al valore della colonna Event.

    L’attività Dividi è descritta nella sezione.

    Per ogni sottoinsieme, specifica uno dei valori nella colonna Evento.

    L'attività Split conterrà pertanto le seguenti informazioni:

  4. Specificare quindi i processi da eseguire per ciascun tipo di popolazione. Nel nostro esempio, andremo a Update the data nel database. A questo scopo, inserisci un'attività Update data alla fine di ogni transizione in uscita dall'attività divisa.

    L'attività Update data è descritta nella sezione Update data.

recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1