In questo Percorso Didattico Collegato, creeremo una Catena che illustra come tenere conto dinamicamente di un anno bisestile.
| Obiettivo di apprendimento primario | Evidenziare la potenza della Trasformazione Variabile per le operazioni con le date, compresa l'analisi, la formattazione e l'esecuzione di operazioni matematiche. |
| Obiettivi didattici secondari | Evidenziare l'uso di Runtime Inputs, Handlebars, e JSON parsing in Variabili |
| Prerequisiti | Configurare il connettore Handlebars |
| Modello di supporto | CLP | Trasformazione di variabili |
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
- Aggiungi un Input Runtime al nodo Start
- 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 opzioni per i restanti undici mesi dell'anno. Aggiorna il valore e i nomi di visualizzazione di conseguenza
- 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.
- Dal menu a tendina della colonna Output, seleziona "T".
- 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
- Nella sezione Parametri del modello
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
- Seleziona Ottieni valore da JSON, e clicca sul simbolo più (+)
- Clicca sul menu a tendina Seleziona trasformazione
- Clicca nel campo Valore
- Specifica il nome della prima variabile come Nome_mese
- Per la prima variabile:
- 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
- Nel riquadro delle variabili, espandi Modello di testo renderizzato - Crea chiave di periodo
- 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
- Clicca sul campo Value
- Specifica il nome della variabile come Period_Key
- 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
- Clicca sul menu a tendina Seleziona trasformazione e seleziona Aggiungi / Sottrai data e ora, quindi clicca sul simbolo più (+)
- Specifica il nome della variabile come EOM_Key
- 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!