CLP - Loggning av fel i en kontrollark – Supportcenter

Vad händer om kedjan går sönder? Det är viktigt att slutanvändarna får fullständig information om potentiella resultat. I denna Connected Learning Path kommer vi att förbättra vår primära kedja genom att införliva ytterligare grenar som kommunicerar tillbaka till vår kontrollark och specifikt indikerar eventuella fel. Denna utökade kedja kommer att erbjuda ett extra lager av transparens, vilket gör det möjligt för användare att enkelt identifiera det senaste framgångsrika exekveringsdatumet för kommandot. Dessutom kommer det att ge tydlig insyn i om kedjan har fungerat framgångsrikt eller stött på några problem. Denna förbättring säkerställer att användarna är väl utrustade med den information som krävs för att övervaka och åtgärda eventuella fel omedelbart.

Primärt användningsfall för verksamheten	Orkestrering av rapporteringsarbetsflöden från en central plats Ge slutanvändarna insikter i arbetsflödesstatus
Primärt lärandemål	Lär dig hur du lägger till spårning av fel i ark för kedjekontroll Lär dig förgrening av kedjan Lär dig kommandokopiering
Förkunskapskrav	Slutför CLP \| Löpande processer och loggning av resultat i en kontrollark
Mall för support	CLP \| Loggning av fel i ett kontrollark

Steg 1: Redigera befintlig kedja

Navigera till Chain Builder och leta reda på kedjan CLP | Köra processer och logga resultat i en kontrollark
Klicka på pennknappen för att redigera kedjan
Klicka på Kedjeinställningar längst upp till höger
- Byt namn på kedjan: CLP | Loggning av fel i en kontrollark
Rädda kedjan

Steg 2: Lägg till felgren för processen för uppladdning av data

Vi ska nu lägga till de kommandon som ska användas för att generera och fylla i de värden som ska matas tillbaka till arket för att ange att uppladdningen av data misslyckades. Det första steget för att göra detta är att skapa arkiveringen med status och tid.

Lägg till ett Create File Command från File Utilities Connector till Chain canvas
Anslut Kör kedja - ladda upp data Kedjehändelse till Skapa arkivering Kommando
Dubbelklicka på länken för att redigera länkvillkoren
- Klicka på felalternativet
  
  När felalternativet har valts blir länken röd, vilket indikerar att kedjan fortsätter med den här grenen endast om kedjehändelsen "Kör kedja - ladda upp data" misslyckas
Dubbelklicka på Create File Command för att konfigurera den
- Namnge kommandot: Fyll i fel i datauppladdning och tidsstämpel
- I fältet Text skriver du in följande information:

Det gick inte att ladda upp data,(*<System.DateTime>*)

- - Ersätt (*System.DateTime*) platshållaren med lämplig exekvering, detta kommer att programmatiskt hämta datum och tid från Chains
    - I panelen Välj en variabel till vänster, expandera Exekvering
    - Välj värdet System.DateTime
Spara kommandot

Steg 3: Skriva fel i dataöverföringen tillbaka till arket

Vi kommer nu att använda kommandot Write Sheet Data för att skriva tillbaka den information som fylldes i i föregående kommando till kontrollarket. Detta kommer att ge våra slutanvändare insyn i de misslyckade datauppladdningarna och datumet då det gick inte.

Lägg till en Write Sheet Data Command från Workiva Connector till Chain canvas
Länka kommandot Populate Data Upload Failure & Time Stamp till kommandot Write Sheet Data
Dubbelklicka på kommandot för att konfigurera det
- Namnge kommandot: Write Sheet Data - Fel i uppladdning av data
- Klicka på fältet ID för kalkylark
  - I panelen Välj en variabel klickar du på nedåtpilen för att expandera Chain
  - Välj ID för cv-Control kalkylark Kedjevariabel
- Klicka på fältet Ark ID/Namn
  - I panelen Välj en variabel klickar du på nedåtpilen för att expandera Chain
  - Välj namn på cv-Control Sheet Kedjevariabel
- Klicka på fältet Data File
  - I panelen Select a Variable klickar du på nedåtpilen för att expandera Populate Data Upload Failure & Time Stamp
  - Välj Skapad arkivering utdata
- Fältet Region kommer att fyllas i med en kombination av kedjevariabler och JSON-utdata för att tala om för kedjan vilken specifik cell i arket som ska skrivas till för den aktuella iterationen:
  - Klicka på fältet Region och fyll i nedanstående uppgifter:
  - cv-Status Column Letter - variabel som finns i panelen Variabler under Kedjevariabler
  - JSON File Iteration - vi använder iterationens radnummer plus ett för att ange regionen som data ska skrivas till. Vi lägger till en för att ta hänsyn till rubriken.
    - Klicka på nedåtpilen i panelen Select a Variable för att expandera Group Iterator
    - Välj <> JSON File Iteration
    - Klicka på det gröna JSON File Iteration pillret för att omvandla variabeln
      - Klicka på Select a Transformation och välj Get Value from JSON
      - Tryck på den gröna skylten
      - Skriv Radnummer i värdefältet och tryck på Enter.
      - Markera en annan transformation och välj Parse Number
      - Klicka på den gröna -symbolen
      - Markera en annan transformation och välj Add
      - Klicka på den gröna -symbolen
      - Ange 1 i värdefältet.
      - Klicka på Godkänn
  - Ange ett kolon efter den första JSON File Iteration:
  - cv-Time Stamp Column Letter - variabel som finns i panelen Variabler under Kedjevariabler
  - JSON File Iteration - vi använder iterationens radnummer plus ett för att ange regionen som data ska skrivas till. Vi lägger till en för att ta hänsyn till rubriken.
    - Följ samma steg som ovan för den andra JSON File Iteration

Spara kommandot

Steg 4: Lägg till felgren för processen Uppdatera anslutningar

Vi ska nu lägga till de kommandon som ska användas för att generera och fylla i de värden som ska matas tillbaka till arket för att ange att processen för uppdatering av anslutningar misslyckades. Den här gången kopierar vi de två kommandon som vi redan har skapat för att effektivisera processen.

Klicka på kommandot Populate Data Upload Failure & Time Stamp och klicka på knappen Copy
Anslut Kör kedja - Uppdatera anslutningar Kedjehändelse till Fyll i dataladdningsfel och tidsstämpel - Kopiera Kommando som just kopierades
Dubbelklicka på länken för att redigera länkvillkoren
- Klicka på alternativet för misslyckande
Dubbelklicka på Populate Data Upload Failure & Time Stamp - Copy Command för att konfigurera det
- Namnge kommandot: Fyll i uppdatering av felaktig anslutning och tidsstämpel
- I fältet Text uppdaterar du följande information:
```
Uppdatering av anslutning gick inte,(*<System.DateTime>*)
```
  - Du kommer att märka att variabeln System Date and Time inte behöver uppdateras eller läggas till
Spara kommandot

Steg 5: Skriv Refresh Connection Failure tillbaka till arket

Vi kommer nu att använda kommandot Write Sheet Data för att skriva tillbaka den information som fylldes i i föregående kommando till kontrollarket. Detta kommer att ge våra slutanvändare insyn i uppdateringsanslutningsfel och datumet då det gick inte. Än en gång kopierar vi ett tidigare skapat kommando för att spara tid.

Klicka på kommandot Write Sheet Data - Data Upload Failure och klicka på knappen Copy
Anslut Fylla i Uppdatera Anslutningsfel & Tidsstämpel Kommando till Skriva arkdata - Fel i dataladdningen - Kopiera Kommando som just kopierades
Dubbelklicka på länken för att redigera länkvillkoren
- Klicka på alternativet för misslyckande
Dubbelklicka på Write Sheet Data - Data Upload Failure - Copy Command för att konfigurera det
- Namnge kommandot: Write Sheet Data - Refresh Connection Failure
- Klicka på fältet Data File och ta bort variabeln
  - Klicka på nedåtpilen i panelen Select a Variable för att expandera Populate Refresh Connection Failure & Time Stamp
  - Välj Skapad arkivering utdata
    - Du kommer att märka att de andra fälten har fyllts i med samma information som fylldes i för kommandot Write Sheet Data - Data Upload Failure, allt annat förblir detsamma
Spara kommandot

Steg 6: Testa övningen

Nu när kedjan är klar kan du testa resultatet.

Publicera kedjan
För att testa våra nya kommandon kommer vi att tvinga fram ett fel genom att redigera vår ark
- Navigera till CLP Control Sheet Kalkylark i Workiva Platform
- Ta bort TableID-värdet i en av raderna
- Ta bort SpreadsheetID-värdet i en annan rad
Navigera tillbaka till CLP | Logging Failures within a Control Sheet Chain och klicka på Execute. Välj Kör kedja
När kedjan har slutförts, kontrollera att arbetsflödet har slutförts genom att markera nedanstående: