Workiva supportcenter

I denna Connected Learning Path kommer vi att skapa en kedja som illustrerar hur man dynamiskt redovisar ett skottår.

Steg 1: Skapa en kedja

• Från Chains Module på din arbetsyta väljer du DEV Miljö
• Lägg till en ny Kedja
  • Namnge kedjan, CLP | Variabeltransformation | Parsning av datum och tid.
  • Lägg till beskrivning: Mallen Connected Learning Path Chain illustrerar hur en exekvering för månad och år dynamiskt kan generera olika periodnyckelformat och ta hänsyn till skottår.Denna mall använder Variable Transformation för att omformatera datum samt beräkna slutperiodnyckeln samtidigt som skottår dynamiskt beaktas.
• Rädda kedjan

Steg 2: Lägg till en exekvering

Inmatningar vid exekvering illustrerar hur en kedja kan fråga efter värden vid exekvering. Detta är ett värdefullt sätt att göra det möjligt att använda kedjor i flera olika processer.

• Skapa kommandot
  • Lägg till en exekvering i startnoden
    Använd sökfältet för att söka efter "exekvering". Dubbelklicka sedan för att automatiskt ladda kommandot i startcirkeln.
  • Klicka på Add Input och välj DropdownField.
  • Konfigurera DropdownField med följande:
    

    Visa namn	Månad
    Krävs	Markerad
    Beskrivning	Välj aktuell månad

  • Klicka på Lägg till alternativ
  • Konfigurera med alternativet med följande:
    

    Värde	{"display":"January","value":"01-01"}
    Visa namn	Januari
    Standard	Ej kontrollerad

• Fyll i rullgardinsfältet
  • Lägg till optioner för de återstående elva månaderna av året. Uppdatera värde- och displaynamnen i enlighet med detta
    • Exempel: {"display":"February","value":"02-01"}
• Lägg till en NumberField Exekvering
  • När du har fyllt i inmatningen för rullgardinsfältet lägger du till en NumberField Input
  • Konfigurera NumberField med följande:
    

    Visa namn	År
    Krävs	Markerad
    Beskrivning	Ange aktuellt år i formatet YYYY
    Standardvärde	<leave>
    Minvärde (kontrollerat)	2000
    Maxvärde (kontrollerat)	2050

• Spara exekveringsinmatningen

Steg 3: Lägg till ett kommando för att skapa en periodnyckel

Vi använder Handlebars Connector för att ta de värden som anges i Exekvering Inputs och skapa en periodnyckel i formatet YYYY-MM-DD.

• Lägg till en Rendering av textmall Kommando från Styret Koppling till kedjan
• Anslut startnoden (ingångar för exekvering) till Rendera textmall Kommando
• Redigera kommandot
  • Namnge kommandot: Rendera textmall - Skapa periodnyckel
  • Ange följande i parametern Template (Mall):
    

    {{Year}}-{{Period}}

  • I avsnittet Variabler lägger du till två variabler genom att klicka två gånger på knappen Lägg till i avsnittet Variabler
  • För den första variabeln anger du variabelnamnet som Year
    • Observera: Variabelnamn är skiftlägeskänsliga
  • Klicka i fältet Värde
    • I variabelfönstret expanderar du Trigger ➡ Exekvering Inmatningar och väljer År
  • I den andra variabeln anger du namnet som Period
  • Klicka i fältet Värde
    • I variabelfönstret expanderar du Trigger ➡ Exekvering Inputs och väljer Month
    • Klicka på variabeln Month (som indikeras av bubblan) som tilldelades värdet
    • Klicka på Välj omvandling rullgardinsmeny
      • Välj Parsa text som JSON
      • Klicka på symbolen plus ( )
      • Klicka på rullgardinsmenyn Välj omvandling igen
        • Select Hämta värde från JSON
        • Klicka på plussymbolen
      • I avsnittet Hämta värde från JSON ,
        • Välj "T" i rullgardinsmenyn i kolumnen Output
          • Obs: T är den månadsvariabel som fastställdes i det föregående steget
        • I kolumnen Värde skriver du in "värde" och trycker på Enter-knappen
          • Obs: Textvärdet måste skrivas med gemener och visas som en grå bubbla när du trycker på Enter-tangenten
      • Klicka på Godkänn
• Spara kommandot

Steg 4: Lägg till ett kommando för att utföra datumoperationer

Vi använder Handlebars Connector för att utföra flera datumoperationer, inklusive datummatematik och omformatering.

• Lägg till en Render Text Template Kommando från styrets kontaktdon till kedjan
• Koppla Render Text Template - Create Period Key Command till Render Text Template Command
• Redigera kommandot
  • Namnge kommandot: Rendera textmall - Parsning av datum
  • I parametern Template skriver du följande:

Vald tidsperiod: 

  Månad: {{Month_Name}} 

  År: 

  Periodnyckel: {{Period_Key}} 

  Periodnyckel för slutet av månaden: {{EOM_Key}}

• • I avsnittet Mallparameter
    • Klick efter år
    • Expandera sedan Trigger ➡ Inmatningar för exekvering och välj År

Steg 5: Avsnittet Variabler

• Lägg till tre variabler genom att klicka på knappen Lägg till i avsnittet Variabler
  • För den första variabeln:
    • Ange det första variabelnamnet som Month_Name
      • Klicka i fältet Värde
        • I variabelfönstret expanderar du Trigger ➡ Inmatningar för exekvering och väljer Månad
      • Klicka på Month variabelns bubbla i fältet Value
        • Klicka på Välj omvandling rullgardinsmeny
          • Välj Parse text som JSON, och klicka på plustecknet ( )
        • Klicka på rullgardinsmenyn Välj omvandling igen
          • Välj Hämta värde från JSON, och klicka på plustecknet ( )
            • I raden Hämta värde från JSON väljer du T från rullgardinsmenyn Output
            • I samma Get Value from JSON-rad anger du display i fältet Value och trycker på Enter-tangenten
            • Klicka på Godkänn

• För den andra variabeln:
  • Ange variabelns namn som Period_Key
    • Klicka i fältet Värde
      • Expandera Rendera textmall - Skapa periodnyckel i variabelfönstret
        • Välj Renderad text
    • Klicka på Rendered Text variabelns bubbla i fältet Value
      • Klicka på Välj transformation rullgardinsmenyn och välj Parse Date / Time, och klicka på plus ( ) -knappen
      • I den första listrutan skriver du %Y-%m-%d och trycker på Enter.
      • I fältet Output date format skriver du %m/%d/%Y
      • I rullgardinsmenyn Tidszon för inmatningsdatum skriver du UTC och väljer sedan tidszonen (UTC) Dublin, Edinburgh, Lissabon, London
      • Upprepa UTC-valet för fältet Tidszon för utdatadatum
      • Klicka på Godkänn

• För den tredje variabeln:
  • Ange variabelns namn som EOM_Key
    • Klicka i fältet Value (värde). I variabelfönstret expanderar du Renderingstextmall - Skapa periodnyckel och väljer Renderad text
    • Klicka på variabeln Renderad text som tilldelades värdet
      • Klicka på rullgardinsmenyn Välj omvandling och välj Lägg till / dra ifrån datum och tid, och klicka på plustecknet ( )
        • I rullgardinsmenyn Format skriver du %Y-%m-%d och trycker på Enter.
        • I rullgardinsmenyn Operation väljer du Add
        • I fältet Belopp anger du 1
        • I rullgardinsmenyn Enhet väljer du Månad
      • Lägg till ytterligare en Lägg till / dra ifrån datum och tidstransformation
        • I rullgardinsmenyn Format skriver du %Y-%m-%d och trycker på Enter.
        • I rullgardinsmenyn Operation väljer du Subtract
        • I fältet Belopp anger du 1
        • I rullgardinsmenyn Unit väljer du Day
      • Tidszonsfält för utdatadatum
      • Klicka på Godkänn
• Spara kommandot

Steg 6: Testa kedjan

Nu när kedjan är klar kan vi testa resultatet.

• Publicera kedjan
• Klicka på Execute och välj sedan Run With Inputs
• I rullgardinsmenyn Månad väljer du Februari. Ange 2024 i fältet Year.
• Klicka på Starta. Granska resultatet av kedjan på fliken Log i Renderingstextmall - Skapa period Nyckel Kommando
  • Verifiera Perioden i slutet av månaden Nyckel, dvs. ett skottår

• Utför kedjan igen med februari men ange 2025 för året för detta utförande
  • Bekräfta att månaden slutade på rätt dag, dvs. att det inte är ett skottår

Om du vill lära dig mer om datatransformation med hjälp av kedjor kan du kolla in Connected Learning Paths - Transformation Introduction!