DataImporter : Spécifications

Aperçu

Survol du fonctionnement de DataImporter

1. Utiliser le système commercial externe (incluant des outils de gestion de la base de données) pour définir la vue. Les systèmes suivants offrent la possibilité de créer des vues: Oracle, Microsoft SQL Server, MySql, DB2, DBase, Fox Pro.
   
   
2. Utiliser MS-Access comme "pont" entre Octopus et le système externe. Cette option est utile si le système externe possède une base de données compatible avec ODBC/OLEDB mais n'inclut pas d'outils pour créer des vues. Dans ce cas, MS-Access est utilisé pour lier les tables avec le système externe et pour créer la vue; la base de donnée Access devient la source de données de DataImporter.
   
   

Étapes pour définir une requête (vue) utilisable par DataImporter:

1. Créer une base de données MS-Access nommée db1.mdb.
2. Lier une ou plusieurs tables du système externe.
3. Créer une vue nommée "UtilisateursSysFic" dans la DB MS-Access. Le nom de la requête (vue) peut varier.
4. Analyser la structure des tables du système externe pour trouver comment créer une requête répondant aux spécifications d'Octopus. Voir la section des spécifications plus loin dans ce document.
5. Modifier la vue UtilisateursSysFic de manière à ce qu'elle soit conforme aux spécifications. (nom de champs, champs requis, etc.).
6. Sauvegarder la base de données MS-Access qui inclut les changements apportés.

Création du fichier de configuration de DataImporter

<?xml version="1.0" encoding="utf-8" ?>
<Sources>
   <Source Name="UsereSource" >
   <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=c:\\db1.mdb</ConnectionString>
   <ViewName>UtilisateursSysFic</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:\\db1.mdb</ConnectionString>
   <ViewName>UtilisateursSysFic</ViewName> 
   <Content>User</Content>
   </Source>

   <Source Name="SourceName2" >
   <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=c:\\db1.mdb</ConnectionString>
   <ViewName>Ordinateurs</ViewName>
   <Content>CI</Content>
   </Source>

   <Source Name="SourceName3" >
   <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=c:\\db1.mdb</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.mdb</ConnectionString>
   <ViewName>Ordinateurs</ViewName>
   <Content>CI</Content>
</Source>

• 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.
• Local - Texte(50)
• TéléphoneBureau - Texte(50)
• PosteTéléphonique - Texte(6)
• TéléphoneCellulaire - Texte(50)
• Téléavertisseur - Texte(50) « Version 2.15 »
• Courriel - Texte(50)
• Note - Texte(2000)
• Actif - (1/0 ou True/False)
• UtilisateurWindows - Texte(50)

• 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:\\db1.mdb</ConnectionString>
   <ViewName>NomVue</ViewName>
   <Content>User</Content>
   <IdentificationMethod>UserByID</IdentificationMethod>
</Source>

Importation des CI

• Nom - Texte (125)
  • 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 "1.9" pourrait avoir comme nom de CI : "Octopus (1.9)"

• 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.
• Version - Texte (50)
• É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.
• Local – Texte(50)
  • Le système va créer le local s'il n'existe pas.
  • Si un local est spécifié alors un site doit aussi être spécifié.
• Catégorie – Texte(50)
  • 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) - « Version 2.14 »
• SourceFinancement – Texte(100) - « Version 2.14 »
• NécessiteContratService – (1/0 ou True/False) - « Version 2.14 »
• DuréeVie – Texte(50) - « Version 2.14 »
• DuréeAmortissement – Entier (ex : 123) - « Version 2.14 »
  • La durée d'amortissement exprimée en nombre de mois.

• Tout autre attribut personnalisé du type de CI importé.

• 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="SoftwaresView" >
   <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=c:\\db1.mdb</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:\\db1.mdb</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:\\db1.mdb</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:\\db1.mdb</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)
• Fournisseur - Texte (500)

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

<Source Name="ContratsServices">
   <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=c:\\db1.mdb</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:\\db1.mdb</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:\\db1.mdb</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:\\db1.mdb</ConnectionString>
   <ViewName>NomDeVue</ViewName>	
   <Content>LeasedCI</Content>
</Source>

Importation des incidents

• 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.
• Intervenant
  • Usager octopus auquel l’incident sera assigné. Doit être le nom d’utilisateur Windows.
• Impact
  • Doit être égal au libellé d’un niveau d’impact (ex : « 1 – Haut », « 2 – Moyen », « 3 – Bas »)
• Urgence
  • Doit être égal au libellé d’un niveau d’urgence (ex : « 1 – Haute », « 2 – Moyenne », « 3 – Basse »)
• Priorité
  • Doit être égal au libellé d’un niveau de priorité (ex : « 1 – Urgent », « 2 – Haut », « 3 – Normal »)
• Catégorie
  • Doit être égale au libellé d’une catégorie existante dans Octopus
• Sous-catégorie
  • Doit être égale au libellé d’une sous-catégorie existante dans Octopus
• DateOuverture
  • Représente la date d’ouverture dans le format YYYY-MM-DD HH :MM :SS
• 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.
• DateFermeture
  • Représente la date à laquelle l’incident a été fermé dans le format YYYY-MM-DD HH :MM :SS
  • La date doit être supérieure à la date de résolution.
• 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 ». Représente la description de l’activité de résolution.
• ActivitéRésolution
  • Champ requis lorsque l’incident a un statut « Résolu ». 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
• 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:\\db1.mdb</ConnectionString>
   <ViewName>NomDeVue</ViewName>
   <Content>Incident</Content>
</Source>