Aperçu

L'importation de la relation entre les utilisateurs et les CIs permet d'ajouter les utilisateurs qui utilisent un CI. Il est important d'importer les utilisateurs et les CIs avant d'effectuer ce type d'importation.

Références

Liens vers les articles reliés à l'importation des utilisateurs utilisant un CI et à la configuration du fichier XML

• Importation des CIs​
• Fichier de configuration XML
   
• Retour à la page principale de DataImporter
• Retour à la liste des types de sources d'importation

​

Ce que vous devez savoir :  

Les fichiers modèles de référence (.xlsx et .xml) pour l'importation sont inclus dans le fichier compressé CI_FR.zip.  
 

Champs disponibles pour l'importation des relations d'utilisateurs de CIs

Champs requis

• CI – Texte(125)
  • Le nom du CI à lier.
• Utilisateur
  • L'identifiant de l'utilisateur à lier au CI.
  • Pour plus de détail, se référer à la  Méthode d'identification de l'utilisateur.

Contenu du fichier de configuration (CIUser.xml)

La déclaration de la source se fait en indiquant la valeur CIUser dans la balise <Content>.

<?xml version="1.0" encoding="utf-8" ?>
<Sources>
     <Source Name="ImportationUtilisateursCI">

<ConnectionString>Provider=Microsoft.ACE.OLEDB.12.0;Data Source=c:\Import\CI_FR.xlsx;Extended Properties="Excel 12.0 Xml;HDR=YES";</ConnectionString>
<ViewName>[Importation Utilisateur CI$]</ViewName>
<Content>CIUser</Content>

<!-- Balises supplémentaires -->
<UserIdentificationMethod>UserByWindowsUsername</UserIdentificationMethod><ManageRelations>False</ManageRelations>

     </Source>
</Sources>

Référez-vous à l'article Fichier de configuration XML qui explique comment programmer les références à vos sources de données.

Balises supplémentaires pour l'importation des relations d'utilisateurs de CIs

Le fichier XML pour l'importation des relations entre les utilisateurs et un CI peut contenir des balises supplémentaires. Ces balises ne sont pas obligatoires et lorsqu'elles ne sont pas spécifiées, la valeur par défaut est alors utilisée, donc, dans le cas présent, l'option ne sera pas activée.

Méthode d’identification de l’utilisateur

Dans le fichier XML pour l'importation des relations entre utilisateurs et CI, il est possible de spécifier de quelle façon l'utilisateur sera recherché. Cette valeur devient la clé lors de l'importation. Si cette balise n'est pas précisée, la valeur par défaut sera le nom d’utilisateur Windows de l'utilisateur.

Valeurs permises pour la balise UserIdentificationMethod :

• UserByID : Numéro d’employé de l’utilisateur.
• UserByName : Prénom et nom de l’utilisateur (sous le format Martin Tremblay).
• UserByWindowsUsername (Valeur par défaut) : Nom d’utilisateur Windows de l'utilisateur. Dans la source des données, le format avec plus d'un nom d'utilisateur n'est pas accepté, comme par exemple "sile01;esil18". Il faut renseigner un seul des noms d'utilisateur.

Pour utiliser cette balise, ajouter la ligne suivante dans le fichier XML :

<UserIdentificationMethod>VALEUR</UserIdentificationMethod>

Gestion du retrait de la relation entre utilisateurs et CI

DataImporter peut désactiver et réactiver la relation entre utilisateurs et CI, selon la présence ou non dans la source de données.Le retrait ou l'ajout de la relation se fait en fonction des éléments présents dans la source.

La balise ManageRelations permet de la gérer de façon automatique. Si cette balise n'est pas précisée, la valeur par défaut est à False et donc l'option n'est pas activée.

Fonctionnement de cette option :

• Lorsque cette option est activée, on doit absolument s'assurer que le nom de la source; le Source Name dans le fichier XML, est toujours le même pour gérer ces relations.
  • Par exemple <Source Name="GestionDesRelationsUtilisateurs">.
  • C'est important de ne pas mélanger une importation où on veut faire la gestion des relations avec une autre, car si on fait l'import avec la même source, mais sans les relations, toutes les relations préalablement importées avec cette source seront effacées. 
• Lorsqu'un utilisateur ne fait plus partie de la source de données, le système retire la relation au moment de l'importation.

Valeurs permises pour la balise ManageRelations :

• True : Fera la gestion des relations entre utilisateurs et CI, chaque fois qu'un import avec le même nom de source est fait.
• False : Valeur par défaut qui ne tiendra pas compte des relations déjà existantes entre utilisateurs et CI. 
   

Pour utiliser cette balise, ajouter la ligne suivante dans le fichier XML :

<ManageRelations>VALEUR</ManageRelations>