Workiva Support Center

Die Kettenvorlage dient dazu, umfassende Informationen über Ketten und Kettenläufe innerhalb der Kettenumgebungen bereitzustellen. Es dient als wertvolle Ergänzung zum Monitorprotokoll und bietet zusätzliche Einblicke in die Kettenaktivität.

• Inventarisierung und Nachverfolgung: Es vereinfacht den Inventarisierungsprozess und ermöglicht es den Nutzern, schnell zu erkennen, welche Ketten nicht ausgelastet sind oder besonders gefragt sind. Dies trägt zu einer besseren Ressourcenverteilung und Effizienz bei.
• Detaillierte Berichte: Die Benutzer können Berichte erstellen, in denen wichtige Metadaten wie IDs, Daten, Namen usw. aufgeführt sind, die für die Dokumentation und Analyse wichtig sein können.
• Bereinigungsprozess: Die Vorlage ist von unschätzbarem Wert, wenn es darum geht, Testketten oder veraltete Ketten zu identifizieren und zu entfernen, die das System durcheinander bringen und die Wartung erleichtern.
• Optimierung für mehrere Kettenentwickler: In Umgebungen mit mehreren Kettenentwicklern bietet diese Vorlage einen klaren Überblick über die Verwendung von Ketten und erleichtert die Koordinierung und Optimierung, um unnötige Ketten zu eliminieren.

Insgesamt verbessert die Vorlage die Kontrolle über die Überwachung von Ketten und Kettenläufen und ermöglicht es den Benutzern, fundierte Entscheidungen über deren Verwaltung und Wartung zu treffen.

Einführung

Die Kettenvorlage ruft eine Liste von Ketten und Kettenläufen (Ausführungen) für eine oder mehrere Kettenumgebungen innerhalb des Arbeitsbereichs ab, in dem sie ausgeführt wird. Zur Laufzeit wird das Reporting Spreadsheet angegeben, um die Umgebungen, Ketten und Kettenläufe für die Analyse auszuwählen.

Hinweis: Diese Vorlage ist nur für Kettenumgebungen ausführbar, die im bereitgestellten Arbeitsbereich vorhanden sind.

Die Vorlage sammelt Daten auf Chains und lädt sie in die Chain List Wdata Tabelle für jede angegebene Umgebung. Die für jede Kette gesammelten Informationen umfassen:

• Ketten-ID
• Name der Kette
• Erstellungsdatum
• Aktualisiertes Datum
• Ketten-URL
• Arbeitsbereich-ID
• Arbeitsbereichsname
• Umwelt-ID
• Umgebungsname

Außerdem sammelt es Daten über Chain Runs innerhalb der Umgebung und lädt sie in die Tabelle Chain Runs Wdata. Die für jeden Kettenlauf gesammelten Informationen umfassen:

• Ketten-ID
• Arbeitsbereich-ID
• Umwelt-ID
• Ausgeführt von
• Start bei
• Ende bei
• Zustand
• Starttyp
• Lauf-ID

Sobald alle Kettendaten erfasst und in die Wdata-Tabellen geladen sind, überprüft die Vorlage, ob in der Auswahlliste in der Abfrage Tage seit keine neuen Umgebungen seit dem letzten Lauf fehlen. Wenn neue Umgebungen identifiziert werden, wird die Auswahlliste entsprechend aktualisiert.

Der letzte Schritt der Vorlage besteht darin, Refresh Connection auszuführen, um die Connected Sheets mit den neuesten, von der Vorlage erfassten Informationen zu aktualisieren. Die Verbundenen Blätter werden mit den Ergebnissen der Abfrage "Tage seit der Nutzung" aktualisiert.

Anforderungen

1. Die folgenden Vorlagen müssen in Ihrem Arbeitsbereich aktiviert und konfiguriert sein:
   • Daten in Wdata laden
   • Status aktualisieren
   • Wdata-Parameter pflegen
2. Die folgenden Konnektoren müssen in Ihrem Arbeitsbereich aktiviert und konfiguriert sein:
   
   • Workiva
   • Workiva-Ketten
   • JSON
   • Tabellarische Umwandlung
   • Handlebars

Einsetzen der Kette

Die Vorlage "Chain Usage Tracker" befindet sich im Abschnitt "Workiva Chains" auf dem Bildschirm Templates.

So finden Sie es:

1. Gehen Sie im 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 Chain Usage Tracker und öffnen Sie die Vorlage

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

5. Konfigurieren Sie die Vorlage, indem Sie die Schritte im Abschnitt Konfigurieren der Vorlage unten ausführen

Konfigurieren Sie die Vorlage

1. Laden Sie die Datei Chain User Tracker.cb herunter und importieren Sie sie unter in Ihren Arbeitsbereich.
   
   • Dieser Import erstellt die notwendigen Wdata-Tabellen und Abfragen für die Vorlage

     Hinweis: Die Tabellen-IDs jeder Tabelle für die spätere Verwendung beim Konfigurieren der Kettenvariablen

     
   • Öffnen Sie die Abfrage Tage seit Verwendung in Wdata, um sie zu bearbeiten
   • Klicken Sie rechts im Menü auf Parameter
   • Klicken Sie auf den Parameter Umgebungen
     
     

     Hinweis: Siehe Abfrageparameter bearbeiten für weitere Informationen

   • Ändern Sie die List Options, um eine oder mehrere Ihrer Kettenumgebungen aufzunehmen. Vergewissern Sie sich, dass jeder Name genau die gleiche ist wie die entsprechende Kettenumgebung, einschließlich der Groß- und Kleinschreibung.
   • Ändern Sie den Standardwert nach Bedarf.
     
   • Klicken Sie auf Übernehmen
   • Klicken Sie auf Speichern
2. Laden Sie die Datei Chain Usage Tracker.tar.gz herunter und importieren Sie sie in Ihren Arbeitsbereich. Durch diesen Import wird die erforderliche Chain Usage Tracker Tabellenkalkulation erstellt.
   • Sobald die Datei erfolgreich importiert wurde, suchen Sie das Spreadsheet "Chain Usage Tracker" und öffnen es
   • Aktualisieren Sie auf dem Blatt Parameter den Schwellenwert Days Since Use in Zelle B1 auf einen Wert, der größer oder gleich -1 ist.

     Hinweis: Bei einem Wert von -1 werden alle Daten abgerufen.

     
   • Verwenden Sie das Process Tracking Sheet, um den Status der Ausführung der Vorlage zu überwachen
   • Damit die Vorlage bestimmte Kettenumgebungen verarbeiten kann, fügen Sie ein oder mehrere untergeordnete Blätter unter dem Blatt Umgebungen hinzu. Entfernen oder Umbenennen des Kettenumgebungsblatts Platzhalterblatt
   • Vergewissern Sie sich, dass jedes untergeordnete Blatt genau so heißt wie die entsprechende Kettenumgebung, einschließlich der Groß- und Kleinschreibung des Namens
     
   • Erstellen Sie eine eingehende Verbindung aus der Days Since Use Wdata Query und konfigurieren Sie die Parameter Days_Since_Use und Environments
     

     Hinweis: DEV, Demo und SSC sind Beispielnamen für Kettenumgebungen. Diese Umgebungen stimmen möglicherweise nicht mit Ihren Umgebungsnamen überein. Bearbeiten Sie den Abfrageparameter Tage seit Verwendung nach Bedarf. Die Vorlage verwendet Maintain Wdata Parameters zur Pflege der Werte

     

Variablen

Hinweis: Siehe Find IDs for Workiva files and items für Hilfe beim Auffinden von IDs

Laufzeit-Eingaben

Hinweis: Siehe Find IDs for Workiva files and items für Hilfe beim Auffinden von IDs

Ausführen der Vorlage

1. Klicken Sie auf die Schaltfläche Ausführen
2. Klicken Sie auf die Schaltfläche Run With Inputs
3. Geben Sie die Chain Usage Tracker Spreadsheet ID in das Laufzeit-Eingabefeld für die Reporting Spreadsheet ID ein.
   
4. Klicken Sie auf die Schaltfläche Start
5. Navigieren Sie während der Ausführung der Vorlage zum Spreadsheet Chain Usage Tracker und rufen Sie das Blatt Process Tracking auf, um den Ausführungsstatus zu überwachen.
6. Lassen Sie die Vorlage abschließen, um die Daten in den untergeordneten Umgebungsblättern anzuzeigen.

Ausführungsergebnis

Hier ist ein Beispiel für die Ausgabe des Spreadsheets "Chain Usage Tracker":

Abgeschlossene Kette:

Fehlersuche

• Stellen Sie sicher, dass die Unterketten Status aktualisieren, Daten in Wdata laden und Wdata-Parameter pflegen alle veröffentlicht sind.
• Überprüfen Sie, ob die richtigen IDs angegeben sind. Für Hilfe bei der Identifizierung von IDs innerhalb von Workiva, siehe Find IDs for Workiva files and items
• Überprüfen Sie, ob die Dateien Chain User Tracker.cb und Chain User Tracker.tar.gz erfolgreich importiert wurden. Lesen Sie die Hilfeartikel Importing Wdata Files und Import a Workiva file
• Überprüfen Sie, ob die Abfrage Days Since Use die richtigen Tabellen-IDs für die Tabellen Chain List und Chain Runs enthält.
• Überprüfen Sie, ob der Wert Days Since Use auf dem Parameterblatt größer oder gleich -1 ist.
• Vergewissern Sie sich, dass das Blatt "Umgebungen" im Arbeitsblatt "Berichte" vorhanden ist und dass die untergeordneten Blätter der Kette "Umgebung" korrekt benannt sind.
• Wenn Sie das Blatt "Umgebungen" umbenannt haben, passen Sie die Abfrage "Tage seit Verwendung" so an, dass der benutzerdefinierte Name des Blatts verwendet wird.
• Wenn Sie die Namen Ihrer Status- und/oder Parameterblätter umbenannt haben und in Ihren Kettenvariablen auf diese Namen verweisen, stellen Sie sicher, dass die benutzerdefinierten Namen in den Werten der Kettenvariablen berücksichtigt wurden.
• Wenn Sie den Parameter "Umgebungen" in Ihrer Abfrage "Tage seit Verwendung" umbenannt haben, stellen Sie sicher, dass die Variable "Abfrageparameterkette" aktualisiert wurde, um den benutzerdefinierten Namen Ihres Parameters zu verwenden 
• Vergewissern Sie sich, dass der Workiva Connector die notwendigen Berechtigungen hat, um Befehle in der/den ausgewählten Umgebung(en) auszuführen.

Zusätzliche Ressourcen

• • Ein Wdata-Objekt importieren
  • Workiva-Datei importieren
  • Kettenvorlage Daten in Wdata laden
  • Aktualisierungsstatus der Kettenvorlage
  • Kettenvorlage Wdata-Parameter pflegen
  • Workiva-Konnektor
  • Workiva Kettenverbinder
  • JSON-Verbinder
  • Tabellarischer Transformationsverbinder
  • Handlebars-Konnektor