DataImporter - Importation des requêtes planifiées

AFFICHER TOUT LE CONTENU

Table des matières

Introduction

Cet article vous explique comment procéder à l'importation des requêtes planifiées.

Conjointement à cet article, vous trouverez dans la section suivante le lien vers l'article permettant d'importer les CIs spécfiques associés aux requêtes planifiées.

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

  • Type - Texte(100)
    • Désigne s'il s'agit d'un Changement ou d'une demande de service (SR).
    • Les valeurs acceptées sont : "Changement", "Demande de service (SR)", "Change" ou "Service Request (SR)".
  • ModePlanification - Texte
    • Représente la fréquence de création des requêtes.
    • Les valeurs acceptées sont : "Une fois", "Quotidien", "Hebdomadaire", "Mensuel", "Intervalle variable", "One time", "Daily", "Weekly", "Monthly" ou "Variable Interval".
  • ModeAssignation - Texte
    • Représente la manière d'assigner la requête lors de sa création.
    • Les valeurs acceptées sont : "Tel que défini dans le CI (ou le type)", "Tel que défini dans le type de SR", "Spécifique, "As defined in the CI (or CI Type)", "As defined in the SR type" ou "Custom".
    • La valeur "Tel que défini dans le type de SR" est permise seulement si le type est "Demande de service (SR)".
  • ModeSélectionCI - Texte
    • Représente comment le CI doit être associé à la requête planifiée.
    • Si aucun CI n'est associé, choisir "Aucun CI".
    • Les valeurs acceptées sont : "Aucun CI", "Type de CI", "Modèle de CI", "CIs spécifiques", "No CI", "CI type", "CI Model", ou "Custom CI".

Champs optionnels

  • Numéro - Numérique
    • Représente le numéro de la requête planifiée.
    • Ce champ doit être utilisé seulement lors d'une mise à jour. Lorsque vous ajoutez des nouvelles requêtes planifiées, vous devez laisser ce champ vide et le système va attribuer un nouveau numéro.
  • Catégorie - Texte(100)
    • Les requêtes planifiées peuvent être catégorisées pour une meilleure gestion ou pour organiser dans la planification des requêtes.
    • Si la catégorie n'existe pas, elle sera automatiquement ajoutée.
  • EffortEstimé - Texte
    • Représente l'effort estimé de la requête planifiée.
    • Format HH:MM:SS (dans Excel, la colonne doit être en format texte).
    • Exemple : 01:30.
  • Note - Texte
    • Ce champ peut être utilisé pour ajoute une description supplémentaire à la requête planifiée. La colonne peut ensuite être ajoutée dans les différentes listes du module Gestion des requêtes planifiées.
    • Ce champ est remplacé par les données importées à chaque importation. Le programme n'ajoute pas l'information, mais la remplace.
  • Actif - Booléen.
    • Détermine si la requête est active immédiatement. Si elle ne l'es pas, il faudra l'activer manuellement directement dans Octopus OU utiliser le champ "AutomaticActivationDate" plus bas.
    • Les valeurs acceptées sont : 1 ou 0, Vrai ou Faux, True ou False, Oui ou Non.
  • DernièreDateComplétion - Date
    • Ce champ permet d'ajouter la date de la dernière complétion.
    • Valide seulement si le champ "UneRequêteParCI" est faux.
  • ProchaineDatePlanifiée - Date
    • Ce champ permet d'ajouter la date de la prochaine requête planifiée.
    • Valide seulement si le champ "UneRequêteParCI" est faux.
    • Invalide si une requête est présentement active, que le Mode de Planification (ModePlanification) est à "Intervalle variable" et qu'il soit à Après la "Complétion".
  • DateActivationAutomatique - Date
    • Date à laquelle la tâche doit être activée automatiquement. Si ce champ est vide, la tâche ne sera pas activée automatiquement.
  • UneSeuleFoisDateExacte - Date
    • Attention, ce champ est obligatoire si le Mode de Planification est "Une fois".
    • Exemple : 2013-07-15.
  • Récurrence - Numérique
    • Attention, ce champ est obligatoire si le Mode de Planification est "Quotidien" ou "Hebdomadaire".
    • Pour une récurrence annuelle, veuillez utiliser "Hebdomadaire" avec la récurrence 52 pour 52 semaines.
    • Exemple : 1
  • HebdomadaireJours - Texte
    • Attention, ce champ est obligatoire si le Mode de Planification est "Hebdomadaire".
    • Pour indiquer plusieurs sélections, séparez-les par des virgules.
    • Les valeurs acceptées sont: 1,2,3,4,5,6,7.
    • Exemple : 2,4,6.
  • MensuelMois - Texte
    • Attention, ce champ est obligatoire si le Mode de Planification est Mensuel.
    • Pour indiquer plusieurs sélections, séparez-les par des virgules.
    • Les valeurs acceptées sont: 1,2,3,4,5,6,7,8,9,10,11,12.
    • Exemple : 2,6,10.
  • MensuelJours - Texte
    • Attention, ce champ est obligatoire si le Mode de Planification est Mensuel.
    • Non compatible avec "MensuelPériodes" et "MensuelJoursPériode".
    • Pour indiquer plusieurs sélections, séparez-les par des virgules
    • Les valeurs acceptées sont: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31 ou "Last".
    • Exemple : 15,Last.
  • MensuelPériodes - Texte
    • Attention, ce champ est obligatoire si le Mode de Planification est Mensuel.
    • Non compatible avec "MensuelJours".
    • Pour indiquer plusieurs sélections, séparez-les par des virgules.
    • Les valeurs acceptées sont: 1, 2, 3, 4, ou "Last".
    • Exemple : 2,Last.
  • MensuelJoursPériode - Texte
    • Attention, ce champ est obligatoire si le Mode de Planification est Mensuel.
    • Non compatible avec "MensuelJours".
    • Pour indiquer plusieurs sélections, séparer les par des virgules.
    • Les valeurs acceptées sont: 1, 2, 3, 4, 5, 6 ou 7.
    • Exemple : 2,4,6.
  • IntervalleVariableChiffre - Numérique
    • Attention, ce champ est obligatoire si le Mode de Planification est Intervalle variable.
    • Exemple : 1
  • IntervalleVariableUnité - Texte
    • Attention, ce champ est obligatoire si le Mode de Planification est Intervalle variable.
    • Les valeurs acceptées sont: "jour", "semaine", "mois", "année", "day", "week", "month" ou "year".
    • Exemple : Month.
  • IntervalleVariableAprès - Texte
    • Attention, ce champ est obligatoire si le Mode de Planification est Intervalle variable.
    • Les valeurs acceptées sont: "Création", "Creation", "Completion" ou "Complétion".
    • Exemple : Complétion.
  • GénérerRequêteAvanceChiffre - Numérique
    • Représente le nombre de jours, semaines ou mois pour créer une requête planifiée d'avance.
    • Exemple : 5.
  • GénérerRequêteAvanceUnité - Texte
    • Insique si la requête planifiée doit être créée en jours, semaines ou mois d'avance.
    • Les valeurs acceptées sont jour, semaine, mois, day, week ou month.
    • Attention, ce champ est obligatoire si "GénérerRequêteAvanceChiffre" est spécifié.
    • Exemple : jour
  • Gabarit - Texte
    • Doit être le nom d'un gabarit de type de SR existant si le champ Type est "Demande de service (SR)" ou le nom d'un gabarit de changement existant si le Type est à "Changement".
    • Exemple : Mise à jour du calendrier des jours fériés.
  • Sujet - Texte(500)
    • Ce champ peut être utilisé pour donner un nom spécifique à la requête plutôt que le nom construit avec le gabarit, le nom du CI et la date.
  • Groupe - Texte
    • Ce champ doit être utilisé seulement si Type est "Demande de service (SR)".
    • Attention, ce champ est obligatoire si le Mode d'Assignation est "Spécifique".
    • Exemple : Centre de service.
  • Intervenant - Texte
    • Ce champ doit être utilisé seulement si le Mode d'Assignation est "Spécifique".
    • L'utilisateur doit être un membre du groupe spécifié dans le champ "Groupe".
    • Doit être un utilisateur Octopus.".
    • Exemple : Alice Tremblay.
  • Utilisateur - Texte
    • Ce champ peut être utilisé pour spécifier l'utilisateur de la requête générée.
    • Si cette valeur n'est pas spécifiée, la requête sera générée automatiquement avec l'utilisateur par défaut.
    • Exemple : Bob Sinclair.
  • Site - Texte
    • Représente le site spécifique où sera associée la requête planifiée.
    • Si cette valeur n'est pas spécifiée, la requête sera générée automatiquement avec le site par défaut.
    • Exemple : Québec.
  • Procédure - Texte(500)
    • Représente la procédure qui sera inscrite dans le champ Description de la requête créée.
  • TypeCI - Texte
    • Requis si ModeSélectionCI est "Type de CI" ou "Modèle de CI".
    • Exemple : Imprimante.
  • ManufacturierCI - Texte
    • Requis si ModeSélectionCI est "Modèle de CI".
    • Exemple : Hewlett-Packard.
  • ModèleCI - Texte
    • Requis si ModeSélectionCI est "Modèle de CI".
    • Exemple : Laserjet 6000.
  • UneRequêteParCI - Booléen
    • Par défaut, cette valeur est à oui, donc une requête par CI sera créée.
    • Les valeurs acceptées sont : 1 ou 0, Vrai ou Faux, True ou False, Oui ou Non.

Fichier de configuration (XML)

La déclaration de la source se fait en indiquant la valeur PlannedRequest 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$]</ViewName> 
      <Content>PlannedRequest</Content> 
      <UserIdentificationMethod>UserByWindowsUsername</UserIdentificationMethod>
      <EmptyValueHandling>NoChange</EmptyValueHandling> 
   </Source> 
</Sources>

Explication des balises supplémentaires

Le fichier XML pour l'importation des 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 de l'intervenant

Dans la déclaration de la source de données, il est possible de spécifier de quelle façon l'intervenant assigné à la requête planifiée sera recherché. Si cette balise n'est pas précisée, la valeur par défaut sera le nom d'utilisateur Windows.

Valeurs permises pour la balise UserIdentificationMethod :

  • UserByID : Numéro d’employé du contact principal.
  • UserByName : Prénom et nom du contact principal (sous le format Martin Tremblay).
  • UserByWindowsUsername (Valeur par défaut) : Nom d’utilisateur Windows du contact principal.

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

<UserIdentificationMethod>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