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.

REMARQUE

Pour qu’un exportateur fonctionne correctement, la source du journal doit répondre aux exigences appropriées décrites dans la section Sources du journal du Fichier de configuration de traitement du journal.

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.

Sur cette page