|
A partire da gennaio 2021, i tipi di file classici non potranno più essere utilizzati. È possibile effettuare la transizione dei file classici o scaricare un PDF. Ulteriori informazioni

Centro assistenza di Workiva

CLP - Trasformazione Handlebars

CLP - Trasformazione Handlebars

  • Ultimo aggiornamento

In questo Percorso Didattico Collegato, creeremo una catena che illustra come sfruttare il connettore Handlebars per analizzare i dati di una risposta HTTP e per creare variabili che possono essere utilizzate in una catena.

Obiettivo di apprendimento primario Funzionalità dei comandi del manubrio
Obiettivi didattici secondari Connettore Catene Workiva
Prerequisiti Configura la connessione Handlebars Connector.
Configura la connessione Workiva Chains Connector.
Modello di supporto CLP | Configurazione Manubri

Passo 1: Creare una catena

  1. Aggiungi una nuova catena .
  2. Dai un nome alla Catena CLP | Configurazione Manubri.
  3. Crea una variabile Chain. Inserisci i seguenti valori per il nome e il valore della variabile:
    • Nome della variabile: cv-AllStations
    • Valore della variabile: https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/station_information.json
  4. Salva la catena.

Passo 2: Recuperare i dati JSON

Questo passaggio utilizza il connettore HTTP per recuperare i dati relativi a Citibike in formato JSON da un sito web.

  1. Aggiungi un comando GET dal connettore HTTP al nodo Start.

  2. Configura il comando utilizzando i seguenti valori:

    Nome GET - Tutte le stazioni
    Nome utente <leave blank>
    Password <leave blank>
    Certificato CA <leave blank>
    Certificato <leave blank>
    Chiave privata del certificato <leave blank>
    Mostra risposta Selezionata
    URL cv-AllStations Variabile di catena
    Stringa di query <leave blank>
    Tipo di contenuto applicazione/json
    Risposta <leave blank>
  3. Salva il comando.
    image (79).png

Passo 3: iterazione dei dati JSON

Usa il comando Handlebars - Render Text template per iterare i dati delle stazioni CitiBike in modo da ottenere un formato che fornisca i dati di ogni singola stazione combinati.

  1. Aggiungi il comando Handlebars - Render Text Template all'area di disegno della catena.
  2. Collega il comando GET - All Stations al comando Handlebars - Render Text Template.
  3. Fai doppio clic sul comando per modificarlo.
    1. Dai un nome al comando: RTT - Parsing JSON Response.
    2. Aggiungi una variabile JSON e chiamala citibikeData.
    3. Per il campo Value utilizza la variabile Response del comando Get - All Stations.

    4. Compila il campo modello con il seguente valore:

      {{#each citibikeData.data.stations}} {{@index}} | {{name}} | {{capacity}} {{/each}}

      Questo permetterà al comando di iterare la risposta JSON, utilizzando un percorso principale di data.stations per fornire i valori di testo di ogni chiave: ("name", "capacity"). Inoltre, aggiungerà un valore index per ogni riga elaborata.

  4. Salva il comando.
    image (80).png

Passo 4: Templatizzare le variabili di runtime

Usa il comando Handlebars - Render Text Template per templatizzare le variabili. In questo modo la Catena potrà renderizzare un modello di testo che fornisca un contesto ai diversi componenti della Catena in base al suo tempo di esecuzione.

  1. Aggiungi il comando Handlebars - Render Text Template all'area di disegno della catena.
  2. Collega il comando GET - All Stations al comando Handlebars - Render Text Template.
  3. Fai doppio clic sul comando per modificarlo, utilizzando i seguenti valori:
    1. Dai un nome al comando: RTT - Templatizzazione delle variabili.
    2. Aggiungi e popola le seguenti informazioni per la sezione variabili:
      I campi Valore saranno popolati dal menu a tendina Runtime del riquadro delle variabili di sinistra.
      • Variabile 1
        • Nome della variabile: Chain-Env
        • Valore: <Chain.Enviroment> (Variabile di runtime)
      • Variabile 2
        • Nome della variabile: Chain-Exec-Time
        • Valore: <Chain.ExecutionDateTime> (Variabile di runtime)
      • Variabile 3
        • Nome della variabile: Sistema-Ora-Mese
        • Valore: <System.DateTime> (Variabile di runtime)
          1. Clicca sulla variabile di runtime <System.DateTime> per trasformare la variabile.
          2. Su seleziona la trasformazione, scegli Parse Date/Time e clicca su "+".
          3. Nel primo campo del valore, scegli "ISO Extended (Platform Standard)".
          4. Nel campo Formato della data di uscita, inserisci "%m".
          5. Nel campo Fuso orario della data di ingresso, scegli "UTC (Etc/UTC)".
          6. Nel campo Fuso orario della data di uscita, scegli "UTC (Etc/UTC)".
          7. Clicca su Accetta.
      • Variabile 4
        • Nome della variabile: System-RunTime-Year
        • Valore: <System.DateTime> (Variabile di runtime)
          1. Fai clic sulla variabile di runtime <System.DateTime> per trasformare la variabile
          2. In Seleziona la trasformazione, scegli Parse Date/Time e clicca su "+".
          3. Nel primo campo del valore, scegli "ISO Extended (Platform Standard)".
          4. Nel campo Formato data di uscita, inserisci "%Y".
          5. Nel campo Fuso orario della data di ingresso, scegli "UTC (Etc/UTC)".
          6. Nel campo Fuso orario della data di uscita, scegli "UTC (Etc/UTC)".
          7. Clicca su Accetta.
    3. Compila il campo modello con i seguenti valori:
      • Ambiente della catena: {{Chain-Env}}
      • Data di esecuzione della catena: {{Chain-Exec-Time}}
      • Tempo di esecuzione del sistema Mese-anno: {{System-RunTime-Month}}-{System-RunTime-Year}}
  4. Salva il comando.
    2023-08-16_12-49-57.gif

Passo 5: Templatizzazione delle variabili dell'area di lavoro - Ottieni spazi di lavoro

Utilizza Handlebars - Render Text Template per creare un modello di testo per i componenti di un'area di lavoro. In questo modo la catena potrà visualizzare un modello di testo che fornisce il contesto dei diversi componenti dell'area di lavoro in cui si trova la catena.

  1. Aggiungi il comando Get Workspaces dal connettore Catene di Workiva all'area di disegno Catena.
  2. Collega il comando GET - All Stations al comando Get Workspaces.
  3. Fai doppio clic sul comando per modificarlo e conferma che la connessione è corretta.
  4. Salva il comando.
    image (48).png

Passo 6: Templatizzazione delle variabili dell'area di lavoro - RTT - WorkspaceID

  1. Aggiungi il comando Handlebars - Render Text Template all'area di disegno Chain.
  2. Collega il comando Ottieni spazi di lavoro al comando Maniglie - Modello di testo di rendering.
  3. Fai doppio clic sul comando per modificarlo.
    • Nome del comando RTT - WorkspaceID.

    • Inserisci il seguente valore nel campo Template:

      {{#each workspaces}} {{#if (nome uguale "<(chain.workspace)>") }} {{id}}{{/if}}{{/each}}
  4. Seleziona la variabile <Chain.Workspace> dalla sezione Variabili di runtime nel pannello di sinistra
  5. Nel campo JSON Variables, inserisci le seguenti informazioni:
    • Nome della variabile: workspaces
    • Valore della variabile:: <Spazi di lavoro>
  6. Espandi la variabile Get Workspaces dal pannello delle variabili a sinistra e seleziona Workspaces.
  7. Salva il comando.
    image (49).png

Passo 7: Templatizzazione delle variabili dell'area di lavoro - Ottieni ambienti

  1. Aggiungi il comando Get Environments dal Connettore Catene di Workiva all'area di disegno della catena.
  2. Collega il comando RTT - WorkspaceID al comando Ottieni ambienti.
  3. Fai doppio clic sul comando per modificarlo e inserisci la variabile Rendered Text dal comando RTT-WorkspaceID nel campo dell'ID dello spazio di lavoro.
  4. Salva il comando.
    image (50).png

Passo 8: Templatizzazione delle variabili dell'area di lavoro - RTT - EnvironmentID

  1. Aggiungi il comando Handlebars - Render Text Template al canvas Chain.
  2. Collega il Comando Ottieni ambienti al Comando Manubri - Render Text Template.

  3. Fai doppio clic su questo comando per modificarlo, utilizzando i seguenti valori:

    1. Nome del comando: RTT - EnvironmentID.

    2. Inserisci il seguente valore nel campo Template:

      {{#each environments}} {{#if (nome uguale "<(chain.environment)>") }} {{id}}{{/if}}{{/each}}

      La variabile <Chain.Environment> è una variabile Runtime e si trova nel pannello di sinistra.

    3. Nel campo JSON variables, inserisci le seguenti informazioni:
      • Nome della variabile: ambienti
      • Valore della variabile: <Ambienti>
        Questo valore si trova nel pannello delle variabili a sinistra sotto il comando Ottieni ambienti.
    4. Salva il comando.
      image (51).png

    Passo 9: Prova l'esercizio

    1. Pubblica la Catena.
    2. Clicca su Execute, quindi seleziona Run Chain.
    3. Una volta che la Catena ha completato la sua esecuzione:
      Conferma che tutti i nodi sono stati eseguiti con successo cliccando sul comando RTT - Parsing JSON Response Command e verificando che le prime righe dell'output siano le seguenti:
      image (52).png

    4. Clicca sul comando RTT - Templatizing Variables eseguito e verifica che il testo visualizzato sia corretto nella scheda "Logs".
      image (53).png

      Nota: Questi valori cambiano in base all'ambiente in cui viene eseguita la Catena e al momento in cui viene eseguita.
    5. Clicca sul nodo RTT - Environment ID e seleziona la scheda Outputs.
    6. Conferma che un valore è stato popolato per la variabile testo renderizzato (anche in questo caso, il risultato varia a seconda dell'ambiente in cui ti trovi).
      2023-08-10_16-56-22.gif

    Per saperne di più

    Per saperne di più sulla trasformazione dei dati utilizzando le catene, visita Percorsi didattici collegati - Introduzione alla trasformazione

In questo Percorso Didattico Collegato, creeremo una catena che illustra come sfruttare il connettore Handlebars per ...