Workiva-ondersteuningscentrum

Commando's zijn de taken die binnen de keten worden uitgevoerd, gebaseerd op een verbinding met een gegevensbron. Bij complexere ketens kan dit commando's omvatten die worden geactiveerd door verschillende voorwaarden.

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

Om specifieke commando's serieel uit te voeren —de een na de ander, waarbij elk wacht tot het vorige commando is voltooid— of gelijktijdig parallel , of om een ​​keten te laten mislukken als een van de commando's mislukt, groepeer ze samen.

Voeg een commando toe aan een keten

1. Selecteer in de keten de uit te voeren opdracht:

   • Om een ​​nieuw commando aan de keten toe te voegen, klikt u onder Beschikbare connectoren op de bijbehorende verbinding en verplaatst u het commando vervolgens naar de juiste positie in de keten.
   • Om een ​​bestaande opdracht te dupliceren, selecteer je het bijbehorende knooppunt, klik je op Kopiëren file_copy en verplaats je het nieuwe knooppunt naar de juiste positie in de keten.

   Tip: Om een ​​commando als eerste knooppunt van de keten toe te voegen, verplaats het naar Start .

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

   Opmerking: Om de positie van een knooppunt in de keten te wijzigen, moet u het loskoppelen van andere knooppunten en het vervolgens verplaatsen naar de juiste positie. Om meerdere knooppunten tegelijk te verplaatsen, houd je SHIFT ingedrukt terwijl je ze selecteert.

3. Selecteer het nieuwe knooppunt en klik op Bewerken maken .
4. Voer de parameters van de opdracht in:
   • Voer onder Basisinfo een unieke naam en beschrijving in om het commando en het doel ervan te identificeren.
   • Schakel het oogpictogram in of uit als u gevoelige gegevens wilt maskeren.
   • Om de opdracht meerdere keren uit te voeren, schakelt u voor elk item in de lijst Iterator repeat in, en voer de iteratiewaarden in .
   • Onder Command Properties , voer de invoer van de opdracht in, gebaseerd op de connector .
5. Klik op Opslaan .

Voer slechts één opdracht of groep opdrachten uit.

Om het testen en snel itereren tijdens het bouwen van ketens te vereenvoudigen, kunt u een enkele opdracht of een groep opdrachten binnen een keten uitvoeren.

1. In Chain Builder , selecteer je in het tabblad Chains de optie Execute flight_takeoff in het menu van de keten.
2. Voor de uit te voeren opdracht of groep klikt u op Voer deze opdracht uit play_circle_outline .
3. Klik Run Chain .

Een opdracht overslaan

Om vertakkingslogica te ontwikkelen, of als onderdeel van het ontwikkelen van een keten, kan het nodig zijn een opdracht over te slaan om een ​​specifiek resultaat af te dwingen. Je 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 Bewerken maken en selecteer Overslaan skip_next .
2. Kies of er automatisch een resultaat van info check_circle , warning warning of error error moet worden geretourneerd voor de opdracht wanneer deze wordt overgeslagen.

3. Om de opdracht alleen over te slaan als aan specifieke criteria wordt voldaan, kunt u aangeven wanneer. Bouw de voorwaardelijke logica op als een groep waaraan je regels en andere groepen regels toevoegt, die elk met elkaar verbonden zijn door een AND- of OR-booleaanse operator.

   • Als aan alle voorwaarden moet worden voldaan om over te slaan, selecteer dan EN.
   • Als er slechts aan één voorwaarde moet worden voldaan om over te slaan, selecteer dan OF.

   Je kunt regels toevoegen op basis van verschillende gegevenstypen:

   Gegevenstype	Beschrijving
   String	Twee of meer tekens
   Geheel getal	Elke gehele, niet-decimale numerieke waarde
   Datum	Elke datumstring of datumvariabele
   Vlot	Elke numerieke waarde
   JSON	JavaScript-objectnotatie; gebruik Variabele transformatie om objecten te parseren

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

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

Beheer de foutafhandeling van een opdracht.

Om fouten voor een opdracht te detecteren of te negeren:

1. Klik in de keten op het knooppunt van de opdracht, klik op Bewerken maken en selecteer Foutafhandeling waarschuwing .
2. Onder Foutacties herhalen selecteer je wat er moet gebeuren als de opdracht mislukt.
   
   • Om de vertakkingslogica van de keten te volgen, selecteer Doorgaan met keten .
   • Om de keten tijdelijk te stoppen, bijvoorbeeld om het probleem op te lossen, selecteer je Keten pauzeren . Om de keten opnieuw te starten nadat het probleem is opgelost, selecteert u de opdracht in de keten en klikt u op Hervatten .
   • Om de keten volledig te stoppen, selecteer je Keten verlaten .
3. Om de opdracht te stoppen als deze langer duurt dan zou moeten, voer onder Timeout-voorwaarden alarm de maximale duur in seconden in.
   
4. Om een ​​opdracht opnieuw uit te voeren als de gegevensbron niet beschikbaar of onderbroken is, voert u het aantal herhaalpogingen en de wachttijd in seconden tussen de pogingen in.
5. Onder Foutcondities prioriteit_hoog selecteer je alle fouten die je wilt negeren, bijvoorbeeld bij het aanmaken 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 een waarschuwing geeft wanneer de opdracht succesvol is.
   
7. Onder Loginterpretatie kunt u selecteren of de opdracht moet mislukken op basis van de specifieke uitvoer die deze oplevert.
   • Om te voorkomen dat de opdracht mislukt op basis van specifieke uitvoerwaarden, selecteer 'Niet interpreteren ' .
   • Om de opdracht te laten mislukken wanneer specifieke uitvoerwaarden worden gevonden, selecteert u 'Mislukken als uitvoerwaarden worden gevonden' en voert u de uitvoerwaarden in waarnaar u wilt zoeken.
   • Om de opdracht te laten mislukken als er geen specifieke uitvoer wordt gevonden, selecteer je Mislukken als uitvoer(en) niet gevonden en voer je de uitvoer in waarnaar je wilt zoeken.
   • Meerdere tekstregels moeten worden gescheiden door \n
8. Klik op Opslaan .

De uitvoer van een commando bekijken

Vanuit Monitor flight_takeoff kunt u een voorbeeld van de uitvoer van een commando bekijken dat via de CloudRunner is uitgevoerd. 

1. In Chain Builder , vanuit Monitor , open de run met de uitvoer om te bekijken en selecteer 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 van opdrachten bekijken die via de CloudRunner worden uitgevoerd, niet via een GroundRunner.

Een opdracht uit een keten verwijderen

Om een ​​opdracht uit een keten te verwijderen, klikt u op het bijbehorende knooppunt, klikt u op Verwijderen verwijderen en vervolgens op Verwijderen .

Opmerking: Om de logica van de keten te waarborgen, kunt u een opdracht niet verwijderen als het bovenliggende element meerdere broers of zussen of vertakkingen op hetzelfde niveau heeft.