DataImporter - Importation des contrats de location

AFFICHER TOUT LE CONTENU

Table des matières

Aperçu

Cet article explique comment importer les contrats de location. 

Références

Liens vers les articles reliés à l'importation de contrats de location 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é ContratsLocation.zip.  
 

Champs disponibles pour l'importation des contrats de location

Champs requis

  • Numéro - Texte(50)​
    • Représente le numéro du contrat de location.
    • Peut contenir des lettres ou des chiffres.
    • Le numéro n'a pas besoin d'être unique.
  • Fournisseur - Texte(500)
    • Nom du fournisseur du contrat de location.
    • Le système va créer le fournisseur lors de l'importation s'il n'existe pas.
    • Cette information est reliée au module Fournisseur. Pour plus de détail, se référer à l'importation des fournisseurs.
  • DateDébut - Date et heure
    • Représente la date de début du contrat de location et doit être inférieur à la date de fin.
    • Le format de la date doit être compatible avec les réglages du serveur Octopus (AAAA-MM-JJ HH).
  • DateFin - Date et heure
    • Représente la date de fin du contrat de location et doit être supérieur à la date de début.
    • Le format de la date doit être compatible avec les réglages du serveur Octopus (AAAA-MM-JJ).

Champs optionnels

  • Site - Texte(200)
    • Fait référence au nom du site associé au contrat, si pertinent. 
    • Le site est configurable à partir du menu Outils > Gestion des données de référence... > Général > Sites.
    • Pour spécifier des sous-sites, utilisez la barre verticale "|" pour séparer la hiérarchie.Exemple

ATTENTION : Pour l'importation de sous-sites, vous devez séparer chaque site 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
  • NuméroFacture – Texte(50)
  • NuméroBonCommande - Texte(50)
    • Représente le numéro de bon de commande du contrat de location.
  • Coût – Décimal
    • Coût total du contrat de location.
    • La valeur doit être comprise entre 0 et 9 999 999,99.
    • Exemple : 1234567,89.
  • CentreCoûts – Texte(50)
    • Le centre de coût dans lequel est imputé le coût du contrat de location.
  • Description - Texte(5000)
    • La description du contrat de location.
  • Note - Texte(5000)
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 (ContratLocation.xml)

La déclaration de la source se fait en indiquant la valeur LeaseContract 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 : Cette exemple de fichier XML est pour une importation à partir d'Excel 2007 ou 2010.-->

<?xml version="1.0" encoding="utf-8" ?>

<Sources>
     <Source Name="ImportationContratLocation">

<ConnectionString>Provider=Provider=Microsoft.ACE.OLEDB.12.0;Data 
Source=C:\Import\ContratsLocation.xlsx;Extended Properties="Excel 12.0 Xml;HDR=Yes";</ConnectionString>
     <ViewName>[Import ContratLocation$]</ViewName>
     <Content>LeaseContract</Content>

     <!-- Balises supplémentaires -->
     <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 contrats de location

Le fichier XML pour l'importation des contrats de location peut contenir 1 balise supplémentaire. Cette balise n'est pas obligatoire et lorsqu'elle n'est pas spécifiée, la valeur par défaut est alors utilisé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'un import, il est important que votre source de données doit contenir 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ée 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ées 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