Die Verwendung von Kontrollblättern ist der effizienteste Weg, um verschiedene Variablen zu speichern, die für einen einzelnen Arbeitsablauf verwendet werden. Kontrollblätter sind nützlich, damit Endbenutzer Eingaben für eine Kette festlegen können, ohne die Kette selbst bearbeiten zu müssen. Um ein Kontrollblatt zu verwenden, müssen wir zunächst verstehen, wie ein Kontrollblatt aufgebaut ist und wie man Daten aus dem Kontrollblatt liest. In diesem Connected Learning Path werden wir ein Kontrollblatt einrichten und einen Workiva-Befehl verwenden, um Daten aus dem Kontrollblatt abzurufen.
| Primärer geschäftlicher Anwendungsfall |
Orchestrierung von Berichtsworkflows von einem zentralen Standort aus Vereinfachung der Workflow-Verwaltung für Endbenutzer |
| Primäres Lernziel | Lernen Sie, wie man ein Kontrollblatt strukturiert und Daten aus einem Kontrollblatt mit Hilfe von Chains abruft |
| Voraussetzungen |
Konfigurieren Sie Workiva Connector Vervollständigen Sie das CLP | Daten in einen Tabellenpfad hochladen Füllen Sie das CLP | Liste der Verbindungen aktualisieren Berechtigungen für das Spreadsheet für den zugehörigen Workiva API Grant User erteilen |
| Unterstützende Vorlage | CLP | Lesen von einem Kontrollblatt |
Schritt 1: Erstellen eines Kontrollblatts
Wir werden ein Kontrollblatt erstellen, um Variablen zu speichern, die zum Hochladen von Daten in eine Wdata-Tabelle verwendet werden, und dann die Verbindungen für diese Daten aktualisieren. Anstatt diese Variablen jedes Mal, wenn die Kette läuft, als Runtime Inputs zu spezifizieren, fügen wir unsere Variablen zu einem Kontrollblatt hinzu, das die Kette während ihres gesamten Laufs liest und verwendet.
Während dieses Kontrollblatt das Hochladen mehrerer Dateien in eine einzelne Wdata-Tabelle und das Aktualisieren von Verbindungen in einem einzelnen Tabellenblatt demonstriert, kann der Prozess auf mehrere Tabellen und Tabellenblätter erweitert werden, indem einfach die eindeutige ID der Tabelle oder des Tabellenblatts zum Kontrollblatt hinzugefügt wird.
- Navigieren Sie zur Workiva-Plattform, um ein neues Tabellenblatt zu erstellen
- Klicken Sie auf Erstellen und wählen Sie Tabellenkalkulation
- Benennen Sie die Kalkulationstabelle: CLP-Kontrollblatt
- Benennen Sie das erste Blatt: Blatt für die Primärkontrolle
- Erstellen Sie im Primärkontrollblatt die folgenden Überschriften
- ActiveFlag
- Diese Spalte gibt an, ob der Workflow für diese Zeile im Kontrollblatt ausgeführt werden muss
- Dateiname
- Diese Spalte gibt den Namen des Datensatzes an, wie er in der Wdata-Tabelle erscheinen wird
- TabelleID
- ID der Tabelle in Wdata, in die die Daten hochgeladen werden sollen
- TabellenkalkulationID
- ID der Tabellenkalkulation, in der die Daten aktualisiert werden sollen
- FileLocation
- Ort der herunterzuladenden Datei
- ActiveFlag
- Füllen Sie das Arbeitsblatt mit den folgenden Werten, indem Sie in die Spalte <TableID> die ID der CLP-Mitarbeiter-Detailtabelle und in die Spalte <SpreadsheetID> die ID der CLP-Mitarbeiter-Übersichtstabelle eintragen. Diese IDs wurden in früheren Connected Learning Paths erstellt.
ActiveFlag,FileName,TableID,FileLocation
TRUE,EmployeeDetailsP01,<TableID>,<SpreadsheetID>,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P01.csv
TRUE,EmployeeDetailsP02,<TableID>,<SpreadsheetID>,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P02.csv
TRUE,EmployeeDetailsP03,<TableID>,<SpreadsheetID>,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P03.csv
Schritt 2: Tabellenkalkulationsberechtigungen aktualisieren
Um eine effektive Kommunikation zwischen einem Workiva-Befehl und einem Spreadsheet zu gewährleisten, muss der API Grant einem Benutzer zugeordnet werden, der Eigentümer- oder Editierrechte auf dem Spreadsheet besitzt.
- Klicken Sie in der Tabellenkalkulation CLP-Kontrollblatt auf Datei in der Multifunktionsleiste am oberen Rand
- Klicken Sie auf Berechtigungen, dann Tabellenkalkulation
- Zugriff auf den Workiva-Benutzer, der mit der konfigurierten API-Berechtigung innerhalb der Workiva-Verbindung verbunden ist
Schritt 3: Eine Kette erstellen
Um die Variablen, die wir im Kontrollblatt erstellt haben, zu verwenden, erstellen wir eine Kette, die sie ausliest. Da wir immer dasselbe Arbeitsblatt und dieselbe Tabelle verwenden werden, richten wir Kettenvariablen ein, um diese Details für einen konsistenten Zugriff zu speichern.
- Navigieren Sie zu Chain Builder
- Erstellen Sie eine neue Kette
- Benennen Sie die Kette: CLP | Lesen von einem Kontrollblatt
- Klicken Sie unter Kettenvariablen zweimal auf das Pluszeichen, um zwei Kettenvariablen zu erstellen, und konfigurieren Sie sie wie unten dargestellt:
- Variable 1:
- Typ: Chain-Variable (CV)
- Name: cv-ID des Kontrollen-Arbeitsblatts
- Wert: Eingabe der ID des CLP-Kontroll-Arbeitsblatts
- Um die Spreadsheet-ID zu finden, navigieren Sie zum Spreadsheet CLP Control Sheet
- Wählen Sie in der URL die Spreadsheet-ID aus, die sich nach "spreadsheet/" und vor "/sheet" befindet.
- Die Tabellenkalkulations-ID ist hier zum Beispiel fett gedruckt: app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/6c4a23966c3c4a10a3178ae5791db7fd/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13
- Um die Spreadsheet-ID zu finden, navigieren Sie zum Spreadsheet CLP Control Sheet
- Variable 2:
- Typ: Chain-Variable (CV)
- Name: cv-Kontrollblatt Name
- Wert: Primäres Kontrollblatt
- Variable 1:
- Rettet die Kette
Schritt 4: Blattdaten abrufen
Wir verwenden den Befehl Get Sheet Data, um die Kette zu starten. Auf diese Weise können wir Informationen aus dem Kontrollblatt abrufen und an die Kette weiterleiten.
- Fügen Sie einen Get Sheet Data Befehl aus dem Workiva Connector in den Startbereich der Kette ein
- Doppelklicken Sie auf den Befehl, um ihn zu konfigurieren
- Klicken Sie auf das Feld Spreadsheet ID
- Klicken Sie im Bereich Select a Variable auf den Abwärtspfeil, um Chain zu erweitern.
- Wählen Sie die cv-Control Spreadsheet ID Chain Variable
- Klicken Sie auf das Feld Blatt-ID/Name
- Klicken Sie im Bereich Select a Variable auf den Abwärtspfeil, um Chain zu erweitern.
- Wählen Sie die cv-Control Sheet NameChain-Variable
- Region: Es steht Ihnen frei, eine Region anzugeben. Bleibt es bei ":", werden die Daten im gesamten Spreadsheet abgerufen.
- Klicken Sie auf das Feld Spreadsheet ID
- Speichern Sie den Befehl
Schritt 5: 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 Knoten Get Sheet Data, um den Erfolg zu überprüfen.
- Der Befehl sollte eine .csv-Ausgabe der Daten in dem angegebenen Blatt innerhalb der Kalkulationstabelle liefern. Sie sehen die .csv-Datei, wenn Sie auf das Eyeball-Symbol klicken
Erfahren Sie mehr über die Verwendung von Kontrollblättern, indem Sie den nächsten Pfad durchlaufen: Verwendung von Werten aus einem Kontrollblatt!