Workiva kundestøttesenter

Kommandoer er oppgavene som utføres i kjeden, basert på en forbindelse med en datakilde. For mer komplekse kjeder kan dette inkludere kommandoer utløst av en rekke betingelser.

Merk: Før du legger til en kjede, må du sørge for at organisasjonen din setter opp tilkoblingene som kreves for å aktivere kommandoer med datakildene.

For å kjøre spesifikke kommandoer serielt – én etter den andre, der hver kommando venter på at den forrige kommandoen skal fullføres – eller samtidig i parallelt , eller for å få en kjede til å feile hvis én av flere kommandoer feiler, grupper dem sammen .

Legge til en kommando i en kjede

1. I kjeden velger du kommandoen som skal utføres:

   • For å legge til en ny kommando i kjeden, klikk på tilkoblingen under Tilgjengelige koblinger og flytt deretter kommandoen dit den skal plasseres i kjeden.
   • For å duplisere en eksisterende kommando, velg noden, klikk på Kopier file_copy og flytt den nye noden dit den skal plasseres i kjeden.

   Tips: For å legge til en kommando som den første noden i kjeden, flytt den til Start .

2. For å koble kommandoen til forrige og neste noder i kjeden, klikk og dra linjer mellom nodens porter.

   Merk: For å endre en nodes posisjon i kjeden, koble den fra andre noder og flytt den deretter dit den skal være. For å flytte flere noder samtidig, hold inne SHIFT mens du velger dem.

3. Velg den nye noden, og klikk på Rediger opprett .
4. Skriv inn kommandoens parametere:
   • Under Grunnleggende informasjon skriver du inn et unikt navn og en beskrivelse for å identifisere kommandoen og dens hensikt.
   • Aktiver øyeikonet hvis du vil maskere sensitive data utdata.
   • For å kjøre kommandoen flere ganger, aktiver Iterator repeat, og skriv inn iterasjonsverdiene for hvert element i listen.
   • Under Kommandoegenskaper skriver du inn kommandoens inndata, basert på koblingen .
5. Klikk på Lagre.

Kjør bare én kommando eller gruppe

For å forenkle testing og raske iterasjoner når du bygger kjeder, kan du utføre en enkelt kommando eller kommandogruppe i en kjede.

1. I Kjedebygger , fra fanen Kjeder velger du Utfør flight_takeoff fra kjedens meny.
2. For at kommandoen eller gruppen skal kjøre, klikk på Utfør denne kommandoen play_circle_outline .
3. Klikk på Kjør kjede .

Hopp over en kommando

For å utvikle forgreningslogikk, eller som en del av å utvikle en kjede, kan det hende du må hoppe over en kommando for å fremtvinge et bestemt resultat. Du kan også sette opp betinget logikk for automatisk å returnere et bestemt resultat basert på angitte regler.

1. I kjeden velger du kommandoens node, klikker på Rediger opprett og velger Hopp over skip_next .
2. Velg om du automatisk skal returnere resultatet info check_circle , warning warning eller error error for kommandoen når den hoppes over.

3. Hvis du bare vil hoppe over kommandoen hvis spesifikke kriterier er oppfylt, angi når. Bygg den betingede logikken som en gruppe du legger til regler og andre grupper av regler i, hver sammenkoblet med en AND- eller ELLER-boolsk verdi.

   • Hvis alle betingelsene må være sanne for å hoppe over, velger du OG.
   • Hvis bare én betingelse må være sann for å hoppe over, velg ELLER.

   Du kan legge til regler basert på ulike datatyper:

   Datatype	Beskrivelse
   Streng	To eller flere tegn
   Heltall	Enhver hel, ikke-desimal numerisk verdi
   Dato	Enhver datostreng eller datovariabel
   Flyte	Enhver numerisk verdi
   JSON	JavaScript-objektnotasjon; bruk Variabel transformasjon for å analysere objekter

   For å bekrefte om data oppfyller kriteriene for å hoppe over kommandoen, par den med en operator og verdi:

   • Er blank eller Er ikke blank
   • Inneholder
   • Samsvarer med RegExp for regulært uttrykk
   • Starter med eller Slutter med
   • = eller !=
   • < eller >
   • <= eller >=
4. Klikk på Lagre.

Administrer feilhåndteringen til en kommando

Slik oppdager eller ignorerer du feil for en kommando:

1. I kjeden klikker du på kommandoens node, klikker på Rediger opprett og velger Feilhåndtering advarsel .
2. Under Feilhandlinger gjenta velger du hva som skal gjøres hvis kommandoen mislykkes.
   
   • For å følge kjedeforgreningslogikken, velg Fortsett med kjede .
   • For å stoppe kjeden midlertidig, for eksempel for å løse problemet, velg Pause kjede . For å starte kjeden på nytt etter at problemet er løst, velg kommandoen i kjeden og klikk på Gjenoppta .
   • For å stoppe kjeden helt, velg Avslutt kjede .
3. For å stoppe kommandoen hvis den tar lengre tid enn den burde, angi maksimal varighet i sekunder under Tidsavbruddsbetingelser alarm .
   
4. For å prøve en kommando på nytt hvis datakilden er periodisk eller utilgjengelig, angi antall nye forsøk og hvor mange sekunder du skal vente mellom forsøkene.
5. Under Feilbetingelser priority_high velger du eventuelle feil som skal ignoreres, for eksempel når du oppretter en mappe som allerede finnes.
6. For å angi statusen til kommandoen basert på utdataene, klikk på Legg til under Tolkning av utdata og definer regelen – eller gruppen av regler – som skal tolke statusen.For eksempel, med variabelen Status i utdataene Kommandodetaljer , kan du angi en regel som skal resultere i en advarsel når kommandoen lykkes.
   
7. Under Loggtolkning velger du om kommandoen skal mislykkes basert på om den resulterer i spesifikke utganger.
   • For å ikke feile kommandoen basert på spesifikke utganger, velg Ikke tolk.
   • Hvis du vil at kommandoen skal mislykkes når spesifikke utganger blir funnet, velger du Mislykkes hvis utgang(er) finnes, og angir utgangene det skal søkes etter.
   • For å feile kommandoen når spesifikke utganger ikke finnes , velg Feil hvis utgang(er) ikke finnes, og skriv inn utgangen som skal skannes etter.
   • Flere tekstlinjer må skilles med \n
8. Klikk på Lagre.

Vise utdataene til en kommando

Fra Monitor flight_takeoff kan du forhåndsvise resultatet av en kommando som kjøres gjennom CloudRunner. 

1. I Chain Builder , fra Monitor , åpner du kjøringen med utdataene for å forhåndsvise, og velger kommandoen.
2. I fanen Utganger klikker du på Forhåndsvis utgangen synlighet for at utgangen skal vises.
   

Merk: Du kan bare forhåndsvise utdataene fra kommandoer som kjøres gjennom CloudRunner, ikke en GroundRunner.

Fjerne en kommando fra en kjede

For å fjerne en kommando fra en kjede, klikk på noden, klikk på Slett slett og klikk deretter på Slett .

Merk: For å sikre logikken i kjeden kan du ikke slette en kommando hvis den overordnede har flere søsken eller grener på samme nivå.