Commencer un flux de travail vierge pour le service météorologique américain

Le flux de travail se déclenche lorsqu’une case est cochée dans une feuille Smartsheet. Il utilise les coordonnées de cette ligne pour obtenir les dernières prévisions météorologiques du service météorologique américain, puis renseigne ces données sur la même ligne Smartsheet.

Forfaits :

Bridge by Smartsheet

Vous pouvez utiliser le service météorologique américain pour obtenir des prévisions, car vous n’avez pas besoin d’un compte pour accéder à ses données météorologiques.

Pour obtenir les prévisions, vous devez passer deux appels d’API au service météorologique américain :

Un pour localiser le point de repère d’un emplacement géographique.
un deuxième appel pour obtenir les prévisions pour cette grille identifiée.

Vous n’avez pas besoin de maîtriser les appels d’API pour suivre les étapes contenues dans ce guide, qui fournit tout ce dont vous avez besoin pour terminer le flux de travail.

Voici les étapes à suivre pour créer le flux de travail :

Étape 1 : créer le flux de travail

Dans Bridge, sélectionnez Nouveau flux de travail dans le tableau de bord Workflows .
Donnez un nom à votre flux de travail et sélectionnez Créer un nouveau.
Tous les flux de travail commencent par un déclencheur et un état.

Étape 2 : créer la feuille

Avant de configurer le déclencheur dans Bridge, vous avez besoin d’une feuille Smartsheet avec au moins les noms et types de colonnes suivants :

Nom de la colonne	Type de colonne
Date	Date
Aujourd’hui	Case à cocher
Longitude	Texte
Latitude	Texte
Prévisions météorologiques	Texte

La colonne Prévisions météorologiques peut être votre colonne principale ou une colonne de texte standard.

Dans la première cellule de la colonne Aujourd'hui, collez la formule suivante : =IF (Date@row = TODAY (), true, false)
Sélectionnez Entrée. Cochez la case si l’ensemble de données dans la colonne Date correspond à la date du jour, que vous pouvez utiliser pour déclencher votre flux de travail dans Bridge.
Faites un clic droit sur la cellule contenant la formule et sélectionnez Convertir en formule de colonne. Cela garantit que toutes les nouvelles lignes ajoutées à la feuille utilisent cette formule dans la colonne Aujourd’hui.
Enregistrez la feuille.
Avant de revenir au concepteur dans Bridge, copiez l’identifiant de la feuille. Vous pouvez trouver l’identifiant de la feuille en allant dans Fichier > Propriétés.

Étape 3 : configurer le déclencheur

Dans le concepteur, sélectionnez le Déclencheur en haut du flux de travail. Cela ouvre un panneau sur le côté droit du concepteur où vous pouvez configurer le type de déclencheur que vous souhaitez utiliser.

Puisque le flux de travail doit être déclenché par un événement dans Smartsheet, le type de déclencheur utilisé est un déclencheur d’intégration. Dans le panneau, sélectionnez Page Intégrations sous la section Intégrations.

Cela ouvre un nouvel onglet avec la page Intégrations.

Trouvez Smartsheet et sélectionnez le logo.
Sélectionnez Continue (Continuer).
Sélectionnez Authentifier.
Dans la fenêtre contextuelle, sélectionnez Autoriser.

Si l’authentification est réussie, la fenêtre change pour l’onglet Déclencheurs.

Développez la section Déclencheurs et sélectionnez la ligne avec l’icône plus :

Dans le champ Identifiant de la feuille, collez l’identifiant de la feuille que vous avez copié lors de la création de la feuille. Si vous savez que le nom de la feuille est unique, tapez-le.
Sélectionnez Quand les valeurs des colonnes sont modifiées dans la liste déroulante Type d’événement.
Dans le champ qui est ajouté lorsque vous sélectionnez le type d’événement, saisissez le nom de la colonne Aujourd’hui.
Dans le menu déroulant Sélectionner le flux de travail, choisissez le flux de travail que vous avez créé précédemment, et sélectionnez Enregistrer.
Vous saurez que le déclencheur a été configuré avec succès car la fenêtre contextuelle se recharge et réduit la section Déclencheurs.
Fermez l’onglet et revenez au concepteur.

Erreurs lors de l’enregistrement du déclencheur

Si vous recevez un message d’erreur lors de l’enregistrement d’un déclencheur, passez en revue les éléments suivants :

Assurez-vous d’avoir orthographié le nom de la colonne exactement comme vous l’avez fait dans la feuille.
Si vous avez saisi le nom de la feuille au lieu d’utiliser l’identifiant de la feuille, vérifiez que vous l’avez orthographié de la même manière.
Si vous n’êtes pas le propriétaire de la feuille, vérifiez vos autorisations au niveau de la feuille pour vous assurer que vous avez accès.
Si d'autres déclencheurs sont déjà configurés, un déclencheur différent peut causer un problème. Vérifiez les autres déclencheurs pour vous assurer qu'aucun d'eux n'a eu de changement d'autorisations ou que la feuille référencée dans le déclencheur existe toujours.

Étape 4 : configurer le module Get Row (Obtenir la ligne)

Vous avez configuré le déclencheur pour exécuter le flux de travail lors du changement de la colonne Today; cette action envoie maintenant des informations de base à Bridge. Pour la première étape de votre flux de travail, vous devez récupérer certaines de ces informations initiales :

Définissez la cellule de date de la première ligne sur la date du jour. Cela coche automatiquement la case dans la colonne Today grâce à la formule que vous avez saisie précédemment.
Enregistrez la feuille et revenez au concepteur dans Bridge.
Ouvrez le Run Log. Sélectionnez Refresh, une exécution devrait apparaître avec le statut Terminé.
Pour afficher les données initiales envoyées à Bridge depuis Smartsheet, sélectionnez l'exécution, développez la ligne Trigger, puis la ligne Event.
Survolez rowId dans les données de déclencheur et sélectionnez l'icône more pour révéler une liste déroulante.
Dans le menu déroulant, sélectionnez Copy Data Reference. Cette opération copie dans votre presse-papiers une référence à l’ID de ligne modifiée.
En utilisant la référence plutôt que la source JSON, le flux de travail obtient toujours la ligne modifiée au lieu de toujours regarder la même ligne. C'est important car le changement de ligne diffère entre chaque exécution du flux de travail.

Mettre l’état à jour et ajouter un module

Sélectionnez l'état grisé et changez le champ Name en Get Row.
Il est recommandé de nommer les états en fonction de ce que font les modules ci-dessous pour faciliter la lecture de vos flux de travail.
Recherchez le module Get Row dans le menu de gauche. Utilisez le champ de recherche ou trouvez-le en développant Integrations > Smartsheet > Get Row.
Faites glisser le module dans le flux de travail sous l'état grisé. Un panneau permettant de configurer le module s’ouvre automatiquement.
Dans le champ Row ID , collez la référence que vous avez copiée du rowId dans le Run Log. La valeur collée doit afficher {{runtime.event.rowId}}.
Pour obtenir l’identifiant de la feuille, ouvrez à nouveau le Journal d’exécution et développez les données de déclenchement pour le trouver. Copiez la référence à l’identifiant de la feuille comme vous l’avez fait précédemment pour l’ID de ligne en sélectionnant l’icône more .
Sélectionnez de nouveau le module Get Row (Obtenir la ligne) et collez-le dans la référence du champ Sheet (Feuille). La valeur collée doit afficher {{runtime.sheetID}}.
Sélectionnez Save (Enregistrer) en haut de la page.

Brandfolder Image

Étape 5 : configurer la jonction

Vous devez déterminer si la modification apportée à la case à cocher dans la feuille est due au fait qu’elle a été cochée ou décochée. Une case non cochée doit être ignorée. Cependant, si elle est cochée, cela signifie que la date est définie sur la date du jour dans la colonne Date et que vous souhaitez recueillir les prévisions météorologiques.

Pour ce faire, vous devez faire référence à la cellule contenant la case à cocher :

Retournez dans la feuille et modifiez la date sur la ligne précédemment ajoutée pour décocher la case. Enregistrez la feuille.
Dans Bridge, ouvrez à nouveau le Journal d’exécution et sélectionnez All Runs (Toutes les exécutions) en haut à gauche du panneau. Actualisez la liste pour voir une nouvelle exécution terminée tout en haut.
Ouvrez cette nouvelle exécution et développez l’étape Smartsheet: Get Row (Smartsheet : Obtenir la ligne) pour afficher les données de la ligne.
Sous row > cells > Today, (ligne > cellules > Aujourd’hui), vous pouvez voir que la valeur est false (faux). Cela signifie que la case à cocher dans la colonne Today (Aujourd’hui) était décochée dans la ligne modifiée.
À l’aide de la liste déroulante, copiez la référence de données de cette valeur.

Ajouter une jonction conditionnelle de correspondance

L’étape suivante consiste à ajouter une jonction pour vérifier si la valeur correspond aux valeurs de texte true (vrai, case cochée) ou false (faux, case décochée).

Dans le champ de recherche, saisissez Match (Correspondance) ou développez Utilities > Conditional Junctions > Match (Utilitaires > Jonctions conditionnelles > Correspondance) pour trouver la jonction.
Faites glisser la jonction sous le module Get Row (Obtenir la ligne) et nommez-la Today’s Date. (Date du jour).

Cette jonction se compose de trois éléments : la jonction elle-même et deux états d’espaces réservés. Vous pouvez trouver d’autres états à faire glisser vers le flux de travail en haut du menu de gauche, sous Pinned Items > New State. (Éléments épinglés > Nouvel état).

Ajouter des états à la jonction

Faites glisser un nouvel état vers l’espace réservé de success (réussite) et nommez-le true (vrai).
Faites glisser un nouvel état vers l’espace réservé d’failure (échec) et nommez-le false (faux).

Ajouter la référence de données à la jonction

Sélectionnez la jonction Today's Date pour ouvrir le panneau de configuration.
Collez la référence que vous avez copiée précédemment dans le champ First Value.
La valeur collée doit être {{states.Get Row.smartsheet.get_row.row.cells.Today.value}}.
Dans le champ Second Value, saisissez le mot true.
Enregistrez ce que vous avez créé jusqu’à présent.

Brandfolder Image

Étape 6 : configurer le premier appel d’API

Configurer un profil pour vos appels d’API

Pour obtenir les données de prévisions météorologiques, vous devez d’abord créer un profil pour vos appels d’API au service météorologique américain. Les profils permettent d’enregistrer des informations essentielles sur les API système auxquelles vous souhaitez connecter vos flux de travail.

Dans votre compte Bridge, accédez à l’onglet Integrations (Intégrations).
Sélectionnez l’utilitaire Call API (Appel d’API).
Sélectionnez Continue > Add to Profiles (Continuer > Ajouter aux profils).

Brandfolder Image
Donnez un nom à votre profil. Chaque nom de profil doit être unique. Par exemple : Météo américaine.
Dans le champ Base URL (URL de base), saisissez https://api.weather.gov.
Développez la liste déroulante Headers (En-têtes) :
- Dans le champ Key #1 (Clé n° 1), saisissez User-Agent (Agent-Utilisateur).
- Dans le champ Value #1 (Valeur n° 1), saisissez le nom de votre entreprise et votre adresse e-mail, séparés par une virgule.
  Le service météorologique américain exige cela afin qu’il puisse vous contacter s’il constate une activité ou un comportement inattendu dans ses journaux.
Enregistrez le profil.
Retournez à votre flux de travail.

Configurer le module Make API Call (Passer un appel d’API) dans le flux de travail

Le premier appel d’API identifie le point de repère d’un emplacement saisi dans la feuille.

Utilisez le champ de recherche pour trouver le module Make API Call ou développez Utilities > Utility Functions > Make API Call.
Faites-le glisser vers le flux de travail sous l’état true (vrai).
Dans le module Make API Call (Passer un appel d’API), sélectionnez le profil que vous venez de créer dans le menu déroulant.
Dans le champ Endpoint (Point de terminaison), incluez les points suivants : points/{{states.Get Row.smartsheet.get_row.row.cells.Longitude.value}},{{states.Get Row.smartsheet.get_row.row.cells.Latitude.value}}.
Définissez Method (Méthode) sur GET.
Enregistrez le flux de travail.

Brandfolder Image

Références de données pour l’appel de grille

L’URL ci-dessus a été créée pour vous, car il n’est pas nécessaire de comprendre le fonctionnement des demandes d’API pour ce guide. Cette URL fait référence aux valeurs de longitude et de latitude de la ligne qui a déclenché le flux de travail.

Si vous souhaitez les obtenir, vous devez déclencher à nouveau le flux de travail. Cette fois, vous devez vous assurer que la case est cochée. Ajoutez des informations sur une nouvelle ligne au lieu d’utiliser la première, et veillez à définir la date sur la date du jour afin que le flux de travail suive la branche gauche de la jonction.

Coordonnées

Le service météorologique américain impose quatre décimales maximum pour les coordonnées.

Étape obligatoire
Il serait préférable d’avoir des coordonnées pour les saisir dans les champs Longitude et Latitude. Par exemple, vous pouvez utiliser 47.6174 et -122.2001 pour connaître la météo du bureau de Smartsheet situé à Bellevue.

Étape 7 : configurer le second appel d’API

Le second appel d’API récupère les prévisions du service météorologique américain en fonction des points de référence précédemment localisés. Pour le configurer, ajoutez un nouvel état et un autre module Make API Call (Passer un appel d’API) au flux de travail.

Faites glisser un nouvel état depuis les éléments épinglés en haut du menu de gauche, et nommez-le Get Forecast.
Faites glisser un autre module Make API Call sous le nouvel état.
Dans le module Make API Call (Passer un appel d’API), sélectionnez le profil que vous venez de créer dans la liste déroulante.
Dans le champ Endpoint, incluez les éléments suivants : 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_call.response.properties.gridY}}/forecast
Définissez le Méthode sur GET.
Enregistrez le flux de travail.

Brandfolder Image

Références de données pour l’appel de prévisions

Si vous souhaitez obtenir les références de données utilisées dans le point de terminaison ci-dessus, déclenchez à nouveau le flux de travail. Assurez-vous que la ligne modifiée ou ajoutée contient la date du jour, de sorte que la case se coche.

Une fois que vous avez créé la nouvelle ligne et enregistré la feuille, recherchez la dernière exécution dans le panneau Run Log (Journal d’exécution) et développez l’étape précédente : Call API: Make API Call. Sous Output > properties, localisez les champs gridId, gridX, et gridY. Vous pouvez ensuite utiliser ces références dans l’URL pour appeler le service météorologique.

Étape 8 : configurer le module Update Row (Mettre à jour une ligne)

À présent que vous pouvez obtenir des données météorologiques avec le flux de travail, la dernière étape consiste à mettre à jour la feuille avec les prévisions.

Ajouter les identifiants de feuille et de ligne

Déclenchez à nouveau le flux de travail. Assurez-vous que la ligne modifiée ou ajoutée contient la date du jour, de sorte que la case se coche.
Ajoutez un autre état sous le dernier module d’appel API et nommez-le Update Row.
Recherchez le module Update Row (Mettre à jour la ligne) ou développez Integrations > Smartsheet > Update Row.
Dans le panneau Run Log (Journal d’exécution), développez le déclencheur de la dernière exécution et repérez les valeurs des identifiants de feuille et de ligne .
Utilisez les références de données pour définir les champs Sheet ID et Row ID pour le module Update Row (Mettre à jour la ligne).

Ajouter la référence détaillée des données de prévision

Retournez au panneau Run Log (Journal d’exécution) et développez la dernière étape (le dernier des deux modules Make API Call [Passer un appel d’API]). Les données du service météorologique américain, y compris les prévisions météorologiques sur sept jours, fournissent une gamme d'informations. et la date est
Obtenez la météo actuelle sous Sortie > propriétés > périodes > 0.
Pour ce flux de travail, vous souhaitez utiliser la référence de prévision détaillée. Copiez la référence de données.
Ouvrez à nouveau le module Mettre à jour la ligne et développez la section Cellules .
Collez la référence dans le champ Valeur n° . La valeur collée doit afficher ce qui suit : {{states.Get Forecast.call_api.make_api_call.response.properties.periods.0.detailedForecast}}
Entrez la colonne Prévisions météorologiques dans le champ Clé n°1.
Enregistrez le flux de travail.

Si vous souhaitez vous assurer que le flux de travail n’échoue pas si le service météorologique américain ne peut pas renvoyer d'informations, vous pouvez ajuster la référence de données dans le champ Valeur n° comme suit : {{states.Get Forecast.call_api.make_api_call.response.properties.periods.0.detailedForecast||Unable to fetch weather data}}
Cela garantit que le module met à jour la ligne avec le texte figurant après le symbole '||' s'il n'y a pas de données dans la prévision détaillée.

Flux de travail terminé

Votre flux de travail s’exécute chaque fois que vous ajoutez une nouvelle ligne (en suivant la branche gauche ou droite de la jonction). Il s’exécute également chaque fois que la date d'aujourd'hui est celle définie pour une ligne existante. La colonne Prévisions météorologiques de votre feuille se remplit automatiquement si le flux de travail suit la branche gauche de la jonction ou si la case Aujourd’hui est cochée.

USM Content