DataImporter - Importation des relations entre CI

AFFICHER TOUT LE CONTENU

Table des matières

Aperçu

L'importation des relations entre les CI permet de relier deux ou plusieurs CI ensemble et d'ajouter un commentaire à la relation. Avant d'effectuer ce type d'importation, vous devez préalablement importer les CIs à mettre en relation et configurer les types de relation.



Références

Liens vers les articles reliés à l'importation des relations entre CIs 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 entre CIs

Champ requis

  • CI1 – Texte(125)
  • CI2 – Texte(125)
  • Relation
    • Nom de la relation à créer entre les deux CIs.
    • Les relations doivent exister entre les deux types de CI avant d'effectuer ce type d'importation.
    • Pour gérer les relations entre les CIs, vous devez :
      • vous assurez que le type de relation existe à partir du menu Outils > Gestion des données de référence... > CI > Types de relations.
      • vous assurez que les deux types de CI sont en relation à partir du menu Outils > Gestion des données de référence... > CI > Types > sélectionner un des deux types de CI à mettre en relation et allez à l'onglet Relations.

Champs optionnels

  • Note - Texte (2000)
    • Représente la note de la relation.
ATTENTION : Ce champ est remplacé par les données importées à chaque importation. Le programme n'ajoute pas l'information, mais la remplace.

Contenu du fichier de configuration (CIRelation.xml)

La déclaration de la source se fait en indiquant la valeur CIRelation 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="ImportationRelationsCI">

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

<!-- Balises supplémentaires -->
<ManageRelations>False</ManageRelations>
<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 des relations entre CI

Le fichier XML pour l'importation des relations entre CIs 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.

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.

Supression des relations qui n'existent plus entre 2 CIs

Dans la déclaration de la source de données (fichier XML), il est possible de gérer la suppression des relations entre les CI.

Fonctionnement de cette option :

  • Lorsque vous activez cette option, vous devez absolument vous assurez que le nom de la source (le Source Name dans le fichier XML) est toujours la même pour une même importation, mais toujours différent pour chaque source de données importées.
  • Lorsqu'une relation entre deux CI ne fait plus partie de la source de données, le système la retire au moment de l'importation.

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

<ManageRelations>VALEUR</ManageRelations>

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).

Valeur 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