Avvia un flusso di lavoro vuoto per il Servizio Meteo degli Stati Uniti

Puoi utilizzare il servizio meteorologico degli Stati Uniti per ottenere previsioni, poiché non hai bisogno di un account per accedere ai loro dati meteorologici.

Per ottenere le previsioni, devi effettuare due chiamate API al servizio meteorologico degli Stati Uniti:

• Uno per localizzare il punto di presa di una posizione geografica.
• La seconda per ottenere la previsione per la griglia identificata. 

Non è necessario avere dimestichezza con le chiamate API per seguire i passaggi di questa guida, che fornisce tutto il necessario per completare il flusso di lavoro.

Ecco i passaggi per creare il flusso di lavoro:

1. Crea il flusso di lavoro
2. Crea il foglio
3. Effettua l'autenticazione con Smartsheet e configura il trigger
4. Configura Get Row
5. Imposta la giunzione
6. Configura la prima chiamata API
7. Configura la seconda chiamata API
8. Imposta la riga di aggiornamento

Passaggio 1 - Crea il flusso di lavoro

1. In Bridge, seleziona Nuovo flusso di lavoro dalla dashboard Flussi di lavoro.

2. Assegna un nome al flusso di lavoro e seleziona Crea nuovo. 

   Tutti i flussi di lavoro iniziano con un trigger e uno stato.

Passaggio 2 - Crea il foglio

Prima di configurare il trigger in Bridge, hai bisogno di un foglio Smartsheet con almeno i seguenti nomi e tipi di colonna:

La colonna Previsioni meteo può essere la colonna principale o una normale colonna di testo. 

1.  Nella prima cella della colonna Today, incolla la seguente formula: =IF (Date @row = TODAY (), true, false)
2. Seleziona Invio. Questo seleziona la casella di controllo se il set di dati nella colonna Data è la data odierna, che puoi utilizzare per attivare il flusso di lavoro in Bridge.
3. Fai clic con il pulsante destro del mouse sulla cella con la formula e seleziona Converti in formula colonna. Ciò garantisce che tutte le nuove righe aggiunte al foglio utilizzino quella formula nella colonna Oggi.
4. Salva il foglio.
5. Prima di tornare a Designer in Bridge, copia l'ID del foglio. Puoi trovare l'ID del foglio andando su File > Proprietà.

Passaggio 3 - Imposta il trigger

Nel Designer, seleziona il Trigger nella parte superiore del flusso di lavoro. Si apre un pannello sul lato destro del Designer in cui è possibile impostare il tipo di trigger che si desidera utilizzare. 

Poiché il flusso di lavoro deve essere attivato da un evento in Smartsheet, il tipo di trigger utilizzato è un trigger di integrazione. Nel pannello, seleziona Pagina delle integrazioni nella sezione Integrazioni.

Brandfolder Image

Si apre una nuova scheda con la pagina Integrazioni. 

1. Trova Smartsheet e seleziona il logo. 
2. Seleziona Continue (Continua). 
3. Seleziona Autentica.
4. Nella finestra pop-up, seleziona Consenti.

Se l'autenticazione ha esito positivo, la finestra si trasforma nella scheda Trigger.

Brandfolder Image

Espandi la sezione Trigger e seleziona la riga con l'icona più:

1. Nel campo ID foglio, incolla l'ID del foglio che hai copiato quando hai creato il foglio. Se sai che il nome del foglio è univoco, digitalo.
2. Seleziona Quando i valori delle colonne vengono modificati nell'elenco a discesa Tipo di evento.
3. Nel campo che viene aggiunto quando selezioni il Tipo di evento, digita il nome della colonna Oggi.

4. Nell'elenco a discesa Seleziona flusso di lavoro, scegli il flusso di lavoro creato in precedenza e seleziona Salva.

   Puoi dire che il trigger è stato impostato correttamente perché il popup ricarica e comprime la sezione Trigger.

5. Chiudi la scheda e torna alla finestra di progettazione.

Errori durante il salvataggio del trigger

Se viene visualizzato un messaggio di errore quando salvi un trigger, esamina gli elementi seguenti:

• Assicurati di aver digitato il nome della colonna esattamente come hai fatto nel foglio. 
• Se hai digitato il nome del foglio anziché utilizzare l'ID del foglio, verifica di averlo digitato allo stesso modo. 
• Se non sei il proprietario del foglio, controlla le autorizzazioni del foglio per assicurarti di avere accesso.
• Se sono già impostati altri trigger, un altro trigger potrebbe causare un problema. Esamina gli altri trigger per assicurarti che su uno di essi non siano state modificate le autorizzazioni o che il foglio a cui si fa riferimento nel trigger esista ancora

Passaggio 4 - Configura Get Row (Ottieni riga)

Hai impostato il trigger per eseguire il flusso di lavoro quando modifichi la colonna Oggi; questa azione ora invia alcune informazioni di base a Bridge. Per la prima fase del flusso di lavoro, devi recuperare alcune di queste informazioni iniziali: 

1. Imposta la cella della data nella prima riga sulla data odierna. Questo seleziona automaticamente la casella nella colonna Oggi a causa della formula inserita in precedenza. 
2. Salva il foglio e torna alla finestra di progettazione in Bridge.
3. Apri il registro di esecuzione. Seleziona Aggiorna, una corsa dovrebbe apparire con lo stato Completato.
4. Per visualizzare i dati iniziali inviati a Bridge da Smartsheet, seleziona durante l'esecuzione, espandi la riga Trigger e quindi la riga Evento. 
5. Passa il mouse su RowID nei dati del trigger e seleziona l'icona Altro per visualizzare un elenco a discesa. 

6. Nel menu a discesa, seleziona Copia riferimento dati. Viene copiato un riferimento all’ID della riga modificato negli appunti.

   Utilizzando il riferimento anziché l'origine JSON, il flusso di lavoro ottiene sempre la riga modificata anziché guardare sempre la stessa riga. Questo è importante in quanto la modifica delle righe varia tra ogni esecuzione del flusso di lavoro. 

Brandfolder Image

Aggiorna lo stato e aggiungi un modulo

1. Seleziona lo stato grigio e modifica il campo Nome in Ottieni riga.

   È buona norma denominare gli stati in base a ciò che fanno i moduli sottostanti per facilitare la lettura dei flussi di lavoro.

2. Trova il modulo Get Row nel menu a sinistra. Usa il campo di ricerca o trovalo espandendo Integrazioni > Smartsheet > Ottieni riga.
3. Trascina il modulo nel flusso di lavoro sotto lo stato grigio. Un pannello per impostare il modulo si apre automaticamente. 
4. Nel campo Row ID, incolla il riferimento che hai copiato dal RowID nel registro di esecuzione. Il valore incollato deve essere {{runtime.event.rowid}}.
5. Per ottenere l'ID del foglio, apri nuovamente il registro di esecuzione ed espandi i dati del trigger per trovarlo. Copia il riferimento all'ID del foglio come hai fatto in precedenza per l'ID di riga selezionando l'icona Altro.
6. Seleziona nuovamente il modulo Get Row e incollalo nel riferimento nel campo Foglio. Il valore incollato deve essere {{runtime.sheetId}}.

7. Seleziona Salva nella parte superiore della pagina.

   Brandfolder Image

   

Passaggio 5 - Imposta la giunzione

È necessario determinare se la modifica alla casella di controllo nel foglio è stata selezionata o deselezionata. Una casella deselezionata deve essere ignorata; tuttavia, se la casella diventa selezionata, significa che la data impostata nella colonna Data è la data odierna e si desidera raccogliere le previsioni del tempo.

Per farlo, devi fare riferimento alla cella con la casella di spunta:

1. Torna al foglio e modifica la data nella riga aggiunta in precedenza per deselezionare la casella. Quindi salva il foglio.
2. In Bridge, apri nuovamente il registro delle esecuzioni e seleziona Tutte le esecuzioni in alto a sinistra del pannello. Aggiorna l'elenco per visualizzare una nuova corsa completata in alto. 
3. Apri questa nuova corsa ed espandi il passaggio Smartsheet: Get Row per rivelare i dati della riga.
4. In riga > celle > Oggi, puoi vedere che il valore è falso. Ciò indica che la casella di controllo nella colonna Oggi è stata deselezionata nella riga modificata. 
5. Utilizzando l’elenco a discesa, copia il riferimento ai dati di questo valore.

Aggiungi una giunzione condizionale Match (Corrispondenza)

Il passaggio successivo consiste nell'aggiungere una giunzione per verificare se il valore corrisponde ai valori di testo true (selezionato) o false (deselezionato). 

1. Nel campo di ricerca, digita Abbina o espandi Utilità > Giunzioni condizionali > Abbina per trovare la giunzione. 
2. Trascina il bivio sotto il modulo Get Row e assegnagli il nome Today's Date.

Questa giunzione è costituita da tre componenti: la giunzione stessa e due stati placeholder. Puoi trovare altri stati da trascinare nel flusso di lavoro nella parte superiore del menu a sinistra in Elementi bloccati > Nuovo stato.

Aggiungi stati alla giunzione

1. Trascina un nuovo stato nel segnaposto di successo e assegnagli un nome vero. 
2. Trascina un altro nuovo stato nel segnaposto dell'errore e assegnagli il nome falso.

Aggiungi il riferimento dati alla giunzione

1. Seleziona l'incrocio Today's Date per aprire il pannello di configurazione. 
2. Incolla il riferimento copiato in precedenza nel campo Primo valore.
   Il valore incollato deve essere {{states.get row.smartsheet.get_row.row.cells.today.value}}
3. Nel campo Secondo valore, digita la parola true. 

4. Salva ciò che hai creato finora.

   Brandfolder Image

   

Passaggio 6 - Configura la prima chiamata API

Configura un profilo per le chiamate API

Per recuperare i dati delle previsioni del tempo, devi prima creare un profilo per le tue chiamate API allo US Weather Service. I profili sono un modo per salvare le informazioni essenziali per le API di sistema a cui desideri connettere i flussi di lavoro.

1. Nel tuo account Bridge, vai alla scheda Integrazioni.
2. Seleziona l'utilità Call API.

3. Seleziona Continua > Aggiungi ai profili.

   Brandfolder Image

   

    

4. Assegna un nome al profilo. Ogni nome del profilo deve essere univoco. Ad esempio: Meteo Stati Uniti.
5. Nel campo URL di base, inserisci https://api.weather.gov.
6. Espandi il menu a discesa Headers:
   • Nel campo Key #1, inserisci User-Agent.

   • Nel campo Valore #1, inserisci il nome e l'email della tua azienda, separati da una virgola.

     Il servizio meteorologico degli Stati Uniti lo richiede in modo che possa contattarti se rileva attività o comportamenti imprevisti nei suoi registri.

7. Salva il profilo.
8. Torna al flusso di lavoro.

Configura il modulo Make API Call nel flusso di lavoro

La prima chiamata API identifica il punto della griglia di una posizione immessa nel foglio.

1. Usa il campo di ricerca per trovare il modulo Make API Call o espandi Utility > Utility Functions > Make API Call.
2. Trascinalo nel flusso di lavoro nello stato reale.
3. Nel modulo Make API Call (Crea chiamata API), seleziona il profilo che hai appena creato dal menu a discesa.
4. Nel campo Endpoint, includi i seguenti punti: points/ {{states.get row.smartsheet.get_row.row.row.cells.longitude.value}}, {{states.get row.smartsheet.get_row.row.cells.latitude.value}}
5. Imposta il metodo su GET.

6. Salva il flusso di lavoro.

   Brandfolder Image

   

Riferimenti dati per la chiamata griglia

L'URL sopra riportato è stato creato per te poiché la comprensione del funzionamento delle richieste API è facoltativa per questa guida. Questo URL fa riferimento ai valori di longitudine e latitudine sulla riga che ha attivato il flusso di lavoro.

Se desideri ottenerli, devi attivare nuovamente il flusso di lavoro. Questa volta, devi assicurarti che la casella di controllo sia selezionata. Aggiungi informazioni a una nuova riga anziché utilizzare la prima e assicurati di impostare la data sulla data odierna in modo che il flusso di lavoro segua il ramo sinistro dell'incrocio.

Coordinate

Il Servizio meteo degli Stati Uniti richiede un massimo di quattro cifre decimali per le coordinate.

Fase richiesta

Sarebbe meglio avere le coordinate per inserirle nei campi Longitudine e Latitudine. Ad esempio, puoi utilizzare i numeri 47.6174 e -122.2001 per conoscere il meteo presso l’ufficio Smartsheet di Bellevue.

Passaggio 7 - Configura la seconda chiamata API

La seconda chiamata API recupera le previsioni dal Servizio meteo degli Stati Uniti in base ai punti della griglia precedentemente individuati. Per configurarlo, aggiungi un nuovo stato e un altro modulo Make API Call al flusso di lavoro. 

1. Trascina e rilascia un nuovo stato dagli elementi bloccati nella parte superiore del menu a sinistra e chiamalo Ottieni previsioni.
2. Trascina un altro modulo Make API Call nel nuovo stato.
3. Nel modulo Make API Call (Crea chiamata API), seleziona il profilo che hai appena creato dal menu a discesa.
4. Nel campo Endpoint, includi quanto segue: gridpoints/ {{states.true.call_api.make_api_call.response.properties.gridiD}}/{{states.true.call_api.make_api_call.response.properties.gridX}}, {{states.true.call_api.make_api_api_call.response.properties.gridy}} /previsione
5. Imposta il metodo su GET.

6. Salva il flusso di lavoro.

   Brandfolder Image

   

Riferimenti ai dati per la chiamata previsioni

Se desideri utilizzare i riferimenti ai dati nell'endpoint precedente, attiva nuovamente il flusso di lavoro. Assicurati che la riga modificata o aggiunta abbia la data odierna, in modo che la casella di controllo diventi selezionata.

Dopo aver creato la nuova riga e salvato il foglio, trova l'ultima esecuzione nel registro di esecuzione ed espandi il passaggio precedente: Chiama API: effettua una chiamata API. In Output > properties, individua i campi GridID, GridX e GridY. È quindi possibile utilizzare questi riferimenti nell'URL per chiamare il servizio meteo.

Passaggio 8: imposta la riga di aggiornamento

Ora che puoi ottenere i dati meteo con il flusso di lavoro, l’ultimo passaggio consiste nell’aggiornare il foglio con le previsioni.

Aggiungi gli ID di foglio e riga

1. Attiva di nuovo il flusso di lavoro. Assicurati che la riga modificata o aggiunta abbia la data odierna, in modo che la casella di controllo diventi selezionata.
2. Aggiungi un altro stato nell'ultimo modulo di chiamata API e chiamalo Update Row.
3. Cerca il modulo Aggiorna riga o espandi Integrazioni > Smartsheet > Aggiorna riga.
4. Dal registro di esecuzione, espandi il Trigger dell'ultima esecuzione e individua i valori dell'ID del foglio e dell'ID di riga. 
5. Utilizza i riferimenti ai dati per impostare i campi ID foglio e ID riga per il modulo Update Row.

Aggiungi il riferimento ai dati dettagliati della previsione

1. Torna al registro di esecuzione ed espandi l'ultimo passaggio (l'ultimo dei due moduli Make API Call). I dati del servizio meteorologico degli Stati Uniti, comprese le previsioni meteorologiche per sette giorni, forniscono una serie di informazioni. e la data è 
2. Trova il meteo attuale in Uscita > proprietà > periodi > 0.
3. Per questo flusso di lavoro, si desidera utilizzare il riferimento dettagliato della previsione. Copiare il riferimento ai dati. 
4. Apri nuovamente il modulo Update Row ed espandi la sezione Celle. 
5. Incolla il riferimento nel campo Valore #. Il valore incollato deve essere: {{states.get forecast.call_api.make_api_call.response.properties.Periods.0.detailedForecast}}
6. Inserisci la colonna Previsioni meteo nel campo Chiave #1.
7. Salva il flusso di lavoro.

Se vuoi assicurarti che il flusso di lavoro non fallisca se il servizio meteorologico degli Stati Uniti non è in grado di restituire le informazioni, puoi modificare il riferimento ai dati nel campo Value # su: {{states.get forecast.call_api.make_api_call.response.properties.periods.0.detailedForecast||Unable to fetch weather data}} Ciò assicura che il modulo aggiorni la riga con il testo dopo il simbolo '||' se presente nessun dato nella previsione dettagliata.

Brandfolder Image

Flusso di lavoro completato

Il flusso di lavoro viene eseguito ogni volta che aggiungi una nuova riga (scendendo lungo il ramo sinistro o destro dell'incrocio). Viene inoltre eseguito in qualsiasi momento oggi, alla data impostata su una riga esistente. La colonna Previsioni meteo del foglio si compila automaticamente se il flusso di lavoro segue il ramo sinistro dell'incrocio o se la casella Oggi è selezionata.