CLP - Utilizzare i valori di un foglio di controllo – Centro assistenza

Sfruttare i valori di un foglio di controllo per i flussi di lavoro a catena richiede la lettura e l'applicazione sistematica di questi valori nei comandi. In questo Percorso Didattico Collegato esploreremo come leggere e utilizzare i valori di un Foglio di Controllo e come utilizzare un Gruppo di Comandi per iterare più righe in modo efficiente.

Caso d'uso primario	Orchestrazione dei flussi di lavoro di reporting da una postazione centralizzata Semplificare la gestione dei flussi di lavoro per gli utenti finali
Obiettivo di apprendimento primario	Imparare a utilizzare i valori di un foglio di controllo in una Catena
Obiettivi didattici secondari	Imparare a usare i comandi condizionali, gli iteratori JSON e il connettore Handlebars
Prerequisiti	Completa CLP \| Creare e leggere un foglio di controllo Configura i seguenti connettori: - JSON - Manubri
Modello di supporto	CLP \| Usare i valori di un foglio di controllo

Passo 1: Modifica della catena esistente

Naviga in Chain Builder e individua la catena CLP | Lettura da un foglio di controllo
Clicca sul pulsante con la matita per modificare la Catena
Clicca su Impostazioni della catena in alto a destra
- Rinomina la catena: CLP | Utilizzo dei valori di un foglio di controllo
Salva la catena

Passo 2: convertire il foglio di controllo in JSON

Per utilizzare efficacemente i valori di un foglio di controllo, convertiremo l'output del comando Get Sheet Data dal formato CSV a JSON. Questa conversione stabilisce coppie chiave-valore tra le intestazioni del foglio di controllo e i valori corrispondenti nelle righe sotto ogni intestazione, consentendo un'iterazione efficiente.

Aggiungi un comando CSV to JSON dal connettore JSON all'area di disegno a catena
Collega il comando Ottieni dati foglio al comando CSV to JSON
Fai doppio clic sul comando per configurarlo
- Dai un nome al comando: Converti foglio di controllo in JSON
- Clicca sul campo File di input
  - Nel pannello Seleziona una variabile, clicca sulla freccia verso il basso per espandere Ottieni dati del foglio
  - Seleziona l'output Data
- Lascia il campo delimitatore come Virgola (,)
- Salva il comando

Passo 3: Aggiungere un gruppo di comandi

Aggiungi un gruppo di comandi alla catena per abilitare l'iterazione su ogni riga del foglio di controllo. Questo ci permette di far passare ogni riga del foglio di controllo attraverso la serie di comandi del gruppo.

Aggiungi un Gruppo di comandi all'area di disegno Catena
Collega il comando Convertire il foglio di controllo in JSON alla sezione In del Gruppo di Comandi
Fai doppio clic sul gruppo di comandi per configurarlo
- Dai un nome al gruppo: Iteratore del foglio di controllo
- Vai alla scheda Iteratori
  - Attiva la levetta Iterazioni e clicca sul campo Iterazioni
    - Nel pannello Seleziona una variabile, clicca sulla freccia verso il basso per espandere Convertire il foglio di controllo in JSON
    - Seleziona l'output JSON
- Salva il comando

Ora che il comando è stato configurato, itererà ogni riga del foglio di controllo e fornirà un output per ogni riga.

Passo 4: Aggiungere un comando condizionale

All'interno di un foglio di controllo, gli utenti possono stabilire se desiderano che una determinata riga venga eseguita all'interno di un flusso di lavoro. Questo viene sfruttato tramite la colonna ActiveFlag. Utilizzeremo un comando condizionale per determinare se il flusso di lavoro deve continuare per ogni riga del foglio di controllo.

Aggiungi un Comando condizionale Evento a catena all'area di disegno Catena
Collega il Gruppo Inizio all'interno del Foglio di controllo Iteratore Gruppo al Comando condizionale
Fai doppio clic sul comando per configurarlo
- Dai un nome al comando: Bandiera attiva?
- Lascia la condizione AND e clicca sul pulsante + RULE
- Verifica che il tipo di dati sia impostato su Stringa e modifica l'operazione da Is Blank a =
- Clicca nel campo aperto sul lato sinistro del comando (il valore da testare)
  - Dal pannello Seleziona una variabile, clicca sulla freccia verso il basso per espandere Iteratore di gruppo
  - Seleziona <> Iterazione file JSON
  - Clicca sulla pillola verde JSON File Iteration per trasformare la Variabile
    - Clicca su Seleziona una trasformazione e scegli Ottieni valore da JSON
    - Premi il segno verde +
    - Nel campo del valore digita l'intestazione ActiveFlag esattamente come si trova nel foglio di controllo e premi invio.
    - Seleziona un'altra trasformazione e scegli Minuscolo
    - Premi il segno verde +
    - Clicca su Accetta

- Nel Comando Condizionale, a destra (il valore da confrontare), digita la parola vero
  - Assicurati che sia in minuscolo, poiché la trasformazione della variabile applicata in precedenza rende il valore del flag attivo tutto in minuscolo.
Salva il comando

Fase 5: alimentazione delle uscite a un comando

A questo punto, l'iteratore del foglio di controllo è impostato per fornire i valori a qualsiasi Comando che esiste nel Gruppo iniziale del Gruppo di Comandi. Utilizzeremo un comando Handlebars come segnaposto per visualizzare i valori recuperati, che possono essere utilizzati in modo iterativo nei comandi successivi.

Aggiungi un Modello di testo di rendering Comando dal connettore Handlebars all'area di disegno a catena
Collega il comando Bandiera attiva? Comando al modello di testo di rendering Comando
Fai doppio clic sul comando per configurarlo
- Nome del comando: Cattura Valori Foglio di Controllo
- Nel campo Template, inserisci le seguenti informazioni:
  - Riga superiore: Informazioni sul foglio di controllo
  - Seconda riga: Nome del file: <JSON>
    - Sostituisci <JSON> dal pannello Seleziona una variabile, clicca sulla freccia verso il basso per espandere Iteratore di gruppo
    - Seleziona <> Iterazione file JSON

- - - Clicca sulla pillola verde JSON File Iteration per trasformare la Variabile
      - Clicca su Seleziona una trasformazione e scegli Ottieni valore da JSON
      - Premi il segno verde +
      - Nel campo del valore digita FileName esattamente come si trova nel foglio di controllo e premi invio.
      - Clicca su Accetta

- Ripeti i passaggi per le righe terza, quarta e quinta.
  - Sostituisci il segnaposto <JSON> con la variabile del foglio di controllo.
    - ID tabella: <JSON>
      - Segui gli stessi passi di prima, ma usa TableID invece di FileName.
    - ID del foglio di calcolo: <JSON>
      - Segui gli stessi passi di prima, ma usa SpreadsheetID invece di FileName.
    - Posizione del file: <JSON>
      - Segui gli stessi passi di prima, ma usa FileLocation invece di FileName.
Salva il comando

Nota: Segui i passaggi descritti per estrarre qualsiasi intestazione e recuperare i valori delle righe corrispondenti da un foglio di controllo.

Passo 6: Prova l'esercizio

Ora che la Catena è completa, verifica il risultato.

Pubblica la catena
Clicca su Esegui e poi seleziona Esegui catena
Una volta completata la Catena, clicca sul comando Capture Control Sheet Values per verificarne il successo.
- Lascia che la Catena si completi completamente prima di cliccare sul Comando
Ci sarà un campo con scritto Valore 1
- Se fai clic su questo campo, ti verrà mostrato che il comando ha elaborato tre valori diversi, questi valori sono le tre righe di dati del foglio di controllo.
Clicca sul campo Log per ogni singolo valore e verifica che corrisponda ai valori del foglio di controllo.