Connecteur Export

Objectif du connecteur

Le connecteur “Export” permet de générer un fichier CSV à partir d'information qu'il contient sur Youzer. 
Généralement, ce connecteur est utilisé pour exporter un csv qui sera ensuite transmis à une application afin de créer les comptes dans cette application à partir de ce fichier.

Principe de fonctionnement

Le connecteur “export” génère un fichier CSV à partir des unités, il faut donc avoir au préalable une liste d'unités dans ce connecteur.

Pour générer le fichier CSV, il suffit de cliquer sur le bouton “Forcer Synchro” sur le connecteur, ou de lancer des synchronisations (à fréquence régulières ou sur planification).
Les unités et les attributs de ce connecteur sont configurables de la même manière qu'un connecteur self-service.

Vous pouvez générer les unités à partir d'un package et maintenir à jour ces unités avec les calculs d'alignement.

 

Lorsqu'une unité est modifiée dans le connecteur, elle passe en statut “demande envoyée au gestionnaire" et ne sera considérée comme définitivement modifiée que lorsque le fichier CSV aura été généré.

 

Options avancées

Vous pouvez définir de nombreux paramètres pour l’export. 
Pour accéder aux paramères, : dans le connecteur, cliquez sur Configurer, puis sur Synchronisation. Là, vous trouverez le fichier de paramétrage.

  • "header_prefix":   =>  Préfixe ajouté devant chaque en-tête de colonne dans le fichier csv. Si il est vide, aucun préfixe ne sera appliqué.
  • "header":   =>  Indique si le fichier csv doit contenir une ligne d’en-têtes (noms des colonnes), 
    • true = une ligne d’en-têtes sera générée 
    • false = pas d’en-têtes dans le fichier.
  • "line_prefix":  => Préfixe ajouté au début de chaque ligne du fichier csv. Si il est vide, aucun préfixe n’est ajouté.
  • "field_quote":  => Délimiteur de texte utilisé pour entourer les valeurs (par ex. " pour "valeur"). Si il est vide, aucune valeur ne sera entourée de guillemets.
  • "field_separator":  => Caractère utilisé comme séparateur de champs (colonnes) dans le CSV. Dans l'image, c’est le point-virgule “;”.
  • "mandatory_fields": => Liste de champs obligatoires à inclure dans l’export. Si la liste est vide, aucun champ obligatoire n’est défini. Si un champ est vide, la ligne n'est pas exportée.
  • "type_export": =>  Définit le mode d’export : 
    • "full" = export complet (toutes les unités sont incluses).
    • "diff" = export différentiel (uniquement les unités modifiées).
  • "diff_history_days":  => Nombre de jours pris en compte pour un export différentiel.
    Dans l'image, si type_export = diff, seules les modifications des 3 derniers jours seront exportées. (Sans effet si type_export = full).
  • "sendfile2mail": true  => Indique si le fichier exporté doit être envoyé par email.
    • true = le fichier est envoyé par mail.
    • false = pas d’envoi par mail.
  • "filename": =>  Nom du fichier exporté. (ex: "export-youzer{{yyyyMMdd}}.csv") Le modèle {{yyyyMMdd}} est remplacé par la date du jour au format année-mois-jour (exemple : export-youzer20250903.csv).
  • "mail_recipients": => Liste des adresses email qui recevront le fichier exporté si sendfile2mail = true.

 

Mise à jour du fichier avec les alignements 

Chaque fois qu’un package est modifié, ou qu'un utilisateur est modifié, les alignements sont re-calculés et s'il y a des anomalies d'alignements, ces anomalies sont indiquées sur la plateforme.

Si vous acceptez ces corrections d'anomalies, les unités seront mises à jour lors du prochain export programmé, une synchronisation sera effectuée et le fichier CSV contiendra les valeurs à jour, correspondant aux modifications liées à la mise à jour du package.