Teilen über

Runbook-Aktivitäten kontrollieren

  • Artikel

Sie legen die Abfolge von Vorgängen 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 für die Ausführung dieser Vorgänge mit eingebetteten Schleifen festlegen. Schließlich können Sie Text- und numerische Vorgänge verwenden, um Daten während der Übertragung zwischen Aktivitäten zu bearbeiten oder um Bedingungen für die Reihenfolge der Vorgänge festzulegen. In diesem Artikel wird beschrieben, wie Sie die Abfolge steuern und Daten in Ihrem Runbook bearbeiten.

Die Aktivitäten in Ihrem Runbook werden entsprechend der Reihenfolge abgeschlossen, die Sie festgelegt haben, 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 bestimmten Kriterien entspricht.

Wichtig

Die Regeln der Registerkarte Ausschließen des intelligenten Links ersetzen die Regeln auf der Registerkarte Einschließen des intelligenten Links.

Wichtig

Die Regeln auf jeder Registerkarte werden mithilfe einer ODER-Bedingung verknüpft. Nur eine der auf einer Registerkarte definierten Bedingungen 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 für die Steuerung der Runbooksequenz festlegen können. Einige Aktivitäten veröffentlichen binäre Daten und andere veröffentlichen numerische Daten 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 die Ausführung, Einbeziehung oder den Ausschluss festzulegen.

Condition Beschreibung
contains Der angegebene Text wird irgendwo im Wert des Elements „Veröffentlichte Daten“ angezeigt.
enthält nicht Der angegebene Text wird nicht irgendwo im Wert des Elements „Veröffentlichte Daten“ angezeigt.
Beginnt mit Der Wert des Elements „Veröffentlichte Daten“ beginnt mit dem angegebenen Text.
Endet mit Der Wert des Elements „Veröffentlichte Daten“ endet mit dem angegebenen Text.
Entspricht Muster Der Wert des Elements „Veröffentlichte Daten“ entspricht dem spezifischen regulären Ausdruck.
Entspricht keinem Muster Der Wert des Elements „Veröffentlichte Daten“ entspricht dem spezifischen regulären Ausdruck.
equals Der Wert des Elements „Veröffentlichte Daten“ entspricht exakt dem angegebenen Text.
ist ungleich Der Wert des Elements „Veröffentlichte Daten“ entspricht nicht dem angegebenen Text.

Hinweis

Die Groß-/Kleinschreibung wird bei Textwerten nicht beachtet.

Sie können Kriterien auch mit regulären Ausdrücken festlegen, um Musterabgleich 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.

Condition Beschreibung
equals Der Wert des Elements „Veröffentlichte Daten“ entspricht exakt dem angegebenen Wert.
ist ungleich Der Wert des Elements „Veröffentlichte Daten“ entspricht nicht dem angegebenen Wert.
ist kleiner als Der Wert des Elements „Veröffentlichte Daten“ ist kleiner als der angegebene Wert.
ist größer als Der Wert des Elements Veröffentlichte Daten ist größer als der angegebene Wert.
kleiner als oder gleich Der Wert des Elements Veröffentlichte Daten ist kleiner als oder gleich dem angegebenen Wert.
ist größer oder gleich Der Wert des Elements Veröffentlichte Daten ist größer oder gleich dem angegebenen Wert.
Liegt zwischen Der Wert des Elements Veröffentlichte Daten liegt zwischen zwei angegebenen Werten.

Wählen Sie die erforderliche Registerkarte aus, um Schritte zum Hinzufügen oder Entfernen einer SmartLink-Bedingung auszuwählen:

Wiederholen von Aktivitäten mit eingebetteten Schleifen

Mithilfe von Schleifen können Sie automatische Wiederholungen erstellen und an einem beliebigen Ort in einem Runbook überwachen.

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. Sie können diese Mechanismen auch verwenden, um Wartezeiten in Ihre Workflows zu integrieren.

Wenn Sie eine Schleife für eine Aktivität konfigurieren, wird sie weiterhin mit denselben 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 ein beliebiges veröffentlichtes Datenelement aus der Aktivität als Teil des Beendens verwenden oder die Konfiguration nicht beenden. Zu den gemeinsamen veröffentlichten Daten gehören auch spezielle Datenelemente wie Schleife: Anzahl der Versuche und Schleife: Gesamtdauer, die es ermöglichen, Informationen aus der Schleife selbst in den Schleifenbedingungen zu verwenden.

Schleifen werden für jeden eingehenden Datenabschnitt, der an die Aktivität übergeben wird, einmal ausgeführt. Nehmen wir zum Beispiel ein Runbook, das eine Datenbank abfragen-Aktivität gefolgt von Zeile anhängen verwendet. Wenn die Aktivität Datenbank abfragen drei Zeilen zurückgibt, würde die Aktivität Zeile anhängen dreimal ausgeführt. Wenn Sie eine Schleife für die Aktivität Zeile anhängen haben, würden drei separate Schleifen laufen. Nachdem das erste Datenelement die Aktivität Zeile anhängen durchlaufen hat, durchläuft das nächste Element die Aktivität Zeile anhängen und durchläuft eine Schleife, 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 und wählen Sie Schleifen. Das Dialogfeld Schleifeigenschaften wird geöffnet.

  2. Wählen Sie auf der Registerkarte Allgemein Aktivieren.

  3. Geben Sie in das Feld Verzögerung zwischen den Versuchen die Anzahl der Sekunden ein, die zwischen jedem Versuch, die Aktivität auszuführen, vergehen sollen.

Beendigungs- und Nicht-Beendigungsbedingungen

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 eine Fortsetzung der Schleife bewirken.

Wichtig

Die Regeln auf der Registerkarte Nicht beenden haben Vorrang vor den Regeln auf der Registerkarte Beenden.

Die Regeln innerhalb jeder Registerkarte werden durch eine Oder-Bedingung verbunden. Nur eine der Bedingungen auf einer Registerkarte muss wahr sein, damit die gesamte Registerkarte wahr ist.

Wählen Sie die gewünschte Registerkarte für die Prozedur zum Hinzufügen oder Entfernen einer Beenden-Bedingung aus:

Gehen Sie folgendermaßen vor, um eine Beendigungsbedingung hinzuzufügen:

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

    Wichtig

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

  2. Wählen Sie die aufgelistete Aktivität in der Bedingung aus, um den Dialog Veröffentlichte Daten zu öffnen.

  3. Aktivieren Sie das Kontrollkästchen Gemeinsame 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. Der Kriterienausdruck wird abhängig vom Datentyp geändert, den die Eigenschaft zurückgibt.

  5. Wenn Sie die verschiedenen Teile des Ausdrucks ändern möchten, markieren Sie den unterstrichenen Text, und wählen Sie einen geeigneten Wert aus, oder geben Sie ihn ein.

  6. Wählen Sie Fertig stellenaus.

Einen Zeitplan für ein Runbook festlegen

Sie können einen Zeitplan für die Steuerung festlegen, wenn ein Runbook ausgeführt wird. Es gibt zum Beispiel Zeiten, in denen es unangebracht ist, einige Runbooks auszuführen, wie z. B. die Sicherung eines Runbooks auf einem Hauptserver während der regulären Geschäftszeiten. Sie können einen Zeitplan erstellen, der nach einem komplexen Intervall abläuft, z. B. am ersten und dritten Montag und Donnerstag eines jeden Monats, außer wenn diese Tage auf einen Feiertag fallen.

Zeitpläne verwenden die Systemuhr des Runbook-Servers, auf dem das Runbook ausgeführt wird. Dadurch können Zeitpläne in virtuellen Computerumgebungen funktionieren und auch dann weiter ausgeführt werden, wenn die Systemuhr aufgrund des Wechsels zu oder von Sommerzeit angepasst wird.

Runbooks, die vor einer verbotenen Laufzeit beginnen, bis sie abgeschlossen sind, auch wenn sie noch verarbeitet werden, wenn die verbotene Zeit eintrifft. Sie werden nach Beginn der Verarbeitung nicht unterbrochen.

Wichtig

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

Hinweis

Wenn Sie ein Runbook für den Start in einer Stunde einplanen, die übersprungen wird, wenn die Systemuhr um eine Stunde vorgestellt wird, wird diese Startzeit übersprungen, und das Runbook startet zur nächsten geplanten Zeit. Wenn Sie ein Runbook für den Start zu einer Stunde einplanen, die zweimal vorkommt, weil die Systemuhr um eine Stunde zurückgestellt wird, startet das Runbook zweimal.

Hinweis

Orchestrator unterstützt das Verschieben mehrerer Zeitpläne mit mehrfacher Auswahl nicht. Um mehrere Zeitpläne in einen anderen Ordner zu verschieben, 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:

Gehen Sie folgendermaßen vor, um einen Zeitplan zu erstellen:

  1. Klicken Sie im Bereich Verbindungen 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, um den Dialog Neuer Zeitplan zu öffnen.

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

  3. Geben Sie in das Feld Beschreibung eine Beschreibung ein, die den Zweck des Zeitplans beschreibt oder erklärt.

  4. Wählen Sie die Registerkarte Details aus. Wählen Sie die Tage aus, an denen dieser Zeitplan die Ausführung von Runbooks zulässt:

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

    Vorkommen: Wählen Sie die Wochen des Monats aus, wenn der Zeitplan die Ausführung von Runbooks zulässt.

    Tage des Monats: Wählen Sie diese Option und wählen Sie die Tage des Monats, an denen dieser Zeitplan die Ausführung von Runbooks erlaubt. Geben Sie die Tage des Monats an, indem Sie die Anzahl des Tages eingeben. Sie können Bindestriche verwenden, um Bereiche und Kommas zu beschreiben, um Einträge zu trennen. Wenn Sie zum Beispiel 1,3 eingeben, werden der erste und der dritte Tag des Monats berücksichtigt. Die Eingabe von 1-21 umfasst den ersten bis zum einundzwanzigsten Tag des Monats. Sie können beide kombinieren, um komplexe Beschreibungen der Tage des Monats zu erstellen. Geben Sie alle ein, um alle Tage des Monats anzugeben. Geben Sie last ein, um den letzten Tag des Monats anzugeben.

    Sie können alle und letzte nicht als Teil einer Reihe von Tagen verwenden. Wenn Sie einen Bereich von 5 bis 31 eingegeben haben, funktioniert dieser Bereich außerdem 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 unten im Dialogfeld zeigt den ausgewählten Zeitraum an. Wählen Sie dann eine der folgenden Optionen aus:

    Erlaubnis (blau): weist den von Ihnen gewählten Zeitraum als Zeit zu, in der Runbooks ausgeführt werden dürfen.

    Verweigert (weiß): Weisen Sie den von Ihnen gewählten Zeitraum als Zeit zu, in der Runbooks nicht ausgeführt werden dürfen.

  7. Wählen Sie OK aus.

  8. Wählen Sie die Registerkarte Ausnahmen. In der Liste werden alle Tage angezeigt, die Ausnahmen von den auf der Registerkarte Details definierten Regeln sind.

  9. Wählen Sie Hinzufügen, um den Dialog Datum zu öffnen.

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

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

  12. Um einen Zeitplan zu ändern, doppelklicken Sie auf den Zeitplan.

  13. Um einen Zeitplan zu entfernen, klicken Sie mit der rechten Maustaste auf den Zeitplan, und wählen Sie dann Löschen.

  14. Wählen Sie Fertig stellenaus.

Bearbeiten von Daten mit Funktionen

Möglicherweise müssen Sie Zeichenfolgendaten aus Textdateien, zurückgegebenen Daten oder anderen Quellen manipulieren und in eine für Ihre Runbook-Aktivitäten verwendbare Form umwandeln. Darüber hinaus können Sie einfache arithmetische Operationen durchführen, z. B. Summen und Differenzen berechnen sowie Divisions- und Multiplikationsoperationen durchführen. Sie können zum Beispiel mit einer Textdateiverwaltung Aktivität Text aus einer Textdatei extrahieren, führende und nachfolgende Leerzeichen aus dem Text entfernen und dann bestimmte Teile des Textes abrufen, die Sie als zurückgegebene Datenelemente an andere Aktivitäten weitergeben können.

Sie bearbeiten Daten im Runbook, indem Sie eine Funktion einfügen. Datenmanipulationsfunktionen müssen in eckige Klammern ('[' und ']') gesetzt werden. Zum Beispiel:

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

Wenn die Aktivität ausgeführt wird, wird der Text 'dies wird in Großbuchstaben eingefügt' im Beispiel durch 'DIES WIRD IN GROSSBUCHSTABEN EINGESETZT' ersetzt.

Bei den Funktionen wird zwischen Groß- und Kleinschreibung unterschieden. So wird zum Beispiel upper('Text') verarbeitet, upper('Text') jedoch nicht.

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

Funktion und Definition Verbrauch Parameter Beispiel
Groß - konvertiert Text in Großbuchstaben. Upper('Text') Text - der Text, der in Großbuchstaben konvertiert wird. Upper('dies wird in Großbuchstaben umgewandelt') gibt 'THIS WILL BE CONVERTED TO UPPERCASE' zurück
Klein - konvertiert Text in Kleinbuchstaben. Lower('Text') Text - der Text, der in Kleinbuchstaben konvertiert wird. Lower('Dies wird in Kleinbuchstaben umgewandelt') gibt 'dies wird in Kleinbuchstaben umgewandelt' zurück
Feld - Gibt Text an einer bestimmten Position zurück. Field('Text', 'Delimiter', Field Number) Text - der Text, der durchsucht wird.

Trennzeichen - das Zeichen, das jedes Feld trennt.

Feldnummer - die Position des Felds, das zurückgegeben wird (beginnend bei 1).		 Field('John;Smith;9055552211', ';', 2) returns 'Smith'
Summe - gibt die Summe einer Menge von Zahlen zurück. Sum(firstNumber, secondNumber, thirdNumber, ...) Nummer - die Nummer, die hinzugefügt wird. Sie können eine beliebige Gruppe von Zahlen platzieren, die jeweils durch ein Komma (,) getrennt sind. Sum(2,3,4,5) returns '14'
Diff - gibt die Differenz von zwei Zahlen zurück. Diff(Number1, Number2, <Precision>) 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.		 Diff(9, 7) returns '2'

Diff(9.3, 2.1, 2) returns '7.20'
Mult - gibt das Produkt einer Reihe von Zahlen zurück. Mult(firstNumber, secondNumber, thirdNumber, ...) Zahl - die Zahl, die multipliziert wird. Sie können eine beliebige Gruppe von Zahlen platzieren, die jeweils durch ein Komma (,) getrennt sind. Mult(2, 3, 4) returns '24'
Div - gibt den Quotient von zwei Zahlen zurück. Div(Number1, Number2, <Precision>) Zahl1 - die Zahl, die geteilt wird.

Zahl2 - die Zahl, durch die Zahl1 geteilt wird.

Genauigkeit <Optional> – die Anzahl der Dezimalstellen, auf die das Ergebnis gerundet wird.		 Div(8, 4) returns '2'

Div(9, 2, 2) returns '4.50'
Instr - gibt die Position des ersten Vorkommens von Text innerhalb eines anderen Textes zurück. Instr ('SearchText', 'TextToFind') SearchText - der Text, nach dem gesucht wird.

TextToFind - der Text, nach dem Sie suchen.		 Instr('This is a string that is searched', 'string') returns 11
Rechts - gibt eine Teilmenge des Texts von der rechten Seite des Volltexts zurück. Right('Text', Length) Text - der Volltext.

Länge - die Anzahl der Zeichen von der rechten Seite, die zurückgegeben wird.		 Right('Take from the right', 9) returns 'the right'
Links - gibt eine Teilmenge des Texts von der linken Seite des Volltexts zurück. Left('Text', Length) Text - der Volltext.

Länge - die Anzahl der Zeichen von der linken Seite, die zurückgegeben wird.		 Left('Take from the left', 4) returns 'Take'
Mid - gibt eine Teilmenge des Texts aus der Mitte des Volltexts zurück. Teil('Text', Anfang, Länge) Text - der Volltext.

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

Länge - die Anzahl der Zeichen, die von der Startposition beginnen, die zurückgegeben wird.		 Mid('Take from the middle', 5, 4) returns 'from'
LTrim - schneidet führende Leerzeichen von Text ab. LTrim('Text') Text - der Text, der auf führende Leerzeichen zugeschnitten wird. LTrim(' Remove the leading spaces only. ') returns 'Remove the leading spaces only. '
RTrim - schneidet die nachfolgenden Leerzeichen von Text ab. RTrim('Text') Text - der Text, der auf nachfolgende Leerzeichen gekürzt wird. RTrim(' Entfernen Sie nur die nachfolgenden Leerzeichen. ') gibt ' Entfernen Sie nur die nachfolgenden Leerzeichen.'
Trim - schneidet führende und nachfolgende Leerzeichen von Text ab. Trim('Text') Text - der Text, der gekürzt wird. Trim(' Remove leading and trailing spaces. ') returns 'Remove leading and trailing spaces.'
Len - gibt die Textlänge zurück. Len('Text') Text - der Text, der gemessen wird. Len('Measure this text') returns 17

Hinweis

Bei den Funktionen wird zwischen Groß- und Kleinschreibung unterschieden. So wird zum Beispiel upper('Text') verarbeitet, upper('Text') jedoch nicht.

Nächste Schritte

Eine Anleitung zum Erstellen eines Beispiel-Runbooks finden Sie unter Erstellen und Testen eines Beispiel-Runbooks.