Einführung
Die Vorlage Data Dictionary Chain ermöglicht es Benutzern, detaillierte Informationen über bestimmte Tabellen in ihrem Arbeitsbereich zu erfassen und in eine Kalkulationstabelle zu exportieren. Die Benutzer können ein Schlüsselwort angeben, um Tabellen zu finden, den Namen des Export-Tabellenblatts definieren und eine Tabelle im Arbeitsbereich erstellen, um das Schema jeder Tabelle zu speichern.
Weitere Details finden Sie in der Dokumentation zum Prozess Load Data to Wdata. Dort erhalten Sie einen umfassenden Überblick. Es wird empfohlen, diese Dokumentation vor der Verwendung der Data Dictionary-Vorlage zu lesen.
Voraussetzungen
Diese Vorlage setzt voraus, dass die folgenden Objekte bereits in Ihrer Workiva-Anwendung eingerichtet sind:
- API-Gewährung
- Um Workiva API's nutzen zu können, muss ein Nutzer einen OAuth API Grant in seinem Arbeitsbereich einrichten. Bitte lesen Sie diesen Artikel für führende Praktiken für die Verwaltung des OAuth Grant.
- Die folgenden Connectors müssen in Ihrem Arbeitsbereich aktiviert und konfiguriert sein:
Hinweis: Einige Variablenwerte können sensible Informationen wie Benutzernamen und Kennwörter enthalten. Wir empfehlen, die Option "Verschlüsseln" für datenschutzrelevante Variablen zu verwenden und die entsprechenden Berechtigungen für Ihr Arbeitsblatt festzulegen.
- Variablen konfigurieren
- Damit die Unterkette Load Data to Wdata in der Vorlage wie erwartet funktioniert, muss eine Variable workspace mit dem Namen wsv-WdataLoadWarningThreshold erstellt werden.
Hinweis: Es empfiehlt sich, den Standardwert dieser Variable auf 50 (entsprechend 50 MB) zu setzen, obwohl dieser Wert bei Bedarf angepasst werden kann.
-
- Zusätzlich müssen vier weitere Arbeitsbereichsvariablen erstellt werden, bevor die Data-Dictionary-Kette verwendet werden kann.
Nachstehend finden Sie eine Aufschlüsselung der einzelnen Variablen, die eingerichtet und ausgefüllt werden müssen:
Bauen Sie Ihre Kette
Die Vorlage Data Dictionary | ALL | Primary Chain befindet sich im Abschnitt Workiva Chains auf dem Bildschirm Templates.
So finden Sie es:
- Gehen Sie in Chain Builder auf die Registerkarte Templates .
- Wählen Sie Workiva Chains aus dem Menü am oberen Rand
- Suchen Sie oben rechts nach Data Dictionary | ALL | Primary Chain Template und öffnen Sie die Vorlage
Wenn die Kette Data Dictionary | ALL | Primary in einem Arbeitsbereich bereitgestellt wird, werden automatisch sechs zusätzliche Unterketten bereitgestellt.
Die Benutzer müssen sicherstellen, dass alle sieben Ketten im selben Arbeitsbereich bereitgestellt und veröffentlicht wurden:
- Datenwörterbuch | ALL | Primär
- Data Dictionary | Dokument und Unterabschnitte erstellen | Tabellenkalkulation erstellen
- Data Dictionary | Dokument und Unterabschnitte erstellen | Blatterstellung
- Data Dictionary | Tabelle erstellen
- Daten in Wdata | Primärkette laden
- Daten in Wdata laden | Datensatz ersetzen
- Daten in Wdata laden | Neuen Datensatz hinzufügen
Nachdem Sie Ihre Vorlage gefunden haben, konfigurieren Sie sie für Ihren Arbeitsbereich mit Hilfe der Variablen, die im obigen Abschnitt erstellt wurden.
Hinweis: Ausführliche Anweisungen zum Erstellen einer Kette aus einer Vorlage finden Sie im Artikel Ketten erstellen und verwalten.
Laufzeit-Eingaben
Bei der Ausführung dieser Primärkette (Data Dictionary | ALL | Primary) müssen die folgenden Run Time Inputs ausgefüllt oder durch eine aufrufende Kette geleitet werden:
| Laufzeit-Eingabe | Beschreibung | Feldtyp | Erforderlich? |
|---|---|---|---|
| Tabellenkalkulationsname | Gibt den Namen des Tabellenblatts an, in das das Tabellenschema geschrieben werden soll. | Text | Ja |
| Wert suchen | Diese Eingabe wird verwendet, um Tabellen zu finden, die das angegebene Schlüsselwort enthalten. | Text | Ja |
| Wdata Tabelle Name | Gibt den Namen der Data-Dictionary-Tabelle an, die bei der ersten Ausführung der Vorlage erstellt wird. | Text | Ja |
Wdata-Tabelle
Um diese Kette nutzen zu können, muss eine Data Dictionary-Tabelle Wdata im Arbeitsbereich vorhanden sein. Die Kette erstellt diese Tabelle automatisch unter Verwendung der Namenskonvention "Data Dictionary Table", es sei denn, ein Benutzer gibt einen anderen Tabellennamen an.
Das folgende Tabellenschema wird für die Erstellung der Datenwörterbuch-Tabelle verwendet:
| Spaltenname | Spalte Beschreibung | Spalten-ID | Spaltentyp |
|---|---|---|---|
| Tabelle_Name | n. z. | tabellen_name | Text |
| Alias | n. z. | alias | Text |
| Art | n. z. | Modus | Text |
| Name | n. z. | Name | Text |
| Typ | n. z. | Typ | Text |
Benutzerdefinierte Anpassungen Haftungsausschluss: Wenn Benutzer beim Importieren ihrer Daten in eine Wdata-Tabelle Probleme mit nicht übereinstimmenden Spaltenüberschriften haben, können sie die Datenvorbereitung oder andere Befehle nutzen, um dies zu korrigieren. Wenn ein Benutzer jedoch benutzerdefinierte Anpassungen an dieser Vorlage vornimmt, empfiehlt es sich, vorher eine Kopie zu erstellen. Jegliche Änderungen an der Vorlage erschweren ihre Wiederverwendbarkeit. Dies gilt auch für die Anwendung einer Tag-Konfiguration auf die Vorlage.
Fehlersuche
Die folgenden Schritte können zur Behebung von Problemen mit der Kettenvorlage verwendet werden:
Fehler bei der Kettenausführung
- Überprüfen Sie, ob alle Ketten veröffentlicht sind.
- Vergewissern Sie sich, dass die OAuth2-Anmeldeinformationen (
wsv-Client IDundwsv-Client Secret) gültig und auf dem neuesten Stand sind. - Prüfen Sie die Arbeitsbereich-Berechtigungen für den Benutzer, der die Kette ausführt.
Fehler beim Datenimport
- Stellen Sie sicher, dass die Spaltenüberschriften in Ihrer Quelldatei mit dem Schema der Tabelle Wdata übereinstimmen.
- Achten Sie bei Operationen zum Ersetzen von Datensätzen darauf, dass die Dateinamen mit den vorhandenen Datensätzen in der Tabelle übereinstimmen.
- Stellen Sie bei Vorgängen zum Hinzufügen neuer Datensätze sicher, dass die Dateinamen innerhalb der Tabelle eindeutig sind.
Duplizieren von Tabellen oder Tabellenblättern
- Verwenden Sie einheitliche Namen für
Wdata Table NameundSpreadsheetNamein allen Läufen.
Monitor-Bildschirm
- Die Benutzer können die Ursache eines Fehlers diagnostizieren, indem sie zu ihrem Monitorbildschirm navigieren.
- Die Variable DCV_Chain Result gibt den Status der Kette auf der Grundlage des Endergebnisses an. Wenn ein Fehler auftritt, wird der Grund für den Fehler in den Ausgabetext der Kette auf dem Bildschirm eingeblendet.
Die Benutzer können auch den Monitorbildschirm verwenden, um festzustellen, ob ihre Datei erfolgreich importiert wurde
Bewährte Praktiken
-
Vermeiden Sie die Anpassung der Originalvorlage:
Erstellen Sie eine Kopie, wenn Anpassungen erforderlich sind. Änderungen an der Vorlage können die Wiederverwendbarkeit behindern. -
Tagging für Enhanced Context:
Fügen Sie bei Bedarf Laufzeit-Inputs (Tag-KeyundTag-Value) zu Tag-Datensätzen hinzu. Aktualisieren Sie Kettenknoten, um diese Eingaben weiterzuleiten. -
Verwaltung der Dateigröße:
Überwachen Sie die Größe des Datensatzes mithilfe der Variablenwsv-WdataLoadWarningThreshold. Erwägen Sie die Aufteilung großer Datensätze, wenn Warnungen ausgelöst werden.