Importer des entités à partir d'un fichier - Card Synchronization 3.4.0

Guide du module externe Card Synchronization 3.4.0

Applies to
Card Synchronization 3.4.0
Last updated
2023-04-20
Content type
Guides > Guides de modules externes et d’extensions
Language
Français
Product
Card Synchronization
Version
3.4

Vous pouvez importer des entités à partir d'un fichier qui adhère au schéma Card Synchronization. Après l’importation, les modifications apportées dans la source de données peuvent être synchronisées dans Security Center.

Avant de commencer

Effectuez les étapes indiquées dans Préparer l'importation des entités.

À savoir

  • Chaque source de données externe que vous ajoutez à la liste Source de données utilise une licence de source de données. Un fichier de source de données peut contenir un fichier par type d’entité (titulaires de cartes, groupes de titulaires de cartes, membres de groupes de titulaires de cartes et identifiants). Si vous ajoutez un fichier de source de données distinct pour chaque type d’entité, cela compte comme quatre sources de données.
  • Pour inclure des caractères spéciaux et accentués, le fichier doit utiliser le jeu de caractères Unicode.
  • Inclure des images dans la source de données rallonge les délais d’importation.
    REMARQUE : Si vous avez fait la mise à niveau depuis la version 3.0 ou 3.1 du module externe Card Synchronization, la configuration de la source de données est affichée comme dans l’ancienne version. Pour des instructions sur comment importer ces entités, consultez le guide fourni avec l’ancienne version du module externe. Pour afficher l’assistant Configuration des sources de données abordé dans cette rubrique, vous devez supprimer vos sources de données du module externe, puis les recréer.
  • Si vous tentez d'importer un fichier CSV qui est ouvert, la synchronisation échoue et renvoie un message indiquant que le fichier est en cours d'utilisation par un autre processus.

Procédure

  1. Sur la page d'accueil de Config Tool, ouvrez la tâche Modules externes
  2. Dans la tâche Modules externes, sélectionnez le module externe Card Synchronization dans l’arborescence des entités, puis cliquez sur l’onglet Propriétés.
  3. Dans la section Sources de données, cliquez sur Ajouter une source de données ().
    La fenêtre Configuration des sources de données apparaît.
  4. Dans la liste Source, sélectionnez Fichier, puis cliquez sur Suivant.
    Sélection d'un fichier.
  5. Sélectionnez les types d'entités à importer et à synchroniser avec Security Center, puis cliquez sur Suivant.
    Titulaires de cartes
    Importe les titulaires de cartes depuis la source de données externe dans Security Center.
    Groupes de titulaires de cartes
    Importe les groupes de titulaires de cartes depuis la source de données externe dans Security Center.
    IMPORTANT : Cette opération ne place pas les titulaires de cartes dans leurs groupes respectifs.
    Appartenances aux groupes de titulaires de cartes
    Synchronise la relation des titulaires de cartes et des groupes de titulaires de cartes depuis la source de données externe.
    IMPORTANT : Cette option affecte les titulaires de cartes importés aux groupes de titulaires de cartes. Si cette option n’est pas sélectionnée, les titulaires de cartes importés ne sont pas associés aux groupes de titulaires de cartes.
    Identifiants
    Importe les identifiants depuis la source de données externe dans Security Center.
    Sélection de ce que vous souhaitez importer et synchroniser
  6. Configurez les options suivantes:
    Fichier
    Naviguez jusqu’au fichier que vous souhaitez importer.
    REMARQUE : Le fichier doit être accessible par le service Genetec™ Server qui exécute le rôle module externe. Si vous utilisez un emplacement réseau, utilisez un chemin UNC (\\<Nom du serveur>\<Nom du dossier>\<Nom du fichier.csv>).
    Délimiteur
    Entrez le délimiteur utilisé pour séparer les enregistrements dans votre fichier.
    REMARQUE : Si une valeur à importer contient le délimiteur, modifiez le fichier pour placer le délimiteur entre guillemets droits.
    Démarrer à la ligne
    Si votre fichier contient des en-têtes, entrez le numéro de la ligne qui suit l’en-tête. Lorsque l'option Démarrer à la ligne est réglée sur 0, la lecture des enregistrements démarre à la première ligne.
    CONSEIL : Pour simplifier la mise en correspondance des champs, vous pouvez régler la valeur Démarrer à la ligne sur différentes valeurs et vérifier les données de chaque champ via la colonne Valeur témoin.
  7. Associez chaque champ externe à un champ Security Center en sélectionnant le nom de colonne dans la liste déroulante correspondante.
  8. (Facultatif) Sélectionnez un ou plusieurs champs qui serviront de clés globales.
  9. (Facultatif) Si les données externes contiennent des termes que vous souhaitez remplacer, procédez de la manière suivante :
    1. Cliquez sur Rechercher et remplacer du texte à l’aide d’expressions régulières ().
    2. Entrez le texte à rechercher et remplacer.
      Vous pouvez par exemple rechercher des variantes d'un nom de pays et les remplacer par un code pays, ou remplacer un nom de format de carte natif par un alias de format de carte pris en charge.
    3. Le cas échéant, modifiez l’ordre avec les flèches haut et bas.
      Les expressions de transformation sont traitées dans l'ordre spécifié dans la boîte de dialogue Ajouter des expressions de transformation pour le champ.
    1. Cliquez sur Enregistrer.
    CONSEIL : Si nécessaire, vous pouvez sélectionner la ligne des expressions dont vous n'avez plus besoin et cliquer sur supprimer .
    Une icône de script () est affichée dans la colonne Exemple de valeur lorsque le texte du champ est remplacé par une expression régulière.
  10. (Facultatif) Cliquez sur Actualiser () pour mettre à jour les données des champs externes depuis votre source. Cette option d'actualisation est utilisée dans les situations où les données existantes ont été modifiées, de nouvelles lignes de données ont été ajoutées ou de nouvelles colonnes d'attributs ont été ajoutées.
  11. Si un champ externe n’a pas de champ correspondant dans Security Center, vous pouvez créer un champ personnalisé et l'associer maintenant : Cliquez sur Gérer les champs personnalisés, remplissez le formulaire, puis cliquez sur Enregistrer.
    Créez des champs personnalisés et associez-les aux champs externes.
    REMARQUE : Pour associer un champ externe qui est un champ personnalisé, activez l’option Afficher tous les champs externes.
  12. Cliquez sur Suivant.
  13. Dans le champ Nom de la source de données, donnez un nom à la source de données, puis cliquez sur Terminer.
  14. Cliquez sur Appliquer.

Résultats

Lorsque la synchronisation démarre, le fichier de données source est ajouté à la liste des sources de données, et les entités sont créées dans Security Center.