Requisiti dei file ETL

Denominazione dei file ed estensioni

• Tutti i file devono essere in formato CSV RFC-4180.
• La codifica dei caratteri deve essere UTF-8 e tutte le lunghezze massime sono in byte con codifica UTF-8.
• I file ETL possono essere compressi e crittografati. Le estensioni di file compressi valide sono .zip e .gz. L'estensione di crittografia valida è .pgp.
• I file non vengono elaborati a meno che i nomi dei file non corrispondano alla struttura definita degli schemi dei feed di dati ETL. Non è possibile personalizzare lo schema di un file ETL.
• Assicurarsi che il formato di denominazione dei file sia coerente per ogni feed di dati. Nella maggior parte delle condizioni, il nome del feed di dati ETL è seguito da una data e un'ora, ad esempio user-yyyy-mm-dd_hh-mm-ss.csv. Personalizzazione di Marketing Cloud utilizza la data per elaborare i file in ordine quando vengono caricati più file contemporaneamente.
• Quando si inviano file da Automation Studio per l'elaborazione ETL, omettere di utilizzare minuti e secondi nei nomi dei file. Cioè, quando si elabora più di un file al giorno da Automation Studio, assegnare un nome ai file nel formato user-yyyy-mm-dd_hh.csv. Quando si elabora un solo file al giorno da Automation Studio, assegnare un nome ai file nel formato user-yyyy-mm-dd.csv.

Struttura intestazione file

I file elaborati dai componenti ETL integrati vengono gestiti in modo coerente indipendentemente dal tipo di ETL. Alcuni tipi di feed di dati hanno accesso a definizioni di intestazione aggiuntive a causa del tipo di dati di destinazione, ma i campi in genere rientrano in alcune categorie diverse.

Frequenza

Il sistema Ingranaggi di personalizzazione ha un listener incorporato per i file nel sito SFTP. Ogni 15 minuti, ogni feed di dati ETL abilitato controlla nella directory di /dataset/inbound la presenza di file che corrispondono alla struttura del nome file prevista per quel singolo feed di dati. Il consiglio generale per la frequenza di elaborazione dei file è giornaliero. Tuttavia, se è necessario elaborare i file con maggiore frequenza o si desidera aggiornare dati non aggiornati, valutare la possibilità di caricare i file ogni ora. Caricamenti più frequenti assicurano che il sistema abbia il tempo di elaborare completamente i file, evitando la formazione di un'area di attesa di elaborazione dei file.

Campi di sistema

La personalizzazione ha diversi campi di sistema incorporati per supportare gli attributi. I campi di sistema disponibili per ogni tipo di feed di dati ETL variano e hanno processi di gestione espliciti. La creazione di attributi con lo stesso nome di un attributo di sistema provoca conseguenze negative per i dati, ad esempio quando si include l'attributo name di un elemento in un file ETL Prodotto. Sebbene "nome" sia un campo di sistema, Personalizzazione legge da un'intestazione di colonna "attribute:name". La creazione di un attributo personalizzato denominato "name" per l'oggetto Catalogo prodotti nella pagina Oggetti catalogo e profilo può avere conseguenze negative durante l'elaborazione ETL.

Reimpostazione dei valori predefiniti

Ad eccezione del feed di dati ETL Utente, tutti i feed di dati ETL possono ripristinare i valori predefiniti dei campi (tranne nei casi in cui il campo sia obbligatorio, ad esempio un ID). La reimpostazione di un valore avviene quando un record ha un valore vuoto per una colonna durante l'elaborazione. Personalizzazione considera nulla l'assenza di un valore e rimuove tutti i valori esistenti per quella chiave nel record in Personalizzazione. È possibile utilizzare questo processo per rimuovere una vecchia descrizione per un articolo, rimuovere un attributo personalizzato per una transazione o rimuovere categorie per un prodotto.

La personalizzazione prevede che ogni record abbia un valore corrispondente per ogni colonna, anche in un file delta.

Esistono alcuni campi di sistema i cui valori annullati sono leggermente diversi da un valore assente. Alcune di queste chiavi sono valide solo per un sottoinsieme di tipi ETL, ma sono tutte elencate in questa tabella.

Errori e registrazione

• Se un'intestazione di colonna non corrisponde a un campo di sistema, a un attributo personalizzato o a un'altra intestazione di colonna valida nello schema di un feed di dati ETL, Personalizzazione non carica tali record. Si verifica un errore quando un valore di colonna non riflette dati validi.
• Se si verifica un errore che indica "Attenzione: Almeno un Prodotto è archiviato. Gli aggiornamenti non saranno visibili nell'interfaccia utente", significa che almeno uno degli elementi nel file ETL è in stato di archiviazione. Un elemento viene archiviato quando si include l'intestazione della colonna attribute:archived e un valore true nel file ETL o quando si fa clic su Elimina accanto all'elemento nel catalogo. Per annullare l'archiviazione di un elemento, verificare che la colonna attribute:archived sia nel file ETL e che l'elemento abbia il valore false.
• Un errore che indica "estrazione non riuscita molto probabilmente a causa di una colonna o delimitatore di riga" indica che un file presenta errori di carattere, ad esempio virgolette doppie non chiuse o virgole aggiuntive in un valore.
• Quando si verificano errori per un feed di dati ETL, Personalizzazione registra ogni messaggio di errore nel dialogo Registri. I registri includono il numero di riga del file che causa un errore.
• La personalizzazione non esegue un processo ETL quando la soglia di errore raggiunge il 10%. Non è possibile modificare la soglia di errore.
• Se un campo di un record non viene mappato correttamente al tipo di dati indicato dalla relativa intestazione, Personalizzazione ignora il record e non lo carica. Se sono presenti abbastanza istanze di questo tipo di errore, Personalizzazione non riesce a eseguire l'intero file ETL.

Limiti dei feed

Per informazioni sui limiti dei feed, vedere Limiti per Personalizzazione di Marketing Cloud.

Limiti delle dimensioni dei file

Per informazioni sui limiti consigliati per le dimensioni dei file, vedere Limiti per Personalizzazione di Marketing Cloud.