Définition des exportateurs

Les exportateurs fournissent des instructions pour générer les données d’événement.

La fonctionnalité de transformation fournit trois types d’exportateurs pour l’exportation de fichiers .vsl, de fichiers journaux, de fichiers XML et de données ODBC sous la forme de fichiers .vsl, de fichiers texte ou de fichiers texte délimités pouvant être utilisés par des routines de chargement de DataWarehouse, des agences de contrôle ou d’autres cibles.

Pour définir un exportateur

1. Ouvrez Transform.cfg dans Data Workbench. Voir Pour modifier le fichier Insight Transform.cfg.

2. Cliquez avec le bouton droit de la souris sur Exporters, puis cliquez sur Add New.

3. Sélectionnez l’une des options suivantes :

   • ExportTextFile
   • ExportDelimitedTextFile
   • ExportVSLFile
   REMARQUE

   Pour l’option ExportVSLFile , tous les champs étendus du fichier d’entrée et tous les champs définis par l’utilisateur du formulaire cs(header) sont toujours écrits dans le fichier de sortie VSL. Si vous remplacez un champ étendu existant, la nouvelle valeur est écrite dans le fichier de sortie, même si le champ est vide.

4. Modifiez les paramètres Exportateurs dans le fichier de configuration à l’aide du tableau suivant comme guide :

   Paramètre	Description
   Format des données	Pour ExportTextFile uniquement. Format de chaque ligne de sortie, composé d’échappement des noms de champ (exprimés en %nom de champ%) et de tout autre texte fixe souhaité. Le format doit inclure un séparateur de ligne, généralement [CR] [LF]. Un signe de pourcentage littéral (%) peut être incorporé dans la chaîne de format en échappant le caractère comme illustré ici : %% Un exemple d’entrée pour le paramètre Data Format est %x-timestring% %x-trackingid%[CR][LF].
   Champs	Pour ExportDelimitedTextFile uniquement. Noms des champs à générer.
   Délimiteur	Facultatif. Pour ExportDelimitedTextFile uniquement. Caractère utilisé pour séparer les champs dans le fichier de sortie. Le logiciel ne peut pas échapper les délimiteurs inclus dans les valeurs des données. Par conséquent, Adobe ne recommande pas d’utiliser des virgules comme délimiteurs. Si vous maintenez la touche Ctrl enfoncée et cliquez avec le bouton droit dans le paramètre Délimiteur, un menu Insérer s’affiche. Ce menu contient une liste de caractères spéciaux, souvent utilisés comme délimiteurs.
   Séparateur de lignes	Facultatif. Pour ExportDelimitedTextFile uniquement. Caractère(s) utilisé(s) pour séparer les lignes dans les fichiers de sortie. La valeur par défaut est [CR] [LF].
   Nom	Facultatif. Identifiant de l’exportateur. Ce nom apparaît dans l’interface État détaillé. Pour plus d’informations sur l’interface État détaillé, consultez le Guide de l’utilisateur du Data Workbench.
   Commentaires	Facultatif. Remarques sur l’exportateur.
   Chemin de sortie	Chemin d’accès où les fichiers de sortie doivent être stockés. Le chemin d’accès est relatif au dossier d’installation du serveur Data Workbench. Remarque : Le serveur Data Workbench qui stocke les données de sortie est le serveur de traitement #0 dans le fichier profile.cfg .
   Période de rotation du fichier	Facultatif. Fréquence à laquelle les données sont exportées vers le fichier de sortie. Chaque fichier de sortie contient des données liées à une période spécifique appelée période de rotation. Tous les calculs de temps sont en GMT : Un jour commence à minuit GMT et se termine le lendemain à minuit GMT, même si les données écrites dans le fichier incluent un champ qui a été transformé en heure locale. Les valeurs disponibles sont les suivantes : ANNÉE. Chaque fichier contient des données pour une année civile. MOIS. Chaque fichier contient des données pour un mois calendaire. Les mois sont numérotés du 1er janvier au 12 décembre. SEMAINE. Chaque fichier contient des données pour une semaine. Une semaine commence le lundi. La semaine qui commence l’un des sept premiers jours de l’année est la semaine 1 et la semaine précédente (partielle), le cas échéant, est la semaine 0. JOUR. Chaque fichier contient des données pour un jour calendaire. HEURE. Chaque fichier contient des données pendant une heure. NONE. Aucune rotation n’est effectuée. Toutes les données sont écrites dans le même fichier (ou dans un ensemble de fichiers déterminé par d’autres paramètres). Voir le paramètre Format du nom de fichier dans ce tableau. La période de rotation de fichier par défaut est JOUR. Définissez la rotation de fichier sur NONE uniquement lorsque vous utilisez le mode hors ligne. Voir la description du paramètre Mode hors ligne .
   Format du nom de fichier	Facultatif. Format du nom du fichier de sortie. Chaque entrée de journal peut être stockée dans un fichier dont le nom est dérivé de l’heure de début de la période de rotation, et éventuellement des valeurs des champs des lignes qu’elle contient. Les champs à utiliser dans le nom de fichier sont incorporés en tant qu’échappement de nom de champ (exprimé en %nom de champ%). Les composants de nom de fichier associés à la période de rotation sont incorporés dans la chaîne de format à l’aide des séquences d’échappement suivantes : %yyy% (année à quatre chiffres) %yy% (année à deux chiffres) %mm% (mois à deux chiffres, 01 - 12) %ss% (semaine à deux chiffres, 01 - 52) %dd% (jour à deux chiffres, 01 - 31) %HH% (heure à deux chiffres, 00 - 23) Le format de nom de fichier par défaut est %yyyy%%mm%%dd%-%x-mask%.txt Les séquences d’échappement sont sensibles à la casse. Lorsque la période de rotation du fichier est définie sur NONE, une chaîne vide est remplacée par chacune des séquences d’échappement, le cas échéant. Une erreur est générée si File Name Format ne génère pas de nom de fichier unique pour chaque période de rotation (voir le paramètre File Rotation Period dans ce tableau). Par exemple, lors de l’utilisation de la période de rotation DAY, les séquences d’échappement %dd%, %mm% et %yy% ou %yyy% doivent être présentes dans le modèle pour éviter toute perte de données. Si vous utilisez des séquences d’échappement de nom de champ dans le modèle et que le champ donné comporte de nombreuses valeurs distinctes, de nombreux fichiers de sortie sont écrits pour chaque période de rotation. Notez que ce scénario peut entraîner des performances médiocres. Vous devez donc l’utiliser avec précaution. Tous les calculs sont effectués en GMT.
   Exécuter au survol	Facultatif. Lorsque chaque fichier est finalisé, une commande externe (Windows) peut être exécutée. La ligne de commande est dérivée du nom de fichier final en remplaçant les séquences d’échappement suivantes par ce paramètre : %dir%. La partie répertoire du nom de fichier final, y compris la barre oblique inverse à la fin. %file%. Le nom de fichier (à l’exception du répertoire et de l’extension) du fichier final. %ext%. L’extension (y compris le premier ".") du nom de fichier final. %chemin d’accès%. Nom du chemin d’accès complet du fichier, équivalent à %dir%%file%%ext%. Par défaut, ce paramètre est vide (aucune commande n’est exécutée).
   Limite de mémoire	Facultatif. La quantité de mémoire en octets utilisée pour la mise en mémoire tampon de la sortie de l’exportateur. La valeur par défaut est de 10 000 000 octets. Remarque : Si de nombreux fichiers de sortie sont ouverts en même temps, vous pouvez augmenter cette valeur, mais vous pouvez réduire la quantité de mémoire disponible pour les autres composants du système. La diminution de cette valeur peut toutefois ralentir le processus d’exportation. Pour obtenir de l’aide, contactez l’Adobe.
   Limite des fichiers ouverts	Facultatif. Nombre maximal de fichiers pouvant être ouverts en même temps pour la sortie de l’exportateur. Si ce nombre est dépassé, une erreur est enregistrée dans le journal des événements et l’exécution du serveur Data Workbench s’arrête. La valeur par défaut est 1000.

5. Après avoir défini votre exportateur (et apporté des modifications à d’autres paramètres) dans le fichier Transform.cfg, enregistrez le fichier localement et enregistrez-le dans le profil approprié sur l’ordinateur du serveur Data Workbench.