DataImporter : Importation de données à partir d'une source externe

Aperçu

Exemple

• CI.xls : chiffrier Excel contenant les données à importer dans Octopus.

• CI.xml : déclaration des sources de données utilisées par DataImporter.

• Changer le répertoire courant pour le répertoire Octopus.

cd "C:\Program Files\Octopus"

• Lancer DataImporter en spécifiant un utilisateur Octopus valide.

ESI.Octopus.DataImporterApp.exe /login:nom d'utilisateur /password:mot de passe /configfilepath:C:\CI.xml

Création du fichier de configuration de DataImporter

<?xml version="1.0" encoding="utf-8" ?>
<Sources>
   <Source Name="UserSource" >
   <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Users.xls;Extended Properties="Excel 8.0;HDR=Yes;IMEX=1";</ConnectionString>
   <ViewName>[Utilisateurs$]</ViewName>
   <Content>User</Content>
   </Source>
</Sources>

<?xml version="1.0" encoding="utf-8" ?>
<Sources>

   <Source Name="SourceName" >
   <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Users.xls;Extended Properties="Excel 8.0;HDR=Yes;IMEX=1";</ConnectionString>
   <ViewName>[Utilisateurs$]</ViewName> 
   <Content>User</Content>
   </Source>

   <Source Name="SourceName2" >
   <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Users.xls;Extended Properties="Excel 8.0;HDR=Yes;IMEX=1";</ConnectionString>
   <ViewName>[Ordinateurs$]</ViewName>
   <Content>CI</Content>
   </Source>

   <Source Name="SourceName3" >
   <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Users.xls;Extended Properties="Excel 8.0;HDR=Yes;IMEX=1";</ConnectionString>
   <ViewName>[Moniteurs$]</ViewName>
   <Content>CI</Content>
   </Source>

</Sources>

Fichier XML de déclaration des sources de données

<Source Name="Ordinateurs">
   <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Ordinateurs.xls;Extended Properties="Excel 8.0;HDR=Yes;IMEX=1";</ConnectionString>
   <ViewName>Ordinateurs</ViewName>
   <Content>CI</Content>
</Source>

• Source Name : Le "source name" est une donnée importée dans la base de données à titre de référence pour indiquer d'où vient l'importation et sera utilisée pour les mises à jour. Cette donnée n'est pas validée, mais il est important d'entrer une donnée significative pour indiquer le type de données importées (Ordinateurs, Écrans, Utilisateurs, etc.).
• ConnectionString : Une "connection string" ou chaîne de connexion regroupe toutes les informations spécifiques à propos d'une source de données et comment s'y connecter. Vous trouverez toutes les informations nécessaires sur le site suivant : www.connectionstrings.com
• ViewName : Nom de la vue. Si Excel est votre source de données, vous devez mettre le nom de la feuille du chiffrier Excel entre crochets avec ”$“ à la fin. Exemple : [Sheet1$].
• Content : Déclaration de la source, c'est-à-dire, ce que vous voulez importer dans Octopus (CI, Utilisateurs, etc.). Voir section suivante pour les sources que vous pouvez importer.

Utilisation du programme DataImporter

Paramètres

• /Login : Nom d’utilisateur Octopus.
• /Password: Mot de passe Octopus.
• /ConfigFilePath : Chemin complet du fichier de configuration de DataImporter

 ESI.Octopus.DataImporterApp.exe /login:system /password:octo /ConfigFilePath:c:\pc.xml

Journal des opérations

Spécifications des sources d’importation

Importation des utilisateurs

• Prénom - Texte(100)
• Nom - Texte(100)

• NuméroEmployé – Texte(50)
  • Doit être unique.
• Langue
  • Doit être une des valeurs de référence existante dans Octopus.
• Département - Texte(50)
  • Le système va créer le département s’il n'existe pas.
• SousDépartement - Texte(50)
  • Le système va créer le sous-département s'il n'existe pas.
  • Si un sous-département est spécifié alors un département doit aussi être spécifié.
• Titre - Texte(100)
• Site - Texte(50)
  • Le système va créer le site s'il n'existe pas.
    

Exemple:
Canada|Québec|Montréal|Montréal-Est

• Local - Texte(50)
• TéléphoneBureau - Texte(50)
• PosteTéléphonique - Texte(6)
• TéléphoneCellulaire - Texte(50)
• Téléavertisseur - Texte(50)
• Courriel - Texte(50)
• Note - Texte(2000)
• Actif - (1/0 ou True/False)
• UtilisateurWindows - Texte(50)
• VIP - (1/0 ou True/False)

• UserByID : Représente le numéro d'employé (Valeur par défaut)
• UserByName : Le format est {Prénom} {Nom} (ex.: Martin Tremblay).
• UserByNameAndPhoneExtension
• UserByWindowsUsername

<Source Name="NomSource">
   <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Users.xls;Extended Properties="Excel 8.0;HDR=Yes;IMEX=1";</ConnectionString>
   <ViewName>NomVue</ViewName>
   <Content>User</Content>
   <IdentificationMethod>UserByID</IdentificationMethod>
</Source>

Importation des CI

• Nom - Texte (850)
  • Doit être unique
  • Nous vous suggérons de combiner le nom du logiciel avec la version pour un faire un nom unique. Par exemple le logiciel "Octopus" à la version "3.2" pourrait avoir comme nom de CI : "Octopus (3.2)"

• Type
  • Cette colonne représente le type de CI que l’on veut importer. Pour que l’import fonctionne, il faut que le type retourné corresponde EXACTEMENT à un des types de CI présent dans la base de données d’Octopus. Les types de CI sont accessibles dans Octopus dans les données de références.

• Manufacturier - Texte (500)
  • Le système va créer le manufacturier s'il n'existe pas.
• Modèle - Texte (50)
  • Le système va créer le modèle s’il n’existe pas.
• État
  • Doit correspondre à un des états de CI existant dans les valeurs de référence.
• Criticité
  • Doit correspondre à un des niveaux de criticité existant dans les valeurs de référence.
• NuméroSérie – Texte(250)
• NuméroInventaire – Texte(50)
• Département – Texte(50)
  • Le système va créer le département s'il n'existe pas.
• SousDépartement – Texte(50)
  • Le système va créer le sous-département s'il n'existe pas.
  • Si un sous-département est spécifié alors un département doit aussi être spécifié.
• ContactPrincipal
  • Voir la section «Méthode d’identification du contact principal du CI »
• Site – Texte(50)
  • Le système va créer le site s'il n'existe pas.

Exemple:
Canada|Québec|Montréal|Montréal-Est

• Local – Texte(50)
• Catégorie – Texte(100)
  • Le système va créer la catégorie si elle n'existe pas.
  • La catégorie d’un CI est relié à son type
• Note – Texte(5000)
• Fournisseur – Texte(500)
  • Le système va créer le fournisseur s’il n’existe pas.
• FournisseurDeMaintenance – Texte(500)
• NuméroBonCommande – Texte(50)
• DateAchat – Date et heure
  • Le format de la date doit être compatible avec les réglages du serveur Octopus (AAAA-MM-JJ HH :MM :SS)
• CoûtAchat – Décimal (ex : 123456789,12)
• CentreCoûts – Texte(50)
• NuméroFacture – Texte(50)
• ExpirationGarantie – Texte(50)
• TypeGarantie – Texte(100)
• SourceFinancement – Texte(100)
• NécessiteContratService – (1/0 ou True/False)
• DuréeVie – Texte(50) - « Version 2.14 »
• DuréeAmortissement – Entier (ex : 123)
  • La durée d'amortissement exprimée en nombre de mois.

• Tout autre attribut personnalisé du type de CI importé - Texte (2000).

• CIByName : Nom du CI (Valeur par défaut)
  
• CIByInventoryNumber : Numéro d’inventaire
  
• CIBySerialNumber : Numéro de série

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

<Source Name="SoftwareView" >
   <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\CI.xls;Extended Properties="Excel 8.0;HDR=Yes;IMEX=1";</ConnectionString>
   <ViewName>NomDeVue</ViewName>
   <Content>CI</Content>
   <ManageCIRetirement>false</ManageCIRetirement>
   <IdentificationMethod>CIByName</IdentificationMethod>
   <MainContactIdentificationMethod>UserByWindowsUsername</MainContactIdentificationMethod>
</Source>

Importation des relations entre CI

• CI1 – Texte(125)
• CI2 – Texte(125)
• Relation
  • Nom de la relation à créer entre les deux CI.

• Note - Texte (5000)

<Source Name="ComputerMonitorsView">
   <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\CI.xls;Extended Properties="Excel 8.0;HDR=Yes;IMEX=1";</ConnectionString>
   <ViewName>NomDeVue</ViewName>	
   <Content>CIRelation</Content>
</Source>

Suppression des relations qui n'existent plus entre 2 CI

<?xml version="1.0" encoding="utf-8" ?> 
<Source Name="CIRelation">   
   <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Relations.xls;Extended Properties="Excel 8.0;HDR=Yes;IMEX=1";</ConnectionString>
   <ViewName>NomDeVue</ViewName>	
   <ManageRelations>True</ManageRelations>
   <Content>CIRelation</Content>
</Source>

Importation des utilisateurs des CI

• CI – Texte(125)
• Utilisateur

• UserByID: Numéro d’employé de l’utilisateur
• UserByName: Prénom et nom de l’employé de l’utilisateur (format : Martin Tremblay)
• UserByWindowsUsername (Valeur par défaut): Nom d’utilisateur réseau de l’utilisateur (Windows Logon)

<Source Name="UtilisateursCI">
   <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\CIUsers.xls;Extended Properties="Excel 8.0;HDR=Yes;IMEX=1";</ConnectionString>
   <ViewName>NomDeVue</ViewName>	
   <Content>CIUser</Content>
   <UserIdentificationMethod>UserByWindowsUsername</UserIdentificationMethod>
</Source>

Importation des contrats de service

• Numéro - Texte (50)
• Type - Texte (100)
  • Type de contrat de service (Maintenance, Garantie prolongée, etc.)
• DateDébut - Date et heure
  • Le format de la date doit être compatible avec les réglages du serveur Octopus (AAAA-MM-JJ HH :MM :SS)
• DateFin - Date et heure
  • Le format de la date doit être compatible avec les réglages du serveur Octopus (AAAA-MM-JJ HH :MM :SS)

• SupportExterne - (1/0 ou True/False)

• Fournisseur - Texte (500)

• NuméroBonCommande - Texte (50)
• Coût – Texte (50)
• Description - Texte (5000)

• Fournisseur - Texte (500)
  • Le champ Fournisseur est requis si SupportExterne est 0 ou False
• Site - Texte (500)
  • Le champ Site est requis si SupportExterne est 1 ou True

<Source Name="ContratsServices">
   <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Contrat.xls;Extended Properties="Excel 8.0;HDR=Yes;IMEX=1";</ConnectionString>
   <ViewName>NomDeVue</ViewName>	
   <Content>ServiceContract</Content>
</Source>

Importation des CI supportés par un contrat de services

• Contrat - Texte (50)
  • Doit contenir le numéro du contrat
• CI - Texte (100)

• Coût – Texte (50)

<Source Name="CIContratsServices">
   <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\CIContrat.xls;Extended Properties="Excel 8.0;HDR=Yes;IMEX=1";</ConnectionString>
   <ViewName>NomDeVue</ViewName>	
   <Content>SupportedCI</Content>
</Source>

Importation des contrats de location

• Numéro - Texte (50)
• DateDébut - Date et heure
  • Le format de la date doit être compatible avec les réglages du serveur Octopus (AAAA-MM-JJ HH :MM :SS)
• DateFin - Date et heure
  • Le format de la date doit être compatible avec les réglages du serveur Octopus (AAAA-MM-JJ HH :MM :SS)
• Fournisseur - Texte (500)

• NuméroBonCommande - Texte (50)
• Coût – Texte (50)
• Description - Texte (5000)

<Source Name="ContratsLocation">
   <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Contrats.xls;Extended Properties="Excel 8.0;HDR=Yes;IMEX=1";</ConnectionString>
   <ViewName>NomDeVue</ViewName>	
   <Content>LeaseContract</Content>
</Source>

Importation des CI supportés par un contrat de location

• Contrat - Texte (50)
  • Doit contenir le numéro du contrat
• CI - Texte (100)

• Coût – Texte (50)

<Source Name="CIContratsLocation">
   <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\CI.xls;Extended Properties="Excel 8.0;HDR=Yes;IMEX=1";</ConnectionString>
   <ViewName>NomDeVue</ViewName>	
   <Content>LeasedCI</Content>
</Source>

Importation des incidents / SR

• Type - (Incident ou SR)
  • Indique s'il s'agit d'un incident ou d'une SR. Il est possible d'importer les incidents et les SR dans le même fichier.
• TypeDeSR - Obligatoire lorsque c'est une SR et le nom du type de SR doit exister.
• Sujet - Texte(500)
• État
  • Doit être un statut d’incident valide
• Utilisateur
  • Doit être le nom d’utilisateur Windows valide d’un usager existant
• Demandeur
  • Doit être le nom d’utilisateur Windows valide d’un usager existant

• NuméroIncident – Le numéro sera préfixé au sujet de l’incident.
• DescriptionDétaillée Texte(5000) – Description détaillée
• Groupe
  • Représente le groupe auquel l’incident sera rattaché et doit donc être un nom de groupe valide auquel l’usager spécifié en paramètre à DataImporter à accès.
  • Lorsque le groupe n'est pas spécifié, la requête est associé au groupe "Centre de service par défaut".
• Intervenant
  • Usager octopus auquel l’incident sera assigné. Doit être le nom d’utilisateur Windows.
  • Dans le cas d'un incident/SR en traitement ou résolu, l'intervenant est obligatoire
• Impact
  • Doit être égal au libellé d’un niveau d’impact (ex : « 1 – Haut », « 2 – Moyen », « 3 – Bas »)
  • Obligatoire si ce champ est obligatoire dans Octopus (Menu Outils > Options > Gestion des champs obligatoires).
• Urgence
  • Doit être égal au libellé d’un niveau d’urgence (ex : « 1 – Haute », « 2 – Moyenne », « 3 – Basse »)
  • Obligatoire si ce champ est obligatoire dans Octopus (Menu Outils > Options > Gestion des champs obligatoires).
• Priorité
  • Doit être égal au libellé d’un niveau de priorité (ex : « 1 – Urgent », « 2 – Haut », « 3 – Normal »)
  • Obligatoire si ce champ est obligatoire dans Octopus (Menu Outils > Options > Gestion des champs obligatoires).
• Catégorie
  • Doit être égale au libellé d’une catégorie existante dans Octopus.
  • Ne doit pas être présent dans le cas d'une SR, sinon la donnée sera rejetée.
  • Obligatoire si ce champ est obligatoire dans Octopus et que l'incident est résolu (Menu Outils > Options > Gestion des champs obligatoires).
• Sous-catégorie
  • Doit être égale au libellé d’une sous-catégorie existante dans Octopus.
  • Ne doit pas être présent dans le cas d'une SR, sinon la donnée sera rejetée.
  • Obligatoire si ce champ est obligatoire dans Octopus et que l'incident est résolu (Menu Outils > Options > Gestion des champs obligatoires).
• DateOuverture
  • Représente la date d’ouverture dans le format YYYY-MM-DD HH :MM :SS
  • Si non spécifié, la date du système sera ajoutée lors de l'importation
  • Obligatoire lorsqu'un indident/SR est résolu et doit être inférieure la date de résolution.
• DateRésolution
  • Représente la date à laquelle l’incident à été résolu dans le format YYYY-MM-DD HH :MM :SS
  • La date doit être supérieure à la date d’ouverture.
  • Obligatoire lorsqu'un incident/SR est résolu ou fermé.
• EffortRésolution
  • Format HH:MM:SS (dans excel la colonne doit être en format texte).
  • Obligatoire si ce champ est obligatoire dans Octopus et que l'incident/SR est résolu (Menu Outils > Options > Gestion des champs obligatoires).
• DateFermeture
  • Représente la date à laquelle l’incident a été fermé dans le format YYYY-MM-DD HH :MM :SS
  • La date doit être égale ou supérieure à la date de résolution.
  • Obligatoire lorsqu'un incident/SR est fermé.
• RaisonMiseEnAttente
  • Indique la raison pour laquelle l’incident a été mis sous le statut « En attente ».
  • La raison doit être égale au libellé d’une raison existante dans Octopus.
• DescriptionRésolution (5000)
  • Champ requis lorsque l’incident a un statut « Résolu » et qu'il est obligatoire dans les options d'Octopus (Menu Outils > Options > Gestion des champs obligatoires).
  • Représente la description de l’activité de résolution.
• ActivitéRésolution
  • Champ requis lorsque l’incident a un statut « Résolu » et qu'il est obligatoire dans les options d'Octopus (Menu Outils > Options > Gestion des champs obligatoires).
  • Représente le TYPE automatisé d’activité de résolution.
• NoteFermeture
  • Représente la note de fermeture associée à un incident dont le statut est « Fermé ».
• CI
  • CI en cause associé à l’incident.
  • Obligatoire si ce champ est obligatoire dans Octopus et que l'incident/SR est résolu (Menu Outils > Options > Gestion des champs obligatoires).
• Site
  • Site associé à l’incident, si le site de l’incident est requis.
• ServiceTI
  • Service TI associé à l’incident.

<Source Name="SourceName" >
   <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Users.xls;Extended Properties="Excel 8.0;HDR=Yes;IMEX=1";</ConnectionString>
   <ViewName>NomDeVue</ViewName>
   <Content>Incident</Content>
</Source>

Importation des activités dans les requêtes

• Numéro
  • Représente le numéro de l'incident/SR associé à l'activité
• Date – Date et heure
  • Le format de la date doit être compatible avec les réglages du serveur Octopus (AAAA-MM-JJ HH :MM :SS)
  • Date de l'activité
• Intervenant
  • Intervenant qui a entré l'activité

• Type
  • Représente le type d'activité défini dans Octopus.
  • Requis si ce champ est obligatoire dans Octopus (Menu Outils > Options > Gestion des champs obligatoires)
• TravauxEffectués
  • Description des travaux effectués.
  • Requis si ce champ est obligatoire dans Octopus (Menu Outils > Options > Gestion des champs obligatoires)
• Effort
  • Effort des travaux effectués.
  • Format HH:MM:SS (dans excel la colonne doit être en format texte).
  • Requis si ce champ est obligatoire dans Octopus (Menu Outils > Options > Gestion des champs obligatoires)
• Déplacement - (1/0 ou True/False)
  • Par défaut, la valeur est à 0 (False)

• ByIncidentID: Numéro d’incident dans Octopus
• ByImportedIncidentID: (Valeur par défaut) Numéro d'incident de la source importée

<?xml version="1.0" encoding="utf-8" ?> 
<Sources>
	<Source Name="Activities">
		<ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Activity.xls;Extended Properties="Excel 8.0;HDR=Yes;IMEX=1";</ConnectionString>
		<ViewName>[NomDeLaVue]</ViewName> 
		<Content>IncidentActivity</Content> 
		<IncidentIdentificationMethod>ByImportedIncidentID</IncidentIdentificationMethod>
	</Source>
</Sources>

Importation des fournisseurs

• Nom - Texte (500)

• Numéro - Texte (100)
• EstUnManufacturier - (1/0 ou True/False)
• EstUnFournisseur - (1/0 ou True/False)
• Adresse - Texte (500)
• Téléphone - Texte (50)
• Télécopieur - Texte (50)
• SiteWeb - Texte (250)
• Courriel - Texte (320)
• Note - Texte (5000)

<Source Name="Fournisseurs">
   <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Fournisseurs.xls;Extended Properties="Excel 8.0;HDR=Yes;IMEX=1";</ConnectionString>
   <ViewName>NomDeVue</ViewName>	
   <Content>Business</Content>
</Source>

Importation des contacts d'un fournisseur

• Nom - Texte (100)

• Prénom - Texte (100)
• Titre - Texte (100)
• Adresse - Texte (500)
• TéléphoneBureau - Texte (50)
• PosteTéléphonique - Texte (50)
• TéléphoneCellulaire - Texte (50)
• Téléavertisseur - Texte (50)
• Télécopieur - Texte (50)
• Compagnie - Texte (250)
• Courriel - Texte (320)
• Note - Texte (5000)

<Source Name="Contact">
   <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Contact.xls;Extended Properties="Excel 8.0;HDR=Yes;IMEX=1";</ConnectionString>
   <ViewName>NomDeVue</ViewName>	
   <Content>Contact</Content>
</Source>

Importation des pièces jointes

Importation des pièces jointes dans les requêtes

• Numéro- Numéro de l'incident/SR
• Attachement - Doit contenir le chemin (path) de la pièce jointe et le nom du document.
  • Exemple : C:\NomDuRepertoire\NomDuFichier.txt

• ByIncidentID: Numéro d’incident dans Octopus
• ByImportedIncidentID: (Valeur par défaut) Numéro d'incident de la source importée
  • C'est-à-dire, si vous avez importé des incidents d'une source externe et que par la suite vous importez les pièces jointes, le système peut se fier au numéro de requête de l'ancien système.

<Source Name="Incidents_SR">
   <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\IncidentAttachement.xls;Extended Properties="Excel 8.0;HDR=Yes;IMEX=1";</ConnectionString>
   <ViewName>NomDeVue</ViewName>	
   <Content>IncidentAttachment</Content>
   <IncidentIdentificationMethod>ByImportedIncidentID</IncidentIdentificationMethod>
</Source>

Importation des pièces jointes dans les CI

• CI- Nom du CI
• Attachement - Doit contenir le chemin (path) de la pièce jointe et le nom du document.
  • Exemple : C:\NomDuRepertoire\NomDuFichier.txt

<Source Name="CI_PieceJointe">
   <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\CI_Attachement.xls;Extended Properties="Excel 8.0;HDR=Yes;IMEX=1";</ConnectionString>
   <ViewName>NomDeVue</ViewName>	
   <Content>CIAttachment</Content>
</Source>