Workiva supportcenter

Kommandon är de uppgifter som utförs inom kedjan, baserat på en anslutning till en datakälla. För mer komplexa kedjor kan detta inkludera kommandon som utlöses av en mängd olika förhållanden.

Obs: Innan du lägger till en kedja ska du se till att din organisation konfigurerar de anslutningar som krävs för att aktivera kommandon med dess datakällor.

För att köra specifika kommandon seriellt-ett efter ett annat, där varje väntar på att föregående kommando ska avslutas- eller samtidigt i parallellt, eller för att få en kedja att misslyckas om ett kommando av flera går inte, gruppera dem.

Lägga till ett kommando i en kedja

1. I kedjan väljer du det kommando som ska utföras:
   • Om du vill lägga till ett nytt kommando i kedjan klickar du på Available Connectors, klickar på dess anslutning och flyttar sedan kommandot till den plats i kedjan där det ska finnas.
   • För att duplicera ett befintligt kommando markerar du dess nod, klickar på Copy file_copy och flyttar den nya noden till den plats i kedjan där den ska finnas.

   Tips: Om du vill lägga till ett kommando som första nod i kedjan flyttar du det till Starta.

2. För att länka kommandot till föregående och nästa nod i kedjan klickar du på och drar linjer mellan nodens portar.

   Obs: För att ändra en nods position i kedjan måste du koppla bort den från andra noder och sedan flytta den till den plats där den ska vara. Om du vill flytta flera noder samtidigt håller du ned SHIFT medan du markerar dem.

3. Markera den nya noden och klicka på Edit create.
4. Ange kommandots parametrar:
   • Under Basic Info anger du ett unikt namn och en beskrivning som hjälper dig att identifiera kommandot och dess syfte.
   • Växla ögonikonen om du vill maskera känsliga uppgifter utgångar.
   • För att köra kommandot flera gånger, för varje objekt i listan, aktivera Iteratorupprepa, och ange iterationsvärdena.
   • Under Command Properties anger du kommandots ingångar, baserat på kontakten.
5. Klicka på Spara.

Kör bara ett enda kommando eller en enda grupp

För att underlätta testning och snabba iterationer när du bygger kedjor kan du utföra ett enda kommando eller en kommandogrupp inom en kedja.

1. I Chain Builder, på fliken Chains, välj Execute flight_takeoff från kedjans meny.
2. För kommandot eller gruppen som ska köras, klicka på Utför detta kommando play_circle_outline.
3. Klicka på Kör kedjan.

Hoppa över ett kommando

För att utveckla förgreningslogik, eller som en del av utvecklingen av en kedja, kan du behöva hoppa över ett kommando för att tvinga fram ett visst resultat. Du kan också ställa in villkorlig logik för att automatiskt returnera ett specifikt resultat baserat på fastställda regler.

1. Markera kommandots nod i kedjan, klicka på Editcreate, och välj Skipskip_next.
2. Välj om du automatiskt vill returnera ett resultat av info check_circle, warning warning, eller error error för kommandot när det hoppas över.
3. Om du vill hoppa över kommandot endast om vissa kriterier uppfylls anger du when. Bygg upp den villkorliga logiken som en grupp som du lägger till regler och andra grupper av regler till, var och en sammanfogad med ett AND- eller OR-boolean.
   • Om alla villkor måste vara sanna för att hoppa över, välj AND.
   • Om endast ett villkor måste vara sant för att hoppa över, välj OR.

   Du kan lägga till regler som baseras på olika datatyper:

   Datatyp	Beskrivning
   Sträng	Två eller flera tecken
   Heltal	Alla hela, icke-decimala numeriska värden
   Datum	Valfri datumsträng eller datumvariabel
   Flottör	Valfritt numeriskt värde
   JSON	JavaScript Object Notation; använd Variable Transformation för att analysera objekt

   För att verifiera om data uppfyller kriterierna för att hoppa över kommandot, para ihop det med en operator och ett värde:

   • Är blank eller Är inte blank
   • Innehåller
   • Träffar RegExp, för reguljärt uttryck
   • Börjar med eller Slutar med
   • = eller !=
   • < eller >
   • <= eller >=
4. Klicka på Spara.

Hantera ett kommandos felhantering

För att upptäcka eller ignorera fel för ett kommando:

1. Klicka på kommandots nod i kedjan, klicka på Redigera skapa, och välj Felhantering varning.
2. Under Error actions repeat, välj vad du ska göra om kommandot gick inte.
   
   • För att följa kedjans förgreningslogik, välj Fortsätt med kedjan.
   • Om du vill stoppa kedjan tillfälligt, t.ex. för att åtgärda problemet, väljer du Pausa kedjan. Om du vill starta om kedjan efter att problemet har lösts väljer du kommandot i kedjan och klickar på Återuppta.
   • Om du vill stoppa kedjan helt väljer du Avsluta kedjan.
3. För att stoppa kommandot om det tar längre tid än det borde, under Timeout conditions alarm, ange dess maximala varaktighet i sekunder.
   
4. Om du vill försöka igen med ett kommando om datakällan är intermittent eller otillgänglig anger du antalet försök och hur många sekunder som ska gå mellan försöken.
5. Under Error conditions priority_high, välj eventuella fel som ska ignoreras, t.ex. när du skapar en mapp som redan finns.
6. Om du vill ange status för kommandot baserat på dess utdata klickar du på Lägg till under Tolkning av utdata och definierar den regel eller grupp av regler som ska tolka dess status.  Med variabeln Status i utdata Command Details kan du t.ex. ange en regel som resulterar i en varning när kommandot lyckas.
   
7. Under Loggtolkning, välj om kommandot ska gå inte baserat på om det resulterar i specifika utdata.
   • För att inte inte tolka kommandot baserat på specifika utdata, välj Tolka inte.
   • Om du vill att kommandot ska misslyckas när specifika utgångar hittas väljer du Det gick inte om utgång(ar) hittades och anger vilka utgångar som ska sökas efter.
   • Om du vill att kommandot ska gå fel när specifika utgångar inte hittas väljer du Det gick inte om utgång(ar) inte hittades och anger den utgång som ska sökas efter.
   • Flera rader med text måste separeras med \n
8. Klicka på Spara.

Visa utdata från ett kommando

Från Monitorflight_takeoff kan du förhandsgranska resultatet av ett kommando som körs via CloudRunner. 

1. I Chain Builder, från Monitor, öppna körningen med utdata som ska förhandsgranskas och välj kommandot.
2. På fliken Utdata klickar du på Förhandsgranska utdatasynlighet för att visa utdata.
   

Obs: Du kan bara förhandsgranska utdata från kommandon som körs via CloudRunner, inte en GroundRunner.

Ta bort ett kommando från en kedja

Om du vill ta bort ett kommando från en kedja klickar du på dess nod, klickar på Radera Radera och sedan på Radera.

Obs: För att säkerställa logiken i kedjan kan du inte ta bort ett kommando om dess förälder har flera syskon eller grenar på samma nivå.