Workiva Support Center

Die Vorlage Load Data to Wdata bringt Daten in eine Wdata-Tabelle, indem sie entweder einen bestehenden Datensatz ersetzt oder einen neuen hinzufügt. Diese Vorlage wird am häufigsten als Teil einer bestehenden Kette verwendet, kann aber zu jedem Arbeitsablauf hinzugefügt werden, bei dem ein Datensatz in eine Tabelle hochgeladen werden muss.

Anforderungen

• Die Ziel-Wdata-Tabelle muss erstellt werden, bevor diese Kette ausgeführt wird.
• Diese Vorlage besteht aus drei Ketten. Jede Kette muss separat veröffentlicht werden zu Ihrem Arbeitsbereich.
• Der Dateiname muss eine .csv- oder .tsv-Erweiterung enthalten. Zum Beispiel: "Datei_Name_Beispiel.csv".
• Die empfohlene maximale Dateigröße für einen Datensatz beträgt 300 MB. Erfahren Sie mehr über die empfohlenen Dateigrößen.

Finden Sie die Vorlage

Die Vorlage Load Data to WData befindet sich im Abschnitt Workiva Chains auf dem Bildschirm Templates.

So finden Sie es:

1. Gehen Sie in Chain Builder auf die Registerkarte Templates dynamic_feed .
2. Wählen Sie Workiva Chains aus dem Menü am oberen Rand.
3. Suchen Sie oben rechts nach Load Data to Wdata | Primary Chain und öffnen Sie die Vorlage.

4. Nachdem Sie die Vorlage gefunden haben, klicken Sie auf New Chain, um sie in Ihrem Arbeitsbereich einzusetzen. 

   Hinweis: Nach der Konfiguration muss jede Kette in dieser Vorlage im Arbeitsbereich veröffentlicht werden.

Konfigurieren Sie die Vorlage

Diese Vorlage besteht aus drei Ketten: der Primärkette, einer Kette "Datensatz ersetzen" und einer Kette "Neuen Datensatz hinzufügen". Wenn die Primärkette in Ihrem Arbeitsbereich bereitgestellt wird, werden die beiden untergeordneten Ketten (Hinzufügen/Ersetzen) automatisch mit ihr bereitgestellt.

Hier ein genauerer Blick auf die einzelnen Ketten:

• Primärkette: Diese Kette bestimmt, ob es in Ihrer Tabelle einen Datensatz gibt, der denselben Namen hat wie der Datensatz, der von der Kette geladen wird.  Wenn ein übereinstimmender Datensatz gefunden wird, erfasst die Kette Informationen über den übereinstimmenden Datensatz und leitet - basierend auf der für die übergeordnete Kette konfigurierten Laufzeiteingabe "Load Method" - diese Daten an eine von zwei untergeordneten Ketten weiter.

• Kette "Datensatz ersetzen": Diese Kette entfernt den übereinstimmenden Datensatz aus Ihrer Tabelle und ersetzt ihn durch einen neuen Datensatz. Wenn während der Ausführung ein Fehler auftritt und die Rollback-Option gewählt wird, löscht die Kette automatisch den neuen Datensatz und kehrt zu dem Datensatz zurück, der ersetzt werden sollte.  

• Add New Dataset Chain: Diese Kette erstellt ein neues Dataset und importiert es in Ihre Tabelle. Der neue Datensatz muss einen eindeutigen Dateinamen haben, der nicht bereits von anderen Datensätzen in der Tabelle verwendet wird.

Beim Hinzufügen dieses Kettensatzes zu einer bestehenden Kette müssen die Laufzeiteingänge für die Primärkette im Knoten "Run Chain" konfiguriert werden.  Die untergeordneten Ketten müssen nicht geändert oder konfiguriert werden.  

Ihre Einstellungen sollten in etwa so aussehen:

Variablen

Laufzeit-Eingaben

Fehlersuche

Um die Historie Ihres Kettenlaufs einschließlich der Fehler anzuzeigen:

1. Rufen Sie im Chain Builder die Registerkarte Monitor auf.
   

2. Bewegen Sie den Mauszeiger über das Fragezeichen, um den Status des Kettenlaufs anzuzeigen.
   
   

Wenn Ihre Kette einen Fehler ausgelöst hat oder die richtigen Daten nicht aktualisiert werden konnten, führen Sie die folgenden Prüfungen durch:

• Überprüfen Sie, ob alle drei Ketten in Ihrem Arbeitsbereich veröffentlicht wurden. Jede Kette muss separat veröffentlicht werden.
• Vergewissern Sie sich, dass Ihr Datensatz ein unterstütztes Trennzeichen verwendet und dass der Dateiname eine .csv- oder .tsv-Erweiterung enthält ("Dateiname_Beispiel.csv").
• Wenn Sie die Methode "Datensatz ersetzen" zum Laden verwenden, überprüfen Sie, ob der Dateiname mit dem vorhandenen Dateinamen in Ihrer Wdata-Tabelle übereinstimmt. Wenn sie nicht übereinstimmt, fügt die Kette einfach eine neue Datei zu Ihrer Tabelle hinzu, ohne die alte zu ersetzen.
• Wenn Sie dagegen die Methode zum Laden eines neuen Datensatzes verwenden, stellen Sie sicher, dass der Dateiname nirgendwo anders in der Tabelle Wdata verwendet wird. Die Kette schlägt fehl, wenn ein sich überschneidender Dateiname verwendet wird.
• Vergewissern Sie sich, dass der OAuth2 Grant, der mit der Workiva-Verbindung verbunden ist, über den entsprechenden Zugriff verfügt.
• Achten Sie bei der Eingabe der Tabellen-ID darauf, dass die ID vollständig eingegeben wurde und keine führenden oder nachfolgenden Leerzeichen vorhanden sind.
• Prüfung auf Laufzeit-Zeitstempel-Variablen. Diese sollten nicht in Dateinamen verwendet werden, da dadurch ein eindeutiger Dateiname für jeden Datensatz erstellt wird, was bedeutet, dass die Kette nicht in der Lage ist, alle übereinstimmenden Datensätze in Ihrer Tabelle zu identifizieren.

Spaltenzuordnungen und andere Kettenänderungen

Wenn Sie beim Importieren von Daten Probleme mit Spaltenüberschriften haben, können Sie data prep oder andere Befehle verwenden. 

Optional: Kennzeichnung importierter Datensätze

Das Markieren von wird beim Importieren von Datensätzen unterstützt, aber wir empfehlen, einen zusätzlichen Satz von Ketten aus der Vorlage bereitzustellen, bevor Sie Änderungen am Original vornehmen. Wenn die Kette einmal geändert wurde, ist es wahrscheinlich schwierig, sie für andere Tabellen wiederzuverwenden, es sei denn, die Datensätze in diesen Tabellen verwenden die gleichen Tags.  

So fügen Sie einer Kette Markierungen hinzu:

1. Fügen Sie die folgenden Laufzeit-Inputs hinzu: für jede der drei Ketten, die von dieser Vorlage aus bereitgestellt werden:
   • Tag-Schlüssel (Textfeld)
   • Tag-Value (Textfeld)
     
2. Bearbeiten Sie die Primary Chain, um die Laufzeit-Eingänge an jedes "Run Chain"-Ereignis zu übergeben:
3. Bearbeiten Sie sowohl in Replace Dataset Chain als auch in Add New Dataset Chain den Befehlsknoten "Import New Dataset", um die Tag-Laufzeiteingaben zu akzeptieren.

Nach Abschluss des Vorgangs werden die importierten Datensätze mit dem angegebenen Tag-Schlüssel und Tag-Wert gekennzeichnet.

Zusätzliche Ressourcen

• Workiva Konnektor
• Dateidienstprogramm Konnektor
• JSON Konnektor
• Tabellen-Transformation Konnektor
• Eine Kette innerhalb einer anderen Kette ausführen ("Run Chain events")
• OAuth2-Erlaubnisse
• Wdata-Funktion und API-Beschränkungen