Configurare le opzioni di formattazione dei file per le destinazioni basate su file

IMPORTANT
Le opzioni di formattazione descritte in questo documento sono attualmente disponibili solo per i file CSV.

L'opzione per configurare varie opzioni di formattazione per i file esportati è disponibile quando si connette a una destinazione basata su file, ad esempio Amazon S3, BLOB di Azure o SFTP.

Puoi configurare varie opzioni di formattazione per i file esportati utilizzando l’interfaccia utente di Experience Platform. È possibile modificare diverse proprietà dei file esportati in modo che corrispondano ai requisiti del sistema di ricezione dei file sul proprio lato, al fine di leggere e interpretare in modo ottimale i file ricevuti da Experience Platform.

Configurazione della formattazione dei file per i file CSV file-configuration

Per visualizzare le opzioni di formattazione del file, avviare il flusso di lavoro connetti alla destinazione. Selezionare Tipo di dati: segmenti e Tipo di file: CSV per visualizzare le impostazioni di formattazione del file disponibili per i file CSV esportati.

IMPORTANT
È possibile che nella destinazione a cui ci si connette non siano disponibili tutte queste opzioni. Spetta allo sviluppatore di destinazione determinare le opzioni di formattazione dei file da supportare nella destinazione. Lo sviluppatore di destinazione può determinare quali opzioni sono disponibili quando si connette alla destinazione. Le opzioni obbligatorie sono contrassegnate da un asterisco nell’interfaccia utente di Experience Platform.
Le destinazioni dell'archiviazione cloud generata dall'Adobe - Amazon S3, Azure Blob, Azure Data Lake Storage Gen2, Data Landing Zone, Google Cloud Storage, SFTP - attualmente supportano solo le sei opzioni CSV evidenziate di seguito.

Immagine che mostra alcune delle opzioni di formattazione del file disponibili.

Delimitatore delimiter

Utilizzare questo controllo per impostare un separatore per ogni campo e valore nei file CSV esportati. Le opzioni disponibili sono:

  • Due punti (:)
  • Virgola (,)
  • Tubazione (|)
  • Punto e virgola (;)
  • Scheda (\t)

Esempi

Visualizza gli esempi seguenti dei contenuti dei file CSV esportati con ciascuna selezione nell’interfaccia utente.

  • Output di esempio con due punti(:) selezionati: male:John:Doe
  • Output di esempio con virgola(,) selezionata: male,John,Doe
  • Output di esempio con pipe(|) selezionata: male|John|Doe
  • Output di esempio con Punto e virgola(;) selezionato: male;John;Doe
  • Output di esempio con scheda(\t) selezionata: male \t John \t Doe

Carattere virgolette quote-character

Utilizzare questa opzione per controllare se le virgolette doppie devono essere rimosse o mantenute all'interno delle stringhe esportate.

Le opzioni disponibili sono:

  • Carattere Null (\0000). Utilizza questa opzione per rimuovere le virgolette doppie dai file CSV esportati.
  • Virgolette ("). Utilizzare questa opzione quando i valori stringa contengono un delimitatore o virgolette doppie. Questa opzione consente di mantenere i delimitatori o le virgolette doppie nei file CSV esportati, in modo da identificare correttamente il valore corrispondente a ciascun campo.

Esempi

Considerare il valore di input Anna,"Doe,John".

Visualizza gli esempi seguenti del contenuto dei file CSV esportati con ciascuna selezione nell’interfaccia utente.

  • Output di esempio con carattere nullo (\0000) selezionato: Anna,Doe,John
  • Output di esempio con virgolette doppie (") selezionate: Anna,"Doe,John"

Carattere di escape escape-character

Utilizzare questa opzione per impostare un singolo carattere per l'escape delle virgolette all'interno di un valore già citato. Questa opzione è utile, ad esempio, quando si dispone di una stringa racchiusa tra virgolette doppie in cui parte della stringa è già racchiusa tra virgolette doppie. Questa opzione determina il carattere con cui sostituire le virgolette doppie interne. Le opzioni disponibili sono:

  • Barra rovesciata (\)
  • Virgoletta singola (')

Esempi

Visualizza gli esempi seguenti del contenuto dei file CSV esportati con ciascuna selezione nell’interfaccia utente.

  • Output di esempio con Barra rovesciata(\) selezionata: "Test,\"John\",LastName"
  • Output di esempio con Virgoletta singola(') selezionata: "Test,'"John'",LastName"

Output valore vuoto empty-value-output

Utilizzare questo controllo per impostare la rappresentazione di stringa di un valore vuoto. Questa opzione determina il modo in cui i valori vuoti vengono rappresentati nei file CSV esportati. Le opzioni disponibili sono:

  • Null (null)
  • Stringa vuota tra virgolette doppie ("")
  • Stringa vuota

Esempi

Visualizza gli esempi seguenti del contenuto dei file CSV esportati con ciascuna selezione nell’interfaccia utente.

  • Output di esempio con null selezionato: male,NULL,TestLastName. In questo caso, Experience Platform trasforma il valore vuoto in un valore nullo.
  • Output di esempio con " selezionato: male,"",TestLastName. In questo caso, Experience Platform trasforma il valore vuoto in una coppia di virgolette.
  • Output di esempio con Stringa vuota selezionata: male,,TestLastName. In questo caso, l’Experience Platform mantiene il valore vuoto e lo esporta così com’è (senza virgolette doppie).
TIP
La differenza tra l’output di un valore vuoto e l’output di un valore nullo nella sezione seguente è che un valore vuoto ha un valore effettivo vuoto. Il valore NULL non ha alcun valore. Considera il valore vuoto come un bicchiere vuoto sul tavolo e il valore nullo come se il bicchiere non fosse affatto sul tavolo.

Output valore nullo null-value-output

Utilizza questo controllo per impostare la rappresentazione stringa di un valore nullo all’interno dei file esportati. Questa opzione determina il modo in cui i valori Null vengono rappresentati nei file CSV esportati. Le opzioni disponibili sono:

  • Null (null)
  • Stringa vuota tra virgolette doppie ("")
  • Stringa vuota

Esempi

Visualizza gli esempi seguenti del contenuto dei file CSV esportati con ciascuna selezione nell’interfaccia utente.

  • Output di esempio con null selezionato: male,NULL,TestLastName. In questo caso, non si verifica alcuna trasformazione e il file CSV contiene il valore null.
  • Output di esempio con " selezionato: male,"",TestLastName. In questo caso, Experience Platform sostituisce il valore null con virgolette doppie intorno a una stringa vuota.
  • Output di esempio con Stringa vuota selezionata: male,,TestLastName. In questo caso, Experience Platform sostituisce il valore null con una stringa vuota (senza virgolette doppie).

Formato di compressione compression-format

Imposta il tipo di compressione da utilizzare per il salvataggio dei dati nel file. Le opzioni supportate sono GZIP e NONE. Questa opzione determina se esportare o meno i file compressi.

Codifica

Non visualizzato nella schermata dell'interfaccia utente. Specifica la codifica (charset) dei file CSV salvati. Le opzioni sono UTF-8 o UTF-16.

Carattere per virgolette di escape

Non visualizzato nella schermata dell'interfaccia utente. Flag che indica se i valori contenenti virgolette devono sempre essere racchiusi tra virgolette.

L'impostazione predefinita prevede l'escape di tutti i valori contenenti una virgoletta.

Separatore di righe

Non visualizzato nella schermata dell'interfaccia utente. Definisce il separatore di riga da utilizzare per la scrittura. La lunghezza massima è di 1 carattere.

Ignora spazio vuoto iniziale

Non visualizzato nella schermata dell'interfaccia utente. Un flag che indica se gli spazi vuoti iniziali dei valori esportati devono essere ignorati o meno.

Output di esempio con True selezionato: "male","John","TestLastName"
Output di esempio con False selezionato: " male","John","TestLastName"

Ignora spazio vuoto finale

Non visualizzato nella schermata dell’interfaccia utente. Un flag che indica se gli spazi vuoti finali dei valori esportati devono essere ignorati o meno.

Output di esempio con True selezionato: "male","John","TestLastName"
Output di esempio con False selezionato: "male ","John","TestLastName"

Passaggi successivi next-steps

Dopo aver letto questo documento, ora sai come configurare le opzioni di esportazione dei file per i file di dati CSV per adattare il contenuto dei file ai requisiti del sistema di ricezione dei file a valle. Successivamente, puoi leggere l'esercitazione sull'attivazione delle destinazioni basate su file per avviare l'esportazione dei file nel percorso di archiviazione cloud preferito.

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6