Workiva Support Center

In diesem vernetzten Lernpfad werden wir eine Kette erstellen, die veranschaulicht, wie ein Schaltjahr dynamisch berücksichtigt werden kann.

Schritt 1: Erstellen einer Kette

• Wählen Sie aus dem Kettenmodul in Ihrem Arbeitsbereich die Umgebung DEV
• Eine neue Kette hinzufügen
  • Benennen Sie die Kette, CLP | Variablenumwandlung | Parsen von Datum und Uhrzeit.
  • Beschreibung hinzufügen: Die Vorlage "Connected Learning Path Chain" veranschaulicht, wie eine Laufzeiteingabe für den Monat und das Jahr dynamisch verschiedene Periodenschlüsselformate erzeugen und Schaltjahre berücksichtigen kann.Diese Vorlage verwendet die Variable Transformation zur Neuformatierung von Datumsangaben sowie zur Berechnung des endenden Periodenschlüssels unter dynamischer Berücksichtigung von Schaltjahren.
• Rettet die Kette

Schritt 2: Hinzufügen einer Laufzeiteingabe

Laufzeit-Eingaben veranschaulichen, wie eine Kette bei der Ausführung nach Werten fragen kann. Dies ist ein wertvoller Weg, um Ketten für mehrere Prozesse nutzbar zu machen.

• Erstellen Sie den Befehl
  • Hinzufügen eines Runtime Inputs zum Startknoten
    Suchen Sie in der Suchleiste nach "runtime". Klicken Sie dann doppelt, um den Befehl automatisch in den Startkreis zu laden.
  • Klicken Sie auf Add Input und wählen Sie DropdownField.
  • Konfigurieren Sie das DropdownField wie folgt:
    

    Anzeigename	Monat
    Vorschrift	Geprüft
    Beschreibung	Wählen Sie den aktuellen Monat

  • Klicken Sie auf Option hinzufügen
  • Konfigurieren Sie mit der Option mit den folgenden:
    

    Wert	{"display":"January","value":"01-01"}
    Anzeigename	Januar
    Standard	Nicht geprüft

• Füllen Sie das Dropdown-Feld aus
  • Fügen Sie Optionen für die restlichen elf Monate des Jahres hinzu. Aktualisieren Sie den Wert und die Anzeigenamen entsprechend
    • Beispiel: {"display":"February","value":"02-01"}
• Hinzufügen eines NumberField Runtime Input
  • Fügen Sie nach Fertigstellung der Dropdown-Feld-Eingabe ein NumberField Input hinzu.
  • Konfigurieren Sie das NumberField wie folgt:
    

    Anzeigename	Jahr
    Vorschrift	Geprüft
    Beschreibung	Geben Sie das aktuelle Jahr im Format JJJJ ein
    Standardwert	<leer lassen>
    Minimalwert (geprüft)	2000
    Maximalwert (geprüft)	2050

• Speichern der Laufzeiteingabe

Schritt 3: Hinzufügen eines Befehls zum Erstellen eines Periodenschlüssels

Wir verwenden den Handlebars Connector, um die in den Runtime Inputs angegebenen Werte zu übernehmen und einen Periodenschlüssel im Format JJJJ-MM-TT zu erstellen.

• Fügen Sie eine Rendering-Textvorlage aus dem Handlebars Connector in die Kette ein
• Verbinden Sie den Startknoten (Runtime Inputs) mit dem Render Text Template Befehl
• Bearbeiten Sie den Befehl
  • Benennen Sie den Befehl: Textvorlage rendern - Periodenschlüssel erstellen
  • Geben Sie im Parameter Template folgendes ein:
    

    {{Year}}-{{Period}}

  • Fügen Sie im Abschnitt "Variablen" zwei Variablen hinzu, indem Sie zweimal auf die Schaltfläche Add im Abschnitt Variables klicken.
  • Für die erste Variable geben Sie als Variablennamen Jahr an.
    • Hinweis: Bei Variablennamen wird zwischen Groß- und Kleinschreibung unterschieden.
  • Klicken Sie in das Feld Wert
    • Erweitern Sie im Variablenfenster Trigger ➡ Runtime Inputs und wählen Sie Year
  • In der zweiten Variablen geben Sie den Namen Zeitraum an.
  • Klicken Sie in das Feld Wert
    • Erweitern Sie im Bereich „Variablen“ Auslöser ➡ Laufzeit-Eingaben und wählen Sie „Monat“
    • Klicken Sie auf die Variable Month (gekennzeichnet durch die Sprechblase), der der folgende Wert zugewiesen wurde
    • Klicken Sie auf das Dropdown-Menü Transformation auswählen
      • Wählen Sie Text als JSON parsen
      • Klicken Sie auf das (+)-Symbol
      • Klicken Sie erneut auf das Dropdown-Menü Transformation auswählen
        • Wählen Sie „Wert aus JSON beziehen“
        • Klicken Sie auf das Plus-Symbol
      • Wählen Sie in „Wert aus JSON beziehen“
        • Wählen Sie in der Dropdown-Liste der Spalte "Ausgabe" die Option "T".
          • Hinweis: Die T ist die Monatsvariable, die im vorangegangenen Schritt festgelegt wurde.
        • Geben Sie in das Feld der Spalte Wert "Wert" ein und drücken Sie die Eingabetaste
          • Hinweis: Der Textwert muss in Kleinbuchstaben eingegeben werden und wird nach dem Drücken der Eingabetaste als graue Blase angezeigt.
      • Klicken Sie auf Akzeptieren
• Speichern Sie den Befehl

Schritt 4: Hinzufügen eines Befehls zur Durchführung von Datumsoperationen

Wir verwenden den Handlebars Connector, um verschiedene Datumsoperationen durchzuführen, einschließlich Datumsberechnungen und -umformatierungen.

• Fügen Sie eine Rendering-Textvorlage aus dem Handlebars Connector in die Kette ein
• Verbinden Sie den Befehl Textvorlage rendern - Periodenschlüssel erstellen mit dem Befehl Textvorlage rendern
• Bearbeiten Sie den Befehl
  • Benennen Sie den Befehl: Textvorlage rendern - Datums-Parsing
  • Geben Sie in den Parameter Template Folgendes ein:

Ausgewählter Zeitraum: 

  Monat: {{Month_Name}} 

  Jahr: 

  Zeitraum Schlüssel: {{Period_Key}} 

  Schlüssel für den Zeitraum am Monatsende: {{EOM_Key}}

• • Im Abschnitt Template-Parameter
    • Klick nach Jahr
    • Erweitern Sie dann Trigger ➡ Runtime Inputs und wählen Sie Year

Schritt 5: Abschnitt Variablen

• Fügen Sie drei Variablen hinzu, indem Sie auf die Schaltfläche Hinzufügen im Abschnitt Variablen klicken
  • Für die erste Variable:
    • Geben Sie den ersten Variablennamen als Month_Name an.
      • Klicken Sie in das Feld Wert
        • Erweitern Sie im Variablenfenster Trigger ➡ Runtime Inputs und wählen Sie Month
      • Klicken Sie im Feld Wert auf die Sprechblase der Variablen Monat
        • Klicken Sie auf das Dropdown-Menü Transformation auswählen
          • Wählen Sie Parse text as JSON, und klicken Sie auf das Plus-Symbol ( )
        • Klicken Sie erneut auf das Dropdown-Menü Transformation auswählen
          • Wert aus JSON beziehen und klicken Sie auf das Plus-Symbol (+)
            • Wählen Sie in der Zeile Get Value from JSON (Wert aus JSON abrufen) T aus der Dropdown-Liste "Output" aus.
            • Geben Sie in der gleichen Zeile Get Value from JSON display in das Feld Value ein und drücken Sie die Eingabetaste
            • Klicken Sie auf Akzeptieren

• Für die zweite Variable:
  • Geben Sie den Variablennamen als Period_Key an.
    • Klicken Sie in das Feld Wert
      • Erweitern Sie im Variablenbereich Textvorlage rendern - Periodenschlüssel erstellen
        • Wählen Sie Gerenderter Text
    • Klicken Sie auf die Sprechblase der Variablen Rendered Text im Feld Wert
      • Klicken Sie auf das Dropdown-Menü Transformation auswählen und wählen Sie Datum/ Uhrzeit analysieren, und klicken Sie auf die Schaltfläche Plus (+)
      • Geben Sie in das erste Dropdown-Feld %Y-%m-%d ein und drücken Sie unbedingt die Eingabetaste.
      • Geben Sie in das Feld für das Format des Ausgabedatums %m/%d/%Y ein.
      • Geben Sie in der Dropdown-Liste Zeitzone des Eingabedatums UTC ein und wählen Sie dann die Zeitzone (UTC) Dublin, Edinburgh, Lissabon, London
      • Wiederholen Sie die UTC-Auswahl für das Feld Zeitzone des Ausgabedatums
      • Klicken Sie auf Akzeptieren

• Für die dritte Variable:
  • Geben Sie den Variablennamen als EOM_Key an.
    • Klicken Sie in das Feld Wert. Erweitern Sie im Variablenbereich Textvorlage rendern - Periodenschlüssel erstellen und wählen Sie Gerenderter Text
    • Klicken Sie auf die Variable Gerenderter Text, der der folgende Wert zugewiesen wurde
      • Klicken Sie auf das Dropdown-Menü Transformation auswählen und wählen Sie Datum und Uhrzeit hinzufügen/subtrahieren, und klicken Sie auf das Plus-Symbol (+)
        • Geben Sie in das Dropdown-Feld "Format" %Y-%m-%d ein und drücken Sie die Eingabetaste.
        • Wählen Sie in der Dropdown-Liste Vorgang die Option Hinzufügen.
        • Geben Sie in das Feld "Betrag" 1 ein.
        • Wählen Sie in der Dropdown-Liste Einheit Monat
      • Zusätzliches Datum addieren/subtrahieren und Zeitumstellung
        • Geben Sie in das Dropdown-Feld "Format" %Y-%m-%d ein und drücken Sie die Eingabetaste.
        • Wählen Sie in der Dropdown-Liste Operation die Option Subtrahieren
        • Geben Sie in das Feld "Betrag" 1 ein.
        • Wählen Sie in der Dropdown-Liste Einheit Tag
      • Feld für das Ausgabedatum und die Zeitzone
      • Klicken Sie auf Akzeptieren
• Speichern Sie den Befehl

Schritt 6: Testen Sie die Kette

Nun, da die Kette vollständig ist, können wir das Ergebnis testen.

• Veröffentlichen Sie die Kette
• Klicken Sie auf Execute und wählen Sie dann Run With Inputs
• Wählen Sie aus dem Dropdown-Menü Monat Februar. Geben Sie in das Feld Jahr 2024 ein.
• Klicken Sie auf Start. Überprüfen Sie die Ergebnisse der Kette auf der Registerkarte Log der Render-Textvorlage - Befehl Periodenschlüssel erstellen
  • Überprüfen Sie den Monatsendzeitraum Schlüssel, d.h. ein Schaltjahr

• Führen Sie die Kette erneut im Februar aus, aber geben Sie 2025 als Jahr für diese Ausführung ein.
  • Bestätigen Sie, dass der Monat am richtigen Tag endete, d. h. kein Schaltjahr ist.

Um mehr über die Datentransformation mit Hilfe von Chains zu erfahren, schauen Sie sich die Connected Learning Paths - Transformation Introduction an!