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

AFFICHER TOUT LE CONTENU

Table des matières

Aperçu

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

Voir l'article général sur DataImporter - Importation des requêtes planifiées pour savoir comment importer les requêtes planifiées.


Références

Ce qu'il faut 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. 

<?xml version="1.0" encoding="utf-8" ?> 
<Sources>
    <Source Name="ImportationRPCI">
<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>

<!-- Balises supplémentaires -->
<CIIdentificationMethod>CIByName</CIIdentificationMethod> 
<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.

Explication des balises supplémentaires

Le fichier XML pour l'importation des CIs de requêtes planifiées peut contenir des 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.

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.

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.

Lorsqu'on utilise ce paramètre dans le cadre d'une importation, il est important que la source de données contienne uniquement des colonnes sur lesquelles agir.

DataImporter tentera de nettoyer systématiquement toutes les colonnes présentes. On peut 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