DataImporter - Importation des départements

Table des matières

Aperçu

Cet article présente les paramètres pour faire l'importation des départements 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é Départements.zip.  
 

Champs requis

  • Nom - Texte (100)
    • Représente le nom du département.
    • Ce champ sera obligatoire lorsque l'importation des départements utilise la reconnaissance par nom.
  • Numéro - Texte (100)
    • Représente le numéro du département.
    • Ce champ sera obligatoire lorsque l'importation des départements utilise la reconnaissance par numéro.

Champs optionnels

  • Gestionnaire – Texte (100)
    • Représente le gestionnaire responsable du département.
    • L'utilisateur doit être existant dans Octopus et identifiable de manière unique pour que cette section fonctionne.
    • La méthode de reconnaissance du gestionnaire est définie en utilisant la balise ManagerIdentificationMethod.
  • DépartementParent - Texte (100)
    • Identifie le département parent dont celui-ci relève, dans le cas d'un sous-département.
    • Le département parent doit être spécifié selon le même critère de reconnaissance.(Par nom ou par numéro)
  • CentreDeCoût - Texte (50)
    • Texte libre permettant d'attribuer un centre de coûts au département.
    • Le champ centre de coûts ne sera apparent que si le mode de centre de coûts est activé dans Octopus.

Fichier de configuration (XML)

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

<?xml version="1.0" encoding="utf-8" ?>
<Sources>
     <Source Name="ImportationDepartements">
          <ConnectionString>Provider=Microsoft.ACE.OLEDB.12.0;Data Source=Utilisateurs.xlsx;Extended Properties="Excel 12.0 Xml;HDR=YES";</ConnectionString>
          <ViewName>[Import Departement$]</ViewName>
          <Content>Department</Content>
          <DepartmentIdentificationMethod>DepartmentByName</DepartmentIdentificationMethod>
          <ManagerIdentificationMethod>UserByWindowsUsername</ManagerIdentificationMethod>
          <EmptyValueHandling>NoChange</EmptyValueHandling>
     </Source>
</Sources>
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.

Explication des balises supplémentaires

Le fichier XML pour l'importation des départements 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 du département

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

Valeurs permises pour la balise DepartmentIdentificationMethod :

  • DepartmentByName (Valeur par défaut) : Utilise le nom du département.
  • DepartmentByNumber : Utilise le numéro du département.

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

<DepartmentIdentificationMethod>VALEUR</DepartmentIdentificationMethod>

Méthode d’identification du gestionnaire du département

Dans la déclaration de la source de données, il est possible de spécifier de quelle façon le gestionnaire du département sera recherché. Si cette balise n'est pas précisée, la valeur par défaut sera le nom d'utilisateur Windows.

Valeurs permises pour la balise MainContactIdentificationMethod :

  • UserByExternalID : Identifiant unique externe à Octopus du gestionnaire.
  • UserByID : Numéro d’employé du gestionnaire.
  • UserByName : Prénom et nom du gestionnaire (sous le format Martin Tremblay).
  • UserByWindowsUsername (Valeur par défaut) : Nom d’utilisateur Windows du gestionnaire.

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

<ManagerIdentificationMethod>VALEUR</ManagerIdentificationMethod>

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ésentant des valeurs vides. 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).


Valeurs permises 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