Créer une exportation de données

Une Exportation de données vous permet d'exporter les données Selligent by Zeta vers un emplacement externe. Vous pouvez définir quand et à quelle fréquence l'exportation doit être réalisée et si une personne doit être informée du statut de l'exportation. Vous pouvez faire votre choix parmi toute une série d'emplacements d'exportation où les données peuvent être stockées.

Une Exportation peut être créée de deux manières différentes :

  • À partir du menu volant de l'entrée Échange de données, dans la barre de navigation de gauche. Cliquez sur le bouton + Nouveau et sélectionnez Exportation de données dans la liste déroulante.
  • Dans la page de démarrage Importation/Exportation, sélectionnez + Nouveau>Exportation de données. Un assistant vous guide tout au long du processus de création et de configuration de l'exportation.

Remarque: Seuls les fichiers au format CSV sont pris en charge.

 

Définir les Propriétés générales

Propriétés

  • Définissez le chemin du dossier pour l'exportation. Il s'agit de l'emplacement dans la structure de dossiers où l'exportation est stockée.
  • Saisissez le nom et la description de cette exportation. Choisissez un nom et une description explicites afin de pouvoir reconnaître facilement votre exportation dans la page de démarrage.
  • Libellé de l'actif — Le(s) libellé(s) attribué(s) à cet actif. Sélectionnez un ou plusieurs libellés dans la liste déroulante. (Ces libellés sont créés dans le module Configuration Admin.) Les utilisateurs disposant des autorisations d'accès appropriées peuvent également créer de nouveaux libellés en saisissant leur nouvelle valeur dans le champ.
  • Définissez le Nom de l'API pour l'exportation. Ce nom est utilisé lorsque l'exportation est exécutée via l'API. Par défaut, le nom de l'API est complété par le nom donné à cette exportation.

 

Programmation

Le commutateur de programmation indique si l'exportation de données doit avoir sa propre programmation. Cela n'est pas nécessaire si cette exportation de données fait partie d'une exécution de travaux par lot. Dans ce cas, elle hérite de la programmation du travail par lot parent.

La section Programmation permet de définir la période de validité de l'exportation, ainsi que son occurrence d'exécution.

Pour programmer votre exportation, activez cette option et définissez-en la programmation.

Dates de début et de fin — Vous pouvez définir une date de début et/ou une date de fin pour l'exportation. Votre exportation doit par exemple être lancée immédiatement, mais être exécutée indéfiniment.

Périodicité — Permet d'indiquer quand l'exportation doit être exécutée :

  • Tous les jours — Permet de sélectionner les heures de la journée auxquelles l'exportation doit être exécutée. Vous pouvez en sélectionner plusieurs.
  • Toutes les semaines — Permet de sélectionner le jour de la semaine auquel l'exportation doit être exécutée. L'exportation peut être exécutée plusieurs fois par semaine. Vous pouvez également définir l'heure de début.
  • Tous les mois — Permet de sélectionner les jours du mois auxquels l'exportation doit être exécutée. Vous pouvez également sélectionner l'heure de la journée à laquelle l'exportation doit être lancée.
  • Périodiquement — Permet de définir la récurrence de l'exportation, exprimée en minutes. Par exemple, l'exportation est exécutée toutes les 10 minutes.

Remarque: L'heure de programmation sera exécutée en fonction du fuseau horaire du serveur. Le fuseau horaire du serveur actuellement configuré est mentionné à côté de l'icône d'information.

 

Notifications

Un message peut être envoyé :

  • * OnFailure — Lorsque le processus échoue. Au moins un groupe de notification/une adresse e-mail est obligatoire
  • OnComplete — Lorsque la tâche est terminée avec succès.
  • OnError — Lorsque la tâche est terminée avec des erreurs (le travail a été terminé, mais une ou plusieurs tâches ont généré des erreurs/exceptions).

Les détails de la procédure peuvent être inclus dans le message. En outre, l'instance sur laquelle le problème est survenu est incluse dans l'objet du message.

Pour activer l'option, il suffit d'activer la bascule à gauche et de saisir une ou plusieurs adresses e-mail. (Les adresses e-mail doivent être séparées par un point-virgule.) Vous pouvez également sélectionner un groupe de notifications. Ces groupes de notifications sont créés dans le module Admin configuration.

Remarque: Il est obligatoire de définir un ou plusieurs groupes de notifications/adresses e-mail en cas d'échec de l'export. Les autres notifications (achèvement ou erreurs) sont facultatives.

Lorsque vous avez terminé, appuyez sur Suivant.

 

Configurer le planificateur (Optionnel)

Remarque: La section Planificateur n'est visible que si des planificateurs sont configurés sur votre environnement. Par défaut, il y a 1 planificateur, auquel cas cette section n'est pas affichée car ce planificateur par défaut est utilisé. S'il existe plus d'un planificateur configuré, vous avez accès à la section Planificateur.

Lorsque plusieurs tâches, importations ou exportations sont exécutées, il pourrait se révéler judicieux d'utiliser un planificateur différent afin de s'assurer que les tâches dont l'exécution est longue n'interfèrent pas avec les tâches dont l'exécution est plus courte. La configuration d'un planificateur est facultative. Si vous conservez le planificateur par défaut, toutes les tâches/exportations/importations seront exécutées, mais si l'une des tâches est plus longue, la tâche plus courte ne sera exécutée que lorsque cette tâche plus longue sera terminée.

Vous pouvez choisir entre 3 planificateurs différents : le planificateur par défaut, le planificateur personnalisé 1 et le planificateur personnalisé 2. En sélectionnant des planificateurs différents pour vos tâches, ces dernières vont s'exécuter en parallèle, sans interférer l'une avec l'autre. Ce qui signifie que si certaines tâches sont plus longues à exécuter, il pourrait se révéler judicieux de les exécuter sur un planificateur différent.

 

Définir les options d'exportation

Exporter liste

Liste — Le nom de la liste Selligent à exporter. Vous pouvez faire votre choix dans une liste déroulante.

Remarque: Lorsque la liste sélectionnée est une liste partagée avec un filtre, seules les fiches conformes au filtre seront exportées.

Remarque 2: Lorsque la liste sélectionnée contient un champ avec une valeur de liste d'options utilisant l'expression translateValue, cette exportation échoue, car l'expression translateValue n'est pas prise en charge par l'exportation.

Segment — Le segment de la liste qui doit être appliqué pour définir les fiches à exporter.

Vous trouverez en dessous une indication du nombre de fiches qui seront exportées. Une icône Filtre vous permet de définir un filtre supplémentaire, le cas échéant.

Seules les fiches appartenant au segment sélectionné et correspondant au filtre supplémentaire sont exportées.

Remarque: Ce filtre peut utiliser les données de profil, les segments ou les métriques d'engagement et d'intérêt.

 

Cible

La deuxième étape consiste à définir l'emplacement où le fichier d'exportation doit être enregistré. Vous pouvez choisir parmi les options suivantes : Référentiel, Azure Blob Storage, Amazon S3 Storage, Google Cloud Storage, Prédéfini, Lien de téléchargement, FTPS, FTPS implicite, SFTP. Selon le média sélectionné, différents paramètres sont définis.

  • Référentiel — Le référentiel est le système de fichiers local de l'agent Tâche. Le système de fichiers comprend déjà un dossier Données Campaign dans lequel un sous-dossier peut être sélectionné. Cliquez sur le menu déroulant pour sélectionner le sous-dossier dans lequel enregistrer le fichier.

  • Azure Blob Storage — Saisissez la chaîne de connexion (vous pouvez activer ou désactiver l’affichage de la chaîne en cliquant sur l’icône Œil) et le conteneur, ainsi qu’un sous-dossier facultatif. (*)

  • Amazon S3 Storage — Saisissez l’ID de la clé d’accès et la clé d’accès secrète (vous pouvez activer ou désactiver l’affichage des deux chaînes en cliquant sur l’icône Œil), le nom du compartiment, le code du point de terminaison de la région et un sous-dossier facultatif. (*)

  • Google Cloud Storage — Saisissez le type, l’ID projet, l’ID de la clé privée et la clé privée (vous pouvez activer ou désactiver l’affichage des deux chaînes en cliquant sur l’icône Œil), l’e-mail client, l’ID client, l’URI d'authentification, l’URI du token, l’URL du certificat X509 du fournisseur d'authentification, l’URL du certificat X509 du client, le nom du compartiment et un sous-dossier facultatif. (*)

* Remarque: Vous trouverez ici des détails sur la façon de configurer le stockage dans le Cloud.

  • Prédéfini — Lorsque vous sélectionnez cette option, le champ 'Moyen de transport prédéfini' s'affiche ; il vous permet de sélectionner un moyen dans une liste de moyens prédéfinis. Ces moyens sont déjà configurés dans le module Admin Configuration et liés à votre Unité commerciale. Lorsque vous sélectionnez un paramètre, tous les paramètres correspondants sont utilisés.

  • Lien de téléchargement — Si cette option est sélectionnée, un lien de téléchargement s'affiche sur la page de démarrage de Échange de données > Importations/Exportations, pour télécharger localement l'exportation de données (complète ou filtrée) sous forme de fichier CSV.

    Remarque: L'option Lien de téléchargement n'est pas disponible par défaut. Elle peut être activée sur demande.

    • Après avoir sélectionné Lien de téléchargement dans la liste déroulante, le champ Nom de fichier devient disponible.

    • Vous pouvez saisir un nom de fichier manuellement et/ou insérer des champs de personnalisation.

      En guise de champs de personnalisation, vous pouvez sélectionner la date du jour et les champs système d'exportation.

    • Il est conseillé (mais pas obligatoire) de saisir votre nom de fichier avec une extension .csv.

      Exemples:
      - avec l'extension .csv:

      - sans extension:

    • Lorsque l'exportation de données est exécutée ultérieurement, un lien de téléchargement s'affiche.

      Cliquez dessus pour télécharger votre fichier afin de le stocker localement.

      Remarque: Le lien de téléchargement expire après 7 jours. Pour le télécharger après la date d'expiration, vous devrez exécuter de nouveau l'exportation.

  • FTPS, FTPS implicite, SFTP — Indiquez dans cette boîte de dialogue le nom du serveur, ainsi que le nom d'utilisateur et le mot de passe permettant de s'y connecter. L'utilisateur peut définir un sous-dossier spécifique dans lequel le fichier doit être enregistré. Un sous-dossier est déjà sélectionné par défaut.

 

Authentification par clé privée

Pour SFTP, outre l'utilisation d'un mot de passe pour s'authentifier lors de la connexion au serveur, il est possible d'utiliser une clé privée:

Un curseur permet de choisir entre Mot de passe et Clé privée.

Lorsque l'option Clé privée est sélectionnée, vous pouvez saisir (ou coller) les données de la clé privée dans le champ Clé privée.

Important: Nous ne prenons en charge que PuTTY format private keys for SFTP exports. pour les exportations SFTP. Veillez donc à utiliser le bon format. Le manuel d'utilisation de PuTTY est disponible ici.

Si la clé privée requiert un mot de passe (comme c'est le cas sur certains serveurs), vous pouvez saisir le mot de passe dans le champ « Mot de passe de la clé privée ». Ce champ est facultatif.

Remarque: Les données des deux champs (clé privée et mot de passe de la clé privée) sont cryptées et stockées dans la base de données et ne sont utilisées que lors du transfert des fichiers.

La clé d'hôte est un champ facultatif qui peut être utilisé comme étape de vérification supplémentaire pour s'assurer que vous vous connectez au bon serveur.

Remarque:
Lors de l'enregistrement de l'Exportation de données:
- Le contenu du champ de la clé privée est vidé (pour des raisons de sécurité).
- L'intitulé du champ Clé privée est mis à jour et devient Spécifier une nouvelle clé privée pour mettre à jour la clé privée existante .
- Le contenu du champ Mot de passe de la clé privée est vidé (pour des raisons de sécurité).
- L'intitulé du champ Mot de passe de la clé privée est mis à jour et devient Spécifier un nouveau mot de passe de la clé privée pour mettre à jour le mot de passe de la clé privée existante.

 

Options de fichier

Cliquez sur l'icône en forme de crayon pour accéder à la boîte de dialogue Options de fichier:

  • Le délimiteur de fichier peut être défini sur : deux-points, point-virgule, tabulation ou barre verticale. Par défaut, le délimiteur est défini sur ;.
  • Il est possible de mettre le texte entre guillemets doubles. Activez cette option, le cas échéant.
  • Vous pouvez également définir la première ligne comme étant celle contenant les noms des colonnes. Cette option est sélectionnée par défaut.
  • L'option Passer BOM vous permet de ne pas tenir compte de l'indicateur d'ordre des octets au début d'un flux de texte.
  • Définissez la taille maximum du fichier, exprimée en Mégaoctets. Si l'exportation dépasse cette quantité, d'autres fichiers sont créés avec la mention _ 001, _002, etc., placée (avant le suffixe du fichier), chacun ne dépassant pas cette taille. Exemple : si vous définissez cette valeur sur 10 Mo, vous créez ainsi « export.csv », « export_001.csv », « export_002.csv », « export_003.csv », chacun de moins de 10 Mo. Laissez 0 si aucune limite ne doit être définie
  • Définissez le Saut de ligne sur Windows ou Unix. Windows utilise le retour chariot et le saut de ligne ("\r\n") en fin de ligne, où Unix utilise uniquement le saut de ligne ("\n").
  • Définissez le type d'encodage à appliquer au fichier. Cliquez sur la liste déroulante pour accéder à la liste étendue des mécanismes d'encodage.

 

Avancé

Écraser le fichier cible existant — Si le fichier cible sélectionné existe déjà, il est écrasé si cette option est sélectionnée. Si l’option n’est pas sélectionnée, l’exportation échoue lors de l’exécution.

S’il n’y a aucune donnée à exporter :

  • Passer l’exportation — Dans le cas où la liste, le segment et le filtre sélectionnés ne renvoient aucune fiche, l’exportation n’est pas exécutée. Une notification d'achèvement est générée.

  • Échec d’exportation (Fail export) — Dans le cas où la liste, le segment et le filtre sélectionnés ne renvoient aucune fiche, le système considère que l’exportation a échoué. Une notification d'échec est générée.

  • Continuer l’exportation — Exporte un fichier vide (ou un fichier ne contenant que des en-têtes s'il est configuré) et génère une notification ACHÈVEMENT.

 

Cliquez sur le bouton Suivant pour passer à l'étape de mise en correspondance des champs.

 

Définir la correspondance des champs

Dans cette section, vous définissez la correspondance entre les zones de la liste sélectionnée et les colonnes du fichier d'exportation.

Dans le champ Champ d'action, sélectionnez la liste maîtresse, la liste liée 1:1 ou 1:n. Cela vous permet également d'exporter des données dans ces listes liées.

Remarque: Lorsqu'une liste liée est utilisée dans l'exportation, elle est visible dans la boîte de dialogue Utilisation des relations.

Sélectionnez le nom du champ dans la liste sélectionnée.

Ensuite, définissez l'alias à utiliser dans le fichier d'exportation. Une suggestion est faite en fonction du nom du champ, mais vous pouvez changer l'alias.

Faites de même pour tous les champs à exporter. Une fois la mise en correspondance établie pour tous les champs requis, sauvegardez l'exportation.

Vous pouvez aussi utiliser des expressions dans votre exportation. Les expressions vous permettent de concaténer des champs, de convertir des champs de date, de formater des champs de texte ou d’effectuer toute autre opération accessible via la boîte de dialogue Personnalisation. Vous pouvez aussi saisir manuellement les expressions.

Pour créer une expression pour l’exportation, sélectionnez Personnalisé dans la liste déroulante Champ d’action. Vous pouvez alors placer votre expression dans la colonne Champ. Une boîte de dialogue Personnalisation vous permet de sélectionner les expressions à utiliser.

Remarque: Les expressions peuvent inclure des champs des listes liées 1:1.

Remarque: L'ordre des champs détermine l'ordre des colonnes dans le fichier d'exportation. Vous pouvez modifier cet ordre par simple glisser-déposer d'un champ. Survolez la ligne que vous voulez déplacer et cliquez sur cette icône pour faire glisser la ligne vers une nouvelle position.

 

Pour sauvegarder votre configuration, procédez de l'une des façons suivantes :

 

Historique

Une fois l'exportation configurée, un onglet Historique fournit des détails sur l'exécution de l'exportation, la durée, la date de début et apporte des précisions en cas d'erreur.