DataImporter - Importation des CIs de requêtes planifiées

Table des matières

Aperçu

Le présent article décrit comment importer les CI associés aux requêtes planifiées.

Vous trouverez l'article général sur l'importation des requêtes planifiées dans la section suivante.


Références

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é RequêtesPlanifiées.zip.  
 

Champs requis

  • RequêtePlanifiée - Numérique
    • Doit contenir le numéro de la requête planifiée à laquelle on assigne le CI.
  • CI - Texte
    • Doit contenir le nom d'un CI valide.

Champs optionnels

  • Note - Texte(5000)
    • Cette note sera ajoutée à l'assignation du CI dans la requête planifiée.
    • Ce champ est remplacé par les données importées à chaque importation. Le programme n'ajoute pas l'information, mais la remplace.
  • DernièreDateComplétion - Date
    • Ce champ sert à spécifier la dernière date à laquelle la requête planifiée a été complétée pour ce CI spécifique.
    • Invalide si une date est déjà assignée.
  • ProchaineDatePlanifiée - Date
    • Valide seulement si la requête planifiée associée est en mode "Une requête par CI".
    • Invalide si la requête planifiée associée est en mode "Intervalle variable" et que la requête doit être lancée après un intervalle calculé sur la complétion de la requête précédente.
  • Actif - Booléen
    • Indique si la requête associée à ce CI est active ou non.
    • Les valeurs acceptées sont : 1 ou 0, Vrai ou Faux, True ou False, Oui ou non.
    • Par défaut, les assignations de CIs seront considérées comme Actif.

Fichier de configuration (XML)

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

ATTENTION : Le modèle de fichier XML utilisé en exemple est pour une importation à partir d'Excel 2007 ou 2010. Pour l'explication des balises générales à tous les types d'importation ou pour d'autres types de fichiers, veuillez vous référer à l'article Fichier de configuration XML.
<?xml version="1.0" encoding="utf-8" ?> 
<Sources> 
   <Source Name="ImportationTypeDeCI" > 
      <ConnectionString>Provider=Microsoft.ACE.OLEDB.12.0;Data Source=c:\Import\RequetesPlanifiees.xlsx;Extended Properties="Excel 12.0 Xml;HDR=YES";</ConnectionString> 
      <ViewName>[Importation RP_CI$]</ViewName> 
      <Content>PlannedRequestItem</Content> 
      <CIIdentificationMethod>CIByName</CIIdentificationMethod> 
      <EmptyValueHandling>NoChange</EmptyValueHandling> 
   </Source> 
</Sources>

Explication des balises supplémentaires

Le fichier XML pour l'importation des CIs de requêtes planifiées peut contenir 2 balises supplémentaires. Ces balises ne sont pas obligatoires et lorsqu'elles ne sont pas spécifiées, les valeurs par défaut sont alors utilisées.

Méthode d’identification du CI

Dans le fichier XML pour l'importation des requêtes planifiées, il est possible de spécifier de quelle façon le CI sera recherché. Cette valeur devient la clé unique lors de l'importation. Si cette balise n'est pas précisée, la valeur par défaut sera le nom du CI.
Valeurs permises pour la balise CIIdentificationMethod :

  • CIByName (Valeur par défaut) : Nom du CI
  • CIByInventoryNumber : Numéro d’inventaire
  • CIBySerialNumber : Numéro de série

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

<CIIdentificationMethod>VALEUR</UserIdentificationMethod>

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é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ées 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








Aidez-nous à améliorer l’article