Mit einer mit Workiva verbundenen Lösung gibt es eine Reihe von Möglichkeiten, Daten in einem Workiva Spreadsheet zu aktualisieren. Bei der Verwendung von Wdata kann eine eingehende Verbindung erstellt werden, um Daten in einer Tabellenkalkulation aus einer Wdata-Abfrage zu aktualisieren. In diesem Artikel wird die Verwendung von Verkettungen zur Aktualisierung von Daten in einer Kalkulationstabelle mit den Befehlen Blattdaten schreiben und Blattdaten überschreiben untersucht.
Gemeinsame Befehlseingaben
Die Befehle Blattdaten schreiben und Blattdaten überschreiben haben mehrere Eingänge, die für beide Befehle gleich sind.
| Eingabe | Zweck |
| Arbeitsblatt-ID | Die ID des Workiva Spreadsheets, in das die Daten geschrieben werden sollen. |
| Blatt-ID/Name |
Der Name oder die ID des Blatts innerhalb des Rechenblatts, in das die Daten geschrieben werden. Die Namen sind CASE-SENSITIVE. |
| Daten-Datei |
Die Datei mit den abgegrenzten Daten, die in das Blatt geschrieben werden sollen. CSV ist das gebräuchlichste Dateiformat, aber auch andere Begrenzungszeichen werden unterstützt. JSON-Daten müssen in ein durch Trennzeichen getrenntes Format konvertiert werden, um diesen Befehl verwenden zu können. |
| Trennzeichen |
Das Dateibegrenzungszeichen. Das Komma (,) ist das gebräuchlichste Trennzeichen, aber jedes Trennzeichen wird unterstützt, einschließlich Semikolon (;), Pipe (|) oder Tabulator (\t). Achten Sie darauf, dass Felder, deren Daten das angegebene Trennzeichen enthalten, in doppelte Anführungszeichen gesetzt werden. Zum Beispiel in einer kommagetrennten Datei: Workiva, "Ames, IA, USA",WK |
| Bereich (Schreiben von Blattdaten) / Startzelle (Überschreiben von Blattdaten) |
Die Adresse der Startzelle, in die die Daten geschrieben werden sollen. Weitere Informationen über gültige Werte finden Sie in den jeweiligen Abschnitten der einzelnen Befehle weiter unten. |
| Async verwenden |
Wenn diese Option aktiviert ist, führt der Befehl eine asynchrone Aktualisierung des Blattes durch. Das bedeutet, dass die Kette mit ihrem nächsten Vorgang fortfährt, während der Blattaktualisierungsvorgang innerhalb der Plattform noch ausgeführt wird. Diese Option wird für große Datensätze empfohlen, aber nur, wenn nachfolgende Kettenoperationen nicht von der Blattaktualisierung abhängig sind. |
| Plattform-API verwenden |
Wenn dieses Kontrollkästchen aktiviert ist, verwendet der Befehl die Plattform-API zur Durchführung der Aktualisierung und nicht die herkömmliche Tabellenkalkulations-API. Die Plattform-API wird von empfohlen, da sie die neuere der beiden APIs ist und ständig um zusätzliche Funktionen erweitert wird. |
Blattdaten schreiben
Der Befehl Blattdaten schreiben wird am besten verwendet, wenn bestimmte Bereiche eines Blattes aktualisiert werden sollen, während die Daten in anderen Bereichen des Blattes erhalten bleiben. In der folgenden Tabelle wird das Löschverhalten für jedes angegebene Regionalformat beschrieben.
| Formatieren | Beispiel | Wirkung |
| Adresse einer einzelnen Zelle | B2 |
Aktualisieren Sie eine einzelne Zelle innerhalb des Blattes, ohne dass sich dies auf andere Zellenwerte auswirkt. Dieses Format ist nicht empfohlen, es sei denn, Sie schreiben einen einzelnen Zellenwert. Wenn die Datendatei mehr als einen Datenpunkt enthält, schlägt der Befehl bei Verwendung dieses Formats fehl. |
| Adresse der Startzelle, keine Endzelle oder -spalte | B2: |
Aktualisieren Sie das Blatt ab der Adresse der Startzelle. Blattwerte links (Spalte) und oberhalb (Zeile) der Adresse der Startzelle bleiben erhalten; alle anderen Werte werden gelöscht, auch wenn die Datendatei keine Zellwerte in der Zeile oder Spalte enthält. |
| Adresse der Startzelle, Endspalte ohne Endzeile | B2:D |
Aktualisieren Sie das Blatt ab der Adresse der Startzelle. Blattwerte links (Spalte) und oberhalb (Zeile) der Adresse der Startzelle bleiben erhalten; alle anderen Werte werden gelöscht, auch wenn die Datendatei keine Zellwerte in der Zeile oder Spalte enthält. |
| Adresse der Startzelle, Adresse der Endzelle | B2:D5 |
Ersetzt alle Zellen innerhalb des angegebenen Bereichs. Hinweis: Wenn der im Befehl angegebene Bereich kleiner ist (weniger Zeilen oder Spalten) als die zu ladende Datendatei, schlägt der Befehl fehl. |
Blattdaten überschreiben
Der Befehl Blattdaten überschreiben wird am besten verwendet, wenn ein ganzer Block innerhalb eines Blattes gelöscht werden soll. In der folgenden Tabelle wird das Löschverhalten für jedes angegebene Startzellenformat beschrieben.
| Formatieren | Beispiel | Wirkung |
| Adresse einer einzelnen Zelle | B2 |
Die Werte auf dem Blatt links (Spalte) und oberhalb (Zeile) der Adresse der Startzelle bleiben erhalten; alle anderen Werte auf dem Blatt werden gelöscht, und die Daten in der Datendatei werden ab der angegebenen Zellenadresse geschrieben. |
| Adresse der Startzelle, keine Endzelle oder -spalte | B2: |
Die Werte auf dem Blatt links (Spalte) und oberhalb (Zeile) der Adresse der Startzelle bleiben erhalten; alle anderen Werte auf dem Blatt werden gelöscht, und die Daten in der Datendatei werden ab der angegebenen Zellenadresse geschrieben. |
| Adresse der Startzelle, Endspalte ohne Endzeile | B2:D |
Dieses Format wird von nicht unterstützt und führt zu einem Fehler bei der Befehlsausführung. |
| Adresse der Startzelle, Adresse der Endzelle | B2:D5 |
Die Werte auf dem Blatt links (Spalte) und oberhalb (Zeile) der Adresse der Startzelle bleiben erhalten; alle anderen Werte auf dem Blatt werden gelöscht, und die Daten in der Datendatei werden ab der angegebenen Zellenadresse geschrieben. Die Breite (Spalten) und Höhe (Zeilen) der Datendatei sind irrelevant. |
Probieren Sie es aus
Es wurden eine Kettenvorlage und eine Testtabelle erstellt, die es Ihnen ermöglichen, die Ergebnisse jedes der oben genannten Formate Start Cell/Region zu sehen. Zum Testen:
- Laden Sie das Testarbeitsblat von diesem Link (25 KB) herunter und importieren Sie es in Ihren Arbeitsbereich.
- Erstellen Sie eine Testkette unter Verwendung von Verwenden Sie Ketten, um eine Workiva-Arbeitsblatt- Vorlage zu aktualisieren, das Sie unter finden. 4. Quick Start Guides -> Enablement & Usage Examples Ordner Template.
- Es wird empfohlen, die Spreadsheet ID Template Variable als Chain Variable zuzuordnen.
- Aktualisieren Sie die Spreadsheet ID Kettenvariable bevor Sie die Kette in Ihrem Arbeitsbereich ausführen.
- Vergewissern Sie sich, dass der Benutzer in der Workiva Chains Verbindung den Bereich file:write hat und dass der Benutzer dem importierten Arbeitsblatt zugewiesen wurde.
- Führen Sie die Kette aus und überprüfen Sie die Ergebnisse. Die erwarteten Ergebnisse sind auf dem Blatt Erwartete Ergebnisse des importierten Arbeitsblatts aufgeführt.