DataImporter - Importation des activités dans les Incidents / SR

AFFICHER TOUT LE CONTENU

Table des matières

Aperçu

Ce type d'importation permet d'importer les activités reliées aux requêtes.

Lors de l'importation des requêtes, seule l'activité de résolution est importée. S'il y a d'autres activités importantes à garder, il faut alors utiliser ce type d'importation.

                                                      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. 

Prendre note que la mise à jour d'activité n'est pas disponible avec DataImporter, il est donc très important de faire des validations avant de procéder à ce type d'import. 

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é Incidents-SR_FR.zip.  
 

Champs requis

  • Numéro - Entier
    • Représente le numéro de la requête (incident ou SR) associée à l'activité.
    • Le numéro utilisé peut être celui d'Octopus ou celui du système source, dans le cas où les requêtes ont déjà été importées d'un autre système.
    • Pour plus de détails, voir la méthode d'identification de la requête.
  • Date – Date et heure
    • Représente la date de l'activité. La date doit être supérieure ou égale à la date d'ouverture et inférieure ou égale à la date de résolution.
    • Le format de la date doit être compatible avec les réglages du serveur Octopus, soit AAAA-MM-JJ.
  • Intervenant
    • Intervenant ayant fait l'activité.
    • L'intervenant doit déjà exister dans Octopus. 
    • La seule méthode pour identifier l'intervenant est avec le nom d'utilisateur Windows.
    • Si l'activité a été faite par un utilisateur, le champ UserRoleSource sera requis. 

Champs optionnels

  • ID - Entier
    • Sera obligatoire si la méthode d'identification de la requête est ByImportedIncidentID

    • Doit contenir le numéro de la requête préalablement importée.

    • Le numéro est celui préfixé au sujet de la requête.

  • Type
    • Représente un type d'activité déjà défini dans Octopus.
    • Le type d'activité est configurable à partir du menu Outils > Gestion des données de références > Général > Types d'activité.
    • Si ce champ est obligatoire dans Octopus, il le sera à l'importation.
  • TravauxEffectués - Texte(5000)
    • Représente la description des travaux effectués.
    • Si ce champ est obligatoire dans Octopus, il le sera à l'importation.
Ce qu'il faut savoir : 
  • On peut ajouter plus d'une activité à la fois en les mettant sur des lignes séparées.
  • Chaque nouvelle ligne avec le même numéro de requête sera une nouvelle activité.
  • Effort
    • Représente l'effort des travaux effectués pour chaque activité.
    • Format HH:MM (dans Excel la colonne doit être en format texte).
    • L'effort de l'activité doit être entre 00:01 à 99:59
    • Pour entrer 1 heure 30, inscrire 01:30 dans la colonne.
    • Une valeur en jour est convertie en heure. Par exemple 1 = 24 heures, donc 24:00.
    • Lorsque les minutes dépassent 59, elles sont converties en heure. Par exemple 0:75 = 1:15.
    • S'il y a des secondes ajoutées, elles sont ignorées. Par exemple 1:10:25 = 1:10. 
    • Ce champ est requis s'il est obligatoire dans les options d'Octopus.
  • Déplacement - Booléen
    • Indicateur spécifiant s'il y a eu déplacement pour exécuter l'activité.
    • Les valeurs acceptées sont : 1 ou 0, True ou False, Oui ou Non.
    • Si non spécifiée, la valeur par défaut sera non.
  • Fournisseur - Texte (100)
    • Pour ajouter une activité de Main d'Oeuvre externe
    • Indique le nom du fournisseur qui a fait l'activité
    • Si Octopus trouve le nom d'un fournisseur existant, il associera l'activité avec ce fournisseur
    • Sinon, un nouveau fournisseur sera créé
  • Coût - Décimal
    • La valeur doit être comprise entre 0 et 9 999 999,99.

    • Exemple : 1234567,89

  • Groupe

    • Représente le groupe auquel l'activité sera associée et doit être un nom de groupe valide.

    • Sert à identifier le groupe d'un intervenant lorsque celui-ci fait partir de plus d'un groupe.

  • EstVisibleSurPortailWeb

    • Sert à identifier si l'activité sera visible sur le portail Web de l'utilisateur.

  • UserRoleSource

    • Pour ajouter une activité fait par un utilisateur.

    • Indiquer la valeur Utilisateur. 

    • Le nom d'utilisateur Windows de l'utilisateur qui a fait l'activité devra être dans le champ Intervenant

Contenu du fichier de configuration (IncidentActivite.xml)

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

<ConnectionString>Provider=Microsoft.ACE.OLEDB.12.0;Data Source=c:\Import\Incidents-SR_FR.xlsx;Extended Properties="Excel 12.0 Xml;HDR=YES";</ConnectionString>
     <ViewName>[Importation Activites$]</ViewName> 
     <Content>IncidentActivity</Content> 

     <!-- Balise supplémentaire -->    
<IncidentIdentificationMethod>ByImportedIncidentID</IncidentIdentificationMethod>
   </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 activités des Incidents et SR

Le fichier XML pour l'importation des activités dans les incidents et SR 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.

Méthode d’identification de la requête

Dans le fichier XML pour l'importation des activités, il est possible de spécifier de quelle façon la requête sera recherchée, soit par le numéro d'incident/SR d'Octopus ou par le numéro de requête importée. 

Valeurs permises pour la balise IncidentIdentificationMethod :

  • ByIncidentID : Numéro d’incident/SR dans Octopus
  • ByImportedIncidentID (Valeur par défaut) : Numéro de requête de la source importée

Après l'import d'incidents d'une source externe, si par la suite on importe les activités, le système peut se fier au numéro de requête de l'ancien système.

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

<IncidentIdentificationMethod>VALEUR</IncidentIdentificationMethod>
X
Aidez-nous à améliorer l’article








Aidez-nous à améliorer l’article