DataImporter - Fichier de configuration XML

AFFICHER TOUT LE CONTENU

Table des matières

Aperçu

Le fichier de configuration est un fichier texte en format XML (encodage ANSI) qui contient l'information nécessaire sur la source de données à importer. Le présent article explique le format du fichier, les balises à utiliser et comment modifier ou corriger ce fichier.

Références

Liens vers les articles reliés à l'exécution de l'importation et aux spécifications des données sources.

Fichier de configuration XML

ATTENTION : Comme le modèle de fichier XML utilisé en exemple dans cette section est destiné à une importation à partir d'Excel 2007, 2010 (ou toute version plus récente), il est important de se référer à la section Exemple de connexion pour tout autres types d'importations ou versions antérieures d'Excel supportées .

 

Fichier exemple

<?xml version="1.0" encoding="utf-8" ?>
<Sources>
  <Source Name="EquipementsTI">
  <ConnectionString>Provider=Microsoft.ACE.OLEDB.12.0;Data Source=C:\Import\CI.xlsx;Extended Properties="Excel 12.0 Xml;HDR=YES";</ConnectionString>
        <ViewName>[Importation CI$]</ViewName>
        <Content>CI</Content>
        <IdentificationMethod>CIByName</IdentificationMethod>
        <ManageCIRetirement>false</ManageCIRetirement>
        <MainContactIdentificationMethod>UserByWindowsUsername</MainContactIdentificationMethod>
  </Source>
</Sources>

Analyse du fichier exemple

  • <Source Name="valeur"> : Nom de la source d'importation. Agit à titre de référence si l'on veut réutiliser la même source ultérieurement.
  • <ConnectionString>Provider=Microsoft.ACE.OLEDB.12.0;Data Source=C:\Import\CI.xlsx;Extended Properties="Excel 12.0 Xml;HDR=YES";</ConnectionString> : Chemin et nom du fichier contenant les données à importer.
  • <ViewName>[Importation CI$]</ViewName>
  • <Content>CI</Content>
  • <IdentificationMethod>CIByName</IdentificationMethod>
  • <ManageCIRetirement>false</ManageCIRetirement>
  • <MainContactIdentificationMethod>UserByWindowsUsername</MainContactIdentificationMethod>
     
ATTENTION : Seuls les textes en noir nécessitent des modifications. La partie en bleue doit demeurer telle quelle.



Explication des balises de bases

  • <Source Name="SERVER">
    • Le Source Name ou nom de source est une donnée importée dans la base de données à titre de référence pour indiquer d'où provient l'importation et peut être réutilisé pour les mises à jour lorsqu'il y a une gestion automatique au niveau des relations entre les CI. Cette donnée n'est pas validée, mais il est important d'entrer une valeur significative et différente pour indiquer le type de données importées (Ordinateurs, Écrans, Utilisateurs, etc.). Lors d'importation régulière, c'est sur cette valeur que le système se fit pour comparer les données possiblement à écraser.
ATTENTION : Le nom de la source ne doit contenir aucun caractère accentué (é, à, ê, â, etc.) ou d'esperluette ( & ).
  • <ConnectionString>Provider=Microsoft.ACE.OLEDB.12.0;Data Source=c:\Import\CI_TI(Équipement).xlsx;Extended Properties="Excel 12.0 Xml;HDR=YES";</ConnectionString> 
    • La balise de type ConnectionString ou chaîne de connexion, regroupe toutes les informations spécifiques à propos d'un fournisseur OLEDB et comment s'y connecter. On retrouve tous les types de connexions disponibles sur le site suivant www.connectionstrings.com. De plus, des exemples de connexion les plus utilisés figurent dans la section suivante.
  • <ViewName>[Importation CI$]</ViewName> 
    • Le ViewName ou nom de la vue à importer indique la feuille à importer si l'importation provident d'Excel et le nom de la table ou de la vue si l'importation provient d'une base de données (Access, SQL, etc.). 

Si la source de données est :

  • Excel : Mettre le nom de la feuille du chiffrier Excel entre crochets et avec le symbole ”$“ à la fin. 
    • Exemple : <ViewName>[Sheet1$]</ViewName>. 
  • SQL, Access ou autre base de données : Spécifier le nom de la table ou de la vue.
    • Exemple : <ViewName>VUE_CI</ViewName>
  • Fichier CSV : Lorsque la source de données est un fichier CSV, ne pas mettre le nom du fichier dans le chemin de la section ConnectionString, mais l'indiquer directement dans la section ViewName.
    • Exemple : <ViewName>ImportationCI.csv</ViewName>
<?xml version="1.0" encoding="utf-8" ?>
<Sources>
     <Source Name="Serveurs" >
          <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=c:\Import\;Extended Properties="text;HDR=Yes;FMT=Delimited";</ConnectionString>
          <ViewName>ImportationCI.csv</ViewName>
          <Content>CI</Content>
     </Source>
</Sources>
ATTENTIONLe nom de la vue ne doit contenir aucun caractère accentué  (é, à, ê, â, etc.) ou de tiret (caractère -).
  • <Content>CI</Content> 
    • Le Content ou contenu est la déclaration du type de données à importer, c'est-à-dire, dans quel module les données doivent être importées (CI, Utilisateurs, Fournisseurs, etc.). Cette valeur est différente d'un type d'importation à l'autre et spécifiée dans les articles reliée à chaque importation.​



Explication des balises supplémentaires

Le fichier XML peut contenir des balises supplémentaires différentes par type d'importation. Ces balises ne sont pas obligatoires et lorsqu'elles ne sont pas spécifiées, la valeur par défaut est alors utilisée.  

Pour connaitre les différentes balises selon le type d'importation, il est préférable de se référer directement à la page du type visé, selon la source d'importation désirée.

Cas typiques d'utilisation d'un fichier XML

DataImporter peut importer plusieurs sources de données. Ainsi, un chiffrier Excel peut contenir un onglet par source. L'exemple plus bas représente un fichier XML contenant 3 sources et 3 types de connexions différentes. Lors de l'exécution, DataImporter importera les 3 sources, l’une après l'autre, même si elles font référence à 3 feuilles ou 3 chiffriers différents.

Le fichier de configuration peut être sauvegardé sous n'importe quel nom. Il est également possible d'utiliser plusieurs fichiers différents, si l'on souhaite lancer DataImporter à des heures différentes en fonction des différentes sources à importer.

Exemple de fichier avec plusieurs sources et types de connexions différentes

<?xml version="1.0" encoding="utf-8" ?>
<Sources>
     <Source Name="Ordinateurs" >
          <ConnectionString>Provider=Microsoft.ACE.OLEDB.12.0;Data Source=c:\Import\CI(Equipement).xlsx;Extended Properties="Excel 12.0 Xml;HDR=YES";</ConnectionString>         
          <ViewName>[CI_Ordinateur$]</ViewName>
          <Content>CI</Content>
     </Source>
     <Source Name="Ecran" >
          <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Import\CI(Equipement).mdb</ConnectionString>
          <ViewName>[CI_Ecran$]</ViewName>
          <Content>CI</Content>
     </Source>
     <Source Name="RelationEcranOrdi" >
         <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Import\;Extended Properties="text;HDR=Yes;FMT=Delimited";</ConnectionString>
         <ViewName>CI_Relation.csv</ViewName>
         <Content>CIRelation</Content>
     </Source>
</Sources>

Exemples de types de connexion

Voici les connexions les plus utilisées. Selon la source de données, il faut modifier la section ConnectionString du fichier XML. 
Pour de plus amples informations, se référer au site sur les sources de données ODBC : www.connectionstrings.com.

  • Excel 97 - 2003 :
    • <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Import\MonFichier.xls;Extended Properties="Excel 8.0;HDR=Yes;IMEX=1";</ConnectionString> 
  • Excel 2007 - 2010 :
    • <ConnectionString>Provider=Microsoft.ACE.OLEDB.12.0;Data Source=C:\Import\MonFichier.xlsx;Extended Properties="Excel 12.0 Xml;HDR=YES";</ConnectionString>
  • Access 2003 :
    • <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Import\MaBaseDeDonnees.mdb</ConnectionString>
  • Access 2007 :
    • <ConnectionString>Provider=Microsoft.ACE.OLEDB.12.0;Data Source=C:\Import\MaBaseDeDonnees.accdb;Persist Security Info=False;</ConnectionString>
  • Fichier CSV :
    • <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Import\;Extended Properties="text;HDR=Yes;FMT=Delimited";</ConnectionString>
    • <ViewName>MonFichier.csv</ViewName>
  • Source de donnée ODBC :
    • <ConnectionString>"Provider=MSDASQL;DSN=dsnName;UID=NomUsager;PWD=MotDePasse;";</ConnectionString>
    • <ViewName>MaVue</ViewName>

Trucs et astuces

  • Si la source de données est disponible en format ODBC, il faut d'abord installer un pilote ODBC et configurer un DSN approprié avant d'utiliser le Fournisseur OLEDB pour ODBC (MSDASQL).
  • Si des problèmes sont rencontrés à identifier l'erreur contenue dans le fichier de configuration XML, un valideur en ligne est disponible chez w3Schools XML Validator
  • Pour ce faire, copier le contenu du fichier XML dans la boite Syntax-Check Your XML avant d'appuyer sur le bouton Validate.
X
Aidez-nous à améliorer l’article








Aidez-nous à améliorer l’article