Udostępnij za pośrednictwem

Kontrolowanie działań elementu Runbook

  • Artykuł

Sekwencję operacji w elementach Runbook można ustawić, łącząc działania razem w programie Runbook Designer. Te linki są nazywane linkami inteligentnymi , ponieważ można je skonfigurować tak, aby kontrolować typ danych przekazywanych z jednego działania do drugiego. Możesz również kontrolować, kiedy element Runbook ukończy działania, ustawiając logikę dla tego, kiedy te operacje są uruchamiane z osadzonymi pętlami. Na koniec możesz użyć operacji tekstowych i liczbowych, aby manipulować danymi podczas ich stosowania między działaniami lub ustawić warunki dla kolejności operacji. W tym artykule opisano sposób kontrolowania sekwencjonowania i manipulowania danymi w elemecie Runbook.

Działania w elemekcie Runbook zostaną ukończone zgodnie z kolejnością ustawioną przez połączenie ich razem. Dane przepływające między działaniami można kontrolować przy użyciu kart Dołączanie i Wykluczanie właściwości łącza. Można na przykład uwzględnić tylko dane, które mają zostać przekazane do kolejnego działania spełniającego określone kryteria.

Ważne

Reguły karty Wykluczanie linku inteligentnego zastępują reguły na karcie Dołączanie linku inteligentnego.

Ważne

Reguły na każdej karcie są łączone przy użyciu warunku lub . Tylko jeden z warunków zdefiniowanych na karcie musi być spełniony, aby warunek był spełniony.

Typ danych publikowanych przez działanie określa typ kryteriów, które można ustawić na potrzeby kontrolowania sekwencji elementów Runbook. Niektóre działania publikują dane binarne, a inne publikują dane liczbowe lub tekstowe.

Jeśli opublikowane dane są danymi tekstowym, możesz użyć dowolnej z poniższych opcji, aby ustawić kryteria wykonywania, dołączania lub wykluczania.

Warunek opis
zawiera Określony tekst pojawia się gdzieś w wartości elementu Opublikowane dane.
nie zawiera Określony tekst nie jest wyświetlany gdzieś w wartości elementu Dane opublikowane.
zaczyna się od Wartość elementu Dane opublikowane rozpoczyna się od określonego tekstu.
kończy się na Wartość elementu Dane opublikowane kończy się określonym tekstem.
wzorzec dopasowania Wartość elementu Opublikowane dane jest zgodna z określonym wyrażeniem regularnym.
nie pasuje do wzorca Wartość elementu Opublikowane dane jest zgodna z określonym wyrażeniem regularnym.
equals Wartość elementu Danych publikowanych dokładnie odpowiada określonego tekstu.
nie równa się Wartość elementu Dane opublikowane nie jest zgodna z określonym tekstem.

Uwaga

Wartości tekstowe nie są uwzględniane wielkości liter.

Można również ustawić kryteria przy użyciu wyrażeń regularnych do wykonywania dopasowywania wzorców.

Jeśli opublikowane dane są liczbowe, możesz użyć dowolnej z poniższych opcji, aby ustawić kryteria wykonywania, dołączania lub wykluczania.

Warunek opis
equals Wartość elementu Danych publikowanych jest dokładnie równa określonej wartości.
nie równa się Wartość elementu Dane opublikowane nie jest równa określonej wartości.
jest mniejsze niż Wartość elementu Dane opublikowane jest mniejsza niż określona wartość.
jest większy niż Wartość elementu Dane opublikowane jest większa niż określona wartość.
jest mniejsze niż lub równe Wartość elementu Opublikowane dane jest mniejsza lub równa określonej wartości.
jest większe niż lub równe Wartość elementu Dane opublikowane jest większa lub równa określonej wartości.
jest między Wartość elementu Danych publikowanych znajduje się między dwiema określonymi wartościami.

Wybierz wymaganą kartę, aby wykonać kroki, aby dodać lub usunąć warunek linku inteligentnego:

Powtarzanie działań za pomocą osadzonych pętli

Za pomocą pętli można tworzyć automatyczne ponawianie prób i monitorować w dowolnej lokalizacji w elemecie Runbook.

Możesz utworzyć pętlę dla dowolnego działania, aby można było ponowić próby operacji w przypadku niepowodzenia lub przetestowania informacji wyjściowych działania pod kątem prawidłowych danych. Za pomocą tych mechanizmów można również tworzyć warunki oczekiwania do przepływów pracy.

Po skonfigurowaniu pętli dla działania będzie ona nadal działać z tymi samymi danymi wejściowymi do momentu osiągnięcia żądanych kryteriów pętli zakończenia. Tworzysz kryteria zakończenia pętli w podobny sposób jak konfiguracje linków inteligentnych. Możesz użyć dowolnego opublikowanego elementu danych z działania w ramach zakończenia lub nie zakończyć konfiguracji. Wspólne opublikowane dane są specjalnymi elementami danych, takimi jak Pętla: Liczba prób i Pętla: całkowity czas trwania, który umożliwia korzystanie z informacji z samej pętli w warunkach pętli.

Pętle są uruchamiane pojedynczo dla każdego przychodzącego elementu danych, które są przekazywane do działania. Rozważmy na przykład element Runbook, który używa działania bazy danych zapytań, po którym następuje dołączanie wiersza. Jeśli działanie Baza danych zapytań zwróciło trzy wiersze, działanie Dołącz wiersz zostanie uruchomione trzy razy. Jeśli masz pętlę w działaniu Dołączanie wiersza , będzie uruchamiać trzy oddzielne pętle. Gdy pierwszy element danych zostanie zapętlony przez działanie Dołącz wiersz, następny element przechodzi przez pętlę Dołącz wiersz i aż zakończy działanie, a następnie rozpocznie się trzeci. Po przetworzeniu wszystkich trzech elementów następne działanie w elemecie Runbook zostanie uruchomione.

Konfigurowanie pętli

  1. Kliknij prawym przyciskiem myszy działanie w elemecie Runbook, aby wybrać pozycję Pętla. Zostanie otwarte okno dialogowe Właściwości pętli.

  2. Na karcie Ogólne wybierz pozycję Włącz.

  3. W polu Opóźnienie między próbami wprowadź liczbę sekund wstrzymania między poszczególnymi próbami uruchomienia działania.

Kończ i nie zamykaj warunków

Reguły na karcie Wyjście określają warunki, które określają, czy pętla kończy działanie. Reguły na karcie Nie zamykaj określają warunki, które powodują kontynuowanie pętli.

Ważne

Reguły na karcie Nie zamykaj zastępują reguły na karcie Zakończ .

Reguły na każdej karcie są łączone przy użyciu warunku Or . Tylko jeden z warunków na karcie musi mieć wartość true dla całej karty, aby mieć wartość true.

Wybierz kartę wymaganą dla procedury, aby dodać lub usunąć warunek zakończenia :

Wykonaj następujące kroki, aby dodać warunek zakończenia:

  1. W oknie dialogowym Właściwości pętli wybierz kartę Zakończ lub Nie zamykaj, a następnie wybierz warunek wymieniony w polu wybierz pozycję Dodaj, aby dodać warunek.

    Ważne

    Aby zmienić wartości tworzące regułę, należy wybrać każdą podkreślonej części warunku łącza.

  2. Wybierz wymienione działanie w warunku, aby otworzyć okno dialogowe Opublikowane dane .

  3. Zaznacz pole Pokaż typowe zwrócone dane, aby wyświetlić właściwości wspólne dla wszystkich działań.

  4. Wybierz właściwość z opublikowanych danych, a następnie wybierz przycisk OK. Wyrażenie kryteriów jest zmieniane w zależności od typu danych zwracanych przez właściwość.

  5. Aby zmienić różne części wyrażenia, zaznacz podkreślony tekst i wybierz lub wprowadź odpowiednią wartość.

  6. Wybierz Zakończ.

Ustawianie harmonogramu elementu Runbook

Harmonogram można ustawić tak, aby kontrolować, kiedy element Runbook jest uruchamiany. Istnieją na przykład czasy, w których uruchamianie niektórych elementów Runbook jest nieodpowiednie, na przykład tworzenie kopii zapasowej elementu Runbook na serwerze głównym w regularnych godzinach pracy. Można utworzyć harmonogram uruchamiany zgodnie ze złożonym interwałem, takim jak pierwsze i trzecie poniedziałki i czwartki każdego miesiąca, z wyjątkiem sytuacji, gdy te dni spadną na wakacje.

Harmonogramy używają zegara systemowego serwera Runbook z uruchomionym elementem Runbook. Dzięki temu harmonogramy mogą działać w środowiskach maszyn wirtualnych i kontynuować działanie nawet wtedy, gdy zegar systemowy jest dostosowywany z powodu przejścia do lub z czasu letniego.

Elementy Runbook, które rozpoczynają się przed zabronionym czasem działania do czasu zakończenia, nawet jeśli nadal są przetwarzane, gdy nadejdzie zabroniony czas. Nie zostaną one przerwane po rozpoczęciu przetwarzania.

Ważne

Uprawnienia dostępu do harmonogramów można modyfikować, ale serwer runbook nie wymusza tych uprawnień.

Uwaga

Jeśli planujesz uruchomienie elementu Runbook w ciągu godziny, która jest pomijana, gdy zegar systemowy jest dostosowywany do przodu o jedną godzinę, czas rozpoczęcia jest pomijany, a element Runbook rozpoczyna się w następnym zaplanowanym czasie. Jeśli planujesz uruchomienie elementu Runbook w ciągu godziny, która występuje dwa razy, ponieważ zegar systemowy jest dostosowywany do tyłu o jedną godzinę, element Runbook jest uruchamiany dwa razy.

Uwaga

Program Orchestrator nie obsługuje przenoszenia wielu harmonogramów z wielokrotnym wyborem. Aby przenieść więcej niż jeden harmonogram do innego folderu, należy przenieść każdy harmonogram indywidualnie.

Wybierz kartę wymaganą, aby utworzyć harmonogram, przypisać harmonogram do elementu Runbook lub usunąć harmonogram z elementu Runbook:

Wykonaj następujące kroki, aby utworzyć harmonogram:

  1. W okienku Połączenia kliknij prawym przyciskiem myszy folder Harmonogramy lub podfolder folderu Harmonogramy, wskaż polecenie Nowy, a następnie wybierz pozycję Harmonogram, aby otworzyć okno dialogowe Nowy harmonogram.

  2. Na karcie Ogólne w polu Nazwa wprowadź nazwę harmonogramu.

  3. W polu Opis wprowadź opis opisujący lub wyjaśniający przeznaczenie harmonogramu.

  4. Wybierz kartę Szczegóły . Wybierz dni, w których ten harmonogram umożliwia uruchamianie elementów Runbook:

    Dni tygodnia: wybierz tę opcję i wybierz dni tygodnia, w których ten harmonogram umożliwia uruchamianie elementów Runbook.

    Wystąpienie: wybierz tygodnie miesiąca, kiedy harmonogram umożliwia uruchamianie elementów Runbook.

    Dni miesiąca: wybierz tę opcję i wybierz dni miesiąca, w których ten harmonogram umożliwia uruchamianie elementów Runbook. Określ dni miesiąca, wprowadzając liczbę dni dnia. Łączniki umożliwiają opisywanie zakresów i przecinków w celu oddzielenia wpisów. Na przykład wpisanie 1,3 obejmuje pierwszy i trzeci dzień miesiąca. Wprowadzenie 1-21 obejmuje pierwszy do dwudziestego pierwszego dnia miesiąca. Oba te elementy można połączyć, aby utworzyć złożone opisy dni miesiąca. Wprowadź wszystkie , aby określić wszystkie dni miesiąca. Wprowadź ostatni, aby określić ostatni dzień miesiąca.

    Nie można używać wszystkich i ostatnich w ramach zakresu dni. Ponadto, jeśli wprowadzono zakres od 5 do 31, ten zakres działa poprawnie przez wszystkie miesiące, w tym te z 28, 29, 30 i 31 dni.

  5. Wybierz pozycję Godziny , aby otworzyć okno dialogowe Planowanie godzin .

  6. Wybierz i przeciągnij, aby wybrać grupę godzin w tygodniu. Tekst w dolnej części okna dialogowego zawiera wybrany okres czasu. Następnie wybierz jedną z następujących pozycji:

    Zezwalaj (niebieski): przypisuje okres wybrany jako czas, w którym można uruchamiać elementy Runbook.

    Odmowa (biały): przypisz wybrany okres jako czas, w którym elementy Runbook nie mogą być uruchamiane.

  7. Wybierz przycisk OK.

  8. Wybierz kartę Wyjątki . Lista zawiera wszystkie dni, które są wyjątkami od reguł zdefiniowanych na karcie Szczegóły .

  9. Wybierz pozycję Dodaj , aby otworzyć okno dialogowe Data .

  10. Określ datę i wybierz pozycję Zezwalaj lub Nie zezwalaj na działanie elementu Runbook lub nie zezwalaj na jego uruchamianie w tym dniu, a następnie wybierz przycisk OK. Wpis zostanie wyświetlony na liście.

  11. Aby zmodyfikować wpis Wyjątek, zaznacz go, a następnie wybierz pozycję Modyfikuj. Aby usunąć wpis Wyjątek, zaznacz go, a następnie wybierz pozycję Usuń.

  12. Aby zmodyfikować harmonogram, kliknij dwukrotnie harmonogram.

  13. Aby usunąć harmonogram, kliknij prawym przyciskiem myszy harmonogram, a następnie wybierz polecenie Usuń.

  14. Wybierz Zakończ.

Manipulowanie danymi za pomocą funkcji

Może być konieczne manipulowanie danymi ciągu z plików tekstowych, zwracanych danych lub innych źródeł i konwertowanie ich na formularz do użycia dla działań elementu Runbook. Ponadto można wykonywać proste operacje arytmetyczne, takie jak obliczanie sum i różnic oraz wykonywanie operacji dzielenia i mnożenia. Można na przykład wyodrębnić tekst z pliku tekstowego przy użyciu działania Zarządzanie plikami tekstowymi, przycinać spacje wiodące i końcowe z tekstu, a następnie pobierać określone części tekstu, które można przekazać do innych działań jako zwracane elementy danych.

Dane w elemecie Runbook można manipulować, wstawiając funkcję. Funkcje manipulowania danymi muszą być ujęte w nawiasy kwadratowe ("[" i "]"). Na przykład:

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

Po uruchomieniu działania tekst "zostanie wstawiony wielkimi literami" w przykładzie zostanie zastąpiony ciągiem "THIS WILL BE INSERTED IN UPPERCASE".

W funkcjach jest rozróżniana wielkość liter. Na przykład funkcja Upper('Text') zostanie przetworzona, ale upper('Text') nie będzie.

W poniższej tabeli wymieniono funkcje obsługiwane dla elementów Runbook.

Funkcja i definicja Użycie Parametry Przykład
Upper — konwertuje tekst na wielkie litery. Upper('Text') Text — tekst, który jest konwertowany na wielkie litery. Upper('this will be converted to to uppercase') zwraca wartość "THIS WILL BE CONVERTED TO TO UPPERCASE"
Dolna — konwertuje tekst na małe litery. Lower('Text') Text — tekst, który jest konwertowany na małe litery. Lower('This Will Be Converted To Lowercase') zwraca wartość "zostanie przekonwertowana na małe litery"
Pole — zwraca tekst w określonej pozycji. Field('Text', 'Ogranicznik', Numer pola) Text — wyszukiwany tekst.

Ogranicznik — znak oddzielający każde pole.

Numer pola — pozycja zwracanego pola (począwszy od 1).		 Field('John; Kowal; 9055552211", ";", 2) zwraca wartość "Smith"
Sum — zwraca sumę zestawu liczb. Sum(firstNumber, secondNumber, thirdNumber, ...) Number — liczba, która jest dodawana. Można umieścić dowolny zestaw liczb, każdy oddzielony przecinkiem (,). Suma(2,3,4,5) zwraca wartość "14"
Różnica — zwraca różnicę dwóch liczb. Różnice (liczba1, liczba2, <precyzja>) Number1 — liczba, odejmowana od.

Number2 — liczba, która zostanie odejmowana od numeru 1.

Precyzja opcjonalna <> — liczba miejsc dziesiętnych, do których wynik zostanie zaokrąglony.		 Różnica (9, 7) zwraca wartość "2"

Różnice (9.3, 2.1, 2) zwracają wartość "7,20"
Mult — zwraca iloczyn zestawu liczb. Mult(firstNumber, secondNumber, thirdNumber, ...) Number — liczba, która jest mnożona. Można umieścić dowolny zestaw liczb, każdy oddzielony przecinkiem (,). Mult(2, 3, 4) zwraca wartość "24"
Div — zwraca iloraz dwóch liczb. Div(Liczba1, Liczba2, <Precyzja>) Number1 — liczba, która zostanie podzielona.

Number2 — liczba, która podzieli numer1.

Precyzja opcjonalna <> — liczba miejsc dziesiętnych, do których wynik zostanie zaokrąglony.		 Funkcja Div(8, 4) zwraca wartość "2"

Funkcja Div(9, 2, 2) zwraca wartość "4,50"
Instr — zwraca położenie pierwszego wystąpienia tekstu w innym tekście. Instr ('SearchText', 'TextToFind') SearchText — wyszukiwany tekst.

TextToFind — wyszukiwany tekst.		 Instr('This is a string that is searched', 'string') zwraca 11
Right — zwraca podzbiór tekstu z prawej strony pełnego tekstu. Right('Text', Length) Tekst — pełny tekst.

Długość — liczba znaków z prawej strony, która zostanie zwrócona.		 Right('Take from the right', 9) zwraca wartość "the right"
Left — zwraca podzbiór tekstu z lewej strony pełnego tekstu. Left('Text', Length) Tekst — pełny tekst.

Długość — liczba znaków z lewej strony, które zostaną zwrócone.		 Left('Take from the left', 4) zwraca 'Take'
Mid — zwraca podzbiór tekstu z środka pełnego tekstu. Mid('Text', Start, Length) Tekst — pełny tekst.

Start — pozycja początkowa w tekście, w którym chcesz rozpocząć zwracanie znaków.

Length — liczba znaków rozpoczynających się od pozycji Początkowej, która zostanie zwrócona.		 Mid('Take from the middle', 5, 4) zwraca 'from'
LTrim — przycina wiodące spacje z tekstu. LTrim('Text') Tekst — tekst, który jest przycinany spacjami wiodącymi. LTrim(' Usuń tylko spacje wiodące. ") zwraca wartość "Usuń tylko spacje wiodące. '
RTrim — przycina końcowe spacje z tekstu. RTrim('Text') Tekst — tekst, który jest przycinany spacji końcowych. RTrim(' Usuń tylko spacje końcowe. ") zwraca wartość "Usuń tylko spacje końcowe".
Trim — przycina spacje wiodące i końcowe z tekstu. Trim('Text') Tekst — tekst, który jest przycinany. Trim(' Usuń spacje wiodące i końcowe. ") zwraca "Usuń spacje wiodące i końcowe".
Len — zwraca długość tekstu. Len('Text') Text — mierzony tekst. Funkcja Len('Measure this text') zwraca wartość 17

Uwaga

W funkcjach jest rozróżniana wielkość liter. Na przykład funkcja Upper('Text') zostanie przetworzona, ale upper('Text') nie będzie.

Następne kroki

Aby zapoznać się z przewodnikiem po utworzeniu przykładowego elementu Runbook, zobacz Tworzenie i testowanie przykładowego elementu Runbook.