Connecter une application par import de fichiers

Pour certaines applications il n'est pas possible de configurer un connecteur car la connexion directe peut être interdite pour des raisons de sécurité ou des raisons techniques.
Il est quand même possible de remonter les informations des utilisateurs de ces applications dans Youzer en important automatiquement un fichier CSV contenant la liste des utilisateurs de cette application. Ce fichier peut être généré manuellement ou automatiquement, selon les caractéristiques techniques de votre application.

 

Principe de fonctionnement

Le process d'import d'un fichier généré par l'application en question est le suivant :

  • récupération du fichier auprès de l'application
  • dépôt du fichier dans le répertoire d'un agent local Youzer
  • [automatique] chiffrement du fichier par l'agent Youzer
  • [automatique] envoi du fichier chiffré par l'agent Youzer à la plateforme Youzer
  • [automatique] traitement de l'import et synchronisation avec les unités du connecteur concerné

 

Mise en place

Création du connecteur

Le connecteur à utiliser est de type universel. Vous créez donc le connecteur en spécifiant le nom de l'application, nous conseillons de changer son icone par défaut par celle de votre application ce qui vous apportera un confort d'identification au sein de vos Unités.
Il faut ensuite créer les attributs. Généralement ces attributs correspondent aux noms de champs du fichier que vous souhaitez importer. 
Enfin il faut créer les mappings entre les attributs et les champs de votre fichier, comme pour un connecteur base à base.

 

Le connecteur n'étant pas réellement connecté à une base de données, il faut le mettre en synchronisation manuelle (menu synchronisation : fréquence à 0)

 

 

Installation de l'agent

L'agent à installer est l'agent du connecteur universel que vous pouvez récupérer sur le menu "Agents" avec le fichier de configuration de l'agent qui contient la clé de chiffrement.
Vous pouvez installer l'agent sur un serveur ou un poste de travail. Il faut que le répertoire "staging" situé dans le répertoire d'installation de l'agent soit accessible par la personne ou le processus qui va y déposer les fichiers à importer.

 

Dépôt du fichier

Les fichiers doivent être déposés dans le répertoire "staging" situé dans le répertoire d'installation de l'agent.
Le format de nommage de ce fichier csv doit être :
-ressource-{uid du connecteur}-users-.csv

(L'uid du connecteur est indiqué dans Configuration | Personnalisation de votre connecteur.)


ex :
2021-04-29_02-01-09-ressource-FCBD0EEF-2336-4834-B7EA-11A6285ADDDF-users-.csv

 

cas d'un connecteur RH

Pour importer des utilisateurs (plutôt que des unités), le format doit être :
-ressource-{uid du connecteur}-utilisateurs-.csv

 

L'import a lieu dès que le fichier est déposé, il n'est pas nécessaire de lancer la synchronisation à partir de l'interface Youzer.