Workiva-ondersteuningscentrum

Wat gebeurt er als de ketting faalt? Het is essentieel dat eindgebruikers volledig op de hoogte zijn van de mogelijke resultaten. In dit Connected Learning Path zullen we onze primaire ketting verbeteren door extra takken op te nemen die terug naar ons controleblad communiceren en specifiek eventuele fouten aangeven. Deze uitgebreide Chain zal een extra transparantielaag bieden, zodat gebruikers gemakkelijk de laatste succesvolle uitvoeringsdatum van de opdracht kunnen identificeren. Bovendien zal het duidelijk inzichtelijk maken of de Keten succesvol heeft gefunctioneerd of op problemen is gestuit. Deze verbetering zorgt ervoor dat gebruikers goed zijn uitgerust met de nodige informatie om eventuele storingen te controleren en snel aan te pakken.

Stap 1: Bestaande ketting bewerken

• Navigeer naar Chain Builder en zoek de Chain CLP | Processen uitvoeren en resultaten registreren binnen een controleblad
• Klik op de potloodknop om de ketting te bewerken
• Klik op Keteninstellingen in de rechterbovenhoek
  • Hernoem de ketting: CLP | Storingen binnen een controleblad registreren
• Red de Ketting

Stap 2: Fouttak toevoegen voor Upload Data-proces

We zullen nu de opdrachten toevoegen die gebruikt zullen worden om de waarden te genereren en in te vullen die teruggestuurd zullen worden naar het controleblad om aan te geven dat het uploaden van gegevens mislukt is. De eerste stap om dit te doen is om het bestand met de status en tijd aan te maken.

• Voeg een commando Bestand maken toe van de Connector Bestandshulpprogramma's aan het ketting-doek
• Verbind de gebeurtenis Run Chain - Upload Data met de opdracht Bestand maken
• Dubbelklik op de link om de linkvoorwaarden te bewerken
  • Klik op de faaloptie
    
    Nadat de faaloptie is geselecteerd, zal de link rood zijn, wat aangeeft dat de ketting alleen met deze tak zal doorgaan als de gebeurtenis "Keten uitvoeren - gegevens uploaden" faalt
    
• Dubbelklik op de opdracht Bestand maken om het te configureren
  • Geef de opdracht een naam: Gegevensupload mislukt en tijdstempel invullen
  • Typ in het veld Text de volgende informatie:

Gegevensupload mislukt,(*<System.DateTime>*)

• • • Vervang de plaatshouder (*System.DateTime*) door de juiste Runtimevariabele, hierdoor worden de datum en tijd programmatisch uit Chains gehaald
      • Vouw in het paneel Select a Variable aan de linkerkant Runtime uit
      • Selecteer de System.DateTime waarde
• De opdracht opslaan

Stap 3: Gegevensuploadfout terugschrijven naar het controleblad

We gaan nu het commando Bladgegevens schrijven gebruiken om de informatie die in het vorige commando is ingevuld, terug te schrijven naar het controleblad. Dit geeft onze eindgebruikers inzicht in de mislukte uploads van gegevens en de datum waarop deze mislukt zijn.

• Een commando toevoegen Bladgegevens schrijven van de Workiva Connector aan het kettingdoek
• Koppel de opdracht Populate Data Upload Failure & Time Stamp aan de opdracht Write Sheet Data
• Dubbelklik op de opdracht om deze te configureren
  • Noem het commando: Schrijf bladgegevens - mislukte gegevensupload
  • Klik op het veld Spreadsheet-ID
    • Klik in het paneel Selecteer een variabele op de pijl omlaag om Chain uit te vouwen
    • Selecteer de cv-Control Spreadsheet ID Ketenvariabele
  • Klik op het veld Blad-ID/Naam
    • Klik in het paneel Selecteer een variabele op de pijl omlaag om Chain uit te vouwen
    • Selecteer de cv-Controleblad Naam Ketenvariabele
  • Klik op het veld Gegevensbestand
    • Klik in het paneel Selecteer een variabele op de pijl omlaag om Populate Data Upload Failure & Time Stamp (Gegevensuploadfout en tijdstempel vullen) uit te vouwen
    • Selecteer de uitvoer Aangemaakt bestand
  • Het veld Regio wordt gevuld met een combinatie van Kettingvariabelen en JSON-uitvoer om de Ketting te vertellen naar welke specifieke cel in het controleblad geschreven moet worden voor de huidige iteratie:
    • Klik op het veld Regio en vul het onderstaande in:
      
    • cv-Status Kolomletter - variabele gevonden in het Variabelenpaneel onder Ketenvariabelen
    • JSON File Iteration - we gebruiken het rijnummer van de iteratie plus één, om het gebied te specificeren waar de gegevens naartoe geschreven moeten worden. We voegen er één toe om rekening te houden met de header-rij.
      • Klik in het paneel Select a Variable op de pijl omlaag om Group Iterator uit te vouwen
      • Selecteer <> JSON Bestandsinterval
      • Klik op de groene JSON File Iteration pil om de variabele te transformeren
        • Klik op Selecteer een transformatie en kies Haal waarde uit JSON
        • Druk op het groene + teken
        • Typ in het waardeveld Row Number en druk op enter
        • Selecteer een andere transformatie en kies Parse Number
        • Klik op het groene + teken
        • Selecteer een andere transformatie en kies Toevoegen
        • Klik op het groene + teken
        • Voer in het waardeveld 1 in
        • Klik op Accepteren
          
    • Voer een dubbele punt in na de eerste JSON bestandsinterval:
    • cv-Tijdstempel Kolom Letter - variabele gevonden in het Variabelenpaneel onder Kettingvariabelen
    • JSON File Iteration - we gebruiken het rijnummer van de iteratie plus één, om het gebied te specificeren waar de gegevens naartoe geschreven moeten worden. We voegen er één toe om rekening te houden met de header-rij.
      
      • Volg dezelfde stappen als hierboven voor de tweede JSON-bestandsinterval

• De opdracht opslaan

Stap 4: Fouttak toevoegen voor proces Verbindingen vernieuwen

We zullen nu de opdrachten toevoegen die gebruikt zullen worden om de waarden te genereren en in te vullen die teruggestuurd zullen worden naar het controleblad om aan te geven dat het verversen van verbindingen is mislukt. Deze keer kopiëren we de twee commando's die we al gemaakt hebben om het proces te stroomlijnen.

• Klik op de opdracht Populate Data Upload Failure & Time Stamp en klik op de knop Copy
  
• Verbind de Run Chain - Vernieuw Verbindingen Ketengebeurtenis naar de Populate Data Upload Failure & Time Stamp - Kopieer Opdracht die zojuist gekopieerd is
• Dubbelklik op de link om de linkvoorwaarden te bewerken
  • Klik op de optie mislukking
    
• Dubbelklik op de opdracht Populate Data Upload Failure & Time Stamp - Copy om deze te configureren
  • Geef de opdracht een naam: Vernieuwen mislukte verbinding en tijdstempel invullen
  • Werk in het veld Text de volgende informatie bij:

    Vernieuwen verbinding mislukt,(*<System.DateTime>*)

    • U zult zien dat de variabele System Date and Time niet hoeft te worden bijgewerkt of toegevoegd
• De opdracht opslaan

Stap 5: Schrijf Vernieuwen Verbindingsfout terug naar het Controleblad

We gaan nu het commando Bladgegevens schrijven gebruiken om de informatie die in het vorige commando is ingevuld, terug te schrijven naar het controleblad. Dit geeft onze eindgebruikers inzicht in de mislukte verversingsverbindingen en de datum waarop deze mislukten. We kopiëren opnieuw een eerder gemaakt commando om tijd te besparen.

• Klik op de opdracht Bladgegevens schrijven - mislukte gegevensupload en klik op de knop kopiëren
  
• Verbind de opdracht Bevolken Vernieuwen verbindingsfout & tijdstempel met de opdracht Schrijf bladgegevens - mislukte gegevensupload - Kopieer de opdracht die zojuist is gekopieerd
• Dubbelklik op de link om de linkvoorwaarden te bewerken
  • Klik op de optie mislukking
    
• Dubbelklik op de opdracht Schrijfbladgegevens - Storing gegevensupload - Kopieer om deze te configureren
  • Geef het commando een naam: Schrijf bladgegevens - Verbinding verversen mislukt
  • Klik op het veld Data File en verwijder de variabele
    • Klik in het paneel Selecteer een variabele op de pijl omlaag om Populate Refresh Connection Failure & Time Stamp (Vernieuwingsfout en tijdstempel invullen) uit te vouwen
    • Selecteer de uitvoer Aangemaakt bestand
      • U zult zien dat de andere velden zijn ingevuld met dezelfde informatie die is ingevuld voor de opdracht Gegevens schrijfblad - mislukte gegevensupload, al het andere blijft hetzelfde
• De opdracht opslaan

Stap 6: De oefening testen

Nu de Chain compleet is, kunt u het resultaat testen.

• Publiceer de keten
• Om onze nieuwe commando's te testen, zullen we een storing forceren door ons controleblad te bewerken
  • Navigeer naar het CLP Controleblad Werkblad in het Workiva Platform
  • Verwijder de TableID waarde in een van de rijen
  • De waarde SpreadsheetID in een andere rij verwijderen
    
• Navigeer terug naar de CLP | Storingen registreren binnen een Control Sheet (Controleblad) Chain (Keten) en klik op Execute (Uitvoeren). Selecteer Run Ketting
• Zodra de Chain is voltooid, controleert u of de workflow is voltooid door het onderstaande aan te vinken:

Fouttak gevolgd voor mislukte gegevensupload:

Storingstak gevolgd voor Storing verversen verbindingen:

Resultaten worden op het controleformulier geschreven met vermelding van mislukkingen en successen:

Gefeliciteerd! U hebt de Data Centralization Connected Leerpad-serie afgerond! Daag uzelf nog meer uit met de Transformation Connected Learning Paths.