Le fichier Transform.cfg

Le fichier data workbenchTransform.cfg contient les paramètres qui définissent les sources des journaux, les transformations de données et les exportateurs.

Les transformations que vous définissez manipulent les données brutes collectées par les capteurs (fichiers .vsl) ou contenues dans des fichiers texte, des fichiers XML ou des bases de données compatibles ODBC et les génèrent soit dans des champs existants, en remplaçant les données actives, soit dans des champs nouvellement définis.

Pour configurer la fonctionnalité de transformation, vous modifiez le fichier de données Workbench Transform.cfg dans le dossier Dataset pour le profil pour lequel vous souhaitez exporter les données de événement. En règle générale, ce profil est dédié à la fonctionnalité de transformation (c’est-à-dire que vous n’effectuez aucun autre traitement de données que celui défini dans le fichier de données Workbench Transform.cfg). Il est important de noter que toutes les instructions de traitement spécifiées dans les fichiers Log Processing Dataset Include pour tout profil hérité sont appliquées en plus de celles spécifiées dans le fichier data workbench Transform.cfg.

Pour plus d’informations sur les fichiers inclus dans le jeu de données, voir Fichiers inclus dans le jeu de données.

Si les données à exporter sont traitées par une grappe de serveurs de l’outil de données, chacun des serveurs de traitement (DPU) de la grappe traite les données, mais seul le premier DPU (serveur de traitement n° 0 dans le fichier profile.cfg) écrit les données de sortie dans son système de fichiers local.

Pour modifier le fichier Transform.cfg de l’outil de données

  1. Lorsque vous travaillez dans le profil pour lequel vous souhaitez exporter des données, ouvrez Profile Manager et cliquez sur Dataset pour afficher le contenu du répertoire.
  2. Cliquez avec le bouton droit de la souris sur la coche en regard de l’outil de données Transform.cfg, puis cliquez sur Make Local. Une coche pour ce fichier apparaît dans la colonne User.
  3. Cliquez avec le bouton droit de la souris sur la coche nouvellement créée, puis cliquez sur Open > from the workbench. La fenêtre Outils de données Transform.cfg s'affiche.
  4. Modifiez les paramètres du fichier de configuration à l’aide du tableau ci-dessous comme guide :
Paramètre Description
Heure de fin

Facultatif. Filtrez les données pour inclure les entrées de journal avec horodatages jusqu’à cette heure, mais non inclus. L’Adobe recommande d’utiliser l’un des formats suivants pour l’heure :

  • 1er janvier 2013HH:MM:SS EDT
  • 1er janvier 2013 HH:MM:SS GMT

Par exemple, la spécification du 29 juillet 2013 00:00:00 EDT comme Heure de fin inclut des données jusqu’au 28 juillet 2013, à 23h59:59 EDT.

Vous devez spécifier un fuseau horaire. Le fuseau horaire n’est pas défini par défaut sur GMT s’il n’est pas spécifié. Pour obtenir la liste des abréviations de fuseau horaire prises en charge par le serveur de l’outil de données, voir Codes de fuseau horaire .

Le paramètre Utiliser les heures de Début/fin pour les sources de fichiers journaux et de capteurs est associé à ce paramètre.

Exportateurs

Les sous-champs d’un exportateur spécifient comment les données de sortie sont traitées et/ou formatées. Vous pouvez définir plusieurs exportateurs pour un ensemble de sources de journal. Chaque type d’exportateur crée une sortie indépendante.

Il existe trois types d'exportateurs :

  • ExportTextFile
  • ExportDelimitedTextFile
  • ExportVSLFile

Pour plus d'informations sur les types d'exportateurs, voir Définir des exportateurs .

Seuil de hachage Facultatif. Facteur d'échantillonnage pour le sous-échantillonnage aléatoire des rangées. Si la valeur est définie sur n, un seul identifiant de suivi sur n est sélectionné pour l’exportation, ce qui réduit le nombre total de lignes exportées par un facteur n. Pour exporter toutes les lignes, définissez le seuil de hachage sur 1.
Condition d’entrée du journal Facultatif. Définit les règles selon lesquelles les entrées de journal sont prises en compte pour l’exportation. Pour plus d'informations sur la condition d'entrée de journal , consultez Fichier de configuration de traitement de journal .
Sources de journalisation

Sources de données. Les sources de journaux peuvent être .vsl, des fichiers journaux, des fichiers XML ou des données provenant de bases de données compatibles ODBC. Pour plus d'informations sur les sources de journal , voir Fichier de configuration de traitement du journal .

Transform s’attend à ce que toutes les données source soient dans l’ordre chronologique au sein de fichiers d’entrée lexicographiquement triés. Si cette exigence n’est pas satisfaite, les calculs A partir de sont incorrects et des données d’entrée supplémentaires peuvent être traitées après la fermeture des fichiers de sortie.

Mode hors ligne

Facultatif. Vrai ou faux. Si la valeur est true, Transform suppose que tous les fichiers d’entrée sont présents lorsqu’il début le traitement des données. Lorsque toutes les données d'entrée ont été lues, Transform ferme tous les fichiers de sortie sans attendre la réception de données supplémentaires. La valeur par défaut est false.

Remarque : Si Mode hors ligne est défini sur true, Transform s'attend à ce que toutes les données source soient présentes avant le traitement des débuts. Un message d’avertissement est généré dans le fichier VisualServer.log si des données supplémentaires sont reçues après la fermeture des fichiers de sortie.

Retraiter

Facultatif. Tout caractère ou combinaison de caractères peut être saisi ici. La modification de ce paramètre et l’enregistrement du fichier sur l’ordinateur Transform initialise le retraitement des données.

Pour plus d’informations sur le retraitement de vos données, voir Retraitement et retransformation .

Etapes

Facultatif. Les noms des étapes de traitement qui peuvent être utilisées dans le jeu de données de traitement du journal incluent les fichiers qui sont exécutés en plus du fichier de données Workbench Transform.cfg . Les étapes de traitement permettent d'organiser les transformations définies dans les fichiers Jeu de données de traitement du journal Inclure . Ce paramètre est très utile si vous avez défini une ou plusieurs transformations dans plusieurs fichiers Jeu de données de traitement du journal Inclure et que vous souhaitez que des transformations spécifiques soient effectuées à des moments spécifiques pendant le processus d'exportation.

L'ordre dans lequel vous listes les étapes ici détermine l'ordre dans lequel les transformations dans le jeu de données de traitement du journal Inclure sont exécutées lors de l'exportation des données. Le prétraitement et le posttraitement sont des étapes intégrées ; Le prétraitement est toujours la première étape et le posttraitement est toujours la dernière étape. Par défaut, il existe une étape nommée Par défaut .

Pour ajouter une nouvelle étape de traitement

  • Dans la fenêtre Outils de données Transform.cfg , cliquez avec le bouton droit de la souris Etapes , puis cliquez sur Ajouter > Étapes .
  • Entrez le nom de la nouvelle étape.

Pour supprimer une étape de traitement existante

  • Cliquez avec le bouton droit de la souris sur le numéro correspondant à l’étape à supprimer, puis cliquez sur Supprimer < #stage_number .

Remarque : Lorsque vous spécifiez une étape dans un fichier Jeu de données de traitement du journal Inclure , le nom de l'étape doit correspondre exactement au nom que vous saisissez ici. Pour plus d'informations sur les fichiers inclus dans le jeu de données, consultez Fichiers inclus dans le jeu de données .

Heure de début

Facultatif. Filtrez les données pour inclure les entrées de journal avec horodatage à cette heure ou après cette date. L’Adobe recommande d’utiliser l’un des formats suivants pour l’heure :

  • 1er janvier 2013 HH:MM:SS EDT
  • 1er janvier 2013 HH:MM:SS GMT

Par exemple, la spécification du 29 juillet 2013 à 00:00:00 HAE comme heure du Début inclut des données commençant le 29 juillet 2013 à 00:00 HAE.

Vous devez spécifier un fuseau horaire. Le fuseau horaire n’est pas défini par défaut sur GMT s’il n’est pas spécifié. Pour obtenir la liste des abréviations de fuseau horaire prises en charge par le serveur de l’outil de données, voir Codes de fuseau horaire .

Remarque : Le paramètre Utiliser les heures de Début/fin pour les sources de fichiers journaux et de capteurs est associé à ce paramètre.

Transformations

Facultatif. Définit les transformations à appliquer aux données. Pour plus d'informations sur les types de transformation disponibles, voir Data Transformations .

Remarque : Les types de transformation suivants ne fonctionnent pas lorsqu'ils sont définis dans le fichier de données Workbench Transform.cfg :

  • AppendURI
  • CrossRows
  • ODBCLookup
  • Sessionize
REMARQUE

Si des données supplémentaires sont reçues après la fermeture des fichiers de sortie (voir Log Sources et Offline Mode dans le tableau précédent), Transform crée de nouveaux fichiers de sortie avec les données supplémentaires. Les noms des nouveaux fichiers de sortie sont générés à partir du nom du fichier de sortie d’origine avec l’ajout d’un numéro de version entre parenthèses juste avant l’extension. Par exemple, si le fichier de sortie d’origine est 20070701-ABC.vsl, les versions suivantes de ce fichier seront nommées 20070701-ABC(1).vsl, 20070701-ABC(2).vsl, etc. Notez que l’utilisation des fichiers avec version en entrée sur le serveur de l’outil de données peut entraîner des erreurs de traitement.

L’Adobe recommande d’éviter la création de fichiers de sortie versionnés en s’assurant que toutes les données source sont dans l’ordre chronologique dans les fichiers d’entrée lexicographiquement ordonnés et, si Offline Mode est défini sur true, que toutes les données source sont présentes avant le traitement des débuts. Pour plus d'informations, consultez les entrées Log Sources et Offline Mode du tableau précédent.

  1. Ajoutez les transformations en cliquant avec le bouton droit de la souris sur Transformations et en cliquant sur Add new > Transformation type. Renseignez les champs de transformation.

    Voir Transformations de données pour obtenir des descriptions et des exemples des transformations que vous pouvez utiliser avec la fonctionnalité de transformation.

  2. Cliquez avec le bouton droit (modified) en haut de la fenêtre, puis cliquez sur Save.

  3. Pour que les modifications apportées localement prennent effet, dans la Profile Manager, cliquez avec le bouton droit de la souris sur la coche correspondant à l'outil de données Transform.cfg dans la colonne User, puis cliquez sur Save to > profile name, où le nom du profil correspond au nom du profil pour lequel vous exportez des données. Le retraitement des données commence après la synchronisation du profil.

    REMARQUE

    Pour plus d’informations sur le retraitement de vos données pour l’exportation, voir Retraitement et retransformation.

Sur cette page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now