Workiva Support Center

Schritt 1: Vorhandene Kette bearbeiten

• Navigieren Sie zum Chain Builder und suchen Sie die Kette CLP | Lesen von einem Kontrollblatt
• Klicken Sie auf die Bleistift-Schaltfläche, um die Kette zu bearbeiten
• Klicken Sie oben rechts auf Ketteneinstellungen  
  • Benennen Sie die Kette um: CLP | Werte aus einem Kontrollblatt verwenden
• Rettet die Kette

Schritt 2: Konvertieren Sie das Kontrollblatt in JSON

Um die Werte in einem Kontrollblatt effektiv zu nutzen, konvertieren wir die Ausgabe des Befehls Get Sheet Data vom CSV-Format in JSON. Durch diese Konvertierung werden Schlüssel-Wert-Paare zwischen den Überschriften im Kontrollblatt und den entsprechenden Werten in den Zeilen unter jeder Überschrift gebildet, was eine effiziente Iteration ermöglicht.

• Fügen Sie einen CSV-zu-JSON-Befehl vom JSON Connector zum Chain Canvas hinzu.
• Verbinden Sie den Befehl Blattdaten abrufen mit dem Befehl CSV zu JSON
• Doppelklicken Sie auf den Befehl, um ihn zu konfigurieren
  • Nennen Sie den Befehl: Steuerblatt in JSON konvertieren
  • Klicken Sie auf das Feld Eingabedatei
    • Klicken Sie im Bereich Select a Variable auf den Abwärtspfeil, um Get Sheet Data zu erweitern.
    • Wählen Sie die Ausgabe Daten
  • Belassen Sie das Feld für das Trennzeichen auf Komma (,)
  • Speichern Sie den Befehl
    

Schritt 3: Hinzufügen einer Befehlsgruppe

Fügen Sie der Kette eine Befehlsgruppe hinzu, um die Iteration über jede Zeile im Kontrollblatt zu ermöglichen. So können wir jede Zeile des Kontrollblatts durch die Reihe der Befehle für die Gruppe schieben.

• Fügen Sie eine Befehlsgruppe zur Kettenleinwand hinzu.
• Verbinden Sie den Befehl Steuerblatt in JSON konvertieren mit dem Abschnitt In der Befehlsgruppe
• Doppelklicken Sie auf die Befehlsgruppe, um sie zu konfigurieren
  • Benennen Sie die Gruppe: Kontrollblatt Iterator
  • Navigieren Sie zur Registerkarte Iteratoren
    • Aktivieren Sie das Kästchen Iterationen und klicken Sie auf das Feld Iterationen
      
      • Klicken Sie im Bereich Variable auswählen auf den Pfeil nach unten, um Kontrollblatt in JSON konvertieren zu erweitern
      • Wählen Sie die Ausgabe JSON 
  • Speichern Sie den Befehl

Nachdem der Befehl nun konfiguriert wurde, wird er jede Zeile des Kontrollblatts durchlaufen und für jede Zeile eine Ausgabe liefern.

Schritt 4: Hinzufügen eines bedingten Befehls

Innerhalb eines Kontrollblatts können die Benutzer festlegen, ob eine bestimmte Zeile innerhalb eines Workflows ausgeführt werden soll. Dies wird über die Spalte ActiveFlag genutzt. Wir werden einen bedingten Befehl verwenden, um zu bestimmen, ob der Arbeitsablauf für jede Zeile im Kontrollblatt fortgesetzt werden muss.

• Hinzufügen eines Bedingten Befehls Kettenereignisses zum Ketten-Canvas
• Verbinden Sie die Gruppe Start innerhalb der Gruppe Control Sheet Iterator mit dem Befehl Conditional
  
• Doppelklicken Sie auf den Befehl, um ihn zu konfigurieren
  • Nennen Sie den Befehl: Aktive Flagge?
  • Belassen Sie die Bedingung AND und klicken Sie auf die Schaltfläche + RULE
  • Vergewissern Sie sich, dass der Datentyp auf String eingestellt ist, und ändern Sie die zu testende Operation von Is Blank auf =
  • Klicken Sie in das offene Feld auf der linken Seite des Befehls (der zu testende Wert)
    • 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 Wertefeld die Überschrift ActiveFlag genau so ein, wie sie im Kontrollblatt steht, und drücken Sie die Eingabetaste
      • Wählen Sie eine andere Transformation und wählen Sie Lowercase
      • Drücken Sie das grüne +-Zeichen
      • Klicken Sie auf Akzeptieren

• • Zurück im Befehl Conditional, geben Sie auf der rechten Seite (dem zu vergleichenden Wert) das Wort true ein.
    • Vergewissern Sie sich, dass dies in Kleinbuchstaben geschieht, da die zuvor angewandte Variablentransformation dazu führt, dass der Wert der aktiven Markierung ausschließlich in Kleinbuchstaben angegeben wird. 
• Speichern Sie den Befehl

Schritt 5: Übergabe der Ausgaben an einen Befehl

Zu diesem Zeitpunkt ist der Kontrollblatt-Iterator so eingerichtet, dass er Werte für jeden Befehl liefert, der im Gruppenstart der Befehlsgruppe vorhanden ist. Wir werden einen Handlebars-Befehl als Platzhalter für die Anzeige der abgerufenen Werte verwenden, der auch iterativ in nachgeschalteten Befehlen verwendet werden kann.

• Fügen Sie eine Render-Textvorlage aus dem Handlebars Connector zum Chain Canvas hinzu.
• Verbinden Sie die Active Flag? Befehl zur Textvorlage rendern Befehl
• Doppelklicken Sie auf den Befehl, um ihn zu konfigurieren
  
  • Benennen Sie den Befehl: Erfassen von Steuerblatt-Werten
  • Geben Sie in das Feld Vorlage die folgenden Informationen ein:
    • Obere Reihe: Kontrollblatt Informationen
    • Zweite Zeile: Dateiname: <JSON-Datei-Iteration>
      • Ersetzen Sie die <JSON> im Bereich Variable auswählen und klicken Sie auf den Pfeil nach unten, um Gruppen-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 Wertefeld FileName genau so ein, wie es im Kontrollblatt steht, und drücken Sie die Eingabetaste
        • Klicken Sie auf Akzeptieren

• • Wiederholen Sie die Schritte für die dritte, vierte und fünfte Reihe
    • Ersetzen Sie den Platzhalter <JSON File Iteration> durch die Variable aus dem Kontrollblatt.
      • Tabellen-ID: <JSON File Iteration>
        •  Befolgen Sie die gleichen Schritte wie zuvor, aber verwenden Sie TableID anstelle von FileName.
      • Arbeitsblatt-ID: <JSON File Iteration>
        •  Befolgen Sie die gleichen Schritte wie zuvor, aber verwenden Sie SpreadsheetID anstelle von FileName.
      • Speicherort der Datei: <JSON File Iteration>
        •  Befolgen Sie die gleichen Schritte wie zuvor, aber verwenden Sie FileLocation anstelle von FileName.
• Speichern Sie den Befehl

Hinweis: Führen Sie die beschriebenen Schritte aus, um eine beliebige Kopfzeile zu extrahieren und die entsprechenden Zeilenwerte aus einem Kontrollblatt abzurufen.

Schritt 6: Testen Sie die Übung

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

• Veröffentlichen Sie die Kette
• Klicken Sie auf Execute und wählen Sie dann Run Chain
• Sobald die Kette abgeschlossen ist, klicken Sie auf den Befehl Capture Control Sheet Values , um den Erfolg zu überprüfen.
  • Lassen Sie die Kette vollständig ablaufen, bevor Sie auf den Befehl
• Es wird ein Feld mit der Bezeichnung Wert 1
  • Wenn Sie auf dieses Feld klicken, wird angezeigt, dass der Befehl drei verschiedene Werte verarbeitet hat; diese Werte sind die drei Datenzeilen aus dem Kontrollblatt
• Klicken Sie auf das Feld Log für jeden einzelnen Wert und überprüfen Sie, ob er mit den Werten im Kontrollblatt übereinstimmt.

Wert 1:

Wert 2:

Wert 3:

Erfahren Sie mehr über die Verwendung von Kontrollblättern, indem Sie den nächsten Pfad durchlaufen: Ausführen von Prozessen und Protokollieren von Ergebnissen in einem Kontrollblatt!