DataImporter - Importation des utilisateurs

Table des matières

Aperçu

Cet article présente les paramètres pour faire l'importation des utilisateurs dans Octopus.



Références

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é Utilisateurs.zip.  
 

Champs requis

  • Prénom - Texte(100)
    • Représente le prénom de l'utilisateur.
  • Nom - Texte(100)
    • Représente le nom de famille de l'utilisateur.

Champs optionnels

  • NuméroEmployé – Texte (50)
    • Si le numéro d'employé est utilisé comme méthode d'identification de l'utilisateur lors de l'importation, il doit être unique.
    • Si le numéro d'employé est utilisé comme mode d'authentification du portail Web, il doit être unique.
  • UtilisateurWindows - Texte (50)
    • Si le nom d'utilisateur Windows est utilisé comme méthode d'identification de l'utilisateur lors de l'importation, il doit être unique.
    • Si le nom d'utilisateur Windows est utilisé comme mode d'authentification du portail Web, il doit être unique.
  • IdentifiantExterne - Texte (50)
    • Identifiant propre à l'utilisateur qui peut être utilisé pour reconnaitre un compte de manière unique, souvent à partir d'un autre système.
    • Ce champ est utilisé par l'outil ADSIReader pour reconnaitre les comptes Active Directory.
  • Actif - Booléen
    • Les valeurs acceptées sont : 1 ou 0, True ou False, Oui ou Non.
    • L'utilisateur sera actif par défaut, si ce champ n'est pas inclus.
ATTENTION
Par défaut, lors de la désactivation d'un utilisateur, Octopus retire les liens entre l'utilisateur et ses CIs. Il est possible de modifier ce comportement et faire en sorte que l'état d'un utilisateur n'affecte pas les liens avec ses CI.

Communiquer avec le Centre de services Octopus pour faire modifier cette option au besoin. 
  • ComptePartagé - Booléen
    • Les valeurs acceptées sont : 1 ou 0, True ou False, Oui ou Non.

    • Le compte ne sera pas partagé par défaut, si ce champ n'est pas inclus.

  • Département - Texte (100)
    • Le système va créer le département lors de l'importation s'il n'existe pas.
  • SousDépartement - Texte (100)
    • Le système va créer le sous-département lors de l'importation s'il n'existe pas.
    • Lorsqu'un sous-département est spécifié, le département devient obligatoire.
  • SupérieurImmédiat
    • Dois contenir l'identifiant unique du supérieur immédiat - tel que spécifié par la méthode d'identification.
    • L'utilisateur doit exister dans Octopus, car il ne sera pas ajouté lors de l'importation et générera une erreur.
    • Il n'est pas nécessaire de faire apparaitre la ligne contenant l'identifiant du superviseur avant celui de l'employé.
    • Si un usager est indiqué comme étant son propre supérieur immédiat, le système va accepter la valeur, mais donnera tout de même un avertissement lors de l'importation.
  • Titre - Texte (500)
    • Représente le titre de l'utilisateur.
  • Langue
    • Les valeurs acceptées sont : Anglais ou Français.
    • Par défaut, si ce champ n'est pas importé, il sera configuré avec la langue par défaut de la base de données.
  • VIP - Booléen
    • Les valeurs acceptées sont : 1 ou 0, True ou False, Oui ou Non.
    • Par défaut, si ce champ n'est pas importé, il ne sera pas activé lors de la création et restera inchangé lors d'une mise à jour.
  • TéléphoneBureau - Texte (50)
  • PosteTéléphonique - Texte (50)
  • TéléphoneCellulaire - Texte (50)
  • Téléavertisseur - Texte (50)
  • Courriel - Texte (320)
    • L'adresse courriel doit avoir un format valide, c’est-à-dire, contenir un @ et un point (.) pour .com, .ca, .gouv.qc.ca, etc.
  • Site – Texte (200)
    • Le système va créer le site (ou le sous-site) lors de l'importation s'il n'existe pas.
    • Il est possible d'importer plusieurs niveaux de site, ainsi vous pouvez avoir un site principal et ses sous-sites.
ATTENTION : Pour l'importation de sous-sites, vous devez séparer chaque sites de votre champ par le caractère "|" (barre verticale), en respectant le format suivant :
VotreSite|VotreSous-Site1|VotreSous-Site2|VotreSous-Site3 et ainsi de suite.
Tous vos sites et sous-sites seront donc importés via le même champ dans Excel, Access ou autre source ODBC. Le système va créer les sites et les sous-sites s'ils n'existent pas.
Exemple: Canada|Québec|Montréal|Montréal-Est
  • Local – Texte (50)
    • Représente le local (bureau) de l'utilisateur.
  • Note - Texte (2000)
    • Ce champ permet d'importer toute information supplémentaire qui ne peut être reliée à un champ existant de la fiche utilisateur.
    • Ce champ est remplacé par les données importées à chaque importation. Le programme n'ajoute pas l'information, mais la remplace.
  • DélègueSesApprobationsÀ
    • Dois contenir l'identifiant unique de la personne déléguée - tel que spécifié par la méthode d'identification.

    • L'utilisateur doit exister dans Octopus, car il ne sera pas ajouté lors de l'importation et générera une erreur.

    • Il n'est pas nécessaire de faire apparaitre la ligne contenant l'identifiant du délégué avant celui de l'employé.

    • Si un usager est indiqué comme étant son propre propre délégué, le système va donner une erreur lors de l'importation et la ligne ne sera pas importée.

Fichier de configuration (XML)

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

ATTENTION : Le modèle de fichier XML utilisé en exemple est pour une importation à partir d'Excel 2007 ou 2010. Pour l'explication des balises générales à tous les types d'importation ou pour d'autres types de fichiers, veuillez vous référer à l'article Fichier de configuration XML.
<?xml version="1.0" encoding="utf-8" ?>

<Sources>

     <Source Name="ImportationUtilisateurs">

          <ConnectionString>Provider=Microsoft.ACE.OLEDB.12.0;Data Source=c:\Import\Utilisateurs.xlsx;Extended Properties="Excel 12.0 Xml;HDR=YES";</ConnectionString>

          <ViewName>[Import Utilisateur$]</ViewName>

          <Content>user</Content>

          <IdentificationMethod>UserByWindowsUsername</IdentificationMethod>

          <DepartmentIdentificationMethod>DepartmentByName</DepartmentIdentificationMethod>

          <EmptyValueHandling>NoChange</EmptyValueHandling>


     </Source>

</Sources>

Explication de balise supplémentaire

Le fichier XML pour l'importation des utilisateurs peut contenir 3 balises supplémentaires. Ces balises ne sont pas obligatoires et lorsqu'elles ne sont pas spécifiées, les valeurs par défaut sont alors utilisées.

Méthode d’identification de l’utilisateur

Dans le fichier XML pour l'importation des utilisateurs, il est possible de spécifier de quelle façon l'utilisateur, son supérieur immédiat ou une personne déléguée aux approbations seront identifiés. 

Si dans une même importation on combine la création d'utilisateur avec l'ajout du supérieur immédiat et/ou la délégation d'approbation, la même méthode d'identification doit être utilisée. 

Valeurs permises pour la balise IdentificationMethod :

  • UserByID (Valeur par défaut) : Utilise le numéro d'employé.
  • UserByName : Utilise le prénom et le nom.
  • UserByNameAndPhoneExtension : Utilise le prénom, le nom et le poste téléphonique.
  • UserByWindowsUsername : Utilise le nom d'utilisateur Windows.
  • UserByExternalID: Utilise l'identifiant externe.
Ce que vous devez savoir : 

Si dans une même importation on combine la création d'utilisateurs avec l'ajout du supérieur immédiat et/ou la délégation d'approbation, la même méthode d'identification doit être utilisée. 

 

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

<IdentificationMethod>VALEUR</IdentificationMethod>

Méthode d’identification du département

Dans le fichier XML pour l'importation des utilisateurs, il est possible de spécifier de quelle façon le département et le sous-département de l'utilisateur seront identifiés. 

Valeurs permises pour la balise DepartmentIdentificationMethod :

  • DepartmentByName (Valeur par défaut) : Utilise le nom pour reconnaître le département et le sous-département.
  • DepartmentByNumber : Utilise le numéro pour reconnaître le département et le sous-département.


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

<DepartmentIdentificationMethod>VALEUR</DepartmentIdentificationMethod>

Gestion des champs vides

DataImporter permet de nettoyer les données contenues dans Octopus lorsque des champs vides sont rencontrés. Si cette balise n'est pas présente, la valeur par défaut NoChange sera utilisée.

Si vous voulez utiliser ce paramètre dans le cadre d'un import, il est important que votre source de données contienne uniquement les colonnes sur lesquelles agir. DataImporter tentera de nettoyer systématiquement toutes les colonnes présentes. Vous pourrez ainsi nettoyer tous les champs à l'exception de :

  • Les champs requis dans l'application.
  • Les champs rendus obligatoires par la configuration de votre base de données Octopus.
  • Les champs qui imposent un nombre limité de valeurs acceptées, par exemple les champs de type booléen (oui/non).

Valeur permise pour la balise EmptyValueHandling :

  • Clear : la valeur présente dans Octopus sera nettoyée et le champ sera vide.
  • NoChange (Valeur par défaut) : Les champs vides dans la source de donnée sont ignorés et la valeur existante dans Octopus est conservée.


Pour utiliser cette balise, il suffit d'ajouter la ligne suivante dans le fichier XML : 
 

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








Aidez-nous à améliorer l’article