Définition des exportateurs

Les exportateurs fournissent les instructions pour la sortie des données du é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 qui peuvent être utilisés par des routines de chargement de DataWarehouse, des agences d'audit ou d'autres cibles.

REMARQUE

Pour qu'un exportateur fonctionne correctement, la source du journal doit satisfaire 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 l’outil de données. Voir Pour modifier le fichier Insight Transform.cfg.

  2. Cliquez avec le bouton droit de la souris sur Exporters, puis 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 Exporters dans le fichier de configuration en utilisant le tableau suivant comme guide :

    Paramètre Description
    Format des données

    Pour ExportTextFile uniquement. Format de chaque ligne de sortie, composé d’échappement de nom de champ (exprimés en %nom_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é ci-dessous : %%

    Un exemple d'entrée pour le paramètre Format de données 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 du fichier de sortie.

    Le logiciel ne peut pas échapper aux délimiteurs inclus dans les valeurs des données. Par conséquent, l’Adobe ne recommande pas l’utilisation de 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 qui sont souvent utilisés comme délimiteurs.

    Séparateur de ligne 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 Data Workbench.

    Commentaires Facultatif. Notes relatives à l'exportateur.
    Chemin de sortie

    Chemin d’accès où les fichiers de sortie doivent être stockés. Le chemin d’accès dépend du dossier d’installation du serveur de l’outil de données.

    Remarque : Le serveur d’outils de données qui stocke les données de sortie est le serveur de traitement n° 0 dans le fichier profil.cfg.

    Période de rotation du fichier

    Facultatif. Fréquence à laquelle les données sont exportées dans 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 temporels sont en GMT : Un jour début à 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 début lundi. La semaine commençant sur 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 de nom de fichier dans ce tableau.

    La période de rotation par défaut des fichiers est JOUR.

    • Définissez la rotation du fichier sur NONE uniquement lorsque vous travaillez en mode hors connexion. Voir la description du paramètre Mode hors connexion.
    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és en %nom de champ%).

    Les composants de nom de fichier liés à la période de rotation sont incorporés dans la chaîne de format à l’aide des séquences d’échappement suivantes :

    • %aaa% (année à quatre chiffres)
    • %yy% (année à deux chiffres)
    • %mm% (mois à deux chiffres, 01 - 12)
    • %ww% (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 %yyy%%mm%%dd%-%x-mask%.txt

    • Les séquences d’échappement sont sensibles à la casse.
    • Lorsque la valeur NONE est affectée à la période de rotation du fichier, une chaîne vide est remplacée pour chacune des séquences d’échappement, le cas échéant.
    • Une erreur est générée si Format de nom de fichier n'entraîne pas un nom de fichier unique pour chaque période de rotation (voir le paramètre Période de rotation du fichier dans ce tableau). Par exemple, lors de l'utilisation de la période de rotation JOUR, les séquences d'échappement %dd%, %mm% et %yy% ou %yyy% doivent être présentes dans le modèle pour éviter la 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 utiliser cette fonction avec précaution.
    • Tous les calculs sont effectués en GMT.
    Exécuter au survol

    Facultatif. Une fois chaque fichier 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%. Partie du répertoire du nom de fichier final, y compris la barre oblique inverse de fin.
    • %file%. Nom de fichier (à l’exclusion du répertoire et de l’extension) du fichier final.
    • %ext%. L’extension (y compris l’interligne ".") du nom de fichier final.
    • %chemin d’accès%. Nom complet du chemin d'accès au 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. Quantité de mémoire en octets utilisée pour mettre en mémoire tampon 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 d'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 d'ouverture des fichiers

    Facultatif. Nombre maximal de fichiers pouvant être ouverts en même temps pour une sortie de l’exportateur. Si ce nombre est dépassé, une erreur est enregistrée dans le journal de événement et le serveur de l’outil de données s’arrête. La valeur par défaut est 1000.

  5. Après avoir défini l'exportateur (et modifié d'autres paramètres) dans le fichier Transform.cfg, enregistrez le fichier localement et enregistrez-le au profil approprié sur l'ordinateur du serveur de l'outil de données.

Sur cette page

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