English

MailIntegration : Création d'incidents à partir de courriels

Modifié: 2010/06/22 09:43 par slevesque - Catégorisé en: Technique
La création d'incidents à partir de courriels est faite par un programme qui s'appelle ESI.Octopus.MailIntegrationApp.exe. Ce programme est une application command-line qui lit le contenu d'un mailbox dans votre environnement informatique et crée un incident pour chaque courriel dans le mailbox.

Si vous voulez créer des incidents à partir d'un système de surveillance (System Center Operations Manager 2007 par exemple), nous vous suggérons de créer des événements et non des incidents. Pour créer des événements à partir de courriels, veuillez consulter la page suivante : Création d'événements à partir de courriels.

Modifier

Paramètres du programme ESI.Octopus.MailIntegrationApp.exe

Le programme nécessite 3 paramètres:

/Login : Nom d'utilisateur d'un compte Octopus qui sera utilisé pour créer les incidents. Ce nom sera visible dans l'historique de l'incident comme créateur de l'incident. Vous pouvez créer un nouveau compte Octopus pour cela.

Exemple:
Prénom: Mail, Nom: Integration

/Password : Mot de passe pour le compte mentionné ci-dessus.

/ConfigFilePath : Un chemin vers le fichier de configuration. La prochaine section explique comment préparer le fichier de configuration.

Modifier

Fichier de configuration pour création d'incidents

Le fichier de configuration est un fichier texte qui contient l'information sur le serveur de courriel, le mailbox à utiliser, et d'autres paramètres nécéssaires au programme. Ce fichier utilise le format XML.

Avertissement

Avant de commencer la création du fichier de configuration, prenez soins de ne pas briser le format de fichier en modifiant les étiquettes ou la structure de fichier. Un seul "/" ou "<" ou ">" manquant ou additionnel pourra rendre le fichier inutile. Assurez-vous que les valeurs spécifiées sont valides. Ne laissez pas d'espaces vides avant ou après les valeurs. En cas d'erreur avec le fichier de configuration, le logiciel va s'arrêter sans problème. Cependant, le logiciel n'est pas très clair dans la façon qu'il avise des erreurs, alors des erreurs pourront être difficiles à trouver. Une vérification diligente des valeurs est recommandée avant de démarrer le programme.

  1. Ouvrir le fichier suivant dans Notepad : email-integration.txt
  2. Dans la section <serverName>SERVER</serverName>, remplacez SERVER avec le nom de votre serveur courriel.
  3. Dans la section <userName>MAILBOX</userName>, remplacez MAILBOX avec le nom de compte sur le serveur de courriel. Habituellement, la portion domain de l'adresse courriel publique n'est pas incluse. Par exemple, on indiquerait "nouvelincident" au lieu de "nouvelincident@macompagnie.com".
  4. Dans la section <password>PASSWORD-CLEAR-TEXT</password>, remplacez PASSWORD-CLEAR-TEXT avec le mot de passe pour ce compte.
  5. Dans la section <incidentFallbackSiteName>FALLBACK-SITE<incidentFallbackSiteName>, remplacez FALLBACK-SITE avec le nom d'un site qui existe dans Octopus. Quand le programme exécute, il cherche le nom d'utilisateur Octopus de l'addresse courriel de l'expéditeur. Si l'expéditeur n'est pas reconnu ou s'il/elle n'a pas de site, le programme va utiliser le site indiqué ici.
  6. Dans la section <incidentFallbackUserLogon>FALLBACK-USER</incidentFallbackUserLogon>, remplacez FALLBACK-USER avec le nom d'utilisateur Windows d'un utilisateur Octopus existant (technicien ou non). Ceci doit être identique au nom enregistré dans le champ Nom d'utilisateur Windows dans Octopus. Si jamais un courriel est reçu d'un adresse courriel qui n'est pas reconnu par Octopus, le système va utiliser le compte indiqué ici comme les valeurs "Demandeur" et "Utilisateur" pour l'incident.
  7. Dans la section <incidentSource>INCIDENT_SOURCE</incidentSource>, remplacez INCIDENT_SOURCE par le nom de source que vous voulez utiliser. Habituellement, vous allez indiquer "Courriel" dans ce paramètre.
  8. Sauvegardez le fichier dans “c:\program files\octopus\” avec l'extension de fichier ".xml". Par exemple "integration-courriel.xml"

Modifier

Démarrer ESI.Octopus.MailIntegrationApp.exe pour la première fois

Note: Avant de tester MailIntegrationApp, il est recommandé de tester la connection POP3 à votre serveur en utilisant la procédure suivante : Tester la connection POP3

Pour tester MailIntegrationApp, procédez comme suit.
  1. Envoyez un courriel au compte qui va recevoir les courriels
  2. Ouvrir une fenêtre command-line
  3. Entrez la commande suivante et appuyez sur ENTER: c:\
  4. Entrez la commande suivante et appuyez sur ENTER: cd c:\program files\octopus\
  5. Entrez la commande suivante en fournissant les valeurs correctes pour les 3 paramètres et appuyez sur ENTER: ESI.Octopus.MailIntegrationApp.exe /Login: loginname /Password:password /ConfigFilePath: path
    • Le programme va démarrer pour quelques secondes et va ensuite terminer.
  6. Entrez dans Octopus et ouvrez la liste des incidents "Nouveaux" pour voir le nouvel incident.

Automatiser ESI.Octopus.MailIntegrationApp.exe

MailIntegrationApp ne va pas surveiller le mailbox. Quand vous démarrez MailIntegrationApp, il lit une fois le mailbox, il crée les incidents, et il termine. Par conséquent, vous aurez besoin d'automatiser l'exécution de MailIntegrationApp. Pour accomplir la tâche, vous devez tout simplement créer un Windows Scheduled Task pour exécuter ce programme tous les 5 ou 10 minutes. Si vous avez besoin d'assistance avec la création du Scheduled Task, contactez-nous.

Administration | Ce wiki est conçu avec ScrewTurn.