Workiva-ondersteuningscentrum

Opdrachten zijn de taken die binnen de keten worden uitgevoerd op basis van een verbinding met een gegevensbron. Voor complexere ketens kunnen dit commando's zijn die door verschillende omstandigheden worden geactiveerd.

Opmerking: Voordat u een keten toevoegt, moet u ervoor zorgen dat uw organisatie de verbindingen instelt die nodig zijn om opdrachten met haar gegevensbronnen mogelijk te maken.

Om specifieke opdrachten serieel uit te voeren- de een na de ander, waarbij elke opdracht wacht tot de vorige is voltooid - of gelijktijdig in parallel, of om een keten te laten mislukken als een van de opdrachten mislukt, groepeert u ze.

Een opdracht aan een ketting toevoegen

1. Selecteer in de keten de opdracht die u wilt uitvoeren:
   • Om een nieuwe opdracht aan de keten toe te voegen, klikt u onder Available Connectorsop de bijbehorende verbinding en verplaatst u de opdracht naar de plaats waar deze in de keten moet komen.
   • Om een bestaande opdracht te dupliceren, selecteert u het knooppunt ervan, klikt u op Kopieer  bestand_kopie , en verplaatst u het nieuwe knooppunt naar de plaats waar het in de keten moet komen.

   Tip: Om een opdracht als eerste knooppunt van de keten toe te voegen, verplaatst u deze naar Start.

2. Om de opdracht aan de vorige en volgende knooppunten in de keten te koppelen, klikt u op lijnen tussen de poorten van de knooppunten en sleept u deze.

   Opmerking: Om de positie van een knooppunt in de keten te wijzigen, koppelt u het los van andere knooppunten en verplaatst u het vervolgens naar de plaats waar het moet komen. Om meerdere nodes tegelijk te verplaatsen, houdt u SHIFT ingedrukt terwijl u ze selecteert.

3. Selecteer het nieuwe knooppunt en klik op Bewerken  aanmaken.
4. Voer de parameters van de opdracht in:
   • Voer onder Basisinfoeen unieke naam en beschrijving in om de opdracht en de bedoeling ervan te helpen identificeren.
   • Schakel het pictogram oog als u gevoelige gegevens uitgangen wilt maskeren.
   • Om de opdracht meerdere keren uit te voeren, schakelt u voor elk item in de lijst Iterator repeat in, en voeren de iteratiewaardenin.
   • Voer onder Commando-eigenschappende ingangen van de opdracht in, gebaseerd op de connector.
5. Klik op Opslaan.

Voer slechts één opdracht of groep uit

Om het testen en snelle iteraties te vergemakkelijken terwijl u ketens bouwt, kunt u een enkele opdracht of opdrachtgroep binnen een keten uitvoeren.

1. In Chain Builder, op het tabblad Chains , selecteert u Execute  flight_takeoff in het menu van de keten.
2. Klik voor de uit te voeren opdracht of groep op Voer deze opdracht uit  play_circle_outline.
3. Klik op Ketting uitvoeren.

Een opdracht overslaan

Om vertakkende logica te ontwikkelen, of als onderdeel van het ontwikkelen van een keten, kan het nodig zijn om een commando over te slaan om een specifiek resultaat te forceren. U kunt ook voorwaardelijke logica instellen om automatisch een specifiek resultaat te retourneren op basis van ingestelde regels.

1. Selecteer in de keten het knooppunt van de opdracht, klik op Bewerk  maak en selecteer Sla skip_nextover.
2. Kies of er automatisch een resultaat van info  check_circle, warning  warning, of error  error voor de opdracht moet worden teruggegeven als deze wordt overgeslagen.
3. Om de opdracht alleen over te slaan als aan specifieke criteria is voldaan, geeft u op wanneer. Bouw de voorwaardelijke logica op als een groep waaraan u regels en andere groepen regels toevoegt, elk verbonden met een AND of OR boolean.
   • Als alle voorwaarden waar moeten zijn om over te slaan, selecteert u AND.
   • Als slechts één voorwaarde waar moet zijn om over te slaan, selecteert u OR.

   U kunt regels toevoegen op basis van verschillende gegevenstypes:

   Gegevenstype	Beschrijving
   String	Twee of meer tekens
   Geheel getal	Elke hele, niet-decimale numerieke waarde
   Datum	Elke datumstring of datumvariabele
   Vlotter	Elke numerieke waarde
   JSON	JavaScript Object Notation; gebruik Variable Transformation om objecten te parsen

   Om te controleren of gegevens voldoen aan de criteria om de opdracht over te slaan, koppelt u ze aan een operator en waarde:

   • Is leeg of Is niet leeg
   • Bevat
   • Komt overeen met RegExp, voor reguliere uitdrukking
   • Begint met of Eindigt met
   • = of !=
   • < of &gt
   • <= of >=
4. Klik op Opslaan.

De foutafhandeling van een opdracht beheren

Fouten voor een opdracht detecteren of negeren:

1. Klik in de keten op het knooppunt van de opdracht, klik op Bewerken  maken, en selecteer Foutafhandeling  waarschuwing.
2. Selecteer onder Foutacties  herhaalwat u moet doen als de opdracht mislukt.
   
   • Om de logica van de kettingtakken te volgen, selecteert u Doorgaan met ketting.
   • Om de keten tijdelijk te stoppen, bijvoorbeeld om het probleem te verhelpen, selecteert u Keten onderbreken. Om de keten opnieuw te starten nadat het probleem is opgelost, selecteert u de opdracht in de keten en klikt u op Resume.
   • Om de ketting volledig te stoppen, selecteert u Keten afsluiten.
3. Om het commando te stoppen als het langer duurt dan zou moeten, onder Timeout condities  alarm, voert u de maximale duur in seconden in.
   
4. Om een opdracht opnieuw te proberen als de gegevensbron onderbroken of niet beschikbaar is, voert u het aantal pogingen in dat u wilt proberen en hoeveel seconden u tussen de pogingen wilt wachten.
5. Selecteer onder Foutcondities  prioriteit_hoogeventuele fouten die u wilt negeren, zoals bij het maken van een map die al bestaat.
6. Om de status van de opdracht in te stellen op basis van de uitvoer ervan, klikt u op Toevoegen onder Uitvoerinterpretatie, en definieert u de regel - of groep regels - om de status ervan te interpreteren.Met de variabele Status van de uitvoer Command Details kunt u bijvoorbeeld een regel instellen die resulteert in een waarschuwing als de opdracht slaagt.
   
7. Selecteer onder Logboekinterpretatieof u de opdracht wilt laten mislukken op basis van of deze resulteert in specifieke uitgangen.
   • Om niet de opdracht te laten mislukken op basis van specifieke uitgangen, selecteert u Niet interpreteren.
   • Om de opdracht te laten mislukken als er specifieke uitgangen worden gevonden, selecteert u Mislukken als uitgang(en) worden gevonden en voert u de uitgangen in waarop u wilt scannen.
   • Om de opdracht te laten mislukken wanneer specifieke uitgangen niet worden gevonden, selecteert u Mislukken als uitgang(en) niet gevonden worden en voert u de uitgang in waarnaar u wilt scannen.
   • Meerdere regels tekst moeten gescheiden worden met
8. Klik op Opslaan.

De uitvoer van een opdracht bekijken

Via Monitor flight_takeoffkunt u een voorbeeld bekijken van de uitvoer van een opdracht die via de CloudRunner is uitgevoerd. 

1. In Chain Builder, op Monitor, opent u de run met de uitvoer die u wilt bekijken en selecteert u de opdracht.
2. Klik op het tabblad Uitvoer op Voorbeeld van de uitvoer zichtbaarheid om de uitvoer te bekijken.
   

Opmerking: U kunt alleen de uitvoer bekijken van opdrachten die via de CloudRunner worden uitgevoerd, niet een GroundRunner.

Een opdracht uit een ketting verwijderen

Om een opdracht uit een keten te verwijderen, klikt u op het knooppunt ervan, klikt u op Verwijder  verwijder, en klikt u vervolgens op Verwijder.

Opmerking: Om de logica van de keten te waarborgen, kunt u een opdracht niet verwijderen als de ouder ervan meerdere broers en zussen of takken op hetzelfde niveau heeft.