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

• DataImporter- Importation des activités dans les Changements
• DataImporter- Importation des tâches
• DataImporter- Importation des activités dans les tâches
   
• Fichier de configuration XML

• Retour à la page principale de DataImporter
• Retourà la liste des types d'importations

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. 

• 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>. 

<?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 Fichierde 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.

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.