Workiva Support Center

Haben Sie das Chains Foundations Webinar gesehen? Möchten Sie in Ihrem eigenen Tempo vorankommen? In diesem Connected Learning Path werden wir eine Kette erstellen, die Daten von einer Quelle herunterlädt, in eine Wdata-Tabelle hochlädt und Verbindungen aktualisiert. Dabei folgen wir den Schritten aus dem Chains Foundations Webinar.

Schritt 1: Erstellen einer Kette

Um die Übertragung unserer Quelldaten in unsere Endberichte zu automatisieren, müssen wir zunächst eine Kette erstellen, die den Prozess von Anfang bis Ende orchestriert. Da wir immer dieselbe Kalkulationstabelle und Tabelle verwenden werden, werden wir Kettenvariablen einrichten, um diese Details für einen konsistenten Zugriff zu speichern.

1. Erstellen Sie eine neue Kette und benennen Sie die Kette: CLP | Chains Foundations.

2. Unter Kettenvariablen klicken Sie zweimal auf das Pluszeichen, um zwei Kettenvariablen zu erstellen und sie wie unten beschrieben zu konfigurieren:

   Variable 1:

   • Typ: Kettenvariable (cv)
   • Name: cv-Arbeitsblatt-ID
   • Wert:Die ID des Tabellenblatt "CLP-Unternehmensausgaben nach Abteilung", das in Wdata Foundations CLP erstellt wurde.
   • So finden Sie die Spreadsheet-ID:
     1. Navigieren Sie zum Arbeitsblatt CLP Ausgaben des Unternehmens nach Abteilungen.
     2. Wählen Sie in der URL die Tabellenkalkulations-ID aus, die sich nach "spreadsheet/" und vor "/sheet" befindet. 
        Die Spreadsheet-ID ist hier beispielsweise fett gedruckt: app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/6c4a23966c3c4a10a3178ae5791db7fd/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13

   Variable 2:

   • Typ: Kettenvariable (cv)
   • Name: cv-Tabelle ID
   • Wert: geben Sie die ID der CLP-Unternehmens-Ausgabetabelle ein.
   • So finden Sie die Tabellen-ID:
     1. Navigieren Sie zurCLP Company Spend Table.
     2. Wählen Sie in der URL die Tabellen-ID, die nach "table/" zu finden ist.
        Zum Beispiel wird die Tabellen-ID hier fett dargestellt: app.wdesk.com/s/wdata/a/QWNjb3VudB8yMDkwNzExMDQ0/tables/16aba1634ead43a29df8f839422582f0
3. Speichern Sie die Kette.

Schritt 2: Datei herunterladen

Der Befehl HTTP Anfrage Get wird verwendet, um die Datei herunterzuladen, die in die Tabelle hochgeladen werden soll. Wir haben Dateien online gehostet, die die Kette herunterladen kann, um das Herunterladen von Dateien aus der Cloud zu demonstrieren. Um diesen Prozess dynamisch zu gestalten, fügen wir der URL den aktuellen Zeitraum hinzu, der dem Monat entspricht, in dem wir uns befinden, und stellen sicher, dass wir den aktuellen Datensatz abrufen.

1. Hinzufügen eines Befehls Get aus dem Konnektor HTTP Anfrage in den Startbereich.
2. Doppelklicken Sie auf den Befehl, um ihn zu konfigurieren.
   1. Füllen Sie das Feld URL mit dem unten stehenden Inhalt und verwenden Sie eine Variable zur Generierung des aktuellen Monats, der dem Zeitraum entspricht:
      https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/Webinars/ERP-P <System.DateTime>.csv.
   2. Ersetzen Sie <System.DateTime> durch die Laufzeitvariable für Datum und Uhrzeit des Systems.
   3. Klicken Sie im Bereich Eine Variable auswählen auf den Pfeil nach unten, um Laufzeit zu erweitern.
   4. Wählen Sie System.DateTime.
   5. Klicken Sie auf die Variable System.DateTime, um sie umzuwandeln. Verwenden Sie die folgenden Werte:
      1. Für Wählen Sie Transformation:, wählen Sie Datum/Zeit analysieren.
      2. Klicken Sie auf die Schaltfläche +.
      3. Für Format dropdown:, wählen Sie ISO Extended (Platform Standard).
      4. Für Ausgabe des Datumsformats:, wählen Sie %m.
         Diese Ausgabe bedeutet, dass wir nur den zweistelligen Monat aus dem Systemdatum und der Uhrzeit erhalten.
         Erfahren Sie mehr über gängige Datums- und Zeitumwandlungen unter.
      5. In den Feldern Eingabe Datum Zeitzone und Ausgabe Datum Zeitzone wählen Sie Ihre aktuelle Zeitzone.
      6. Klicken Sie auf ACCEPT.
         
3. Aktualisieren Sie das Feld Inhaltstyp auf: application/csv.
4. Speichern Sie den Befehl.

Schritt 3: Datei erstellen

Das Hochladen einer Datei zu einer Wdata-Tabelle ist ein zweistufiger Prozess. Die Datei muss zunächst im Status Staged erstellt werden, bevor sie zur endgültigen Verwendung importiert werden kann. Wir werden den Befehl Datei erstellen verwenden, um die Datei innerhalb der Wdata-Tabelle im Status Staged zu erstellen, was anzeigt, dass sie erstellt, aber noch nicht als Datensatz importiert wurde.

1. Fügen Sie einen Create File Befehl aus dem Workiva Connector in den Chain Canvas ein.
2. Verbinden Sie den Befehl Get mit dem Befehl Create File.
3. Doppelklicken Sie auf den Befehl, um ihn zu konfigurieren.
   1. Klicken Sie auf das Feld Tabellen-ID.
      1. Klicken Sie im linken Bereich Eine Variable auswählen auf den Pfeil nach unten, um Kette zu erweitern.
      2. Wählen Sie cv-Table ID.
   2. Klicken Sie auf das Feld Datei.
      1. Klicken Sie im linken Bereich Eine Variable auswählen auf den Pfeil nach unten, um GET zu erweitern.
      2. Wählen Sie Antwort.
   3. Füllen Sie das Feld Name mit den nachstehenden Informationen und befolgen Sie dabei die gleichen Schritte wie bei der Eingabe des Zeitraums in das Namensfeld:
      ERPSpendData<System.DateTime>.csv
   4. Ersetzen Sie <System.DateTime> durch die Laufzeitvariable für Datum und Uhrzeit des Systems.
      1. Klicken Sie im linken Bereich Variable auswählen auf den Pfeil nach unten, um Laufzeit zu erweitern.
      2. Wählen Sie System.DateTime.
      3. Klicken Sie auf die Variable System.DateTime, um sie umzuwandeln.
         1. Für Wählen Sie Transformation, wählen Sie Datum/Zeit analysieren.
         2. Klicken Sie auf die Schaltfläche + .
         3. Für Format, wählen Sie ISO Extended (Platform Standard).
         4. Für Datumsformat der Ausgabe, wählen Sie %m-%d-%Y@T%H:%M.
            Diese Ausgabe bedeutet, dass wir nur das vollständige Datum und die Uhrzeit erhalten, zu der die Kette ausgeführt wird.
            Erfahren Sie mehr über gängige Datums- und Zeitumwandlungen unter.
         5. In den Feldern Eingabe Datum Zeitzone und Ausgabe Datum Zeitzone wählen Sie Ihre aktuelle Zeitzone.
         6. Klicken Sie auf ACCEPT.
            
4. Klicken Sie auf Speichern, um den Befehl zu speichern.

Schritt 4: Datei in Tabelle importieren

Der zweite Schritt im Prozess des Hochladens von Dateien in Wdata-Tabellen besteht darin, die Daten zu importieren, damit sie in Abfragen verwendet werden können. Bei diesem Schritt wird die bereitgestellte Datei in die vorgesehene Tabelle als Datensatz importiert.

1. Fügen Sie den Befehl Datei in Tabelle importieren aus dem Workiva Connector in das Chain Canvas ein.
2. Verbinden Sie den Befehl Datei erstellen mit dem Befehl Datei in Tabelle importieren.
3. Doppelklicken Sie auf den Befehl, um ihn zu konfigurieren.
4. Klicken Sie auf das Feld Tabellen-ID.
   1. Klicken Sie im linken Bereich Eine Variable auswählen auf den Pfeil nach unten, um Kette zu erweitern.
   2. Wählen Sie cv-Table ID.
5. Klicken Sie auf das Feld File ID.
   1. Klicken Sie innerhalb des linken Wählen Sie eine Variable Feldes auf den Pfeil nach unten, um Erstellen Sie eine Datei zu erweitern.
   2. Klicken Sie auf den Pfeil nach unten, um Ergebnis zu erweitern.
   3. Wählen Sie Id.
6. Speichern Sie den Befehl.

Schritt 5: Verbindungen auflisten

Wir werden den Befehl Verbindungen auflisten verwenden, um die Liste der Verbindungs-IDs abzurufen, die mit der Spreadsheet-ID verbunden sind. Die Ausgabe des Befehls VERBINDUNGEN AUFLISTEN ist eine JSON-Datei, die jede Verbindung im Arbeitsblatt mit den Verbindungsdetails, einschließlich der Verbindungs-ID, enthält.

1. Hinzufügen eines Befehls Verbindungen auflisten aus dem Workiva Konnektor in den Chain Canvas.
2. Verbinden Sie den Befehl Datei in Tabelle importieren mit dem Befehl Verbindungen auflisten.
3. Doppelklicken Sie auf den Befehl, um ihn zu konfigurieren.
   • Zieltyp: Tabellenkalkulation
   • Ziel: ID: Verwenden Sie die Kettenvariable Spreadsheet-ID
     1. Klicken Sie auf das Feld Ziel-ID.
     2. Erweitern Sie im linken Variablenfeld das Dropdown-Menü Chain.
     3. Wählen Sie die Variable Arbeitsblatt-ID.
4. Speichern Sie den Befehl.

Schritt 6: Befehlsgruppe

Wir werden eine Befehlsgruppe verwenden, um die Iteration über jede Verbindung zu ermöglichen. Der Gruppen-Iterator schiebt jede Verbindung auf dem Arbeitsblatt durch die folgenden Schritte, einen nach dem anderen.

1. Hinzufügen einer Befehlsgruppe zur Kettenleinwand.
2. Verbinden Sie den Befehl Verbindungen auflisten mit dem Abschnitt In der Befehlsgruppe.
3. Doppelklicken Sie auf den Befehl, um ihn zu konfigurieren.
   1. Benennen Sie die Gruppe: Verbindungen Iteration
   2. Navigieren Sie zur Registerkarte Iteratoren.
   3. Aktivieren Sie den Schalter Iterationen und klicken Sie auf das Feld Iterationen.
      1. Klicken Sie im Bereich Select a Variable auf den Abwärtspfeil, um List Connections zu erweitern.
      2. Wählen Sie die Ausgabe Verbindungen.
4. Speichern Sie die Befehlsgruppe.

Schritt 7: Verbindung aktualisieren

Wir werden den Befehl Verbindung aktualisieren verwenden, um unsere Verbindungen unter Verwendung der Verbindungs-ID aus der Iteration zu aktualisieren.

1. Hinzufügen eines Befehls Verbindung aktualisieren aus dem Workiva Connector zum Chain Canvas.
2. Verbinden Sie den Abschnitt Start des Gruppen-Iterators mit dem Befehl Verbindung aktualisieren.
3. Doppelklicken Sie auf den Befehl, um ihn zu konfigurieren.
   • Für Verbindungs-ID: verwenden Sie die Verbindungs-ID aus dem Gruppen-Iterator - Iteration der Verbindungen. Dies ermöglicht es uns, die ID für die aktuelle Iteration an den Befehl Verbindungen aktualisieren weiterzugeben.
     1. Klicken Sie auf das Feld Verbindungs-ID.
     2. Erweitern Sie im linken Fensterbereich das Dropdown-Menü Group Iterator.
     3. Erweitern Sie das Dropdown-Menü Verbindungen Iteration.
     4. Wählen Sie die Variable ConnectionId.
   • Aktivieren Sie das Kontrollkästchen Use Previous Source Parameters.

Schritt 8: Testen Sie die Übung

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

1. Veröffentlichen Sie die Kette.
2. Klicken Sie auf Ausführen und dann Kette ausführen.
3. Sobald die Verkettung abgeschlossen ist, navigieren Sie zurück zur Tabelle und sehen, dass die Daten geladen wurden, navigieren Sie zum Arbeitsblatt und sehen, dass die Verbindung erfolgreich aktualisiert wurde.

Erfolgreicher Kettenlauf

Daten zur Tabelle hinzugefügt

Verbindungen aktualisiert