Workiva kundestøttesenter

I denne Connected Learning Path skal vi lage en kjede som illustrerer hvordan man dynamisk tar hensyn til et skuddår.

Trinn 1: Opprett en kjede

• Fra Chains-modulen i arbeidsområdet ditt velger du DEV Environment
• Legg til en ny Kjede
  • Gi kjeden et navn, CLP | Variabeltransformasjon | Parsing av dato og klokkeslett.
  • Legg til beskrivelse: Malen Connected Learning Path Chain illustrerer hvordan en kjøretidsinngang for måned og år dynamisk kan generere ulike periodetallformater og ta hensyn til skuddår.denne malen bruker variabel transformasjon til å omformatere datoer og beregne sluttperiodenøkkelen samtidig som den dynamisk tar hensyn til skuddår.
• Redd kjeden

Trinn 2: Legg til en kjøretidsinngang

Runtime Inputs illustrerer hvordan en Chain kan be om verdier under kjøring. Dette er en verdifull måte å gjøre det mulig å bruke kjeder på tvers av flere prosesser.

• Opprett kommandoen
  • Legg til en Runtime Inputs i Start-noden
    Bruk søkefeltet til å søke etter "runtime". Dobbeltklikk deretter for å laste inn kommandoen automatisk i Start-sirkelen.
  • Klikk på Add Input og velg DropdownField.
  • Konfigurer DropdownField med følgende:
    

    Vis navn	Måned
    Påkrevd	Kontrollert
    Beskrivelse	Velg gjeldende måned

  • Klikk på Legg til alternativ
  • Konfigurer med følgende alternativ:
    

    Verdi	{"display":"January","value":"01-01"}
    Vis navn	Januar
    Standard	Ikke sjekket

• Fyll ut nedtrekksfeltet
  • Legg til opsjoner for de resterende elleve månedene av året. Oppdater verdi- og visningsnavnene tilsvarende
    • Eksempel: {"display":"February","value":"02-01"}
• Legg til et NumberField Runtime Input
  • Etter at du har fullført Dropdown-feltet, legger du til et NumberField Input
  • Konfigurer NumberField med følgende:
    

    Vis navn	År
    Påkrevd	Kontrollert
    Beskrivelse	Skriv inn det aktuelle året i ÅÅÅÅÅ-format
    Standardverdi	<la stå tomt&gt
    Min verdi (kontrollert)	2000
    Maksverdi (kontrollert)	2050

• Lagre kjøretidsinndataene

Trinn 3: Legg til en kommando for å opprette en periodetast

Vi bruker Handlebars Connector til å ta verdiene som er angitt i Runtime Inputs, og opprette en periodisk nøkkel i formatet ÅÅÅÅÅ-MM-DD.

• Legg til en Render tekstmal Kommando fra Styret Kobling til kjeden
• Koble Start Node (Runtime Inputs) til Render Text Template Command
• Rediger kommandoen
  • Gi kommandoen et navn: Gjengi tekstmal - Opprett periodetast
  • I parameteret Mal skriver du inn følgende:
    

    {{År}}-{{Periode}}

  • I delen Variabler legger du til to variabler ved å klikke to ganger på knappen Legg til i delen Variabler
  • For den første variabelen angir du variabelnavnet som Year
    • Merk: Variabelnavn er sensitive for store og små bokstaver
  • Klikk i feltet Value
    • I variabelruten utvider du Trigger ➡ Runtime Inputs og velger Year
  • I den andre variabelen angir du navnet Period
  • Klikk i feltet Value
    • I variabelruten utvider du Trigger ➡ Runtime Inputs og velger Month
    • Klikk på variabelen Måned (som angitt av boblen) som ble tilordnet verdien
    • Klikk på rullegardinmenyen Velg transformasjon
      • Velg Parse tekst som JSON
      • Klikk på pluss-symbolet (+)
      • Klikk på rullegardinmenyen Velg transformasjon igjen
        • Velg Hent verdi fra JSON
        • Klikk på pluss-symbolet
      • I Hent verdi fra JSON ,
        • Velg "T" i rullegardinmenyen i Output-kolonnen
          • Merk: T er månedsvariabelen som ble etablert i forrige trinn
        • I kolonnen Verdi skriver du inn "verdi" og trykker på Enter-tasten
          • Merk: Tekstverdien må skrives med små bokstaver og vises som en grå boble etter at du har trykket på Enter-tasten
      • Klikk på Godta
• Lagre kommandoen

Trinn 4: Legg til en kommando for å utføre datooperasjoner

Vi bruker Handlebars Connector til å utføre flere datoperasjoner, inkludert datomatematikk og omformatering.

• Legg til en Render Text Template -kommando fra Handlebars Connector til Chain
• Koble kommandoen Render Text Template - Create Period Key til kommandoen Render Text Template
• Rediger kommandoen
  • Gi kommandoen et navn: Gjengi tekstmal - datoanalyse
  • I parameteren Template skriver du inn følgende:

Valgt tidsperiode

Måned: {{Måned_navn}}

År

Periodenøkkel: {{Period_Key}}

Nøkkel for slutten av månedsperioden: {{EOM_Key}}

• • I delen Malparameter
    • Klikk etter år
    • Utvid deretter Trigger ➡ Runtime Inputs og velg Year

Trinn 5: Variabelseksjon

• Legg til tre variabler ved å klikke på Legg til-knappen i Variabler-delen
  • For den første variabelen:
    • Angi det første variabelnavnet som Month_Name
      • Klikk i Verdi-feltet
        • I variabelruten utvider du Trigger ➡ Runtime Inputs og velger Month
      • Klikk på Måned variabelens boble i Verdi-feltet
        • Klikk på rullegardinmenyen Velg transformasjon
          • Velg Parse tekst som JSON, og klikk på pluss-symbolet (+)
        • Klikk på rullegardinmenyen Velg transformasjon igjen
          • Velg Get Value from JSON, og klikk på pluss-symbolet (+)
            • I Get Value from JSON-linjen velger du T fra rullegardinmenyen Output
            • I den samme Get Value from JSON-linjen skriver du inn display i Value-feltet og trykker på Enter-tasten
            • Klikk på Godta

• For den andre variabelen:
  • Angi variabelnavnet som Period_Key
    • Klikk i feltet Value
      • Utvid Render tekstmal - Opprett periodetast i variabelruten
        • Velg Rendert tekst
    • Klikk på Rendered Text -variabelens boble i Verdi-feltet
      • Klikk på rullegardinmenyen Velg transformasjon og velg Parse Date / Time, og klikk på plussknappen (+)
      • I den første nedtrekksboksen skriver du inn %Y-%m-%d og trykker på Enter
      • I feltet Output date format skriver du inn %m/%d/%Y
      • I rullegardinmenyen Tidssone for inndatadato skriver du inn UTC og velger deretter tidssonen (UTC) Dublin, Edinburgh, Lisboa, London
      • Gjenta UTC-valget for feltet Utdatadato tidssone
      • Klikk på Godta

• For den tredje variabelen:
  • Angi variabelnavnet som EOM_Key
    • Klikk i feltet Verdi. I variabelruten utvider du Render tekstmal - Opprett periodetast og velger Rendert tekst
    • Klikk på variabelen Rendered Text som ble tilordnet verdien
      • Klikk på rullegardinmenyen Velg transformasjon og velg Legg til / trekk fra dato og klokkeslett, og klikk på plusstegnet (+)
        • Skriv inn %Y-%m-%d i nedtrekksboksen Format, og trykk på Enter
        • I rullegardinmenyen Operasjon velger du Legg til
        • Skriv inn 1 i beløpsfeltet
        • I rullegardinmenyen Enhet velger du Måned
      • Legg til en ekstra Legg til / trekk fra dato og tidstransformasjon
        • Skriv inn %Y-%m-%d i nedtrekksboksen Format, og trykk på Enter
        • I rullegardinmenyen Operasjon velger du Subtrahere
        • Skriv inn 1 i beløpsfeltet
        • I rullegardinmenyen Enhet velger du Dag
      • Tidssonefelt for utdatadato
      • Klikk på Godta
• Lagre kommandoen

Trinn 6: Test kjeden

Nå som kjeden er ferdig, kan vi teste resultatet.

• Publiser kjeden
• Klikk på Execute og velg deretter Run With Inputs
• Fra rullegardinmenyen Måned velger du Februar. Skriv inn 2024 i årstallsinntastingen
• Klikk på Start. Se resultatene av kjeden på Log fanen i Render Text Template - Create Period Key Command
  • Verifiser Slutten av månedsperioden Nøkkel, f.eks. et skuddår

• Kjør kjeden på nytt med februar, men skriv inn 2025 for året for denne kjøringen
  • Bekreft at måneden sluttet på riktig dag, dvs. at det ikke er skuddår

Hvis du vil lære mer om datatransformasjon ved hjelp av kjeder, kan du sjekke ut Connected Learning Paths - Transformation Introduction!