Configurer des options de formatage de fichier pour les destinations basées sur des fichiers

IMPORTANT
Les options de formatage des fichiers décrites dans ce document ne sont actuellement disponibles que pour les fichiers CSV.

La possibilité de configurer diverses options de formatage des fichiers exportés vous est offerte lorsque vous vous connectez à une destination basée sur des fichiers, telle que Amazon S3, Azure Blob ou SFTP.

Vous pouvez configurer diverses options de formatage des fichiers exportés à l’aide de l’interface utilisateur d’Experience Platform. Vous pouvez modifier plusieurs propriétés des fichiers exportés pour répondre aux exigences du système de réception de fichiers de votre côté, afin de lire et d’interpréter de manière optimale les fichiers provenant d’Experience Platform.

Configuration du formatage des fichiers pour les fichiers CSV file-configuration

Pour afficher les options de formatage du fichier, lancez le workflow Se connecter à la destination. Sélectionnez Type de données : segments et Type de fichier : CSV pour afficher les paramètres de formatage de fichier disponibles pour les fichiers CSV exportés.

IMPORTANT
Toutes ces options ne sont peut-être pas disponibles pour la destination à laquelle vous vous connectez. Il appartient au développeur de la destination de déterminer les options de formatage des fichiers qu’il souhaite prendre en charge dans sa destination. Le développeur de la destination peut déterminer quelles options sont disponibles lors de la connexion à la destination. Les options obligatoires sont marquées d’un astérisque dans l’interface utilisateur d’Experience Platform.
Les destinations de stockage dans le cloud créées par Adobe - Amazon S3, Azure Blob, Azure Data Lake Storage Gen2, Data Landing Zone, Google Cloud Storage, SFTP - ne prennent actuellement en charge que les six options CSV mises en évidence ci-dessous.

Image montrant certaines des options de formatage de fichier disponibles.

Délimiteur delimiter

Utilisez ce contrôle pour définir un séparateur pour chaque champ et valeur dans les fichiers CSV exportés. Les options disponibles sont les suivantes :

  • (:) deux-points
  • (,) virgule
  • (|) de tuyau
  • Point-virgule (;)
  • (\t) d’onglet

Exemples

Consultez les exemples ci-dessous du contenu des fichiers CSV exportés avec chacune des sélections effectuées dans l’interface utilisateur.

  • Exemple de sortie avec Deux-points(:) sélectionné : male:John:Doe
  • Exemple de sortie avec (,) sélectionné : male,John,Doe
  • Exemple de sortie avec Pipe(|) sélectionné : male|John|Doe
  • Exemple de sortie avec Des points-virgules(;) sélectionnés : male;John;Doe
  • Exemple de sortie avec Tab(\t) sélectionné : male \t John \t Doe

Guillemets quote-character

Utilisez cette option pour déterminer si les guillemets doubles doivent être supprimés ou conservés dans les chaînes exportées.

Les options disponibles sont les suivantes :

  • Caractère Null (\0000). Utilisez cette option pour supprimer les guillemets doubles des fichiers CSV exportés.
  • Guillemets doubles ( »). Utilisez cette option lorsque les valeurs de chaîne contiennent un délimiteur ou des guillemets doubles. Cette option vous permet de conserver les délimiteurs ou les guillemets doubles dans vos fichiers CSV exportés, afin que vous puissiez identifier correctement quelle valeur correspond à quel champ.

Exemples

Tenez compte de l’Anna,"Doe,John" de la valeur d’entrée.

Consultez les exemples ci-dessous du contenu des fichiers CSV exportés avec chacune des sélections effectuées dans l’interface utilisateur.

  • Exemple de sortie avec caractère nul (\0000) sélectionné : Anna,Doe,John
  • Exemple de sortie avec Guillemets doubles ( ») sélectionné : Anna,"Doe,John"

Caractère d’échappement escape-character

Utilisez cette option pour définir un caractère unique pour placer les guillemets entre guillemets dans une valeur déjà entre guillemets. Par exemple, cette option est utile lorsque vous avez une chaîne entre guillemets doubles où une partie de la chaîne est déjà entre guillemets doubles. Cette option détermine le caractère par lequel remplacer les guillemets doubles internes. Les options disponibles sont les suivantes :

  • Barre oblique (\)
  • Guillemet (')

Exemples

Consultez les exemples ci-dessous du contenu des fichiers CSV exportés avec chacune des sélections effectuées dans l’interface utilisateur.

  • Exemple de sortie avec Barre oblique inverse(\) sélectionnée : "Test,\"John\",LastName"
  • Exemple de sortie avec Guillemet simple(') sélectionné : "Test,'"John'",LastName"

Sortie de valeur vide empty-value-output

Utilisez ce contrôle pour définir la représentation sous forme de chaîne d'une valeur vide. Cette option détermine la manière dont les valeurs vides sont représentées dans vos fichiers CSV exportés. Les options disponibles sont les suivantes :

  • Null (null)
  • Chaîne vide entre guillemets doubles (« »)
  • Chaîne vide

Exemples

Consultez les exemples ci-dessous du contenu des fichiers CSV exportés avec chacune des sélections effectuées dans l’interface utilisateur.

  • Exemple de sortie avec null sélectionné : male,NULL,TestLastName. Dans ce cas, Experience Platform transforme la valeur vide en valeur nulle.
  • Exemple de sortie avec » » sélectionné : male,"",TestLastName. Dans ce cas, Experience Platform transforme la valeur vide en une paire de guillemets doubles.
  • Exemple de sortie avec Chaîne vide sélectionné : male,,TestLastName. Dans ce cas, l'Experience Platform conserve la valeur vide et l'exporte telle quelle (sans guillemets doubles).
TIP
La différence entre la sortie de valeur vide et la sortie de valeur nulle dans la section ci-dessous est qu’une valeur vide a une valeur réelle qui est vide. La valeur NULL n'a aucune valeur. Pensez à la valeur vide comme à une vitre vide sur la table et à la valeur nulle comme si la vitre n’était pas du tout sur la table.

Sortie de valeur nulle null-value-output

Utilisez ce contrôle pour définir la représentation sous forme de chaîne d’une valeur null dans les fichiers exportés. Cette option détermine comment les valeurs nulles sont représentées dans vos fichiers CSV exportés. Les options disponibles sont les suivantes :

  • Null (null)
  • Chaîne vide entre guillemets doubles (« »)
  • Chaîne vide

Exemples

Consultez les exemples ci-dessous du contenu des fichiers CSV exportés avec chacune des sélections effectuées dans l’interface utilisateur.

  • Exemple de sortie avec null sélectionné : male,NULL,TestLastName. Dans ce cas, aucune transformation ne se produit et le fichier CSV contient la valeur null.
  • Exemple de sortie avec » » sélectionné : male,"",TestLastName. Dans ce cas, Experience Platform remplace la valeur nulle par des guillemets doubles autour d’une chaîne vide.
  • Exemple de sortie avec Chaîne vide sélectionné : male,,TestLastName. Dans ce cas, Experience Platform remplace la valeur null par une chaîne vide (sans guillemets doubles).

Format de compression compression-format

Définit le type de compression à utiliser lors de l’enregistrement de données dans un fichier. Les options prises en charge sont GZIP et NONE. Cette option détermine si vous allez exporter des fichiers compressés ou non.

Encodage

Non affiché dans la capture d’écran de l’interface utilisateur. Indique l’encodage (jeu de caractères) des fichiers CSV enregistrés. Les options sont UTF-8 ou UTF-16.

Caractère pour échapper les guillemets

Non affiché dans la capture d’écran de l’interface utilisateur. Un indicateur précisant si les valeurs contenant des guillemets doivent toujours être placées entre guillemets.

La valeur par défaut est lʼéchappement de toutes les valeurs contenant un guillemet.

Séparateur de ligne

Non affiché dans la capture d’écran de l’interface utilisateur. Définit le séparateur de ligne à utiliser pour l’écriture. Longueur maximale : 1 caractère.

Ignorer l’espace blanc de début

Non affiché dans la capture d’écran de l’interface utilisateur. Indicateur précisant si les espaces de début des valeurs exportées doivent être ignorés.

Exemple de sortie avec Vrai sélectionné : "male","John","TestLastName"
Exemple de sortie avec Faux sélectionné : " male","John","TestLastName"

Ignorer l’espace de fin

Non affiché dans la capture d’écran de l’interface utilisateur. Un indicateur précisant si les espaces blancs de fin de valeurs exportées doivent être ignorés ou non.

Exemple de sortie avec Vrai sélectionné : "male","John","TestLastName"
Exemple de sortie avec Faux sélectionné : "male ","John","TestLastName"

Étapes suivantes next-steps

Après avoir lu ce document, vous savez maintenant comment configurer les options d’exportation de vos fichiers de données CSV pour adapter le contenu du fichier aux exigences de votre système de réception de fichiers en aval. Vous pouvez ensuite lire le tutoriel d’activation des destinations basées sur les fichiers pour commencer à exporter des fichiers vers votre emplacement de stockage dans le cloud préféré.

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