DataImporter - Importation des contrats de service - Mode externe

AFFICHER TOUT LE CONTENU

Table des matières

Aperçu

Cet article explique comment importer les contrats de service lorsque le mode de support externe est activé.
Si vous utilisez Octopus uniquement pour faire du support interne, référez-vous plutot à l'article Importation des contrats de service en mode interne.
Dans un contexte où le mode externe est activé dans votre environnement, certains champs deviennent alors obligatoires (la colone SupportExterne, le site ou le fournisseur).

Références

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

Champs disponibles pour l'importation de contrats de service externe

Champs requis

  • Numéro - Texte(50)
    • Représente le numéro du contrat.
    • Peut contenir des lettres ou des chiffres.
    • Le numéro n'a pas besoin d'être unique.
  • Type - Texte(100)
    • Type de contrat de service (Pièces et main d'oeuvre, Maintenance, Garantie prolongée, etc.).
    • Si le type n'existe pas, il sera ajouté lors de l'importation.
    • Le type de contrat de service est configurable à partir du menu Outils > Gestion des données de référence > Général > Types de contrats de service.
  • DateDébut - Date et heure
    • Représente la date de début du contrat.
    • Le format de la date doit être compatible avec les réglages du serveur Octopus, soit AAAA-MM-JJ.
  • DateFin - Date et heure
    • Représente la date de fin du contrat 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, soit AAAA-MM-JJ.
  • SupportExterne - Bouléen
    • Indique s'il s'agit d'un contrat de support externe (vendu) ou interne (acheté).
    • Les valeurs acceptées sont : 1, True ou Oui pour Vendu, et 0, False ou Non pour Acheté.
  • Site - Texte(500)
    • Le champ Site est requis s'il s'agit d'un contrat de support vendu (SupportExterne est 1 ou True).
    • Pour spécifier des sous-sites, utilisez la barre verticale "|" pour séparer la hiérarchie.
    • Le site est configurable à partir du menu Outils > Gestion des données de référence... > Général > Sites.

Champs optionnels

  • NuméroBonCommande - Texte(50)
  • EstRenouvelé – Booléen
    • Permet d'indiquer qu'un contrat a été renouvelé.
    • Les valeurs acceptées sont : 1 ou 0, True ou False, Oui ou Non.
    • Par défaut, si ce champ n'est pas importé, il ne sera pas activé lors de la création et restera inchangé lors d'une mise à jour.
  • Coût – Décimal
    • La valeur doit être comprise entre 0 et 9 999 999,99.
    • Exemple : 1234567,89.
  • CentreCoûts- Texte(50)
    •  Représente le centre de coût
  • Description - Texte(5000)
    • Description du contrat de service.
    • Une partie de cette description sera affichée dans la fiche du CI.
  • Note - Texte(5000)
    • Onglet note du Contrat de service.
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 (ContratExterne.xml)

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

ATTENTION : Le modèle de fichier XML utilisé en exemple est pour une importation à partir d'Excel 2007 ou 2010. 
<?xml version="1.0" encoding="utf-8" ?> 
<Sources>
   <Source Name="ImportationContratsServicesInterne">
      <ConnectionString>Provider=Microsoft.ACE.OLEDB.12.0;Data Source=C:\Import\ContratsService.xlsx;Extended Properties="Excel 12.0 xml;HDR=Yes;";</ConnectionString>
      <ViewName>[Import ContratExterne$]</ViewName>
      <Content>ServiceContract</Content>
   
    <!-- Balises supplémentaires -->
     <EmptyValueHandling>NoChange</EmptyValueHandling>
   </Source>
</Sources>

Voir 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 contrat de servcie externe

Le fichier XML pour l'importation des contrats de service 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 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é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 est ignorée 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