Import d'utilisateurs

Vous avez la possibilité d'importer des utilisateurs, accompagnés des filtres et groupes associés, à partir de fichiers Excel, de sources LDAP ou d'une combinaison des deux.

Nous vous recommandons d'avoir une tâche d'import par ensemble d'utilisateurs, de groupes et de filtres. Vous pouvez avoir différentes sources pour les mêmes entités. Par exemple : un fichier Excel pour les managers et un fichier Excel pour les fournisseurs, les deux fichiers ayant un groupe ou un filtre commun. Ces deux sources doivent être jointes à la même tâche d'import. Vous pouvez modifier le chemin d'accès à vos sources Excel et LDAP, si nécessaire.

Vous devez exécuter les tâches d'import une par une. Si vous exécutez plusieurs tâches d'import à la fois, cela peut entraîner des conflits et les tâches risquent d'échouer.

Limitations

L'import présente des limitations :

• Vous ne pouvez pas importer de filtres via LDAP. Vous devez utiliser un fichier Excel.
• Vous ne pouvez pas importer d'e-mails de secours via LDAP. Vous devez utiliser un fichier Excel.
• Si vous devez créer ou supprimer des rôles de sécurité, vous devez le faire manuellement dans la Console Web Qlik Nprinting. Consultez : Gestion des rôles
• Vous pouvez procéder à des imports à partir de forêts, d'arbres et de domaines LDAP différents de ceux du serveur Qlik NPrinting. Notez cependant que les affiliations croisées entre les forêts ne sont pas supportées.
• Lors de l'import d'utilisateurs via LDAP, les valeurs de paramètres régionaux et de fuseaux horaires ne sont pas disponibles. Les utilisateurs importés de cette manière utiliseront par défaut l'anglais et le fuseau horaire UTC. Vous pouvez définir des valeurs différentes pour les paramètres linguistiques et les fuseaux horaires en important des utilisateurs à partir d'un fichier Excel ou en les modifiant manuellement. Le réimport des mêmes utilisateurs via LDAP n'écrasera pas les valeurs de paramètres régionaux et de fuseaux horaires.

L'import d'utilisateurs via Excel présente des limitations :

• Si des groupes, des rôles ou des filtres ajoutés sur la ligne n'existent pas, ils sont ignorés.

• Si le nom d'un filtre, d'un utilisateur ou d'un rôle comporte des virgules, utilisez des guillemets doubles comme délimiteurs. Exemple : "Jeremy Martinson, Jr."

• Si une valeur de champ comporte des guillemets doubles, des espaces de début/fin ou le caractère { ou }, vous devez commencer et terminer la chaîne par des guillemets doubles. Il est nécessaire d'insérer des guillemets doubles deux fois pour les différencier des guillemets d'échappement.

  Exemple :

  • [Country]={" Italy, France ", "Germany",Spain} => " Italy, France ","Germany","Spain"
  • [Country]={"""Italy"""} => ""Italy""
  • [Country]={"{Sweden}"} => {Sweden}

• Pour pouvoir importer un champ contenant des espaces de début et de fin, assurez-vous que la chaîne commence et se termine par des crochets.

  Exemple : [ Country ]={Italy}, CountryBorn ={Italy} => " Country "={Italy}, "CountryBorn"={Italy}

• Vous ne pouvez pas insérer de caractère [ ou ] comme noms de champ.

• Vous pouvez supprimer des champs de filtre existants en ajoutant des champs (valeurs, valeurs numériques ou colonnes de formule) dotés d'un nom valide et d'une liste de valeurs vide. La case Mettre à jour les filtres en cas de modification doit être cochée.

  Exemple :

  • Entrée [Country] => ignorée
  • Champ de filtre [Country]={} => avec nom de pays retiré

 

Syntaxe d'import des documents Excel

Créez un fichier Excel en respectant scrupuleusement les noms suivants dans les feuilles de calcul et les colonnes. Vous ne pouvez pas réorganiser ou retirer des colonnes. Vous ne pouvez pas réorganiser ou retirer des feuilles de calcul.

Si vous souhaitez vous procurer un fichier Excel contenant des exemples d'utilisateurs à des fins de test, rendez-vous sur Fichiers exemples, téléchargez le fichier Examples.zip, puis ouvrez le document Recipients.xls.

Syntaxe d'import de filtres

La première feuille de calcul contient les définitions de filtre. Si une valeur ou une formule contient des virgules, utilisez des guillemets doubles comme délimiteurs. Par exemple : [SalesmanName]={"Jeremy Martinson, Jr.", Tom Lindwall}.

Si un filtre utilise la fonction Sélectionner les valeurs exclues pour exclure des valeurs, ajoutez <excluded> à la fin. Par exemple : [CategoryName]={Babywear, Men´s Wear, Women's Wear}<excluded>

L'attribut <override> peut être utilisé lors de l'importation de champs de filtre à partir d'Excel avec l'indicateur Remplacer les valeurs activé. Par exemple :

• [Country]={Sweden}<override>
• [Country]={"France"}<override,excluded>

Syntaxe d'import d'utilisateurs

La deuxième feuille de calcul contient les définitions d'utilisateur.

Dans les champs E-mail de secours, vous pouvez ajouter plusieurs adresses e-mails, séparées par deux-points. Votre fournisseur de messagerie détermine le nombre d'adresses qui peuvent être ajoutées à chaque champ.

Syntaxe d'import de groupes

La troisième feuille de calcul contient les définitions de groupe.

Syntaxe d'import des sources LDAP

Syntaxe des connexions

Syntaxe des attributs d'entrée

Les attributs d'entrée doivent refléter les noms d'attribut de votre serveur LDAP.

Syntaxe avancée

Active directory

Les utilisateurs Active Directory doivent remplacer la valeur Identification de l'utilisateur inetOrgPerson par user ou person. Par défaut, tous les groupes sont importés. Si vous souhaitez importer un groupe spécifique, utilisez le champ Autre chemin d'accès au groupe ou Filtres de groupe supplémentaires.

Fusion des données source d'import

La stratégie de fusion fait référence aux règles à appliquer lors de la fusion des données provenant d'une étape d'import avec les résultats des étapes précédentes. La synchronisation des résultats de la fusion des données source d'import dans le référentiel Qlik NPrinting ne fait pas appel à une stratégie de fusion. Cette opération dépend des paramètres définis pour votre tâche d'import. Consultez : Création d'une tâche d'import.

Clé de fusion de l'utilisateur

Ce paramètre spécifie le champ utilisateur servant à identifier les cas où un utilisateur récupéré à partir des sources d'import fait référence à un utilisateur existant. L'algorithme utilisé pour fusionner les données utilisateur est basé sur des stratégies de fusion d'entités et d'associations. Pour permettre la correspondance des entités importées par rapport au référentiel Qlik NPrinting, le champ Nom d'utilisateur est toujours utilisé. Cette clé de fusion n'est donc pas prise en compte.

Stratégie de fusion de l'entité

Ce paramètre spécifie l'algorithme utilisé pour fusionner les données récupérées à partir de différentes sources d'import faisant référence à la même entité (utilisateur, groupe ou filtre). Il n'est pas appliqué aux champs mappant une association à une autre entité (filtres utilisateur, rôles, groupes et champs de filtre).

Les valeurs supportées sont Remplacer, Mettre à jour si manquant et Ignorer. Les données récupérées à partir d'une source d'import antérieure sont les suivantes :

• Remplacer : données supprimées et remplacées par l'import le plus récent. Les colonnes présentes dans une étape antérieure mais absentes de l'étape la plus récente ne sont pas modifiées.
• Mettre à jour si manquant : données ignorées, à l'exception des valeurs absentes des tâches d'import précédentes, qui sont ajoutées. Cela s'applique aux colonnes manquantes et non aux cellules vides.
• Ignorer : données ignorées.

Stratégie de fusion de l'association

Ce paramètre spécifie l'algorithme utilisé pour fusionner les données récupérées à partir de différentes sources d'import faisant référence à la même entité (groupe, utilisateur ou filtre). Il est appliqué aux champs mappant une association à une autre entité (filtres utilisateur, rôles, groupes et champs de filtre).

Les valeurs supportées sont Remplacer, Fusionner et Ignorer. Les entités récupérées à partir d'étapes d'import antérieures sont les suivantes :

• Remplacer : données supprimées et remplacées par l'import le plus récent. Les colonnes présentes dans une étape antérieure mais absentes de l'étape la plus récente ne sont pas modifiées.
• Fusionner : données fusionnées.
• Ignorer : données ignorées.

Attribution de droits d'import à un rôle de sécurité

Pour importer des utilisateurs, vous devez vous connecter à Console Web Qlik Nprinting en tant qu'utilisateur doté des droits Tâche d'import dans au moins un rôle de sécurité. Les utilisateurs dotés du rôle Administrateur disposent des droits Tâche d'import. Si vous appliquez le rôle Administrateur à un utilisateur, celui-ci disposera également de tous les autres privilèges d'administration.

Vous pouvez également attribuer des droits d'import à un rôle de sécurité sans lui accorder d'autres privilèges d'administration.

Procédez comme suit :

1. Connectez-vous à Console Web Qlik Nprinting en tant qu'utilisateur disposant du rôle de sécurité Administrateur.
2. Dans le menu principal de Qlik NPrinting, cliquez sur le menu déroulant Admin.
3. Cliquez sur Rôles de sécurité.
4. Cliquez sur le rôle auquel vous souhaitez attribuer des droits Tâche d'import.
5. Cliquez sur l'onglet Applications.
6. Faites défiler la liste jusqu'aux cases à cocher des droits Tâche d'import.
7. Cochez la case située à gauche du paramètre Tâche d'import pour attribuer tous les droits des tâches d'import au rôle.

   Vous pouvez également sélectionner uniquement des droits spécifiques en sélectionnant les cases à cocher appropriées.

8. Cliquez sur Enregistrer.

Création d'une tâche d'import

Procédez comme suit :

1. Dans le menu principal de Qlik NPrinting, sélectionnez Tâches, puis choisissez Tâche d'import.
2. Cliquez sur Créer une tâche d'import.

3. Renseignez le champ Nom de la tâche. Par exemple : Import Users.

4. Vérifiez que la case Activé est cochée. Sinon, la tâche sera ignorée par Qlik NPrinting Engine.
5. Sous Sources, cliquez sur Ajouter une source. Dans le menu déroulant, sélectionnez Importer à partir d'Excel ou Importer à partir de LDAP.
6. Les étapes suivantes dépendent du type de la source :

   1. Excel : ajoutez le Chemin du fichier d'import (serveur) du Qlik NPrinting Server sur lequel le fichier Excel est enregistré.

      Par exemple : C:\ProgramData\NPrinting\Imports\NP_Web_Imports.xlsx. Il ne s'agit pas du chemin d'accès au fichier situé sur votre ordinateur local.

      Vous pouvez également utiliser un chemin d'accès au réseau informatique distant. L'utilisateur Windows qui exécute Service de planification Qlik Nprinting doit avoir accès au dossier distant à partir de Qlik NPrinting Server. Consultez : Syntaxe d'import des documents Excel.

   2. LDAP : ajoutez le Chemin d'accès à la connexion de la source LDAP.

      Renseignez les autres champs si nécessaire. Consultez : Syntaxe d'import des sources LDAP.

7. Vérifiez que la case Activé est cochée. Sinon, la source sera ignorée par Qlik NPrinting Engine.
8. Cliquez sur Ajouter une source pour ajouter une autre source.
9. Cliquez sur , à droite, pour supprimer une source. Cliquez sur pour la dupliquer.
10. Sous Paramètres, cochez les cases spécifiant la façon dont vous souhaitez gérer les conflits de fusion :
    • Créer les utilisateurs si nécessaire
    • Mettre à jour les utilisateurs en cas de modification

    • Supprimer les utilisateurs absents des sources d'import récentes

      Seuls les utilisateurs ajoutés lors d'une précédente exécution du même import seront supprimés. Les autres utilisateurs, comme ceux qui ont été ajoutés manuellement, ne seront pas supprimés.

    • Remplacer les associations d'utilisateurs existantes (filtres, rôles et groupes)

      Les associations d'utilisateurs existantes seront supprimées si elles ne sont pas présentes dans le fichier d'import. Elles seront remplacées par les associations du nouveau fichier.

    • Supprimer les groupes absents des sources d'import récentes

      Seuls les groupes ajoutés lors d'une précédente exécution du même import seront supprimés. Les autres groupes, comme ceux qui ont été ajoutés manuellement, ne seront pas supprimés.

    • Créer les filtres si nécessaire
    • Mettre à jour les filtres en cas de modification

    • Supprimer les filtres absents des sources d'import récentes

      Les filtres ajoutés lors d'une précédente exécution du même import seront supprimés. Les autres filtres, comme ceux qui ont été ajoutés manuellement, ne seront pas supprimés.

    • Remplacer les champs de filtre existants

      Les champs de filtre existants seront supprimés s'ils ne figurent pas dans le fichier d'import. Ils seront remplacés par les champs de filtre provenant du fichier d'import.

11. Sous Notifications, vous pouvez sélectionner Envoyer des notifications de tâche. Un e-mail est alors envoyé aux adresses indiquées sous Paramètres > Tâches. Consultez : Notifications d'exécution des tâches.
12. Cliquez sur Créer.

Exécution de la tâche d'import

Vérification de l'état des tâches

La page principale Tâche d'import de filtres et destinataires présente l'état de vos tâches d'import.

• Dernière exécution : affiche la date et l'heure de la dernière exécution.
• État de la dernière exécution : si une tâche s'est déroulée normalement, cette colonne affiche la mention Terminé. Sinon, elle indique Échec de l'opération.
• Progression de la dernière exécution : affiche l'état d'avancement d'une tâche active.

• Journal de la dernière import : cliquez sur le lien Télécharger pour consulter les derniers journaux associés à la tâche.

  Si une erreur se produit au cours de l'import, le fichier journal affiche le message d'erreur dans la langue des paramètres régionaux de l'ordinateur sur lequel l'import a été exécuté. L'import de tous les utilisateurs s'interrompt à la première erreur et l'état antérieur à l'import est restauré. Dans le téléchargement des fichiers journaux, à chaque action d'import correspond une ligne de journal. Les journaux relatifs à l'exécution des tâches comprennent uniquement les entrées de journal principales, consignant les erreurs et les informations de progression.

• Activée : si cette case n'est pas cochée, la tâche sera ignorée par Qlik NPrinting Engine.
• Actions : cliquez sur l'icône pour modifier, supprimer, exécuter ou tester la tâche.

Vérifiez les utilisateurs importés en consultant la page Utilisateurs, qui affiche les utilisateurs qui viennent d'être créés. Vous pouvez vérifier que les filtres associés ont bien été créés en ouvrant l'onglet Filtres.