Delen via

Runbook-activiteiten beheren

  • Artikel

Belangrijk

Deze versie van Orchestrator heeft het einde van de ondersteuning bereikt. U wordt aangeraden een upgrade uit te voeren naar Orchestrator 2022.

U stelt de volgorde van bewerkingen in runbooks in door activiteiten aan elkaar te koppelen in het runbook Designer. Deze koppelingen worden slimme koppelingen genoemd, omdat u ze kunt configureren om het type gegevens te beheren dat van de ene activiteit naar de andere wordt doorgegeven. U kunt ook bepalen wanneer het runbook activiteiten voltooit door de logica in te stellen voor wanneer deze bewerkingen worden uitgevoerd met ingesloten lussen. Ten slotte kunt u tekst- en numerieke bewerkingen gebruiken om gegevens te bewerken wanneer deze tussen activiteiten worden doorgegeven of om voorwaarden in te stellen voor de volgorde van bewerkingen. In dit artikel wordt beschreven hoe u de volgorde bepaalt en gegevens in uw runbook bewerkt.

De activiteiten in uw runbook worden voltooid volgens de volgorde die u hebt ingesteld door ze aan elkaar te koppelen. U kunt de gegevens beheren die tussen de activiteiten stromen met behulp van de tabbladen Opnemen en Uitsluiten van de koppelingseigenschappen. U kunt bijvoorbeeld alleen gegevens opnemen die moeten worden doorgegeven aan de volgende activiteit die aan een bepaald criterium voldoet.

Belangrijk

De regels van het tabblad Uitsluiten van slimme koppeling vervangen de regels op het tabblad Opnemen van slimme koppeling.

Belangrijk

De regels op elk tabblad worden samengevoegd met behulp van een of-voorwaarde . Slechts een van de op een tabblad gedefinieerde voorwaarden hoeft waar te zijn om de volledige groep regels waar te laten zijn.

Het type gegevens dat door een activiteit wordt gepubliceerd, bepaalt het type criteria dat u kunt instellen voor het beheren van de runbookvolgorde. Sommige activiteiten publiceren binaire gegevens en andere publiceren numerieke of tekstgegevens.

Als de gepubliceerde gegevens tekstgegevens zijn, kunt u een van de volgende opties gebruiken om de criteria voor uitvoering, opname of uitsluiting in te stellen.

Voorwaarde Description
bevat De opgegeven tekst staat ergens in de waarde van het gepubliceerde-gegevensitem.
bevat geen De opgegeven tekst staat nergens in de waarde van het gepubliceerde-gegevensitem.
begint met De waarde van het gepubliceerde-gegevensitem begint met de opgegeven tekst.
eindigt met De waarde van het gepubliceerde-gegevensitem eindigt met de opgegeven tekst.
komt overeen met patroon De waarde van het gepubliceerde-gegevensitem komt overeen met de opgegeven reguliere expressie.
komt niet overeen met patroon De waarde van het gepubliceerde-gegevensitem komt overeen met de opgegeven reguliere expressie.
is gelijk aan De waarde van het gepubliceerde-gegevensitem komt exact overeen met de opgegeven tekst.
is niet gelijk aan De waarde van het gepubliceerde-gegevensitem komt niet exact overeen met de opgegeven tekst.

Notitie

Tekstwaarden zijn niet hoofdlettergevoelig.

U kunt ook criteria instellen met behulp van reguliere expressies om patroonkoppeling uit te voeren.

Als de gepubliceerde gegevens numeriek zijn, kunt u een van de volgende opties gebruiken om de criteria voor uitvoering, opname of uitsluiting in te stellen.

Voorwaarde Description
is gelijk aan De waarde van het gepubliceerde-gegevensitem is exact gelijk aan de opgegeven waarde.
is niet gelijk aan De waarde van het gepubliceerde-gegevensitem is niet gelijk aan de opgegeven waarde.
is kleiner dan De waarde van het gepubliceerde-gegevensitem is kleiner dan de opgegeven waarde.
is groter dan De waarde van het gepubliceerde-gegevensitem is groter dan de opgegeven waarde.
is kleiner dan of gelijk aan De waarde van het gepubliceerde-gegevensitem is kleiner dan of gelijk aan de opgegeven waarde.
groter is dan of gelijk is aan De waarde van het gepubliceerde-gegevensitem is groter dan of gelijk aan de opgegeven waarde.
ligt tussen De waarde van het gepubliceerde-gegevensitem ligt tussen twee opgegeven waarden.

Selecteer het vereiste tabblad voor de stappen om een voorwaarde voor een slimme koppeling toe te voegen of te verwijderen:

Activiteiten herhalen met ingesloten lussen

Met behulp van lussen kunt u automatische nieuwe pogingen bouwen en bewaken op elke locatie in een runbook.

U kunt een lus maken voor elke activiteit, zodat u bewerkingen opnieuw kunt proberen als deze mislukken of de uitvoergegevens van de activiteit kunt testen op geldige gegevens. U kunt deze mechanismen ook gebruiken om wachtvoorwaarden in uw werkstromen in te bouwen.

Wanneer u een lus voor een activiteit configureert, blijft deze worden uitgevoerd met dezelfde invoergegevens totdat het gewenste criterium voor het afsluiten van een lus is bereikt. U bouwt de afsluitcriteria voor de lus op dezelfde manier als slimme koppelingsconfiguraties. U kunt elk gepubliceerd gegevensitem van de activiteit gebruiken als onderdeel van de configuratie voor afsluiten of niet afsluiten. De algemene gepubliceerde gegevens bevatten speciale gegevensitems, zoals Lus: aantal pogingen en Lus: totale duur, waarmee u informatie uit de lus zelf kunt gebruiken in de lusvoorwaarden.

Lussen worden één keer uitgevoerd voor elk binnenkomend gegevensstuk dat aan de activiteit wordt doorgegeven. Denk bijvoorbeeld aan een runbook dat gebruikmaakt van een querydatabaseactiviteit gevolgd door Toevoegregel. Als de activiteit Querydatabase drie rijen retourneert, wordt de activiteit Toevoeglijn drie keer uitgevoerd. Als u een lus hebt voor de activiteit Toevoeglijn , worden er drie afzonderlijke lussen uitgevoerd. Nadat het eerste gegevensitem de activiteit Toevoeglijn heeft doorlopen, gaat het volgende item door Toevoeglijn en wordt het item herhaald totdat het wordt afgesloten. Vervolgens begint het derde item. Nadat alle drie de items zijn verwerkt, wordt de volgende activiteit in het runbook uitgevoerd.

Luss configureren

  1. Klik met de rechtermuisknop op een activiteit in het runbook om Herhalen te selecteren. Het dialoogvenster Eigenschappen van lus wordt geopend.

  2. Selecteer op het tabblad Algemeen de optie Inschakelen.

  3. Voer in het vak Vertraging tussen pogingen het aantal seconden in dat moet worden onderbroken tussen elke poging om de activiteit uit te voeren.

Voorwaarden voor afsluiten en niet afsluiten

De regels op het tabblad Afsluiten geven de voorwaarden op die bepalen of de lus wordt afgesloten. De regels op het tabblad Niet afsluiten geven de voorwaarden op die ervoor zorgen dat de lus wordt voortgezet.

Belangrijk

De regels op het tabblad Niet afsluiten vervangen de regels op het tabblad Afsluiten .

De regels binnen elk tabblad worden gekoppeld met behulp van de voorwaarde Of . Slechts één van de voorwaarden op een tabblad moet waar zijn om het hele tabblad waar te maken.

Selecteer het vereiste tabblad voor de procedure om een afsluitvoorwaarde toe te voegen of te verwijderen:

Volg deze stappen om een afsluitvoorwaarde toe te voegen:

  1. Selecteer in het dialoogvenster Eigenschappen van lus het tabblad Afsluiten of Niet afsluiten en selecteer vervolgens de voorwaarde die in het vak wordt vermeld , selecteer Toevoegen om een voorwaarde toe te voegen.

    Belangrijk

    Als u de waarden wilt wijzigen waaruit de regel bestaat, moet u elk onderstreept gedeelte van de koppelingsvoorwaarde selecteren.

  2. Selecteer de vermelde activiteit in de voorwaarde om het dialoogvenster Gepubliceerde gegevens te openen.

  3. Schakel het selectievakje Algemene geretourneerde gegevens weergeven in om eigenschappen weer te geven die gemeenschappelijk zijn voor alle activiteiten.

  4. Selecteer een eigenschap uit de gepubliceerde gegevens en selecteer vervolgens OK. De criteriumexpressie verandert afhankelijk van het gegevenstype dat de eigenschap retourneert.

  5. Als u de verschillende onderdelen van de expressie wilt wijzigen, selecteert u de onderstreepte tekst en selecteert of voert u een geschikte waarde in.

  6. Selecteer Finish.

Een planning instellen voor een runbook

U kunt een planning instellen om te bepalen wanneer een runbook wordt uitgevoerd. Er zijn bijvoorbeeld momenten waarop het ongepast is om bepaalde runbooks uit te voeren, zoals het maken van een back-up van een runbook op een hoofdserver tijdens normale kantooruren. U kunt een plan maken dat volgens een complex interval wordt uitgevoerd, bijvoorbeeld de eerste en derde maandag en donderdag van iedere maand, behalve wanneer deze samenvallen met een feestdag.

Plannen gebruiken de systeemklok van de Runbook-server die het runbook uitvoert. Zo kunnen plannen functioneren in virtuele machineomgevingen en blijven draaien, ook als de systeemklok wordt aangepast wegens de overgang naar zomer- of wintertijd.

Runbooks die vóór een verboden tijdstip worden gestart, worden uitgevoerd totdat ze zijn voltooid, zelfs als ze nog steeds worden verwerkt wanneer de verboden tijd aankomt. Ze worden niet onderbroken nadat de verwerking is gestart.

Belangrijk

De toegangsmachtigingen voor planningen kunnen worden gewijzigd, maar de runbookserver dwingt deze machtigingen niet af.

Notitie

Als u plant dat een runbook wordt gestart gedurende een uur dat wordt overgeslagen wanneer de systeemklok één uur vooruit wordt aangepast, wordt die begintijd overgeslagen en begint het runbook op het volgende geplande tijdstip. Als u plant dat een runbook wordt gestart gedurende een uur dat twee keer optreedt omdat de systeemklok één uur naar achteren wordt aangepast, wordt het runbook twee keer gestart.

Notitie

Orchestrator biedt geen ondersteuning voor het verplaatsen van meerdere planningen met meervoudige selectie. Om meer dan een planning naar een andere map verplaatsen, moet u elke planning afzonderlijk verplaatsen.

Selecteer het vereiste tabblad om een planning te maken, een planning toe te wijzen aan een runbook of een schema uit een runbook te verwijderen:

Volg deze stappen om een planning te maken:

  1. Klik in het deelvenster Connections met de rechtermuisknop op de map Planningen of een submap van de map Planningen, wijsNieuw aan en selecteer Plannen om het dialoogvenster Nieuwe planning te openen.

  2. Voer op het tabblad Algemeen in het vak Naam een naam in voor de planning.

  3. Voer in het vak Beschrijving een beschrijving in waarin het doel van de planning wordt beschreven of uitgelegd.

  4. Selecteer het tabblad Details . Selecteer de dagen waarop runbooks volgens dit schema mogen worden uitgevoerd:

    Dagen van de week: selecteer deze optie en selecteer de dagen van de week waarop runbooks volgens dit schema kunnen worden uitgevoerd.

    Exemplaar: selecteer de weken van de maand waarop runbooks volgens de planning mogen worden uitgevoerd.

    Dagen van maand: selecteer deze optie en selecteer de dagen van de maand waarop runbooks volgens dit schema kunnen worden uitgevoerd. Geef de dagen van de maand op door het nummer van de dag in te voeren. U kunt koppelstreepjes gebruiken om reeksen en komma's te beschrijven en vermeldingen van elkaar te scheiden. Als u bijvoorbeeld 1,3 typt, wordt de eerste en derde dag van de maand opgenomen. Het invoeren van 1-21 omvat de eerste tot en met de eenentwintigste dag van de maand. U kunt beide combineren om complexe beschrijvingen van de dagen van de maand te maken. Voer alles in om alle dagen van de maand op te geven. Voer laatste in om de laatste dag van de maand op te geven.

    U kunt niet alle en de tijd gebruiken als onderdeel van een reeks dagen. Als u bovendien een bereik van 5-31 hebt ingevoerd, werkt dit bereik correct voor alle maanden, inclusief de maanden met 28, 29, 30 en 31 dagen.

  5. Selecteer Uren om het dialoogvenster Uren plannen te openen.

  6. Selecteer en sleep om een groep uren in een week te selecteren. De tekst onder aan het dialoogvenster toont de periode die u hebt geselecteerd. Selecteer vervolgens een van de volgende opties:

    Toestaan (blauw): wijst de periode toe die u hebt geselecteerd als een tijd waarop runbooks mogen worden uitgevoerd.

    Geweigerd (wit): wijs de periode toe die u hebt geselecteerd als een tijd waarin runbooks niet mogen worden uitgevoerd.

  7. Selecteer OK.

  8. Selecteer het tabblad Uitzonderingen . In de lijst worden alle dagen weergegeven die uitzonderingen zijn op de regels die zijn gedefinieerd op het tabblad Details .

  9. Selecteer Toevoegen om het dialoogvenster Datum te openen.

  10. Geef de datum op en selecteer Toestaan of Niet toestaan om het runbook op die dag al dan niet te laten uitvoeren. Selecteer vervolgens OK. De vermelding verschijnt in de lijst.

  11. Als u een uitzonderingsvermelding wilt wijzigen, selecteert u deze en selecteert u vervolgens Wijzigen. Als u de vermelding Uitzondering wilt verwijderen, selecteert u deze en selecteert u vervolgens Verwijderen.

  12. Als u een planning wilt wijzigen, dubbelklikt u op De Planning.

  13. Als u een planning wilt verwijderen, klikt u met de rechtermuisknop op Planning en selecteert u verwijderen.

  14. Selecteer Finish.

Gegevens bewerken met functies

Mogelijk moet u tekenreeksgegevens uit tekstbestanden, geretourneerde gegevens of andere bronnen bewerken en deze converteren naar een bruikbare vorm voor uw runbookactiviteiten. Daarnaast kunt u eenvoudige rekenkundige bewerkingen uitvoeren, zoals het berekenen van optellingen en verschillen en het uitvoeren van deel- en vermenigvuldigingsbewerkingen. U kunt bijvoorbeeld tekst uit een tekstbestand extraheren met behulp van een activiteit Tekstbestandbeheer , voorloop- en volgspaties uit de tekst knippen en vervolgens specifieke delen van de tekst ophalen die u als geretourneerde gegevensitems aan andere activiteiten kunt doorgeven.

U bewerkt gegevens in het runbook door een functie in te voegen. Functies voor gegevensmanipulatie moeten tussen vierkante haken staan ('[' en ']'). Bijvoorbeeld:

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

Wanneer de activiteit wordt uitgevoerd, wordt de tekst 'dit wordt ingevoegd in hoofdletters' in dit voorbeeld vervangen door 'DIT WORDT INGEVOEGD IN HOOFDLETTERS'.

Functies zijn hoofdlettergevoelig. Upper('Text') wordt bijvoorbeeld verwerkt, maar upper('Text') niet.

De onderstaande tabel bevat de functies die worden ondersteund voor runbooks.

Functie en definitie Gebruik Parameters Voorbeeld
Hoofdletter: converteert tekst naar hoofdletters. Upper('Text') Tekst: de tekst die wordt geconverteerd naar hoofdletters. Hoofdletter('dit wordt geconverteerd naar hoofdletters') retourneert 'DIT WORDT GECONVERTEERD NAAR HOOFDLETTERS'
Lower : converteert tekst naar kleine letters. Lower('Text') Tekst: de tekst die wordt geconverteerd naar kleine letters. Lower('This Will Be converted to lowercase') retourneert 'this will be converted to lowercase' (dit wordt geconverteerd naar kleine letters)
Veld: retourneert tekst op een specifieke positie. Field('Text', 'Delimiter', Field Number) Tekst: de tekst die wordt doorzocht.

Scheidingsteken: het teken dat elk veld scheidt.

Veldnummer: de positie van het veld dat wordt geretourneerd (beginnend bij 1).		 Field('John; Smith; 9055552211', ';', 2) retourneert 'Smith'
Som: retourneert de som van een set getallen. Sum(firstNumber, secondNumber, thirdNumber, ...) Getal: het getal dat wordt toegevoegd. U kunt elke set getallen plaatsen, elk gescheiden door een komma (,). Som(2,3,4,5) retourneert '14'
Diff: retourneert het verschil van twee getallen. Diff(getal1, getal2, <precisie>) getal1: het getal dat wordt afgetrokken van.

getal2: het getal dat wordt afgetrokken van Getal1.

Precisie <Optioneel> : het aantal decimalen waarop het resultaat wordt afgerond.		 Diff(9, 7) retourneert '2'

Diff(9,3, 2,1, 2) retourneert '7,20'
Mult: retourneert het product van een set getallen. Mult(firstNumber, secondNumber, thirdNumber, ...) Getal: het getal dat wordt vermenigvuldigd. U kunt elke set getallen plaatsen, elk gescheiden door een komma (,). Mult(2, 3, 4) retourneert '24'
Div: retourneert het quotiënt van twee getallen. Div(getal1, getal2, <precisie>) getal1: het getal dat wordt gedeeld.

getal2: het getal dat Getal1 deelt.

Precisie <Optioneel> : het aantal decimalen waarop het resultaat wordt afgerond.		 Div(8, 4) retourneert '2'

Div(9, 2, 2) retourneert '4,50'
Instr: retourneert de positie van het eerste exemplaar van tekst binnen een andere tekst. Instr ('SearchText', 'TextToFind') SearchText: de tekst die wordt doorzocht.

TextToFind : de tekst die u zoekt.		 Instr('Dit is een tekenreeks die wordt doorzocht', 'tekenreeks') retourneert 11
Rechts: retourneert een subset van de tekst vanaf de rechterkant van de volledige tekst. Right('Text', Length) Tekst: de volledige tekst.

Lengte: het aantal tekens aan de rechterkant dat wordt geretourneerd.		 Right('Take from the right', 9) retourneert 'the right'
Links: retourneert een subset van de tekst vanaf de linkerkant van de volledige tekst. Left('Text', Length) Tekst: de volledige tekst.

Lengte: het aantal tekens aan de linkerkant dat wordt geretourneerd.		 Left('Take from the left', 4) retourneert 'Take'
Midden: retourneert een subset van de tekst vanaf het midden van de volledige tekst. Mid('Tekst'; Begin, Lengte) Tekst: de volledige tekst.

Start : de beginpositie in de tekst waar u tekens wilt laten terugkeren.

Lengte: het aantal tekens vanaf de beginpositie dat wordt geretourneerd.		 Mid('Nemen van het midden', 5, 4) retourneert 'van'
LTrim: hiermee worden voorloopspaties van tekst weggeknipt. LTrim('Text') Tekst: de tekst die wordt ingekort met voorloopspaties. LTrim(' Verwijder alleen de voorloopspaties. ') retourneert 'Alleen de voorloopspaties verwijderen. '
RTrim: hiermee worden de afsluitende spaties van tekst verwijderd. RTrim('Text') Tekst: de tekst die wordt afgekapt van volgspaties. RTrim(' Verwijder alleen de afsluitende spaties. ') retourneert alleen de afsluitende spaties verwijderen.'
Knippen: hiermee knipt u voorloop- en volgspaties uit tekst. Trim('Text') Tekst: de tekst die wordt ingekort. Trim(' Verwijder voorloop- en volgspaties. ') retourneert 'Voorloop- en volgspaties verwijderen'.
Len: retourneert de lengte van tekst. Len('Text') Tekst: de tekst die wordt gemeten. Len('Deze tekst meten') retourneert 17

Notitie

Functies zijn hoofdlettergevoelig. Upper('Text') wordt bijvoorbeeld verwerkt, maar upper('Text') niet.

Volgende stappen

Zie Een voorbeeldrunbook maken en testen voor meer informatie over het maken van een voorbeeldrunbook.