Exemple de Runbook : Surveiller un dossier avec un runbook
Cet article vous montre comment créer un runbook simple qui surveille un dossier pour les nouveaux fichiers texte. Lorsqu'un fichier est détecté, le Runbook envoie un message de journal des événements, puis démarre un autre Runbook.
Créer et tester un Runbook d'analyse
Les procédures de création, de configuration et de test d’un runbook simple qui surveille un dossier sont décrites ci-dessous.
Créer le flux de travail
Procédez comme suit pour créer un flux de travail :
Dans le volet Connexions du Concepteur de runbooks, cliquez avec le bouton droit sur le dossier Runbooks pour sélectionner Nouveau, puis sélectionnez Runbook.
Cliquez avec le bouton droit sur l'onglet Nouveau Runbook pour sélectionner Renommer.
Dans la boîte de dialogue Confirmer l’extraction, sélectionnez Oui.
Entrez un nom pour le runbook, tel que Monitor Runbook, puis appuyez sur Entrée.
Dans le volet Activités , sélectionnez Gestion des fichiers pour développer la catégorie, puis faites glisser l’activité Surveiller le dossier dans l’espace de travail Runbook Designer Design.
Dans le volet Activités , sélectionnez Notification pour développer la catégorie, puis faites glisser l’activité Envoyer le message du journal des événements dans l’espace de travail Création du Runbook Designer , à droite de l’activité Surveiller le dossier .
Dans l'espace de travail Conception de Runbook Designer , déplacez votre pointeur vers le côté droit de l'activité Analyser le dossier pour afficher la flèche de la liaison intelligente.
Sélectionnez la flèche de lien intelligent, puis faites-la glisser vers l’activité Envoyer un message du journal des événements.
Dans le volet Activités , sélectionnez Runbook Control pour développer la catégorie, puis faites glisser l’activité Invoke Runbook dans l’espace de travail Runbook Designer Design, à droite de l’activité Envoyer un message du journal des événements.
Dans l'espace de travail Conception de Runbook Designer , déplacez votre pointeur vers le côté droit de l'activité Envoyer un message du journal des événements pour afficher la flèche de liaison intelligente.
Sélectionnez la flèche de lien intelligent, puis faites-la glisser vers l’activité Invoke Runbook .
Configurer le flux de travail
Procédez comme suit pour configurer le flux de travail :
Dans l'espace de travail Conception de Runbook Designer , double-cliquez sur l'activité Analyser le dossier .
Dans la boîte de dialogue Surveiller les propriétés du dossier, sélectionnez l’onglet Général .
Dans la zone Nom , remplacez le nom de l’activité par quelque chose d’informatif. Par exemple, Surveiller le dossier C :\Monitor.
Sélectionnez l’onglet Détails.
Sous l’onglet Détails , dans la zone Chemin d’accès, entrez le chemin d’accès du dossier que vous souhaitez surveiller. Par exemple, C :\Monitor.
Sous la liste Filtres de fichiers , sélectionnez Ajouter.
Dans la boîte de dialogue Paramètres du filtre, définissez les éléments suivants :
Dans la zone de liste Nom , sélectionnez Nom de fichier.
Dans la liste Relation , sélectionnez Correspond au modèle.
Dans la zone Valeur , entrez *.txt.
Ce paramètre demande à l'analyse de rechercher des fichiers avec l'extension txt . Ce champ accepte la syntaxe d'expression régulière.
Cliquez sur OK.
Sélectionnez l’onglet Déclencheurs.
Sélectionnez l’option Nombre de fichiers , définissez la valeur dans la liste sur supérieure à, puis entrez 0 dans la zone d’édition.
Sélectionnez Terminer.
Dans l'espace de travail Conception de Runbook Designer , double-cliquez sur Envoyer un message du journal des événements.
Dans la boîte de dialogue Envoyer des messages du journal des événements, sous l’onglet Détails , dans la section Propriétés , définissez les éléments suivants :
Dans la zone Ordinateur , entrez le nom de l’ordinateur pour recevoir le message Événement.
Il s’agit généralement de l’ordinateur sur lequel vous exécutez Runbook Designer.
Dans la zone Message , entrez le message à afficher dans le journal des événements. Par exemple, fichier détecté.
Laissez le niveau de Gravité à Informations.
Sélectionnez Terminer.
Remarque
Dans cet exemple, l’activité Invoke Runbook n’est pas configurée.
Modifier les paramètres du runbook
Procédez comme suit pour modifier les paramètres du runbook :
Au-dessus de l'espace de travail Conception de Runbook Designer , cliquez avec le bouton droit sur l'onglet Analyser Runbook pour sélectionner Propriétés.
Dans la boîte de dialogue Surveiller les propriétés du Runbook, sélectionnez l’onglet Journalisation, puis sélectionnez les données retournées spécifiques à l’activité et stockez les données retournées communes.
Sélectionnez Terminer.
Cliquez avec le bouton droit sur l'onglet Analyser Runbook pour sélectionner Enregistrement.
Tester le Runbook
Dans Runbook Tester, vous pouvez tester des Runbook dans un environnement de débogage et d'exécution simulés. Vous pouvez exécuter un Runbook entier, exécuter pas à pas une activité à la fois, ou ajouter des points d'arrêt pour arrêter la simulation à toute activité que vous sélectionnez.
Utilisez la procédure suivante pour tester votre Runbook dans Runbook Tester.
Préparer votre ordinateur
Procédez comme suit pour préparer votre ordinateur :
Cliquez avec le bouton droit sur Démarrer pour sélectionner Ouvrir l'Explorateur Windows.
Créez un dossier C :\Monitor sur votre ordinateur.
Créez un dossier C :\Source sur votre ordinateur.
Dans le dossier C :\Source , créez un fichier avec une extension txt . Par exemple, text.txt.
Tester le Runbook
Procédez comme suit pour tester le runbook :
Dans l'espace Conception de Runbook Designer , sélectionnez l'onglet Analyser Runbook .
Dans la barre d’outils au-dessus de l’espace de travail Runbook Designer Design, sélectionnez Runbook Tester.
Dans la boîte de dialogue Confirmer l’extraction, sélectionnez Oui.
Dans Runbook Tester, dans la barre d’outils, sélectionnez Pas à pas pour commencer à parcourir le runbook.
Conseil
Pour augmenter la taille du volet Journal , supprimez le volet Explorateur de ressources en sélectionnant Affichage dans le menu, puis en désactivant l'option Explorateur de ressources .
Dans l'Explorateur Windows, accédez au dossier C:\Source .
Copiez test.txt dans C:\Monitor.
Fermez l'Explorateur Windows.
Dans la barre d’outils Runbook Tester, sélectionnez Suivant.
Après quelques instants, l’entrée du volet Journal est mise à jour et affiche un événement pour l’activité Surveiller le dossier .
Dans le volet Journal , sélectionnez le lien Afficher les détails pour afficher le contenu du bus de données pour ce runbook.
Faites défiler la liste des propriétés. Si l’état de l’activité réussit, il indique que l’activité Surveiller le dossier a détecté la modification dans le dossier.
Dans la barre d’outils Runbook Tester, sélectionnez Suivant.
Remarquez que le volet Journal change et affiche un événement pour l'activité Envoyer un message du journal des événements .
Sélectionnez le lien Afficher les détails . Si l’état de l’activité réussit, il indique que l’activité Envoyer un message de journal des événements a détecté la modification dans le dossier.
Fermez Runbook Tester.
Dans la barre d’outils Runbook Designer, sélectionnez Point.
Étapes suivantes
- Lisez les runbooks De conception et de génération pour en savoir plus sur la création de runbooks et obtenez des conseils de bonnes pratiques pour la conception de runbooks.
- Pour en savoir plus sur les options de contrôle de l’exécution du runbook, lisez les activités de contrôle des runbooks.