DataImporter - Importation des changements

AFFICHER TOUT LE CONTENU

Introduction

Cet article présente la méthode pour faire l'importation des changements.

.
 

                                                      ATTENTION

Ce type d'importation comporte des risques, particulièrement si Octopus est déjà en production dans votre environnement.

Elle devrait être faite par une personne chevronnée dans la connaissance de DataImporter.

Nous recommandons aussi de communiquer avec nous avant de procéder à l'importation pour faire la demande d'une base de données de test temporaire pour minimiser les risques de problèmes avec l'import et obtenir de l'aide et des conseils au besoin. 

Car l'importation des changements ne permet pas la mise à jour, alors toute erreur doit être corrigée manuellement. 

 

Références

Liens vers les articles reliés à l'importation des changements et à la configuration du fichier XML

 

Ce qu'il faut savoir :  

Les fichiers modèles de référence (.xlsx et .xml) pour l'importation sont inclus dans les fichiers compressés 
Changements.zip et ChangementsSystemeSource.zip
 

Référence lors de l'import

On peut faire l'import de changements pour diverses raisons et en fonction de ce dont on a besoin, on peut importer en quelques étapes ou avoir à le faire tout à la fois. 

L'import de changements permet de faire l'import des éléments suivants : 

  1. Les changements
  2. Les activités dans les changements
  3. Les tâche de changements
  4. Les activités dans les tâches de changements

 

Les deux méthodes de références sont : 

  • Numéro d'Octopus.
  • Numéro du système source.

Si on importe en utilisant le numéro de référence de la base de donnée Octopus qui reçoit l'information, alors le tout peut se faire par étape; Changement en premier, suivi des activités, des tâches et des activités dans les tâches. 

Le contexte plus complexe et risqué est si on a besoin de faire l'import de tout les éléments nommés plus haut et que le numéro de référence à utiliser est celui du système source.

Car pour que ça fonctionne on doit importer les éléments d'un seul coup et aucune mise à jour n'est permise, d'où la complexité et le risque.  Pour ce type d'import, le fichier ChangementsSystemeSource.zip a été préparer. 

On suggère fortement de communiquer avec nous avant de procéder à ce type d'import. 

Champs disponibles pour l'importation des changements

Champs requis

  • SoumisPar
    • Représente l'utilisateur qui a fait la demande de changement, doit être un nom d'utilisateur valide.

    • Si l'utilisateur spécifié n'existe pas, l'enregistrement ne sera pas importé.

  • Sujet - Texte(500)
    • Représente le sujet du changement.

Champs optionnels

  • Numéro - Entier
    • Ce champ peut rester vide, si on veut laisser Octopus gérer le numéro de la requête. 

    • Peut contenir le numéro du changement provenant de la source à importer.

    • Le numéro sera préfixé au sujet du changement.

    • S'il est prévu d'importer des activités dans les changements, le numéro d'un système source doit être précédé par le signe moins ( - ). 

    • Exemple : -123456 pour le numéro 123456. 

  • Catégorie - Texte (100)

    • Doit être égale au libellé d’une catégorie existante dans Octopus.

    • La catégorie est configurable à partir du menu Outils > Gestion des données de référence > Changement > Catégories.

    • Si la catégorie n'existe pas, elle sera créée.

  • État
    • Doit être un état de changement valide.
  • Priorité 
    • Représente la Priorité qui sera attribuée au changement.
    • Doit correspondre à un des niveaux de priorité déjà existants.
  • DateDébut - Date et heure
    • Représente la date de début du changement dans le format YYYY-MM-DD HH:MM:SS.

    • Si non spécifiée, la date sera vide.

  • DateÉchéance - Date et heure
    • Représente la date d'échéance du changement dans le format YYYY-MM-DD HH:MM:SS.
    • Si non spécifiée, la date sera vide.
  • DateFermeture - Date et heure
    • Représente la date de fermeture du changement dans le format YYYY-MM-DD HH:MM:SS.
    • Si non spécifiée, pour un changement à l'état Complété, la date du système sera utilisée lors de l'importation.
  • EnAttente - Booléen
    • Indique si le changement est en attente.

    • Les valeurs acceptées sont : 1 ou 0, True ou False, Oui ou Non.

    • Par défaut, si ce champ n'est pas spécifié, la case ne sera pas cochée.

    • Ce champ est requis si une raison de mise en attente est présente. 

  • RaisonMiseEnAttente - Texte
    • Champ texte pour indiquer pourquoi le changement est en attente. 
    • Ce champ est requis si la raison de mise en attente est cochée. 
  • Urgent - Booléen
    • Indique si le changement sera coché Urgent.
    • Par défaut, si ce champ n'est pas spécifié, la case ne sera pas cochée.
  • SourceDeFinancement
    • Doit être égale au libellé d’une source de financement existante dans Octopus.

    • La source de financement est configurable à partir du menu Outils > Gestion des données de référence > Général > Sources de financement.

    • Si la source de financement n'existe pas, elle sera créée.

  • CoûtEstimé

    • ​La valeur doit être comprise entre 0 et 9 999 999,99.

    • Exemple : 1234567,89

  • DuréeAmortissement – Entier

    • La durée d'amortissement doit être exprimée en nombre de mois et doit être comprise entre 1 et 1200.

    • Exemple : 60

  • ImpactInfrastructure 
    • L'impact sur l'infrastructure du changement.
    • Doit correspondre à un impact déjà existant dans Octopus.
  • ImpactRessources
    • L'impact sur les ressources du changement.
    • Doit correspondre à un impact déjà existant dans Octopus.
  • Service
    • Service associé au changement. 
    • Doit correspondre à un service existant dans Octopus.
  • Site – Texte(200)
    • Le système va créer le site (ou le sous-site) lors de l'importation s'il n'existe pas.
    • Le site est configurable à partir du menu Outils > Gestion des données de référence > Général > Sites.
    • Il est possible d'importer plusieurs niveaux de site; ainsi on peut avoir un site principal et ses sous-sites.
    • Si aucun site n'est spécifié, Octopus va utiliser le site de la personne qui soumet le changement. 
ATTENTION :

Pour l'importation de sous-sites,on doit séparer chaque site du champ par une barre verticale ( | ) ou une virgule, en respectant le format suivant :

Site|Sous-Site1|Sous-Site2|Sous-Site3 et ainsi de suite. 

Tous les 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
  • GéréPar 
    • Représente l'intervenant qui sera assigné au changement, doit être un nom d'intervenant valide.
    • Si l'utilisateur spécifié n'existe pas, l'enregistrement ne sera pas importé.
  • Description - Texte

  • Impacts - Texte

  • ImpactsSiNonRéalisé - Texte

  • SommaireDesCoûtsEtRessources - Texte

  • SommaireDesRisques - Texte

  • PlanDeSecours - Texte

  • TempsArrêtPlanifié - Texte

  • PlanDeCommunication - Texte

  • Autorisations - Texte

 

Contenu du fichier de configuration (Changements.xml)

La déclaration de la source se fait en indiquant la valeur Change 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="ImportationChangement"> 

<ConnectionString>Provider=Microsoft.ACE.OLEDB.12.0;Data Source=C:\Import\Changements.xlsx;Extended Properties="Excel 12.0 Xml;HDR=YES";</ConnectionString>
     <ViewName>[RFC$]</ViewName> 
     <Content>Change</Content> 

     <!-- Balise supplémentaire -->    
<UserIdentificationMethod>UserByWindowsUsername</UserIdentificationMethod> 
     </Source> 
</Sources>

Voir l'article Fichier de configuration XML qui explique comment programmer les références aux sources de données.

Balises supplémentaires pour l'importation des changements

Le fichier XML pour l'importation des changements peut contenir une 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.

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.

Utilisateur qui soumet la requête et l'intervenant du changement

Le champ Soumis par étant obligatoire, il faut prévoir qui sera la personne qui soumet la demande de changement. Prévoir la même méthode d'identificaiton, si on ajoute des valeurs au champ Géré par qui représente l'intervenant du changement. 

Valeurs permises pour la balise UserIdentificationMethod :

  • UserByID : Numéro d’employé de l’utilisateur.
  • UserByName : Prénom et nom de l’utilisateur (sous le format Martin Tremblay).
  • UserByWindowsUsername (Valeur par défaut) : Nom d’utilisateur Windows de l'utilisateur. Dans la source des données, le format avec plus d'un nom d'utilisateur n'est pas accepté, comme par exemple "sile01;esil18". Il faut renseigner un seul des noms d'utilisateur.

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

<UserIdentificationMethod>Valeur</UserIdentificationMethod>

Trucs et astuces

Catégorie, Sources de financement et Sites 

Avant d'importer ces type d'éléments, vérifier les valeurs existantes dans Octopus. Car, comme l'importation va ajouter celles qui n'existent pas, une simple erreur de frappe ou une nomenclature différente peut ajouter plusieurs doublons à la liste.

X
Aidez-nous à améliorer l’article