DocumentationExperience PlatformGuide des destinations

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

Last update: Wed Aug 28 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Administration
  • Utilisateur ou utilisatrice
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 de fichier, démarrez le workflow se connecter à la destination. Sélectionnez Type de données : Segments et Type de fichier : CSV pour afficher les paramètres de mise en forme 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 intégrées par l’Adobe - Amazon S3, Azure Blob, Azure Data Lake Storage Gen2, Data Landing Zone, Stockage dans le cloud Google, 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 (,)
  • Pipe (|)
  • Point-virgule (;)
  • Onglet (\t)

Exemples

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

  • Exemple de sortie avec Colon(:) sélectionné : male:John:Doe
  • Exemple de sortie avec Comma(,) sélectionné : male,John,Doe
  • Exemple de sortie avec Pipe(|) sélectionné : male|John|Doe
  • Exemple de sortie avec Semicolon(;) sélectionné : male;John;Doe
  • Exemple de sortie avec Tab(\t) sélectionné : male \t John \t Doe

Guillemets quote-character

Utilisez cette option pour contrôler 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 nul (\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 permet de conserver les délimiteurs ou les guillemets doubles dans les fichiers CSV exportés, afin que vous puissiez identifier correctement la valeur qui correspond au champ.

Exemples

Examinez la valeur d’entrée Anna,"Doe,John".

Affichez les exemples ci-dessous du contenu des fichiers CSV exportés avec chacune des sélections 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 échapper les 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 à remplacer par les guillemets doubles internes. Les options disponibles sont les suivantes :

  • Barre oblique inverse (\)
  • Guillemet simple (')

Exemples

Affichez les exemples ci-dessous du contenu des fichiers CSV exportés avec chacune des sélections 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 le mode de représentation des valeurs vides dans les fichiers CSV exportés. Les options disponibles sont les suivantes :

  • Null (null)
  • Chaîne vide dans les guillemets doubles (""")
  • Chaîne vide

Exemples

Affichez les exemples ci-dessous du contenu des fichiers CSV exportés avec chacune des sélections 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ée : 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 valeur vide et la sortie valeur nulle dans la section ci-dessous est qu’une valeur vide a une valeur réelle vide. La valeur NULL n’a aucune valeur. Considérez la valeur vide comme une vitre vide sur la table et la valeur nulle comme ne comportant pas du tout de vitre 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 le mode de représentation des valeurs nulles dans vos fichiers CSV exportés. Les options disponibles sont les suivantes :

  • Null (null)
  • Chaîne vide dans les guillemets doubles (""")
  • Chaîne vide

Exemples

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

  • Exemple de sortie avec null sélectionné : male,NULL,TestLastName. Dans ce cas, aucune transformation n’a lieu 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ée : male,,TestLastName. Dans ce cas, Experience Platform remplace la valeur nulle 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