Centro assistenza di Workiva

In questo Percorso Didattico Collegato, creeremo una Catena che illustra come tenere conto dinamicamente di un anno bisestile.

Passo 1: Creare una catena

• Dal Modulo Catene del tuo ambiente di lavoro, seleziona l'Ambiente DEV
• Aggiungi una nuova catena
  • Assegna un nome alla catena, CLP | Trasformazione variabile | Parsing Date and Time.
  • Aggiungi la descrizione: Il modello Connected Learning Path Chain illustra come un input di runtime per il mese e l'anno possa generare dinamicamente diversi formati di chiavi di periodo e tenere conto degli anni bisestili.Questo modello utilizza la Trasformazione Variabile per riformare le date e calcolare la chiave del periodo finale tenendo conto dinamicamente degli anni bisestili.
• Salva la catena

Passo 2: Aggiungere un input di runtime

Runtime Inputs illustra come una Catena può richiedere dei valori in fase di esecuzione. Questo è un modo prezioso per rendere le Catene utilizzabili in più processi.

• Crea il comando
  • Aggiungi un Input Runtime al nodo Start
    Usa la barra di ricerca per cercare "runtime". Poi fai doppio clic per caricare automaticamente il comando nel cerchio iniziale.
  • Clicca su Add Input e seleziona DropdownField.
  • Configura il campo a discesa con il seguente testo:
    

    Mostrare nome	Mese
    Richiesto	Controllato
    Descrizione	Seleziona il mese corrente

  • Clicca su Aggiungi opzione
  • Configura l'opzione come segue:
    

    Valore	{"display":"January","value":"01-01"}
    Mostrare nome	Gennaio
    Impostazione predefinita	Non spuntato

• Completa il campo a tendina
  • Aggiungi opzioni per i restanti undici mesi dell'anno. Aggiorna il valore e i nomi di visualizzazione di conseguenza
    • Esempio: {"display":"February","value":"02-01"}
• Aggiungi un campo numerico Ingresso runtime
  • Dopo aver completato l'inserimento del campo a discesa, aggiungi un ingresso NumberField
  • Configura il campo NumberField con il seguente testo:
    

    Mostrare nome	Anno
    Richiesto	Controllato
    Descrizione	Inserisci l'anno corrente nel formato YYYY
    Valore predefinito	<leave blank>
    Valore minimo (verificato)	2000
    Valore massimo (verificato)	2050

• Salva l'input di runtime

Passo 3: Aggiungere un comando per creare una chiave di periodo

Utilizziamo il connettore Handlebars per prendere i valori specificati negli input del runtime e creare una chiave di periodo nel formato YYYY-MM-DD.

• Aggiungi un comando Modello di testo di rendering dal connettore Handlebars alla catena
• Collega il nodo iniziale (ingressi di runtime) al modello di testo di rendering Comando
• Modifica il comando
  • Nome del comando: Modello di testo di rendering - Crea chiave di periodo
  • Nel parametro Template, inserisci quanto segue:
    

    {{Year}}-{{Period}}

  • Nella sezione Variabili, aggiungi due variabili cliccando due volte sul pulsante Aggiungi nella sezione Variabili
  • Per la prima variabile, specifica il nome della variabile come Anno
    • Nota: i nomi delle variabili sono sensibili alle maiuscole e alle minuscole.
  • Clicca nel campo Value
    • Nel riquadro Variabili, espandi Trigger ➡ Runtime Inputs e seleziona Anno
  • Nella seconda variabile, specifica il nome Periodo
  • Clicca nel campo Value
    • Nel riquadro Variabili, espandi Trigger ➡ Runtime Inputs e seleziona Mese
    • Clicca sulla variabile Month (come indicato dalla bolla) che è stata assegnata al valore
    • Clicca sul menu a tendina Seleziona la trasformazione
      • Seleziona Parse text as JSON
      • Clicca sul simbolo più (+)
      • Clicca di nuovo sul menu a tendina Seleziona la trasformazione
        • Seleziona Ottieni valore da JSON
        • clicca sul simbolo più
      • Nella sezione Ottieni valore da JSON ,
        • Dal menu a tendina della colonna Output, seleziona "T".
          • Nota: T è la variabile del mese stabilita nel passaggio precedente.
        • Nel campo della colonna Valore, inserisci "valore" e premi il tasto Invio
          • Nota: il valore del testo deve essere in minuscolo e apparirà come una bolla grigia dopo aver premuto il tasto Invio.
      • Clicca su Accetta
• Salva il comando

Passo 4: Aggiungi un comando per eseguire operazioni sulla data

Utilizziamo il connettore Handlebars per eseguire diverse operazioni sulla data, tra cui la matematica della data e la riformattazione.

• Aggiungi un comando Modello di testo di rendering dal Connettore Manubrio alla Catena
• Collega il comando Modello di rendering del testo - Creare la chiave del periodo al comando Modello di rendering del testo
• Modifica il comando
  • Nome del comando: Render Text Template - Parsing della data
  • Nel parametro Template, inserisci quanto segue:

Periodo di tempo selezionato: 

  Mese: {{Month_Name}} 

  Anno: 

  Chiave del periodo: {{Period_Key}} 

  Chiave del periodo di fine mese: {{EOM_Key}}

• • Nella sezione Parametri del modello
    • Clicca dopo Anno
    • Poi espandi il Trigger ➡ Runtime Inputs e seleziona Anno

Passo 5: sezione Variabili

• Aggiungi tre variabili cliccando sul pulsante Aggiungi nella sezione Variabili
  • Per la prima variabile:
    • Specifica il nome della prima variabile come Nome_mese
      • Clicca nel campo Valore
        • Nel riquadro Variabili, espandi Trigger ➡ Runtime Inputs e seleziona Mese
      • Clicca sulla bolla della variabile Mese nel campo Valore
        • Clicca sul menu a tendina Seleziona trasformazione
          • Seleziona Parse text as JSON, e clicca sul simbolo più (+)
        • Clicca di nuovo sul menu a tendina Seleziona la trasformazione
          • Seleziona Ottieni valore da JSON, e clicca sul simbolo più (+)
            • Nella riga Ottieni valore da JSON, seleziona T dal menu a tendina Output.
            • Nella stessa riga di Get Value from JSON, inserisci visualizza nel campo Value e premi il tasto Invio.
            • Clicca su Accetta

• Per la seconda variabile:
  • Specifica il nome della variabile come Period_Key
    • Clicca sul campo Value
      • Nel riquadro delle variabili, espandi Modello di testo renderizzato - Crea chiave di periodo
        • Seleziona Testo renderizzato
    • Clicca sulla bolla della variabile Testo renderizzato nel campo Valore
      • Clicca sul menu a tendina Seleziona la trasformazione e seleziona Parse Date / Time, quindi clicca sul pulsante più (+)
      • Nella prima casella a discesa, inserisci %Y-%m-%d e premi Invio.
      • Nel campo Formato data di output, inserisci %m/%d/%Y
      • Nel menu a tendina Fuso orario data di ingresso, digita UTC e seleziona il fuso orario (UTC) Dublino, Edimburgo, Lisbona, Londra
      • Ripeti la selezione del fuso orario UTC per il campo Data di uscita
      • Clicca su Accetta

• Per la terza variabile:
  • Specifica il nome della variabile come EOM_Key
    • Clicca nel campo Valore. Nel riquadro delle variabili, espandi Modello di rendering del testo - Creare la chiave del periodo e seleziona Testo renderizzato
    • Clicca sulla variabile Rendered Text a cui è stato assegnato il valore
      • Clicca sul menu a tendina Seleziona trasformazione e seleziona Aggiungi / Sottrai data e ora, quindi clicca sul simbolo più (+)
        • Nel menu a tendina Formato, inserisci %Y-%m-%d e premi Invio.
        • Nel menu a tendina Operazione, seleziona Aggiungi
        • Nel campo Importo, inserisci 1
        • Nel menu a tendina Unità, seleziona Mese
      • Aggiungi un ulteriore Aggiungi / Sottrai Data e trasformazione dell'ora
        • Nel menu a tendina Formato, inserisci %Y-%m-%d e premi Invio.
        • Nel menu a tendina Operazione, seleziona Sottrai.
        • Nel campo Importo, inserisci 1
        • Nel menu a tendina Unità, seleziona Giorno
      • Campo data di uscita fuso orario
      • Clicca su Accetta
• Salva il comando

Passo 6: Verifica la Catena

Ora che la Catena è completa, possiamo testare il risultato.

• Pubblica la catena
• Clicca su Esegui e poi seleziona Esegui con gli input
• Dal menu a tendina Month, seleziona February. Nell'input Anno, inserisci 2024
• Clicca su Avvia. Esamina i risultati della catena nella scheda Log del modello Render Text - Crea chiave periodo Comando
  • Verifica la chiave Periodo di fine mese cioè un anno bisestile

• Esegui nuovamente la catena utilizzando il mese di febbraio ma inserisci 2025 come anno per questa esecuzione.
  • Confermare che il mese è terminato nel giorno corretto, cioè non è un anno bisestile.

Per saperne di più sulla trasformazione dei dati utilizzando le catene, consulta il sito Percorsi di formazione connessi - Introduzione alla trasformazione!