CLP - Ersetzen von Daten in einer Tabelle – Supportcenter

Sie können Ihre Datenverwaltung noch weiter rationalisieren, indem Sie die einzelnen Schritte in derselben Kette zusammenfassen. In diesem Connected Learning Path zeigen wir Ihnen, wie Sie Daten in einer Wdata-Tabelle am besten ersetzen können. Dies ist ein zweistufiger Prozess mit einer Kette.

Primärer geschäftlicher Anwendungsfall	Tabellenverwaltung
Primäres Lernziel	Ersetzen von Daten in einer Wdata-Tabelle mit Hilfe von Chains
Voraussetzungen	Workiva Connector konfigurieren HTTP Request Connector konfigurieren Vollständig CLP - Hochladen von Daten in eine Tabelle Pfad Identifizieren Sie die Tabellen-ID der CLP-Mitarbeiter-Detailtabelle
Unterstützende Vorlage	CLP - Ersetzen von Daten in einer Tabelle

Schritt 1: Kette ausführen

Navigieren Sie zu der Kette CLP | Daten in eine Tabelle hochladen.
Klicken Sie auf Execute und wählen Sie dann Run With Inputs.
Geben Sie Werte für Ihre Runtime-Inputs ein:
- Tabellen-ID - ID der CLP Employee Detail Tabelle
  Lesen Sie dieses Dokument, um die ID zu finden.
- Dateiname - ein beliebiger Name, den Sie der Datei geben möchten. In diesem Beispiel nennen wir die Datei "Employee Detail".
- Speicherort der Datei - https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail.csv.
Klicken Sie auf Start.
Sobald die Kette abgeschlossen ist, klicken Sie auf den Knoten Datei in Tabelle importieren, um den Erfolg zu überprüfen.
In der CLP-Mitarbeiter-Detailtabelle sind nun Daten verfügbar, die wir nun durch den aktualisierten Datensatz ersetzen werden, indem wir in einer einzigen Kette die alten Daten löschen und die neuen Daten hochladen.

Schritt 2: Eine Kette erstellen

Fügen Sie eine neue Kette hinzu.
Benennen Sie die Kette: CLP | Ersetzen von Daten in einer Tabelle.
Speichern Sie die Kette.

Schritt 3: Laufzeit-Eingaben

Wir verwenden den Befehl Runtime Inputs, um die Kette zu starten. Hier können wir den Dateinamen und die ID der Tabelle angeben, in die die Datei importiert wird, wenn wir die Kette ausführen.

Fügen Sie einen Runtime Inputs Befehl aus Chain Trigger Events dem Startbereich hinzu.
Bearbeiten Sie das Runtime Inputs Kettenereignis, indem Sie auf den Befehl doppelklicken.
Fügen Sie die drei folgenden Eingaben hinzu:
- Eingang 1:
  - Typ: TextField
  - Name anzeigen: Tabelle ID
  - Erforderlich: Abgehakt
- Eingabe 2:
  - Typ: TextField
  - Name anzeigen: Dateiname
  - Erforderlich: Abgehakt
- Eingabe 3:
  - Typ: TextField
  - Name anzeigen: Speicherort der Datei
  - Erforderlich: Abgehakt
Speichern Sie den Befehl.

Schritt 4: Dateien auflisten

Um die alte Datei in der Tabelle zu löschen, benötigen wir die Datei-ID. Um die FileID programmatisch zu finden, verwenden wir den Befehl List Files. Dieser Befehl verwendet die Tabellen-ID, um nach allen Dateien innerhalb dieser Tabelle zu suchen, und liefert uns eine Ausgabe der Dateien sowie Informationen über diese Dateien, einschließlich der Datei-ID.

Hinzufügen eines List Files Befehls zum Chain Canvas
Verbinden Sie das Runtime Inputs Kettenereignis mit dem List Files Befehl.
Doppelklicken Sie auf den Befehl, um ihn zu konfigurieren. und klicken Sie auf das Feld Tabellen-ID.
Klicken Sie im linken Feld Variablen auf den Abwärtspfeil, um Auslöser zu erweitern.
1. Klicken Sie auf den Abwärtspfeil, um Runtime Inputs zu erweitern.
2. Wählen Sie TableID.
Speichern Sie den Befehl.

Schritt 5: Import von Datei aus Tabelle rückgängig machen

Ähnlich wie das Hochladen von Daten in eine Tabelle ist auch das Löschen von Daten aus einer Tabelle ein zweistufiger Prozess. Bevor die Datei gelöscht werden kann, muss sie zunächst in den Status "Bereitgestellt" versetzt werden. Um die Datei als Bereitstellungsdatei einzustellen, muss der Import rückgängig gemacht werden. Wir verwenden den Befehl Un-Import File from Table, um den zu löschenden Datensatz vorzubereiten.

Fügen Sie einen Un-import File from Table Befehl zum Chain Canvas hinzu.
Verbinden Sie den Befehl List Files mit dem Befehl Un-import File from Table.
Doppelklicken Sie auf den Befehl, um ihn zu konfigurieren.
1. Klicken Sie auf das Feld Tabellen-ID.
  1. Klicken Sie im linken Feld Variablen auf den Pfeil nach unten, um Auslöser zu erweitern.
  2. Klicken Sie auf den Abwärtspfeil, um Runtime Inputs zu erweitern.
  3. Wählen Sie TableID.
2. Klicken Sie auf das Feld File ID.
  1. Klicken Sie im linken Variablenfenster auf den Abwärtspfeil, um List Files zu erweitern.
  2. Wählen Sie Dateiliste.
  3. Klicken Sie auf die Variable List Files - Files List, um die Variable umzuwandeln.
    1. Klicken Sie auf Wählen Sie Transformation und wählen Sie dann Wert aus JSON holen.
    2. Klicken Sie auf das Pluszeichen, um die Variablentransformation hinzuzufügen.
    3. Geben Sie in das Feld Wert '0' ein und drücken Sie dann . Geben Sie ein.
    4. Nachdem =0 angezeigt wird, geben Sie 'id' ein und drücken Sie . Geben Sie erneut ein.
      Die Variable liest nun die JSON-Ausgabe des Befehls List Files und findet die ID der ersten Datei in der Tabelle.
      Tipp! Achten Sie beim Parsen von JSON-Werten besonders auf Groß- und Kleinschreibung.
    5. Klicken Sie auf Akzeptieren Sie.
3. Speichern Sie den Befehl.
Schritt 6: Datei herunterladen

Als Nächstes können wir entweder die bereitgestellte Datei aus der Tabelle löschen oder die neue Datei für den Upload vorbereiten. Wir empfehlen Ihnen, eine neue Datei hochzuladen, nachdem Sie die alte Datei deinstalliert haben, um sicherzustellen, dass der Prozess erfolgreich ist, bevor die Daten offiziell gelöscht werden.

Um die neue Datei für den Upload vorzubereiten, müssen wir die Datei zunächst mit dem HTTP Request Get Befehl herunterladen. Wir haben eine Datei online gehostet, die die Kette herunterladen kann, um das Herunterladen von Dateien aus der Cloud zu demonstrieren.
1. Fügen Sie einen Get Befehl aus dem HTTP Request Connector in den Chain Canvas ein.
2. Verbinden Sie den Un-import File from Table Befehl mit dem Get Befehl.
3. Doppelklicken Sie auf den Befehl, um ihn zu konfigurieren.
  1. Klicken Sie auf das Feld URL.
    1. Klicken Sie im linken Feld Wählen Sie eine Variable auf den Pfeil nach unten, um Auslöser zu erweitern.
    2. Klicken Sie auf den Abwärtspfeil, um Runtime Inputs zu erweitern.
    3. Wählen Sie File Location.
  2. Aktualisieren Sie das Feld Inhaltstyp auf: anwendung/csv.
4. Speichern Sie den Befehl.
Schritt 7: Datei erstellen

Genau wie im Upload Data to Table Connected Learning Path, folgen wir dem zweistufigen Prozess für das Hochladen von Daten in Wdata-Tabellen. Die Datei muss zunächst im Status Staged erstellt werden, bevor sie zur endgültigen Verwendung importiert werden kann. Mit dem Befehl "Datei erstellen" wird die Datei innerhalb der Wdata-Tabelle im Status "Staged" erstellt, d. h. sie wurde erstellt, aber noch nicht als Datensatz importiert.
1. Fügen Sie einen Create File Befehl aus dem Workiva Connector in das 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 Feld Wählen Sie eine Variable auf den Pfeil nach unten, um Trigger zu erweitern.
    2. Klicken Sie auf den Abwärtspfeil, um Runtime Inputs zu erweitern.
    3. Wählen Sie Tabellen-ID.
  2. Klicken Sie auf das Feld Datei.
    1. Klicken Sie im linken Bereich Wählen Sie eine Variable auf den Pfeil nach unten, um GET zu erweitern.
    2. Wählen Sie Antwort.
  3. Klicken Sie auf das Feld Name.
    1. Klicken Sie im linken Feld Wählen Sie eine Variable auf den Pfeil nach unten, um Trigger zu erweitern.
    2. Klicken Sie auf den Abwärtspfeil, um Runtime Inputs zu erweitern.
    3. Wählen Sie Dateiname.
    4. Klicken Sie im linken Feld Wählen Sie eine Variable auf den Pfeil nach unten, um Runtime zu erweitern.
    5. Wählen Sie Chain.ExecutionDateTime.
    6. Geben Sie nach Ihren beiden Variablen ".csv" ein.
      Die Variable Chain.ExecutionDateTime wird verwendet, um anzuzeigen, wann die Datei erstellt wurde und um sicherzustellen, dass jede Datei einen eindeutigen Namen hat.
Schritt 8: Datei in Tabelle importieren

Der nächste Schritt beim Hochladen von Dateien in Wdata-Tabellen besteht darin, die Daten zu importieren und sie für Abfragen nutzbar zu machen. Bei diesem Schritt wird die bereitgestellte Datei in die vorgesehene Tabelle als Datensatz importiert.
1. Fügen Sie einen Datei in Tabelle importieren Befehl aus dem Workiva Connector zum Chain Canvas hinzu.
2. Verbinden Sie den Befehl Datei erstellen mit dem Befehl Datei in Tabelle importieren.
3. Doppelklicken Sie auf den Befehl, um ihn zu konfigurieren.
  - Für das Feld Tabellen-ID:
    1. Klicken Sie im linken Feld Wählen Sie eine Variable auf den Pfeil nach unten, um Trigger zu erweitern.
    2. Klicken Sie auf den Abwärtspfeil, um Runtime Inputs zu erweitern.
    3. Wählen Sie Tabellen-ID.
  - Für das Feld Datei-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. Wählen Sie Ergebnis.
    3. Klicken Sie auf Datei erstellen - Ergebnis, um es umzuwandeln.
      1. Wählen Sie in der Dropdown-Liste Transformation auswählen die Option Wert aus JSON abrufen.
      2. Klicken Sie auf die Schaltfläche + (plus).
      3. Geben Sie in das Feld Wert "id" ein und drücken Sie . Geben Sie ein.
      4. Klicken Sie auf ACCEPT.
4. Speichern den Befehl
Schritt 9: Datei löschen

Nachdem die neuen Daten hochgeladen wurden und zur Verwendung bereit sind und der alte Datensatz bereitgestellt wurde, besteht der letzte Schritt darin, die alten Daten offiziell zu löschen. In diesem Schritt wird der Befehl Datei löschen verwendet, um den Datensatz aus der Tabelle zu löschen.
1. Fügen Sie einen Befehl zum Löschen von Dateien aus dem Workiva Connector in das Chain Canvas ein.
2. Verbinden Sie den Befehl Datei in Tabelle importieren mit dem Befehl Datei löschen
3. Doppelklicken Sie auf den Befehl, um ihn zu konfigurieren.
  Um sicherzustellen, dass wir dieselbe Datei löschen, die wir nicht importiert haben, generieren wir die Datei-ID auf dieselbe Weise wie bei dem Befehl Datei aus Tabelle ent-importieren:
  - Im Feld Datei-ID:
    1. Klicken Sie im linken Feld Variablen auf den Abwärtspfeil, um Dateien auflisten zu erweitern.
    2. Wählen Sie Dateiliste.
    3. Klicken Sie auf die Variable List Files - Files List, um die Variable umzuwandeln.
      1. Klicken Sie auf Transformation auswählen und wählen Sie dann Wert aus JSON abrufen.
      2. Klicken Sie auf das Pluszeichen (+), um die Variablentransformation hinzuzufügen.
        
        Geben Sie in das Feld Wert die Zahl '0' ein und drücken Sie dann Eingabe.
        
        Nachdem =0 angezeigt wird, geben Sie 'id' ein und drücken Sie . Geben Sie erneut ein.
        Die Variable liest nun die JSON-Ausgabe des Befehls List Files und findet die ID der ersten Datei in der Tabelle.
        Tipp! Achten Sie beim Parsen von JSON-Werten besonders auf Groß- und Kleinschreibung.
        
        Klicken Sie auf Akzeptieren
        
        Speichern Sie den Befehl.xx
        
        Schritt 10: Testen Sie die Übung
        
        Testen Sie nun, nachdem die Kette vollständig ist, das Ergebnis.
        
        Klicken Sie auf Führen Sie aus und wählen Sie dann Mit Eingaben ausführen.
        
        Fügen Sie Werte für Ihre Runtime-Inputs hinzu.
        
        Tabellen-ID - ID der CLP-Mitarbeiter-Detailtabelle
        Lesen Sie dieses Dokument, um die ID zu finden
        
        Dateiname - ein beliebiger Name, den Sie der Datei geben möchten; in diesem Beispiel nennen wir die Datei "Employee Detail".
        
        Dateispeicherort - https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_replace.csv
        
        Klicken Sie auf Start
        
        Die Kette sollte die alte Datei erfolgreich entfernt und durch die neue Datei in Ihrer Tabelle ersetzt haben.
        
        Sie können überprüfen, ob die Daten in Ihrer Tabelle ersetzt wurden, indem Sie zu der Tabelle in Wdata navigieren und die Datasets im rechten Fensterbereich überprüfen.
        
        Wenn Sie mehr über die Verwendung von Chains zur Rationalisierung der Datenerfassung erfahren möchten, lesen Sie den Rest des Data Centralization Paths!

Support

Community

Workiva Support Center