DataImporter - Importation des Types de CI

AFFICHER TOUT LE CONTENU

Table des matières

Aperçu

L'importation des types de CI permet d'alimenter votre CMDB avec des types n'existant pas initialement dans l'application. Une fois les types de CI importés, il est possible d'importer les CIs associés à chacun des types.

Références

Liens vers les articles reliés à l'importation des types de 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 types de CI

Champs requis

  • DescriptionFR - Texte(100)
    • Nom du type de CI en français
  • DescriptionEN - Texte(100)
    • Nom du type de CI en anglais.

Champs optionnels

  • EstUnDocument - Booléen
    • Indique si ce type de CI contiendra un onglet document
    • Les valeurs acceptées sont : 1 ou 0, True ou False, Oui ou Non
    • Si ce champ n'est pas renseigné, la valeur par défaut est non
  • EstUnOrdinateur - Booléen
    • Indique si ce type de CI est un ordinateur
    • Les valeurs acceptées sont : 1 ou 0, True ou False, Oui ou Non
    • Si ce champ n'est pas renseigné, la valeur par défaut est non
  • DuréeDeVieThéorique - Entier
    • Représente la durée de vie, en année, du type de CI
  • ValeurDeRemplacementSuggérée - Entier
    • Indique la valeur suggérée de remplacement du type de CI
  • GroupeResponsable - Entier
    • Représente le groupe responsable de la maintenance et doit donc être un nom de groupe valide
    • Exemple : Administrateurs de système
  • Attributs
    • Représente la liste des attributs à ajouter au type de CI, chaque valeur séparée par un pipe ( | ) ou une virgule ( , ). À noter que la valeur par défaut est le pipe.
    • Exemple : Année de fabrication,Adresse IP,Adresse MAC
ATTENTION : Ce champ n'est valide que pour la version 4.2.140 ou antérieure.  Dès la version 4.2.150, ce champ sera retiré et remplacé par une importation supplémentaire.  Voir cet article pour obtenir la nouvelle façon d'importer les attributs. 
  • Catégories
    • Représente les catégories de type de CI  à ajouter, chaque valeur séparée par une virgule ( , ) ou un pipe ( | ).
    • Exemple: Tour,Ordinateur de bureau,Mini-PC,Tablette-PC
  • Icône
    • Est le lien vers l'image à lier au profil du type de CI. Doit être un lien local vers le fichier image.
    • Exemple: C:\Octopus\Icônes\StationTravail.png

Contenu du fichier de configuration (CIType.xml)

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

ATTENTION : Le modèle de fichier XML utilisé en exemple est pour une importation à partir d'Excel 2007 ou 2010. 

<!-- ATTENTION : Cet exemple de fichier XML est pour une importation à partir d'Excel
2007 ou 2010. -->

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

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

<!-- Balises supplémentaires -->
<AttributesSplitStrategy>ByPipe</AttributesSplitStrategy>
<EmptyValueHandling>NoChange</EmptyValueHandling>


     </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 de types de CI

Le fichier XML pour l'importation des types de CI peut contenir 2 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.

 

Gestion du séparateur de données

Lors de l'importation, un séparateur doit indiquer la délimitation des données. À titre d'exemple, il est requis pour l'importation d'attributs ou de catégories de préciser ce qui séparera chaque valeur à ajouter.

Les deux choix étant :

  • le pipe ( | ) 
  • la virgule ( , )

Pour préciser lequel des séparateurs doit être utilisé dans le fichier, la balise AttributesSplitStrategy doit être ajoutée au fichier XML.

Valeurs permises pour la balise AttributesSplitStrategy :

  • ByPipe (valeur par défaut)
  • ByComma

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


<AttributesSplitStrategy>VALEUR</AttributesSplitStrategy>

Dans le cas où la balise n'est pas précisée dans le fichier XML, la valeur par défaut est appliquée.

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'une importation, 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).

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, ajouter la ligne suivante dans le fichier XML : 


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








Aidez-nous à améliorer l’article