DataImporter - Importation des relations entre les utilisateurs et les CI

AFFICHER TOUT LE CONTENU

Table des matières

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

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

Contenu du fichier de configuration (CIUser.xml)

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

ATTENTION : Le modèle de fichier XML utilisé en exemple est pour une importation à partir d'Excel 2007 ou 2010. 
<?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.

 

Ce qu'il faut savoir

Les balises supplémentaires sont sensibles aux majuscules.

Si la valeur n'est pas écrite exactement comme il est documenté, Octopus ignorera la balise et utilisera la valeur par défaut.

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. 
     
Ce qu'il faut savoir

Si ManageRelations est à True, mais que la liste des relations Utilisateurs / CI est vide toutes les relations préalablement importées avec cette source seront effacées.

On doit être très prudent avec cette balise. 

Dans Octopus, la colonne Source d'importation peut être utile dans ce contexte pour connaître l'origine du lien entre l'utilisateur et le CI. S'il la valeur est vide, c'est que le lien a été fait manuellement. 

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

<ManageRelations>VALEUR</ManageRelations>
X
Aidez-nous à améliorer l’article