CLP - Protokollierung von Fehlern innerhalb eines Kontrollblatts – Supportcenter

Was passiert, wenn die Kette versagt? Es ist wichtig, dass die Endnutzer umfassend über die möglichen Folgen informiert werden. In diesem vernetzten Lernpfad werden wir unsere primäre Kette durch die Einbeziehung zusätzlicher Zweige erweitern, die zurück zu unserem Kontrollblatt kommunizieren und insbesondere alle Ausfälle anzeigen werden. Diese erweiterte Kette bietet eine zusätzliche Ebene der Transparenz, die es den Benutzern ermöglicht, das Datum der letzten erfolgreichen Ausführung des Befehls leicht zu erkennen. Darüber hinaus wird es einen klaren Überblick darüber geben, ob die Kette erfolgreich funktioniert hat oder ob Probleme aufgetreten sind. Diese Verbesserung stellt sicher, dass die Nutzer mit den notwendigen Informationen ausgestattet sind, um mögliche Störungen zu überwachen und umgehend zu beheben.

Primärer geschäftlicher Anwendungsfall	Orchestrierung von Berichtsworkflows von einem zentralen Standort aus Endnutzer erhalten Einblick in den Workflow-Status
Primäres Lernziel	Erfahren Sie, wie Sie die Fehlerverfolgung in Kettenkontrollblättern hinzufügen können. Kettenverzweigung lernen Kopieren von Befehlen lernen
Voraussetzungen	Vervollständigen Sie das CLP \| Ausführen von Prozessen und Protokollieren von Ergebnissen in einem Kontrollblatt
Unterstützende Vorlage	CLP \| Protokollierung von Fehlern innerhalb eines Kontrollblatts

Schritt 1: Vorhandene Kette bearbeiten

Navigieren Sie zum Chain Builder und suchen Sie die Kette CLP | Running Processes and Logging Results within a Control Sheet
Klicken Sie auf die Bleistift-Schaltfläche, um die Kette zu bearbeiten
Klicken Sie oben rechts auf Ketteneinstellungen
- Benennen Sie die Kette um: CLP | Protokollierung von Fehlern innerhalb eines Kontrollblatts
Rettet die Kette

Schritt 2: Fehlerhafte Verzweigung für Upload-Datenprozess hinzufügen

Nun fügen wir die Befehle hinzu, mit denen die Werte generiert und aufgefüllt werden, die an das Kontrollblatt zurückgegeben werden, um anzuzeigen, dass das Hochladen der Daten fehlgeschlagen ist. Der erste Schritt dazu ist die Erstellung der Datei mit dem Status und der Uhrzeit.

Fügen Sie einen Befehl zum Erstellen von Dateien aus dem File Utilities Connector in die Kettenübersicht ein.
Verbinden Sie den Run Chain - Upload Data Chain Event mit dem Create File Command
Doppelklicken Sie auf den Link, um die Linkbedingungen zu bearbeiten
- Klicken Sie auf die Fehleroption
  
  Nachdem die Fehleroption ausgewählt wurde, wird der Link rot, um anzuzeigen, dass die Kette nur mit diesem Zweig fortgesetzt wird, wenn das Kettenereignis "Kette ausführen - Daten hochladen" fehlschlägt.
Doppelklicken Sie auf den Befehl Datei erstellen, um ihn zu konfigurieren.
- Nennen Sie den Befehl: Daten-Upload-Fehler und Zeitstempel auffüllen
- Geben Sie in das Feld Text die folgenden Informationen ein:

Daten-Upload fehlgeschlagen,(*<System.DateTime>*)

- - Ersetzen Sie den Platzhalter (*System.DateTime*) durch die entsprechende Laufzeitvariable, die programmatisch das Datum und die Uhrzeit aus Chains bezieht
    - Erweitern Sie auf der linken Seite im Bereich Variable auswählen die Option „Laufzeit“.
    - Wählen Sie den Wert System.DateTime
Speichern Sie den Befehl

Schritt 3: Daten-Upload-Fehler in das Kontrollblatt zurückschreiben

Wir werden nun den Befehl Blattdaten schreiben verwenden, um die im vorherigen Befehl eingegebenen Informationen zurück in das Steuerblatt zu schreiben. Dadurch erhalten unsere Endnutzer einen Überblick über die fehlgeschlagenen Datenuploads und das Datum, an dem der Upload fehlgeschlagen ist.

Fügen Sie einen Befehl zum Schreiben von Blattdaten vom Workiva Connector zum Ketten-Canvas hinzu.
Verknüpfen Sie den Befehl Populate Data Upload Failure & Time Stamp mit dem Befehl Write Sheet Data
Doppelklicken Sie auf den Befehl, um ihn zu konfigurieren
- Nennen Sie den Befehl: Blattdaten schreiben - Datenupload fehlgeschlagen
- Klicken Sie auf das Feld Spreadsheet ID
  - Klicken Sie im Bereich Variable auswählen auf den Pfeil nach unten, um Kette zu erweitern
  - Wählen Sie die cv-Control Spreadsheet ID Chain Variable
- Klicken Sie auf das Feld Blatt-ID/Name
  - Klicken Sie im Bereich Variable auswählen auf den Pfeil nach unten, um Kette zu erweitern
  - Wählen Sie die cv-Control Sheet NameChain-Variable
- Klicken Sie auf das Feld Data File
  - Klicken Sie im Bereich Select a Variable auf den Abwärtspfeil, um die Option Populate Data Upload Failure & Time Stamp zu erweitern.
  - Wählen Sie die Ausgabe Erstellte Datei
- Das Feld Region wird mit einer Kombination aus Kettenvariablen und JSON-Ausgabe gefüllt, um der Kette mitzuteilen, in welche Zelle des Kontrollblatts sie für die aktuelle Iteration schreiben soll:
  - Klicken Sie auf das Feld Region und füllen Sie es mit den folgenden Angaben:
  - cv-Status Column Letter - die Variable befindet sich im Variables Panel unter Chain Variables
  - JSON File Iteration - wir verwenden die Zeilennummer der Iteration plus eins, um den Bereich anzugeben, in den die Daten geschrieben werden sollen. Wir fügen eine Zeile hinzu, um die Kopfzeile zu berücksichtigen.
    - Klicken Sie im Bereich Select a Variable auf den Abwärtspfeil, um Group Iterator zu erweitern.
    - Wählen Sie <> JSON-Datei-Iteration
    - Klicken Sie auf die grüne JSON File Iteration Pille, um die Variable zu transformieren
      - Klicken Sie auf Transformation auswählen und wählen Sie Get Value from JSON
      - Drücken Sie das grüne +-Zeichen
      - Geben Sie in das Wertfeld Zeilennummer ein und drücken Sie die Eingabetaste.
      - Wählen Sie eine andere Transformation und wählen Sie Parse Number
      - Klicken Sie auf das grüne +-Zeichen
      - Wählen Sie eine andere Transformation und wählen Sie Hinzufügen
      - Klicken Sie auf das grüne +-Zeichen
      - Geben Sie in das Feld "Wert" 1 ein.
      - Klicken Sie auf Akzeptieren
  - Geben Sie einen Doppelpunkt nach der ersten JSON File Iteration ein:
  - cv-Time Stamp Column Letter - diese Variable befindet sich im Variables Panel unter Chain Variables
  - JSON File Iteration - wir verwenden die Zeilennummer der Iteration plus eins, um den Bereich anzugeben, in den die Daten geschrieben werden sollen. Wir fügen eine Zeile hinzu, um die Kopfzeile zu berücksichtigen.
    - Führen Sie die gleichen Schritte wie oben für die zweite JSON-Datei-Iteration aus

Speichern Sie den Befehl

Schritt 4: Fügen Sie einen Fehlerzweig für den Prozess "Verbindungen aktualisieren" hinzu

Nun fügen wir die Befehle hinzu, die zum Generieren und Auffüllen der Werte verwendet werden, die an das Kontrollblatt zurückgegeben werden, um anzuzeigen, dass der Prozess der Verbindungsauffrischung fehlgeschlagen ist. Dieses Mal werden wir die beiden bereits erstellten Befehle kopieren, um den Prozess zu vereinfachen.

Klicken Sie auf den Befehl Populate Data Upload Failure & Time Stamp und klicken Sie auf die Schaltfläche Copy
Verbinden Sie die Run Chain - Refresh Connections Chain Event mit der Populate Data Upload Failure & Time Stamp - Copy Command that was just copied
Doppelklicken Sie auf den Link, um die Linkbedingungen zu bearbeiten
- Klicken Sie auf die Option Fehler
Doppelklicken Sie auf den Befehl Populate Data Upload Failure & Time Stamp - Copy, um ihn zu konfigurieren.
- Nennen Sie den Befehl: Verbindungsfehler und Zeitstempel aktualisieren
- Geben Sie in das Feld Text die folgenden Informationen ein:
```
Verbindung aktualisieren fehlgeschlagen,(*<System.DateTime>*)
```
  - Sie werden feststellen, dass die Variable Systemdatum und -zeit nicht aktualisiert oder hinzugefügt werden muss
Speichern Sie den Befehl

Schritt 5: Schreiben Sie "Verbindungsfehler aktualisieren" zurück auf das Kontrollblatt

Wir werden nun den Befehl Blattdaten schreiben verwenden, um die im vorherigen Befehl eingegebenen Informationen zurück in das Steuerblatt zu schreiben. Dadurch erhalten unsere Endbenutzer einen Überblick über die fehlgeschlagenen Aktualisierungsverbindungen und das Datum, an dem sie fehlgeschlagen sind. Auch hier kopieren wir einen zuvor erstellten Befehl, um Zeit zu sparen.

Klicken Sie auf den Befehl Write Sheet Data - Data Upload Failure und klicken Sie auf die Schaltfläche Copy
Verbinden Sie den Populate Refresh Connection Failure & Time Stamp Befehl mit dem Write Sheet Data - Data Upload Failure - Kopieren Befehl, der gerade kopiert wurde
Doppelklicken Sie auf den Link, um die Linkbedingungen zu bearbeiten
- Klicken Sie auf die Option Fehler
Doppelklicken Sie auf den Befehl Write Sheet Data - Data Upload Failure - Copy , um ihn zu konfigurieren.
- Nennen Sie den Befehl: Blattdaten schreiben - Verbindung aktualisieren Fehlschlag
- Klicken Sie auf das Feld Data File und löschen Sie die Variable
  - Klicken Sie im Bereich Select a Variable auf den Abwärtspfeil, um Populate Refresh Connection Failure & Time Stamp zu erweitern.
  - Wählen Sie die Ausgabe Erstellte Datei
    - Sie werden feststellen, dass die anderen Felder mit denselben Informationen ausgefüllt wurden, die für den Befehl Blattdaten schreiben - Daten-Upload-Fehler eingegeben wurden, alles andere bleibt gleich
Speichern Sie den Befehl

Schritt 6: Testen Sie die Übung

Testen Sie nun, nachdem die Kette vollständig ist, das Ergebnis.

Veröffentlichen Sie die Kette
Um unsere neuen Befehle zu testen, werden wir einen Fehler erzwingen, indem wir unser Kontrollblatt bearbeiten
- Navigieren Sie zum Arbeitsblatt CLP Control Sheet in der Workiva-Plattform
- Löschen des TableID-Wertes in einer der Zeilen
- Löschen Sie den SpreadsheetID-Wert in einer anderen Zeile
Navigieren Sie zurück zur Kette CLP | Protokollierung von Fehlern innerhalb eines Kontrollblatts und klicken Sie auf Ausführen. Wählen SieKette ausführen
Sobald die Kette abgeschlossen ist, überprüfen Sie, ob der Arbeitsablauf abgeschlossen ist, indem Sie die unten stehenden Punkte überprüfen:

Fehlerhafter Zweig für fehlgeschlagenen Daten-Upload:

Fehlerhafte Verzweigung bei fehlgeschlagener Aktualisierung der Verbindungen:

Die Ergebnisse werden auf dem Kontrollblatt festgehalten, wobei Misserfolge und Erfolge angegeben werden:

Das war erfolgreich! Sie haben die Serie Data Centralization Connected Learning Path abgeschlossen! Fordern Sie sich selbst noch mehr heraus mit den Transformation Connected Learning Paths.

Support

Community

Workiva Support Center