Freigeben über

Überwachen von Runbook-Aktivitäten

  • Artikel

Wichtig

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

Sie legen die Reihenfolge der Vorgänge in Runbooks fest, indem Sie Aktivitäten im Runbook-Designer miteinander verknüpfen. Diese Links werden als intelligente Links bezeichnet, da Sie sie so konfigurieren können, dass sie den Typ der Daten steuern, die von einer Aktivität an eine andere übergeben werden. Sie können auch steuern, wann das Runbook Aktivitäten abschließt, indem Sie die Logik festlegen, wann diese Vorgänge mit eingebetteten Schleifen ausgeführt werden. Schließlich können Sie Text- und numerische Vorgänge verwenden, um Daten beim Übergeben zwischen Aktivitäten zu bearbeiten oder Bedingungen für die Reihenfolge der Vorgänge festzulegen. In diesem Artikel wird beschrieben, wie Sie die Sequenzierung steuern und Daten in Ihrem Runbook bearbeiten.

Die Aktivitäten in Ihrem Runbook werden gemäß der von Ihnen festgelegten Reihenfolge abgeschlossen, indem Sie sie miteinander verknüpfen. Sie können die Daten steuern, die zwischen den Aktivitäten fließen, indem Sie die Registerkarten Einschließen und Ausschließen der Linkeigenschaften verwenden. Sie können beispielsweise nur Daten einschließen, die an die nachfolgende Aktivität übergeben werden sollen, die ein bestimmtes Kriterium erfüllt.

Wichtig

Die Regeln auf der Registerkarte Ausschließen des intelligenten Links haben Vorrang vor jenen auf der Registerkarte Einschließen .

Wichtig

Die Regeln auf den einzelnen Registerkarten werden mit einer ODER -Bedingung verknüpft. Nur eine der festgelegten Bedingungen auf einer Registerkarte muss wahr sein, damit die Bedingung wahr ist.

Der Typ der von einer Aktivität veröffentlichten Daten bestimmt den Typ der Kriterien, die Sie zum Steuern der Runbooksequenz festlegen können. Einige Aktivitäten veröffentlichen Binärdaten, und andere veröffentlichen numerische oder Textdaten.

Wenn es sich bei den veröffentlichten Daten um Textdaten handelt, können Sie eine der folgenden Optionen verwenden, um die Kriterien für Ausführung, Einschluss oder Ausschluss festzulegen.

Bedingung BESCHREIBUNG
contains Der angegebene Text ist im Wert des veröffentlichten Datenelements enthalten.
enthält nicht Der angegebene Text ist nicht im Wert des veröffentlichten Datenelements enthalten.
Beginnt mit Der Wert des veröffentlichten Datenelements beginnt mit dem angegebenen Text.
Endet mit Der Wert des veröffentlichten Datenelements endet mit dem angegebenen Text.
Entspricht dem Muster Der Wert des veröffentlichten Datenelements stimmt mit dem speziellen regulären Ausdruck überein.
Entspricht nicht dem Muster Der Wert des veröffentlichten Datenelements stimmt mit dem speziellen regulären Ausdruck überein.
Ist gleich Der Wert des veröffentlichten Datenelements entspricht genau dem angegebenen Text.
ist ungleich Der Wert des veröffentlichten Datenelements entspricht nicht dem angegebenen Text.

Hinweis

Bei Textwerten wird die Groß-/Kleinschreibung nicht beachtet.

Sie können auch Kriterien festlegen, indem Sie reguläre Ausdrücke verwenden, um Musterabgleiche durchzuführen.

Wenn die veröffentlichten Daten numerisch sind, können Sie eine der folgenden Optionen verwenden, um die Kriterien für Ausführung, Einschluss oder Ausschluss festzulegen.

Bedingung BESCHREIBUNG
Ist gleich Der Wert des veröffentlichten Datenelements entspricht genau dem angegebenen Wert.
ist ungleich Der Wert des veröffentlichten Datenelements entspricht nicht dem angegebenen Wert.
Ist kleiner als Der Wert des veröffentlichten Datenelements ist kleiner als der angegebene Wert.
größer als Der Wert des veröffentlichten Datenelements ist größer als der angegebene Wert.
Ist kleiner als oder gleich Der Wert des veröffentlichten Datenelements ist kleiner als oder gleich dem angegebenen Wert.
Ist größer als oder gleich Der Wert des veröffentlichten Datenelements ist größer als oder gleich dem angegebenen Wert.
Liegt zwischen Der Wert des veröffentlichten Datenelements liegt zwischen zwei angegebenen Werten.

Wählen Sie die erforderliche Registerkarte für die Schritte zum Hinzufügen oder Entfernen einer Smart Link-Bedingung aus:

Wiederholen von Aktivitäten mit eingebetteten Schleifen

Mithilfe von Schleifen können Sie an jeder Position in einem Runbook automatische Wiederholversuche und Überwachungen erstellen.

Sie können eine Schleife für jede Aktivität erstellen, sodass Sie Vorgänge wiederholen können, wenn sie fehlschlagen, oder die Ausgabeinformationen der Aktivität auf gültige Daten testen können. Zudem können Sie mithilfe dieser Mechanismen Wartebedingungen in Ihre Workflows integrieren.

Wenn Sie eine Schleife für eine Aktivität konfigurieren, wird sie weiterhin mit den gleichen Eingabedaten ausgeführt, bis ein gewünschtes Beendigungsschleifenkriterium erreicht ist. Sie erstellen die Beendigungskriterien für die Schleife auf ähnliche Weise wie Smart Link-Konfigurationen. Sie können jedes veröffentlichte Datenelement aus der Aktivität als Teil der Exit- oder nicht beenden-Konfiguration verwenden. In den allgemeinen veröffentlichten Daten sind spezielle Datenelemente enthalten, z. B. Schleife: Anzahl der Versuche und Schleife: Gesamtdauer, mit denen Sie Informationen aus der Schleife selbst in den Schleifenbedingungen verwenden können.

Schleifen werden einmal für jeden eingehenden Datenabschnitt ausgeführt, der an die Aktivität übergeben wird. Betrachten Sie beispielsweise ein Runbook, das eine Datenbankabfrageaktivität gefolgt von Zeile anfügen verwendet. Wenn die Abfragedatenbankaktivität drei Zeilen zurückgibt, würde die Aktivität Zeile anfügen dreimal ausgeführt. Wenn Sie über eine Schleife für die Aktivität "Zeile anfügen" verfügen, werden drei separate Schleifen ausgeführt. Nachdem das erste Datenelement die Aktivität "Zeile anfügen" durchlaufen hat, durchläuft das nächste Element Anfügezeile und schleift, bis es beendet wird, und dann beginnt das dritte Element. Nachdem alle drei Elemente verarbeitet wurden, wird die nächste Aktivität im Runbook ausgeführt.

Konfigurieren von Schleifen

  1. Klicken Sie mit der rechten Maustaste auf eine Aktivität im Runbook, um Schleifen auszuwählen. Das Dialogfeld Schleifeneigenschaften wird geöffnet.

  2. Wählen Sie auf der Registerkarte Allgemein die Option Aktivieren aus.

  3. Geben Sie im Feld Verzögerung zwischen Versuchen die Anzahl der Sekunden ein, die zwischen jedem Versuch zum Ausführen der Aktivität angehalten werden soll.

Bedingungen für "Beenden" und "Nicht beenden"

Die Regeln auf der Registerkarte Beenden geben die Bedingungen an, die bestimmen, ob die Schleife beendet wird. Die Regeln auf der Registerkarte "Nicht beenden " geben die Bedingungen an, die dazu führen, dass die Schleife fortgesetzt wird.

Wichtig

Die Regeln auf der Registerkarte Nicht beenden ersetzen die Regeln auf der Registerkarte Beenden .

Die Regeln auf jeder Registerkarte werden mithilfe einer Oder-Bedingung verknüpft. Nur eine der Bedingungen auf einer Registerkarte muss wahr sein, damit die gesamte Registerkarte wahr ist.

Wählen Sie die erforderliche Registerkarte für die Prozedur aus, um eine Exit-Bedingung hinzuzufügen oder zu entfernen:

Führen Sie die folgenden Schritte aus, um eine Exitbedingung hinzuzufügen:

  1. Wählen Sie im Dialogfeld Schleifeneigenschaften entweder die Registerkarte Beenden oder die Registerkarte Nicht beenden aus, und wählen Sie dann die im Feld aufgeführte Bedingung aus , um eine Bedingung hinzuzufügen.

    Wichtig

    Um die Werte zu ändern, aus denen die Regel besteht, müssen Sie jeden unterstrichenen Teil der Linkbedingung auswählen.

  2. Wählen Sie die aufgeführte Aktivität in der Bedingung aus, um das Dialogfeld Veröffentlichte Daten zu öffnen.

  3. Aktivieren Sie das Kontrollkästchen Allgemeine zurückgegebene Daten anzeigen, um Eigenschaften anzuzeigen, die allen Aktivitäten gemeinsam sind.

  4. Wählen Sie eine Eigenschaft aus den veröffentlichten Daten aus, und wählen Sie dann OK aus. Der Kriterienausdruck wird in Abhängigkeit vom Datentyp geändert, der von der Eigenschaft zurückgegeben wird.

  5. Um die verschiedenen Teile des Ausdrucks zu ändern, wählen Sie den unterstrichenen Text aus, und wählen Sie einen entsprechenden Wert aus, oder geben Sie diesen ein.

  6. Wählen Sie Fertig stellen aus.

Festlegen eines Zeitplans für ein Runbook

Sie können einen Zeitplan festlegen, um zu steuern, wann ein Runbook ausgeführt wird. Es gibt z. B. Zeiten, in denen es unangemessen ist, einige Runbooks auszuführen, z. B. das Sichern eines Runbooks auf einem Standard-Server während der regulären Geschäftszeiten. Sie können einen Zeitplan erstellen, der auch in komplexen Intervallen ausgeführt wird, beispielsweise am ersten und dritten Montag und Dienstag eines jeden Monats, sofern diese Tage nicht auf einen Feiertag fallen.

Zeitpläne verwenden die Systemuhr des Runbook-Servers, auf dem das Runbook ausgeführt wird. Hierdurch wird ein Funktionieren von Zeitplänen auch in Umgebungen mit virtuellen Maschinen ermöglicht. Außerdem kann die Ausführung so fortgesetzt werden, wenn die Systemuhr infolge eines Wechsels zwischen Sommer- und Winterzeit umgestellt wird.

Runbooks, die beginnen, bevor eine verbotene Zeit ausgeführt wird, bis sie abgeschlossen sind, auch wenn sie noch verarbeitet werden, wenn die verbotene Zeit eintrifft. Sie werden nicht unterbrochen, nachdem die Verarbeitung gestartet wurde.

Wichtig

Die Zugriffsberechtigungen für Zeitpläne können geändert werden, aber der Runbookserver erzwingt diese Berechtigungen nicht.

Hinweis

Wenn Sie planen, dass ein Runbook während einer Stunde gestartet wird, die übersprungen wird, wenn die Systemuhr um eine Stunde nach vorne angepasst wird, wird diese Startzeit übersprungen, und das Runbook beginnt zum nächsten geplanten Zeitpunkt. Wenn Sie planen, dass ein Runbook während einer Stunde gestartet wird, die zweimal auftritt, da die Systemuhr um eine Stunde rückwärts eingestellt ist, startet das Runbook zweimal.

Hinweis

Orchestrator unterstützt das Verschieben mehrerer Zeitpläne mit mehrfacher Auswahl nicht. Wenn Sie mehr als einen Zeitplan in einen anderen Ordner verschieben möchten, müssen Sie jeden Zeitplan einzeln verschieben.

Wählen Sie die erforderliche Registerkarte aus, um einen Zeitplan zu erstellen, einem Runbook einen Zeitplan zuzuweisen oder einen Zeitplan aus einem Runbook zu entfernen:

Führen Sie die folgenden Schritte aus, um einen Zeitplan zu erstellen:

  1. Klicken Sie im Bereich Connections mit der rechten Maustaste auf den Ordner Zeitpläne oder einen Unterordner des Ordners Zeitpläne, zeigen Sie auf Neu, und wählen Sie dann Zeitplan aus, um das Dialogfeld Neuer Zeitplan zu öffnen.

  2. Geben Sie auf der Registerkarte Allgemein im Feld Name einen Namen für den Zeitplan ein.

  3. Geben Sie im Feld Beschreibung eine Beschreibung ein, die den Zweck des Zeitplans beschreibt oder erläutert.

  4. Wählen Sie die Registerkarte Details aus. Wählen Sie die Tage aus, an denen dieser Zeitplan runbooks ausführen kann:

    Wochentage: Wählen Sie diese Option aus, und wählen Sie die Wochentage aus, an denen dieser Zeitplan die Ausführung von Runbooks zulässt.

    Ausführen: Wählen Sie aus, für welche Wochen im Kalendermonat die Ausführung von Runbooks durch diesen Zeitplan geplant werden soll:

    Tage des Monats: Wählen Sie diese Option aus, und wählen Sie die Tage im Monat aus, an denen die Ausführung von Runbooks durch diesen Zeitplan zugelassen werden soll. Geben Sie die Tage im Monat durch Eingabe der jeweiligen Nummer des Tags im Monat an. Mithilfe von Bindestrichen können Sie Bereiche festlegen und mit Kommata Einträge voneinander trennen. Beispielsweise umfasst die Eingabe von 1,3 den ersten und dritten Tag des Monats. Die Eingabe von 1-21 umfasst den ersten bis zum einundzwanzig ersten Tag des Monats. Sie können beide Methoden kombinieren und so komplexe Beschreibungen zu den Tagen innerhalb des Monats erstellen. Geben Sie alle ein, um alle Tage des Monats anzugeben. Geben Sie zuletzt ein, um den letzten Tag des Monats anzugeben.

    Sie können nicht alle und last als Teil eines Zeitraums von Tagen verwenden. Wenn Sie einen Bereich von 5 bis 31 eingegeben haben, funktioniert dieser Bereich für alle Monate ordnungsgemäß, einschließlich derjenigen mit 28, 29, 30 und 31 Tagen.

  5. Wählen Sie Stunden aus, um das Dialogfeld Stunden planen zu öffnen.

  6. Wählen Sie aus, und ziehen Sie, um eine Gruppe von Stunden in einer Woche auszuwählen. Der Text am unteren Rand des Dialogfelds zeigt den ausgewählten Zeitraum an. Wählen Sie nun eine der folgenden Einstellungen aus:

    Zugelassen (blau): Hiermit wird der von Ihnen festgelegte Bereich als Zeitraum festgelegt, in dem Runbooks ausgeführt werden dürfen.

    Verweigert (weiß): Hiermit wird der von Ihnen festgelegte Bereich als Zeitraum festgelegt, in dem Runbooks nicht ausgeführt werden dürfen.

  7. Klicken Sie auf OK.

  8. Wählen Sie die Registerkarte Ausnahmen aus. Die Liste zeigt alle Tage an, die Ausnahmen für die auf der Registerkarte Details definierten Regeln sind.

  9. Wählen Sie Hinzufügen aus, um das Dialogfeld Datum zu öffnen.

  10. Geben Sie das Datum an, und wählen Sie Zulassen oder Deaktivieren aus, um die Ausführung des Runbooks an diesem Tag zuzulassen oder nicht zuzulassen, und wählen Sie dann OK aus. Der Eintrag wird in der Liste angezeigt.

  11. Um einen Ausnahmeeintrag zu ändern, wählen Sie ihn aus, und wählen Sie dann Ändern aus. Um den Eintrag Ausnahme zu entfernen, wählen Sie ihn aus, und wählen Sie dann Entfernen aus.

  12. Zum Ändern eines Zeitplans doppelklicken Sie auf den Zeitplan.

  13. Zum Entfernen eines Zeitplans klicken Sie mit der rechten Maustaste auf den Zeitplanund wählen dann Löschenaus.

  14. Wählen Sie Fertig stellen aus.

Bearbeiten von Daten mit Funktionen

Möglicherweise müssen Sie Zeichenfolgendaten aus Textdateien, zurückgegebenen Daten oder anderen Quellen bearbeiten und in eine verwendbare Form für Ihre Runbookaktivitäten konvertieren. Darüber hinaus können Sie einfache arithmetische Vorgänge ausführen, z. B. das Berechnen von Summen und Unterschieden sowie das Ausführen von Divisions- und Multiplikationsvorgängen. Sie können Text z. B. mithilfe einer Aktivität Textdateiverwaltung aus einer Textdatei extrahieren, führende und nachstehende Leerzeichen löschen und dann bestimmte Teile des Texts als zurückgegebene Datenelemente an andere Aktivitäten übergeben.

Sie bearbeiten Daten im Runbook, indem Sie eine Funktion einfügen. Datenbearbeitungsfunktionen müssen in eckigen Klammern stehen ('[' und ']'). Beispiel:

[Upper('this will be inserted in upper case')]

Wenn die Aktivität ausgeführt wird, wird der Text "this will be inserted in uppercase" aus dem Beispiel ersetzt durch "THIS WILL BE INSERTED IN UPPERCASE".

Bei Funktionen wird die Groß- und Kleinschreibung berücksichtigt. "Upper('Text')" wird z. B. verarbeitet, "upper('Text')" jedoch nicht.

In der folgenden Tabelle sind die für Runbooks unterstützten Funktionen aufgeführt.

Funktion und Definition Verwendung Parameter Beispiel
Upper - Konvertiert Text in Großbuchstaben. Upper('Text') Text - Der Text, der in Großbuchstaben konvertiert wird. Die Rückgabe von "Upper('this will be converted to uppercase')" lautet "THIS WILL BE CONVERTED TO UPPERCASE".
Lower - Konvertiert Text in Kleinbuchstaben. Lower('Text') Text - Der Text, der in Kleinbuchstaben konvertiert wird. Die Rückgabe von "Lower('This Will Be Converted To Lowercase')" lautet "this will be converted to lowercase".
Field - Gibt Text an einer bestimmten Position zurück. Field('Text', 'Trennzeichen', Feldnummer) Text - Der Text, der durchsucht wird.

Trennzeichen - Das Zeichen, das die Felder voneinander trennt.

Feldnummer - Die Position des zurückzugebenden Felds (beginnend bei 1).		 Die Rückgabe von "Field('John;Smith;9055552211', ';', 2)" lautet "Smith".
Sum - Gibt die Summe einer Reihe von Zahlen zurück. Sum(ersteZahl, zweiteZahl, dritteZahl, ...) Zahl - Die zu addierende Zahl. Sie können eine beliebige Anzahl von Zahlen mit einem Komma (,) als Trennzeichen eingeben. Die Rückgabe von "Sum(2,3,4,5)" lautet "14".
Diff - Gibt die Differenz zweier Zahlen zurück. Diff(Zahl1, Zahl2, <Genauigkeit>) Zahl1 - Die Zahl, von der subtrahiert wird.

Zahl2 - Die Zahl, die von Zahl1 subtrahiert wird.

Genauigkeit <Optional> : Die Anzahl der Dezimalstellen, auf die das Ergebnis gerundet wird.		 Die Rückgabe von "Diff(9, 7)" lautet "2".

Die Rückgabe von "Diff(9,3, 2,1, 2)" lautet "7,20".
Mult - Gibt das Produkt einer Reihe von Zahlen zurück. Mult(ersteZahl, zweiteZahl, dritteZahl, ...) Zahl - Die zu multiplizierende Zahl. Sie können eine beliebige Anzahl von Zahlen mit einem Komma (,) als Trennzeichen eingeben. Die Rückgabe von "Mult(2, 3, 4)" lautet "24".
Div - Gibt den Quotienten zweier Zahlen zurück. Div(Zahl1, Zahl2, <Genauigkeit>) Zahl1 - Die Zahl, die geteilt werden soll.

Zahl2 - Die Zahl, durch die Zahl1 geteilt wird.

Genauigkeit <Optional> : Die Anzahl der Dezimalstellen, auf die das Ergebnis gerundet wird.		 Die Rückgabe von "Div(8, 4)" lautet "2".

Die Rückgabe von "Div(9, 2, 2)" lautet "4,50".
Instr - Gibt die Position des ersten Vorkommens von Text in einem anderen Text zurück. Instr ('ZuDurchsuchenderText', 'ZuSuchenderText') ZuDurchsuchenderText - Der Text, der durchsucht wird.

ZuSuchenderText - Der Text, den Sie suchen.		 Die Rückgabe von "Instr('This is a string that is searched', 'string')" lautet "11".
Right - Gibt einen Textteil von der rechten Seite des vollständigen Textes zurück. Right('Text', Länge) Text – Der vollständige Text.

Länge - Die Anzahl von Zeichen von der rechten Seite, die zurückgegeben werden.		 Die Rückgabe von "Right('Take from the right', 9)" lautet "the right".
Left - Gibt einen Textteil von der linken Seite des vollständigen Textes zurück. Left('Text', Länge) Text – Der vollständige Text.

Länge - Die Anzahl von Zeichen von der linken Seite, die zurückgegeben werden.		 Die Rückgabe von "Left('Take from the left', 4)" lautet "Take".
Mid - Gibt einen Textteil aus der Mitte des vollständigen Textes zurück. Mid('Text', Start, Länge) Text – Der vollständige Text.

Start - Die Startposition im Text, an der Sie mit der Rückgabe von Zeichen beginnen möchten.

Länge - Die Anzahl von Zeichen, die ausgehend von der Startposition zurückgegeben werden sollen.		 Die Rückgabe von "Mid('Take from the middle', 5, 4)" lautet "from".
LTrim - Entfernt führende Leerzeichen aus einem Text. LTrim('Text') Text - Der Text, aus dem die führenden Leerzeichen gelöscht werden sollen. LTrim(' Entfernen Sie nur die führenden Leerzeichen. ') gibt 'Nur die führenden Leerzeichen entfernen zurück. '
RTrim - Entfernt nachstehende Leerzeichen aus einem Text. RTrim('Text') Text - Der Text, aus dem die nachstehenden Leerzeichen gelöscht werden sollen. RTrim(' Entfernen Sie nur die nachfolgenden Leerzeichen. ') gibt ' Entfernen Sie nur die nachfolgenden Leerzeichen.'
Trim - Entfernt führende und nachstehende Leerzeichen aus einem Text Trim('Text') Text - Der Text, aus dem die Leerzeichen entfernt werden sollen. Trim(' Entfernen Sie führende und nachfolgende Leerzeichen. ') gibt 'Führende und nachfolgende Leerzeichen entfernen' zurück.
Len - Gibt die Länge eines Textes zurück. Len('Text') Text - Der Text, der gemessen wird. Die Rückgabe von "Len('Measure this text')" lautet 17.

Hinweis

Bei Funktionen wird die Groß- und Kleinschreibung berücksichtigt. "Upper('Text')" wird z. B. verarbeitet, "upper('Text')" jedoch nicht.

Nächste Schritte

Eine geführte exemplarische Vorgehensweise zum Erstellen eines Beispielrunbooks finden Sie unter Erstellen und Testen eines Beispielrunbooks.