Workiva-ondersteuningscentrum

In dit Aangesloten Leerpad zullen we een Ketting maken die laat zien hoe u dynamisch rekening kunt houden met een schrikkeljaar.

Stap 1: Maak een ketting

• Selecteer in de Chains Module in uw Workspace de DEV Omgeving
• Een nieuwe Ketting toevoegen
  • Geef de Chain een naam, CLP | Variable Transformation | Parsing Date and Time.
  • Beschrijving toevoegen: De sjabloon Connected Learning Path Chain illustreert hoe een Runtime Input voor de Maand en het Jaar dynamisch verschillende periodesleutelformaten kan genereren en rekening kan houden met schrikkeljaren.deze sjabloon gebruikt Variabele transformatie om datums opnieuw te formatteren en de eindperiodesleutel te berekenen terwijl dynamisch rekening wordt gehouden met schrikkeljaren.
• Red de Ketting

Stap 2: Een runtime-invoer toevoegen

Runtime Inputs laat zien hoe een Chain tijdens de uitvoering om waarden kan vragen. Dit is een waardevolle manier om Chains in meerdere processen te kunnen gebruiken.

• De opdracht maken
  • Voeg een Runtime Inputs toe aan het Start-knooppunt
    Gebruik de zoekbalk om te zoeken naar "runtime". Dubbelklik vervolgens om de opdracht automatisch in de Startcirkel te laden.
  • Klik op Invoer toevoegen en selecteer DropdownField.
  • Configureer het DropdownField met het volgende:
    

    Naam weergeven	Maand
    Vereist	Gecontroleerd
    Beschrijving	Selecteer de huidige maand

  • Klik op Optie toevoegen
  • Configureer met de optie met het volgende:
    

    Waarde	{"display":"January","value":"01-01"}
    Naam weergeven	Januari
    Standaard	Niet gecontroleerd

• Vul het dropdown-veld in
  • Voeg opties toe voor de resterende elf maanden van het jaar. Werk de waarde en weergavenamen dienovereenkomstig bij
    • Voorbeeld: {"display":"February","value":"02-01"}
• Een Getallenveld toevoegen Runtime-invoer
  • Nadat u de Dropdown-veldinvoer hebt voltooid, voegt u een NumberField Input toe
  • Configureer het NumberField met het volgende:
    

    Naam weergeven	Jaar
    Vereist	Gecontroleerd
    Beschrijving	Voer het huidige jaar in het formaat JJJJ in
    Standaardwaarde	<laat leeg&gt
    Min Waarde (Gecontroleerd)	2000
    Max. waarde (Gecontroleerd)	2050

• De runtime-invoer opslaan

Stap 3: Een opdracht toevoegen om een periodieke sleutel te maken

We gebruiken de Handlebars Connector om de in de Runtime Inputs opgegeven waarden te nemen en een periodieke sleutel in de indeling JJJJ-MM-DD te maken.

• Voeg een Tekstsjabloon renderen opdracht toe van het Stuur Connector aan de ketting
• Verbind de Start Node (Runtime Inputs) met de opdracht Render Text Template
• De opdracht bewerken
  • Geef de opdracht een naam: Tekstsjabloon renderen - Periode-sleutel maken
  • Voer in de parameter Sjabloon het volgende in:
    

    {{Jaar}}-{{Periode}}

  • Voeg in het gedeelte Variabelen twee variabelen toe door twee keer op de knop Add te klikken in het gedeelte Variabelen
  • Geef voor de eerste variabele de Variabele Naam op als Jaar
    • Opmerking: Namen van variabelen zijn hoofdlettergevoelig
  • Klik in het veld Waarde
    • Vouw in het deelvenster Variable Trigger ➡ Runtime Inputs uit en selecteer Year
  • Geef in de tweede variabele de naam op als Periode
  • Klik in het veld Waarde
    • Vouw in het deelvenster Variable Trigger ➡ Runtime Inputs uit en selecteer Month
    • Klik op de variabele Maand (aangegeven door de tekstballon) die werd toegewezen aan de waarde
    • Klik op de vervolgkeuzelijst Selecteer transformatie
      • Selecteer Tekst als JSON parseren
      • Klik op het plus-symbool (+)
      • Klik opnieuw op de vervolgkeuzelijst Selecteer transformatie
        • Selecteer Waarde uit JSON halen
        • Klik op het plusteken
      • In de opdracht Waarde ophalen uit JSON ,
        • Selecteer "T" in de vervolgkeuzelijst van de kolom Uitvoer.
          • Opmerking: De T is de maandvariabele die in de vorige stap werd vastgesteld
        • Voer in het veld van de kolom Waarde "value" in en druk op de Enter-toets
          • Opmerking: De tekstwaarde moet in kleine letters zijn en verschijnt als een grijze tekstballon nadat u op de Enter-toets hebt gedrukt
      • Klik op Accepteren
• De opdracht opslaan

Stap 4: Een opdracht toevoegen om datumbewerkingen uit te voeren

We gebruiken de Handlebars Connector om verschillende datumbewerkingen uit te voeren, waaronder het berekenen en opnieuw opmaken van datums.

• Een Render Text Template opdracht van de stuurconnector aan de ketting toevoegen
• Verbind de opdracht Render Text Template - Maak Periode Sleutel met de opdracht Render Text Template
• De opdracht bewerken
  • Geef de opdracht een naam: Tekstsjabloon renderen - Datum parseren
  • Voer in de parameter Template het volgende in:

Geselecteerde periode

Maand: {{Month_Name}}

Jaar

Periode Sleutel: {{Period_Key}}

Einde Maand Periode Sleutel: {{EOM_Key}}

• • In de sectie Sjabloonparameters
    • Klik na Jaar
    • Vouw vervolgens Trigger ➡ Runtime Inputs uit en selecteer Year (Jaar)

Stap 5: Variabelen

• Voeg drie variabelen toe door op de knop Toevoegen te klikken in het gedeelte Variabelen
  • Voor de eerste variabele:
    • Geef de eerste naam van de variabele op als Month_Name
      • Klik in het veld Waarde
        • Vouw in het deelvenster Variable Trigger ➡ Runtime Inputs uit en selecteer Month
      • Klik op de bel van de variabele Maand in het veld Waarde
        • Klik op de vervolgkeuzelijst Selecteer transformatie
          • Selecteer Tekst parsen als JSON, en klik op het plus (+) symbool
        • Klik opnieuw op de vervolgkeuzelijst Selecteer transformatie
          • Selecteer Waarde uit JSON halen, en klik op het plus (+) symbool
            • Selecteer in de regel Waarde ophalen uit JSON T in de vervolgkeuzelijst Uitvoer
            • In dezelfde regel Get Value from JSON voert u display in het veld Value in en drukt u op de Enter-toets
            • Klik op Accepteren

• Voor de tweede variabele:
  • Geef de variabelenaam op als Periode_Key
    • Klik in het veld Waarde
      • Vouw in het deelvenster Variable Render Text Template - Create Period Key (Periode-sleutel maken) uit
        • Selecteer Gerenderde tekst
    • Klik op de bel van de variabele Rendered Text in het veld Waarde
      • Klik op de vervolgkeuzelijst Selecteer transformatie en selecteer Datum/tijd parseren en klik op de plusknop (+)
      • Voer in het eerste dropdownvak %Y-%m-%d in en druk op Enter
      • Voer in het veld Uitvoer datum formaat %m/%d/%Y in
      • Typ in het vervolgkeuzemenu Invoertijdzone UTC en selecteer vervolgens de tijdzone (UTC) Dublin, Edinburgh, Lissabon, Londen
      • Herhaal de UTC-selectie voor het veld Tijdzone uitgangsdatum
      • Klik op Accepteren

• Voor de derde variabele:
  • Geef de variabelenaam op als EOM_Key
    • Klik in het veld Waarde. Vouw in het deelvenster Variabele Render Text Template - Create Period Key uit en selecteer Rendered Text
    • Klik op de variabele Rendered Text die werd toegewezen aan de waarde
      • Klik op de vervolgkeuzelijst Selecteer transformatie en selecteer Datum en tijd toevoegen / aftrekken en klik op het plus-symbool (+)
        • Voer in het vervolgkeuzemenu Formaat %Y-%m-%d in en druk op Enter
        • Selecteer in het vervolgkeuzemenu Werking Toevoegen
        • Voer in het veld Bedrag 1 in
        • Selecteer in de vervolgkeuzelijst Eenheid Maand
      • Een extra toevoegen / aftrekken Datum en Tijd transformatie
        • Voer in het vervolgkeuzemenu Formaat %Y-%m-%d in en druk op Enter
        • Selecteer in de vervolgkeuzelijst Bewerking Aftrekken
        • Voer in het veld Bedrag 1 in
        • Selecteer in de vervolgkeuzelijst Eenheid Dag
      • Tijdzone uitvoer
      • Klik op Accepteren
• De opdracht opslaan

Stap 6: Test de ketting

Nu de Chain compleet is, kunnen we het resultaat testen.

• Publiceer de keten
• Klik op Uitvoeren en selecteer vervolgens Uitvoeren met ingangen
• Selecteer in de vervolgkeuzelijst Maand Februari. Voer bij Jaar 2024 in
• Klik op Start. Bekijk de resultaten van de ketting op het tabblad Log van de opdracht Render Text Template - Create Period Key
  • Controleer de Einde-van-de-maand-periode sleutel, d.w.z. een schrikkeljaar

• Voer de Ketting opnieuw uit met februari, maar voer voor het Jaar voor deze uitvoering 2025 in
  • Controleer of de maand op de juiste dag eindigde, d.w.z. geen schrikkeljaar was

Om meer te leren over datatransformatie met behulp van Chains, kunt u de Connected Learning Paths - Transformation Introduction bekijken!