Freigeben über

Erstellen und Testen eines Beispielrunbooks

  • Artikel

Wichtig

Diese Version von Orchestrator hat das Ende des Supports erreicht. Es wird empfohlen, ein Upgrade auf Orchestrator 2022 durchzuführen.

Im folgenden Artikel wird beschrieben, wie Sie ein Beispielrunbook erstellen und testen. Der Zweck dieses Runbooks besteht darin, zu erkennen, wann eine Textdatei einem bestimmten Ordner hinzugefügt wird, diese Datei in einen anderen Ordner zu kopieren, den Dateiinhalt zu lesen, eine Zeile aus der kopierten Datei an eine andere Datei anzufügen und die Ursprungsdatei schließlich zu löschen.

Das Runbook wird mit der Aktivität Datei überwachen gestartet, um auf das Erstellen der Textdatei zu warten. Anschließend werden mithilfe der Aktivitäten Datei kopieren, Zeile lesen, Zeile anfügenund Datei löschen die anderen Funktionen ausgeführt. Mit der Aktivität Verbindung werden die Aktivitäten koordiniert, damit die Aktivitäten Datei kopieren und Zeile anfügen beide abgeschlossen sind, bevor die Quelldatei gelöscht wird.

Erstellen des Runbooks

Verwenden Sie die folgenden Verfahren, um das Runbook mithilfe der erforderlichen Aktivitäten zu erstellen.

  1. Wählen Sie Start aus, zeigen Sie auf Alle Programme, wählen Sie Microsoft System Center 2016, Orchestrator und dann Runbook Designer aus.

  2. Klicken Sie im Bereich Connections mit der rechten Maustaste auf Runbooks, um Neu auszuwählen, und wählen Sie dann Runbook aus.

    Ein Registerkarte Neues Runbook wird oben im Designbereich von Runbook Designer mit dem Namen Neues Runbookangezeigt.

  3. Klicken Sie mit der rechten Maustaste auf die Registerkarte Neues Runbook , und wählen Sie Umbenennenaus.

    Wählen Sie im Dialogfeld Auschecken bestätigen die Option Ja aus.

  4. Geben Sie workflow anfügen und kopieren in das Feld Eingabe ein, und drücken Sie dann die EINGABETASTE.

Sie haben ein neues Runbook erstellt und können mit dem Hinzufügen und Konfigurieren von Aktivitäten beginnen.

Hinzufügen und Konfigurieren einer Überwachungsdateiaktivität

Führen Sie die folgenden Schritte aus, um eine Aktivität "Datei überwachen" hinzuzufügen und zu konfigurieren:

  1. Erweitern Sie nach dem Öffnen des neu erstellten Runbooks Workflow anfügen und kopieren im Bereich Aktivitäten die Kategorie Dateiverwaltung .

  2. Wählen Sie die Aktivität Datei überwachen aus, und ziehen Sie sie in den Arbeitsbereich Runbook Designer Design.

  3. Doppelklicken Sie auf die Aktivität Datei überwachen , um das Dialogfeld Eigenschaften zu öffnen.

  4. Geben Sie im Feld In Ordnerden Wert C:\Drop ein.

  5. Wählen Sie im Abschnitt Filter die Schaltfläche Hinzufügen aus.

  6. Wählen Sie im Dialogfeld Filtereinstellungen in der Liste Name die Option Dateiname aus.

  7. Wählen Sie in der Liste Beziehung die Option Entspricht dem Musteraus.

  8. Geben Sie im Feld Wert*.txtein.

  9. Klicken Sie auf OK.

  10. Wählen Sie die Registerkarte Trigger aus.

  11. Aktivieren Sie im Abschnitt Trigger if one of the files was (Trigger if one of the files was ) das Kontrollkästchen Erstellt , und wählen Sie dann Fertig stellen aus.

Die Aktivität Datei überwachen wurde erstellt und so konfiguriert, dass im Ordner C:\Drop nach neu erstellten Textdateien gesucht wird.

Hinzufügen zusätzlicher Aktivitäten zum Runbook

Führen Sie die folgenden Schritte aus, um dem Runbook zusätzliche Aktivitäten hinzuzufügen:

  1. Erweitern Sie im Bereich Aktivitäten die Kategorie Dateiverwaltung .

  2. Wählen Sie die Aktivität Datei kopieren aus, und ziehen Sie sie in den Arbeitsbereich Runbook Designer Design.

  3. Erweitern Sie die Kategorie Textdateiverwaltung .

  4. Wählen Sie die Aktivität Zeilen lesen aus, und ziehen Sie sie in den Arbeitsbereich Runbook Designer Design.

  5. Um eine Verknüpfung zwischen der Aktivität Datei überwachen und der Aktivität Datei kopieren zu erstellen, wählen Sie den Pfeil nach rechts der Aktivität Datei überwachen aus, und ziehen Sie ihn in die Aktivität Datei kopieren .

  6. Um eine Verknüpfung zwischen der Aktivität Datei überwachen und der Aktivität Zeilen lesen zu erstellen, wählen Sie den Pfeil nach rechts der Aktivität Datei überwachen aus, und ziehen Sie ihn in die Aktivität Zeile lesen .

Indem Sie sowohl die Aktivität Zeilen lesen als auch die Aktivität Datei kopieren hinzufügen, haben Sie einen Workflow erstellt.

Konfigurieren der Aktivität "Datei kopieren"

Führen Sie die folgenden Schritte aus, um die Aktivität Datei kopieren zu konfigurieren:

  1. Klicken Sie im Runbook Workflow anfügen und kopieren mit der rechten Maustaste auf die Aktivität Datei kopieren , um Eigenschaften auszuwählen.

  2. Klicken Sie auf der Registerkarte Details mit der rechten Maustaste auf das Feld Datei , um Abonnieren auszuwählen, und wählen Sie dann Veröffentlichte Daten aus, um das Dialogfeld Veröffentlichte Daten zu öffnen.

    Die Aktivität "Datei überwachen " wird oben im Dialogfeld "Veröffentlichte Daten " aufgeführt, da dies die Aktivität unmittelbar vor der ausgewählten Aktivität ist.

  3. Wählen Sie in der Spalte Namedie Option Name und Pfad der Datei aus, und klicken Sie dann auf OK. Dadurch wird die Eigenschaft Datei der Aktivität Datei kopieren mit dem Namen und dem Pfad zu der Datei aus der Aktivität Datei überwachen aufgefüllt.

  4. Geben Sie im Feld Zielordnerden Wert C:\Copy ein.

  5. Wählen Sie Fertig stellen aus.

Die Aktivität Datei kopieren ist nun so konfiguriert, dass Dateien aus dem Quellordner in den Zielordner kopiert werden.

Konfigurieren der Lesezeilenaktivität

Führen Sie die folgenden Schritte aus, um die Lesezeilenaktivität zu konfigurieren:

  1. Klicken Sie im Runbook Workflow anfügen und kopieren mit der rechten Maustaste auf die Aktivität Zeile lesen , und wählen Sie Eigenschaftenaus.

  2. Klicken Sie auf der Registerkarte Details mit der rechten Maustaste auf das Feld Datei , um Abonnieren auszuwählen, und wählen Sie dann Veröffentlichte Daten aus, um das Dialogfeld Veröffentlichte Daten zu öffnen.

  3. Wählen Sie in der Liste Aktivitäten den Eintrag Datei überwachenaus.

  4. Wählen Sie in der Spalte Namedie Option Name und Pfad der Datei aus, und klicken Sie dann auf OK.

  5. Wählen Sie rechts neben dem Feld Dateicodierung die Schaltfläche mit den Auslassungspunkten (...) aus, und wählen Sie dann Auto aus.

  6. Geben Sie im Feld Zeilennummernden Wert 1-END ein, und wählen Sie dann OK aus.

  7. Wählen Sie Fertig stellen aus.

Die Aktivität „Zeile lesen“ ist jetzt konfiguriert.

Hinzufügen einer Anfügezeilenaktivität

Führen Sie die folgenden Schritte aus, um eine Aktivität "Zeile anfügen" hinzuzufügen:

  1. Erweitern Sie im Bereich Aktivitäten die Kategorie Textdateiverwaltung .

  2. Wählen Sie die Aktivität Zeile anfügen aus, und ziehen Sie sie in den Arbeitsbereich Runbook Designer Entwurf rechts neben der Aktivität Zeilen lesen.

  3. Um einen Link von der Aktivität "Zeile lesen " zur Aktivität "Zeile anfügen " zu erstellen, wählen Sie den Pfeil nach rechts der Aktivität Zeilen lesen aus, und ziehen Sie ihn auf die Aktivität Zeile anfügen .

  4. Klicken Sie mit der rechten Maustaste auf die Aktivität Zeile anfügen , und wählen Sie Eigenschaftenaus.

  5. Geben Sie auf der Registerkarte Details im Feld DateiC:\Copy\Masterlog.txtein.

  6. Wählen Sie rechts neben dem Feld Dateicodierung die Schaltfläche mit den Auslassungspunkten (...) aus, und wählen Sie dann Auto aus.

  7. Klicken Sie mit der rechten Maustaste auf das Textfeld, um Abonnieren auszuwählen, und wählen Sie dann Veröffentlichte Daten aus, um das Dialogfeld Veröffentlichte Daten zu öffnen.

  8. Wählen Sie in der Spalte Name für die Aktivität Zeilen lesen die Option Zeilentext aus, und klicken Sie dann auf OK.

  9. Wählen Sie Fertig stellen aus.

Die Aktivität Datei anfügen ist nun so konfiguriert, dass Dateien an die Datei Masterlog.txt angefügt werden.

Synchronisieren von Branches eines Runbooks

Führen Sie die folgenden Schritte aus, um die Verzweigungen eines Runbooks zu synchronisieren:

  1. Erweitern Sie im Bereich Aktivitäten die Kategorie Runbooksteuerung .

  2. Wählen Sie das Symbol Verbindung aus, und ziehen Sie es in den Arbeitsbereich Runbook Designer Design.

  3. Um einen Link von der Aktivität Zeile anfügen zur Junction-Aktivität zu erstellen, wählen Sie den Pfeil nach rechts der Aktivität Linie anfügen aus, und ziehen Sie ihn auf die Junction-Aktivität .

  4. Um einen Link von der Copy File-Aktivität zur Junction-Aktivität zu erstellen, wählen Sie den Pfeil nach rechts der Aktivität Datei kopieren aus, und ziehen Sie ihn in die Junction-Aktivität .

  5. Klicken Sie mit der rechten Maustaste auf die Aktivität Verbindung , und wählen Sie Eigenschaftenaus.

  6. Wählen Sie die Schaltfläche mit den Auslassungspunkten (...) neben dem Feld Daten zurückgeben von aus , und wählen Sie dann Datei kopieren aus. Klicken Sie auf OK. Mit dieser Aktion wird die Aktivität so konfiguriert, dass sie dieselben veröffentlichten Daten wie die Aktivität Datei kopieren zurückgibt.

  7. Wählen Sie Fertig stellen aus.

Die Aktivität Verbindung ist für die Koordination des Workflows konfiguriert, sodass keine weiteren Aktivitäten ausgeführt werden, bis sowohl die Aktivität Datei kopieren als auch die Aktivität Zeile anfügen abgeschlossen sind.

Hinzufügen und Konfigurieren der Aktivität "Datei löschen"

Führen Sie die folgenden Schritte aus, um die Aktivität Datei löschen hinzuzufügen und zu konfigurieren.

  1. Erweitern Sie im Bereich Aktivitäten die Kategorie Dateiverwaltung .

  2. Wählen Sie das Symbol Datei löschen aus, und ziehen Sie es in den Arbeitsbereich Runbook Designer Design.

  3. Um einen Link von der Junction-Aktivität zur Aktivität Datei löschen zu erstellen, wählen Sie den Pfeil nach rechts der Junction-Aktivität aus, und ziehen Sie ihn auf die Aktivität Datei löschen .

  4. Klicken Sie mit der rechten Maustaste auf die Aktivität Datei löschen , und wählen Sie Eigenschaftenaus.

  5. Klicken Sie mit der rechten Maustaste auf das Feld Pfad , um Abonnieren auszuwählen, und wählen Sie dann Veröffentlichte Daten aus, um das Dialogfeld Veröffentlichte Daten zu öffnen.

    Wählen Sie in der Liste Aktivitäten den Eintrag Datei kopierenaus.

  6. Wählen Sie in der Spalte Namedie Option Name und Pfad der ursprünglichen Datei aus, und klicken Sie dann auf OK.

  7. Wählen Sie Fertig stellen aus.

Das Runbook Workflow anfügen und kopieren ist nun abgeschlossen. Das Ergebnis sollte der folgende Abbildung ähneln.

Screenshot des Runbook-Beispiels 1.

Testen des Runbooks

Sie können das Runbook mithilfe von Runbook Tester testen. Mit diesem Tool können Sie das gesamte Runbook ausführen und den Abschlussstatus sowie die Ausgabe jeder Aktivität untersuchen. Von Runbook Tester werden die Aktivitäten ausgeführt, d. h., Sie müssen zuerst die im Runbook angegebenen Ordner erstellen.

Führen Sie die folgenden Schritte aus, um das Runbook zu testen:

  1. Erstellen Sie auf dem Runbook-Server einen Ordner mit der Bezeichnung C:\Drop.

  2. Erstellen Sie auf dem Runbook-Server einen Ordner mit der Bezeichnung C:\Copy.

  3. Wählen Sie auf der Symbolleiste Runbook Tester aus, indem Sie das Runbook-Runbook "Workflow anfügen und kopieren" im Designer "Runbook" ausgewählt haben.

  4. Wählen Sie Zum Haltepunkt ausführen aus. Die Aktivität Datei überwachen wird geladen und wartet darauf, dass im Ordner "C:\Drop" eine Textdatei erstellt.

  5. Öffnen Sie Editor, und geben Sie einige Textzeilen ein. Speichern Sie die Datei als C:\Drop\File1.txt.

  6. Warten Sie einige Augenblicke auf die Ausführung der anderen Aktivitäten. Überprüfen Sie, ob jede der Aktivitäten erfolgreich abgeschlossen wurde.

  7. Um die veröffentlichten Daten und andere Details einer Aktivität anzuzeigen, wählen Sie Details für die Aktivität anzeigen aus.

  8. Öffnen Sie den Ordner C:\Drop, und überprüfen Sie, ob die Datei entfernt wurde.

  9. Öffnen Sie den Ordner C:\Drop, und überprüfen Sie, ob die Datei kopiert wurde. Überprüfen Sie außerdem, ob die Datei MasterLog.txt den Inhalt der ursprünglichen Datei enthält.

Nächste Schritte

Siehe Beispielrunbook: Überwachen eines Ordners mit einem Runbook.