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

Vous utiliserez 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 premier appel 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, car il vous fournit tout ce dont vous avez besoin pour terminer le flux de travail.

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

1. Créer le flux de travail
2. Créer la feuille
3. S’authentifier avec Smartsheet et configurer le déclencheur
4. Configurer le module Get Row (Obtenir la ligne)
5. Configurer la jonction
6. Configurer le premier appel d’API
7. Configurer le second appel d’API
8. Configurer le module Update Row (Mettre à jour la ligne)

Étape 1 : créer le flux de travail

1. Dans Bridge, sélectionnez + dans le tableau de bord Workflows (Flux de travail).

2. Donnez un nom à votre flux de travail et sélectionnez Create New (Créer un nouveau) pour accéder au concepteur.

   Tous les flux de travail commencent par un déclencheur et un état.

Brandfolder Image

Étape 2 : créer la feuille

Avant de configurer le déclencheur dans Bridge, vous devez disposer d’une feuille Smartsheet contenant au moins cinq colonnes.

Configurez votre feuille afin qu’elle contienne les noms et types de colonnes suivants :

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

1.  Dans la première cellule de la colonne Aujourd’hui, collez la formule suivante :

   =IF (Date@row = TODAY (), true, false)

2. Sélectionner Saisir. Cochez la case si l’ensemble de données dans la colonne Date correspond à la date du jour, que vous pouvez ensuite utiliser pour déclencher votre flux de travail dans Bridge.
3. Faites un clic droit sur la cellule contenant la formule et sélectionnez Convertir en formule de colonne. Cette action garantit que toutes les nouvelles lignes ajoutées à la feuille utilisent cette formule dans la colonne Aujourd’hui.
4. Enregistrez la feuille.
5. Avant de revenir au concepteur dans Bridge, copiez l’identifiant de la feuille. Vous pouvez obtenir l’identifiant de la feuille en sélectionnant Fichier > Propriétés.

Étape 3 : configurer le déclencheur

Dans le concepteur, sélectionnez l’élément Trigger (Déclencheur) en haut du flux de travail. Cette action ouvre un panneau sur le côté droit du concepteur, dans lequel vous pouvez configurer le type de déclencheur que vous souhaitez utiliser. Dans la mesure où le flux de travail doit déclencher un événement dans Smartsheet, le type de déclencheur utilisé est un déclencheur d’intégration.

Dans le panneau, sélectionnez Integrations Page (Page Intégrations) dans la section développée Integrations (Intégrations) automatiquement.

Brandfolder Image

Cette action ouvre un nouvel onglet avec la page Integrations (Intégrations). 

1. Accédez à l’intégration Smartsheet et sélectionnez le logo. 
2. Sélectionnez Continue (Continuer). 
3. Sélectionner Authentifier.
4. Une autre fenêtre s’ouvre pour vous demander si vous souhaitez autoriser l’accès de Bridge à votre compte Smartsheet. Sélectionnez Allow (Autoriser).

Si l’authentification a réussi, la fenêtre bascule dans l’onglet Triggers (Déclencheurs).

Brandfolder Image

Développez la section Triggers (Déclencheurs) et sélectionnez la ligne contenant l’icône plus :

1. Dans le champ Sheet ID (Identifiant de la feuille), collez l’identifiant copié lors de la création de la feuille. Si vous savez que le nom de la feuille est unique, vous pouvez également le saisir.
2. Dans la liste déroulante Event Type (Type d’événement), sélectionnez When Column Values are Changed (Quand les valeurs des colonnes sont modifiées).
3. Dans le champ ajouté lorsque vous sélectionnez le type d’événement, saisissez le nom de colonne Today (Aujourd’hui).

4. Dans le menu déroulant Select Workflow (Sélectionner le flux de travail), choisissez le flux de travail précédemment créé et sélectionnez Save (Enregistrer).

   Vous saurez que la configuration du déclencheur a réussi si la fenêtre contextuelle se recharge et réduit la section Triggers (Déclencheurs).

5. 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 de la même façon que dans la feuille. 
• Si vous avez saisi le nom de la feuille au lieu d’utiliser son identifiant, vérifiez que vous l’avez orthographié de la même façon. 
• 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 y avez toujours accès.
• Si d’autres déclencheurs sont déjà configurés, il peut y avoir un problème avec un autre déclencheur. Vérifiez les autres déclencheurs afin de garantir qu’il n’y a eu aucun changement au niveau des autorisations associées, 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 de la modification de Aujourd’hui , cette action enverra maintenant des informations de base à Bridge. Pour la première étape de votre flux de travail, vous devez obtenir certaines de ces informations initiales : 

1. Commencez par définir sur la date du jour la cellule de date de la première ligne. La case dans la colonne Today (Aujourd’hui) devrait se cocher automatiquement grâce à la formule précédemment saisie. 
2. Enregistrez la feuille et revenez au concepteur dans Bridge.
3. Ouvrez le Run Log (Journal d’exécution). Il apparaît d’abord vide. Sélectionnez Refresh (Rafraîchir) pour mettre à jour le panneau est alors mis à jour. Une exécution doit apparaître avec le statut Rafraîchir (Terminé).
4. Pour afficher les données initiales envoyées à Bridge depuis Smartsheet, cliquez sur l’exécution et développez la ligne Trigger (Déclencheur), puis la ligne Event (Événement). 
5. Survoler rowIdI (identifiantLigne) dans les données de déclencheur et sélectionnez l’icône more (plus) pour afficher une liste déroulante. 

6. Sélectionnez Copy Data Reference (Copier la référence de données) dans la liste déroulante. 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 qui a été modifiée au lieu de toujours regarder la même ligne, ce qui est important, car la ligne qui change sera probablement différente à chaque exécution du flux de travail. 

Brandfolder Image

Mettre l’état à jour et ajouter un module

1. Cliquez sur l’état grisé et remplacez le champ Name (Nom) par Get Row (Obtenir la ligne).

   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.

2. Recherchez le module Get Row (Obtenir la ligne) dans le menu de gauche. Utilisez le champ de recherche ou développez Integrations > Smartsheet > Get Row (Intégrations > Smartsheet > Obtenir la ligne).
3. Faites glisser le module vers le flux de travail, sous l’état grisé. Un panneau permettant de configurer le module s’ouvre automatiquement. 
4. Dans le champ Row ID (ID de ligne), collez la référence copiée du champ rowId (identifiantLigne) dans le panneau Run Log (Journal d’exécution). La valeur collée doit afficher {{runtime.event.rowId}}.
5. Pour obtenir l’identifiant de la feuille, ouvrez à nouveau le panneau Run Log (Journal d’exécution) et recherchez l’identifiant de la feuille en développant les données de déclencheur. 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 (plus).
6. Cliquez de nouveau sur le module Get Row (Obtenir la ligne) et collez la référence dans le champ Sheet (Feuille). La valeur collée doit afficher {{runtime.sheetID}}.

7. Sélectionnez Delete (Supprimer) en haut de la page.

   Brandfolder Image

   

Étape 5 : configurer la jonction

Vous devez à présent 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 :

1. Retournez dans la feuille et modifiez la date sur la ligne précédemment ajoutée pour décocher la case. Enregistrez la feuille.
2. Dans Bridge, ouvrez à nouveau le panneau Run Log (Journal d’exécution) et sélectionnez All Runs (Toutes les exécutions) en haut à gauche. Actualisez la liste pour voir une nouvelle exécution terminée tout en haut. 
3. 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.
4. 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) et sur la ligne modifiée n’était pas cochée. 
5. À 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). 

1. Dans le champ de recherche, saisissez Match (Correspondance) ou trouvez la jonction en développant Utilities > Conditional Junctions > Match (Utilitaires > Jonctions conditionnelles > Correspondance). 
2. 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

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

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

1. Sélectionner la jonction Today’s Date (Date du jour) pour ouvrir le panneau de configuration. 
2. Dans le champ First Value (Première valeur), collez la référence que vous avez copiée.
   La valeur collée doit être {{states.Get Row.smartsheet.get_row.row.cells.Today.value}}.
3. Dans le champ Second Value (Deuxième valeur), saisissez le mot true (vrai). 

4. 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 les informations clés sur les API système auxquelles vous souhaitez connecter vos flux de travail.

1. Dans votre compte Bridge, accédez à l’onglet Integrations (Intégrations).
2. Sélectionnez l’utilitaire Call API (Appel d’API).

3. Sélectionnez Continue > Add to Profiles (Continuer > Ajouter aux profils).

   Brandfolder Image

   

    

4. Donnez un nom à votre profil. Chaque nom de profil doit être unique. Par exemple : Météo américaine.
5. Dans le champ Base URL (URL de base), saisissez https://api.weather.gov.
6. Développer 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 en les séparant par une virgule.

     Ces informations sont requises par le service météorologique américain afin qu’il puisse vous contacter s’il constate une activité ou un comportement inattendu dans ses journaux.

7. Enregistrez le profil.
8. 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.

1. Recherchez le module Make API Call (Passer un appel d’API) en utilisant le champ de recherche ou en développant Utilities > Utility Functions > Make API Call (Utilitaires > Fonctions d’utilitaire > Effectuer un appel d’API).
2. Faites-le glisser vers le flux de travail sous l’état true (vrai).
3. 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.
4. 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}}
5. Définissez Method (Méthode) sur GET.

6. 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-même, vous devez déclencher à nouveau le flux de travail. Cette fois-ci, 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

Vous avez également besoin de 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, vous devez ajouter un nouvel état et un autre module Make API Call (Passer un appel d’API) au flux de travail. 

1. Faites glisser un nouvel état depuis les éléments épinglés en haut du menu de gauche et nommez-le Get Forecast (Obtenir les prévisions).
2. Ensuite, faites glisser un autre appel module Make API Call (Passer un appel d’API) sous le nouvel état.
3. 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.
4. Dans le champ Endpoint (Point de terminaison), 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
5. Définissez Method (Méthode) sur GET.

6. 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 situé au-dessus du vôtre, 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 la dernière étape : Call API: Make API Call (API d’appel : passer un appel d’API). Sous Output > properties (Sortie > propriétés), localisez les champs gridId, gridX et gridY. Vous pouvez ensuite utiliser ces références dans l’URL de l’appel au service météorologique.

Étape 8 : configurer le module Update Row (Mettre à jour la 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

1. 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.
2. Ajoutez un autre état sous le dernier module d’appel API et nommez-le Update Row (Actualiser la ligne).
3. Recherchez le module Update Row (Mettre à jour la ligne) ou retrouvez-le en développant Integrations > Smartsheet > Update Row (Intégrations > Smartsheet > Mettre à jour la ligne).
4. 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 . 
5. Utilisez les références de données pour définir les champs Sheet ID (Identifiant de la feuille) et Row ID (ID de ligne) pour le module Update Row (Mettre à jour la ligne).

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

1. Revenez 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. 
2. Obtenez la météo actuelle sous Output > properties > periods > 0 (Sortie > propriétés > périodes > 0).
3. Pour ce flux de travail, utilisez la référence aux données detailedForecast (prévisionsDétaillées). Copiez la référence de données. 
4. Ouvrez à nouveau le module Update Row (Mettre à jour la ligne) et développez la section Cells (Cellules). 
5. Coller la référence dans le champ Value # (Valeur n°). La valeur collée doit afficher ce qui suit : {{states.Get Forecast.call_api.make_api_call.response.properties.periods.0.detailedForecast}} 
6. Dans le champ Key #1 (Clé n° 1), saisissez le nom de colonne Weather Forecast (Prévisions météorologiques).
7. 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 n’est pas en mesure de renvoyer des informations, vous pouvez adapter la référence de données dans le champ Value # (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 les symboles || si le champ detailedForecast (prévisionsDétaillées) ne contient aucune valeur.

Brandfolder Image

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 dès lors que la date du jour est celle définie pour une ligne existante. La colonne Weather Forecast (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 Today (Aujourd’hui) est cochée.