Leeren Workflow für den US Weather Service starten

Sie können den US Weather Service nutzen, um Vorhersagen zu erhalten, da Sie kein Konto benötigen, um auf dessen Wetterdaten zuzugreifen.

Um die Vorhersage zu erhalten, müssen Sie zwei API-Aufrufe an den US Weather Service durchführen:

• Einen, um den Gitterpunkt eines geografischen Standorts zu lokalisieren.
• Eine zweite, um die Prognose für dieses identifizierte Gitter zu erhalten. 

Sie müssen mit API-Aufrufen nicht vertraut sein, um die Schritte in dieser Anleitung auszuführen, die alles bietet, was Sie zum Abschließen des Workflows benötigen.

Dies sind die Schritte zum Erstellen des Workflows:

1. Workflow erstellen
2. Sheet erstellen
3. Mit Smartsheet authentifizieren und Auslöser einrichten
4. „Get Row“ (Zeile abrufen) einrichten
5. Verzweigung einrichten
6. Den ersten API-Aufruf einrichten
7. Den zweiten API-Aufruf einrichten
8. „Update Row“ (Zeile aktualisieren) einrichten

Schritt 1: Workflow erstellen

1. In Smartsheet Bridge wählen Sie Neuen Workflow im Dashboard Workflows aus.

2. Geben Sie Ihrem Workflow einen Namen und wählen Sie Neu erstellen aus. 

   Alle Workflows beginnen mit einem Auslöser und einem Zustand.

Schritt 2: Sheet erstellen

Bevor Sie den Auslöser in Bridge einrichten, benötigen Sie ein Smartsheet mit mindestens den folgenden Spaltennamen und -typen:

Die Spalte Wettervorhersage kann Ihre primäre Spalte oder eine reguläre Textspalte sein. 

1.  In der ersten Zelle der Spalte Heute fügen Sie die folgende Formel ein: =IF (Date@row = TODAY (), true, false)
2. Wählen Sie Eingabetaste aus. Damit wird das Kontrollkästchen aktiviert, wenn der Datensatz in der Spalte Datum das heutige Datum ist, das Sie dann zum Auslösen Ihres Workflows in Smartsheet Bridge verwenden können.
3. Klicken Sie mit der rechten Maustaste auf die Zelle mit der Formel und wählen Sie In Spaltenformel konvertieren aus. Dadurch wird sichergestellt, dass alle neuen Zeilen, die dem Sheet hinzugefügt werden, diese Formel in der Spalte Heute verwenden.
4. Speichern Sie das Sheet.
5. Bevor Sie zum Designer in Bridge zurückkehren, kopieren Sie die Sheet-ID. Sie finden die Sheet-ID, indem Sie zu Datei > Eigenschaften gehen.

Schritt 3: Auslöser einrichten

Wählen Sie im Designer das Trigger-Element oben im Workflow aus. Dadurch wird auf der rechten Seite des Designers ein Bereich geöffnet, in dem Sie den gewünschten Auslösertyp einrichten können. 

Da der Workflow durch ein Ereignis in Smartsheet ausgelöst werden soll, wird als Typ ein Integrationsauslöser verwendet. Wählen Sie im Bereich unter dem Abschnitt Integrationsseite die Option Integrationen aus.

Brandfolder Image

Dadurch wird ein neuer Tab mit der Seite Integrationen geöffnet. 

1. Suchen Sie Smartsheet und wählen Sie das Logo aus. 
2. Wählen Sie Continue (Weiter) aus. 
3. Wählen Sie Authentifizieren.
4. Wählen Sie im Popup-Fenster Erlauben aus.

Wenn die Authentifizierung erfolgreich ist, wechselt das Fenster zum Tab Auslöser.

Brandfolder Image

Erweitern Sie den Abschnitt Auslöser und wählen Sie die Zeile mit dem Plus-Symbol aus:

1. Fügen Sie im Feld Sheet-ID die Sheet-ID ein, die Sie beim Erstellen des Sheets kopiert haben. Wenn Sie wissen, dass der Sheetname eindeutig ist, geben Sie ihn ein.
2. Wählen Sie Wenn Spaltenwerte geändert werden in der Dropdown-Liste Ereignistyp aus.
3. Geben Sie in das Feld, das bei der Auswahl des Ereignistyps hinzugefügt wird, den Spaltennamen Heute. ein.

4. Wählen Sie in der Dropdown-Liste Workflow auswählen den Workflow aus, den Sie zuvor erstellt haben, und wählen Sie Speichern. aus.

   Dass der Auslöser erfolgreich eingerichtet wurde, erkennen Sie daran, dass das Popup-Fenster neu geladen wird und der Abschnitt Auslöser geschlossen wird.

5. Schließen Sie den Tab und kehren Sie zum Designer zurück.

Fehler beim Speichern des Auslösers

Wenn Sie beim Speichern eines Auslösers eine Fehlermeldung erhalten, überprüfen Sie Folgendes:

• Stellen Sie sicher, dass Sie den Spaltennamen genau so geschrieben haben wie im Sheet. 
• Wenn Sie den Sheetnamen statt der Sheet-ID eingegeben haben, überprüfen Sie, ob Sie ihn gleich geschrieben haben. 
• Sollten Sie nicht der Sheetinhaber sein, überprüfen Sie Ihre Sheetberechtigungen, um sicherzustellen, dass Sie Zugriff haben.
• Wenn andere Auslöser bereits eingerichtet sind, kann ein anderer Auslöser ein Problem verursachen. Überprüfen Sie die anderen Auslöser, um sicherzustellen, dass bei einem von ihnen die Berechtigungen nicht geändert wurden oder dass das im Auslöser genannte Sheet noch existiert.

Schritt 4. „Get Row“ (Zeile abrufen) einrichten

Sie haben den Auslöser so eingerichtet, dass der Workflow beim Ändern der Heute-Spalte ausgeführt wird; diese Aktion sendet nun einige grundlegende Informationen an Bridge. Für den ersten Schritt Ihres Workflows müssen Sie einige der folgenden Anfangsinformationen abrufen: 

1. Setzen Sie die Datumszelle in der ersten Zeile auf das aktuelle Datum. Dies aktiviert automatisch das Kontrollkästchen in der Heute-Spalte aufgrund der Formel, die Sie zuvor eingegeben haben. 
2. Speichern Sie das Sheet und kehren Sie zum Designer in Smartsheet Bridge zurück.
3. Öffnen Sie das Ausführungsprotokoll. Wählen Sie Aktualisieren, aus, ein Ausführung sollte mit dem Status Abgeschlossen erscheinen.
4. Um die anfänglichen Daten anzuzeigen, die von Smartsheet an Bridge gesendet wurden, wählen Sie die Ausführung aus, erweitern Sie die Zeile Auslöser, und dann die Zeile Ereignis. 
5. Bewegen Sie den Mauszeiger über rowId in den Auslöserdaten und wählen Sie das Mehr-Symbol aus, um eine Dropdown-Liste anzuzeigen. 

6. Wählen Sie im Dropdown-Menü Datenverweis kopieren aus. Dadurch wird ein Verweis auf die geänderte Zeilen-ID in die Zwischenablage kopiert.

   Durch die Verwendung der Referenz anstelle der JSON-Quelle ruft der Workflow immer die geänderte Zeile ab, anstatt immer dieselbe Zeile zu betrachten. Dies ist wichtig, da sich die sich ändernde Zeile zwischen den einzelnen Workflow-Ausführungen unterscheidet. 

Brandfolder Image

Zustand aktualisieren und Modul hinzufügen

1. Wählen Sie den grauen Zustand aus und ändern Sie das Feld Name in Zeile abrufen.

   Es empfiehlt sich, die Zustände nach der Funktion der Module darunter zu benennen, um Ihre Workflows leichter lesbar zu machen.

2. Suchen Sie das Modul Zeile abrufen im linken Menü. Verwenden Sie das Suchfeld oder suchen Sie es, indem Sie Integrationen > Smartsheet > Zeile abrufen. erweitern.
3. Ziehen Sie das Modul unter dem grauen Zustand in den Workflow. Es wird automatisch ein Fenster zum Einrichten des Moduls geöffnet. 
4. Fügen Sie im Feld Zeilen-ID den Verweis ein, den Sie aus dem rowId im Ausführungsprotokoll kopiert haben. Der eingefügte Wert sollte {{runtime.event.rowId}} lauten.
5. Um die Sheet-ID zu erhalten, öffnen Sie das Ausführungsprotokoll erneut und erweitern Sie die Triggerdaten, um sie zu finden. Kopieren Sie den Verweis auf die Sheet-ID, wie Sie es zuvor für die Zeilen-ID getan haben, indem Sie das Symbol mehr auswählen.
6. Wählen Sie erneut das Modul Get Row (Zeile abrufen) aus und fügen Sie es in den Verweis im Feld Sheet ein. Der eingefügte Wert sollte {{runtime.sheetID}} lauten.

7. Wählen Sie oben auf der Seite Speichern aus.

   Brandfolder Image

   

Schritt 5. Verzweigung einrichten

Sie müssen feststellen, ob die Änderung des Kontrollkästchens im Sheet darauf zurückzuführen ist, dass das Kontrollkästchen aktiviert oder deaktiviert wurde. Ein deaktiviertes Kontrollkästchen sollte ignoriert werden; wenn das Kontrollkästchen jedoch aktiviert wird, bedeutet dies, dass das in der Spalte Datum festgelegte Datum das heutige Datum ist und Sie die Wettervorhersage erfassen möchten.

Dazu müssen Sie auf die Zelle mit dem Kontrollkästchen verweisen:

1. Gehen Sie zurück zum Sheet und ändern Sie das Datum in der Zeile, die Sie zuvor hinzugefügt haben, um das Kontrollkästchen zu deaktivieren. Speichern Sie anschließend das Sheet.
2. Öffnen Sie in Bridge erneut das Ausführungsprotokoll und wählen Sie oben links im Bereich Alle Ausführungen aus. Aktualisieren Sie die Liste, um eine neue abgeschlossene Ausführung oben zu sehen. 
3. Öffnen Sie diese neue Ausführung und erweitern Sie den Schritt Smartsheet: Get Row, um die Zeilendaten anzuzeigen.
4. Unter row > cells > Today, (Zeile > Zellen > Heute) sehen Sie, dass der Wert false ist. Daran erkennen Sie, dass das Kontrollkästchen in der Spalte Heute in der Zeile, die geändert wurde, deaktiviert war. 
5. Kopieren Sie mithilfe der Dropdown-Liste die Datenreferenz dieses Werts.

Bedingte Verzweigung „Übereinstimmung“ hinzufügen

Der nächste Schritt besteht darin, eine Verzweigung hinzuzufügen, um zu überprüfen, ob der Wert mit den Textwerten true (aktiviert) oder false (deaktiviert) übereinstimmt. 

1. Geben Sie im Suchfeld Match (Übereinstimmung) ein oder erweitern Sie Utilities > Conditional Junctions > Match (Dienstprogramme > Bedingte Verzweigungen > Übereinstimmung), um die Verzweigung zu finden. 
2. Ziehen Sie die Verzweigung unter das Modul Get Row (Zeile abrufen) und nennen Sie sie Heutiges Datum.

Diese Verzweigung besteht aus drei Komponenten: der Verzweigung selbst und zwei Platzhalterzuständen. Weitere Zustände, die Sie in den Workflow ziehen können, finden Sie oben im Menü links unter Pinned Items > New State. (Angeheftete Elemente > Neuer Zustand).

Hinzufügen von Zuständen zur Verzweigung

1. Ziehen Sie einen neuen Zustand in den Platzhalter success (Erfolg) und nennen Sie ihn true (wahr). 
2. Ziehen Sie einen weiteren neuen Zustand in den Platzhalter failure (Fehler) und nennen Sie ihn false (falsch).

Datenverweis zur Verzweigung hinzufügen

1. Wählen Sie die Verzweigung Heutiges Datum aus, um das Einrichtungsfeld zu öffnen. 
2. Fügen Sie die zuvor kopierte Referenz in das Feld Erster Wert ein.
   Der eingefügte Wert sollte {{states.Get Row.smartsheet.get_row.row.cells.Today.value}} sein.
3. Tippen Sie im Feld Zweiter Wert, das Wort wahr ein. 

4. Speichern Sie, was Sie bisher erstellt haben.

   Brandfolder Image

   

Schritt 6: Den ersten API-Aufruf einrichten

Ein Profil für Ihre API-Aufrufe einrichten

Um Wettervorhersagedaten abzurufen, müssen Sie zunächst ein Profil für Ihre API-Aufrufe an den US Weather Service erstellen. Profile sind eine Möglichkeit, wichtige Informationen für die System-APIs zu speichern, mit denen Sie Ihre Workflows verbinden möchten.

1. Navigieren Sie in Ihrem Bridge-Konto zum Tab Integrationen.
2. Wählen Sie das Dienstprogramm Call API aus.

3. Wählen Sie Weiter > Zu Profilen hinzufügen aus.

   Brandfolder Image

   

    

4. Benennen Sie Ihr Profil. Jeder Profilname muss eindeutig sein. Zum Beispiel: US-Wetter.
5. Geben Sie im Feld Basis-URL https://api.weather.gov ein.
6. Erweitern Sie das Dropdown-Menü Header:
   • Geben Sie im Feld Schlüssel Nr. 1 „User-Agent“ ein.

   • Geben Sie im Feld Wert Nr. 1 Ihren Firmennamen und die E-Mail-Adresse, durch Komma getrennt, ein.

     Der US Weather Service verlangt dies, damit er Sie kontaktieren kann, wenn unerwartete Aktivitäten oder Verhaltensweisen in seinen Protokollen festgestellt werden.

7. Speichern Sie das Profil.
8. Kehren Sie zu Ihrem Workflow zurück.

Einrichten des „Make API Call“-Moduls in Ihrem Workflow

Der erste API-Aufruf identifiziert den Grid Point einer im Sheet eingegebenen Position.

1. Verwenden Sie das Suchfeld, um das Modul API-Aufruf erstellen zu finden oder erweitern Sie Dienstprogramme > Dienstprogrammfunktionen > API-Aufruf erstellen.
2. Ziehen Sie es in den Workflow unter dem Zustand wahr.
3. Wählen Sie im „Make API Call“-Modul das soeben angelegte Profil aus der Dropdown-Liste aus.
4. Geben Sie im Feld Endpunkt die folgenden Punkte an: points/{{states.Get Row.smartsheet.get_row.row.cells.Longitude.value}},{{states.Get Row.smartsheet.get_row.row.cells.Latitude.value}}.
5. Legen Sie die Methode auf GET fest.

6. Speichern Sie den Workflow.

   Brandfolder Image

   

Datenreferenzen für den Tabellenaufruf

Die obige URL wird für Sie erstellt, da es für diese Anleitung optional ist, zu verstehen, wie API-Anforderungen funktionieren. Diese URL verweist auf die Längen- und Breitengradwerte in der Zeile, die den Workflow ausgelöst hat.

Wenn Sie diese erhalten möchten, müssen Sie den Workflow erneut auslösen. Dieses Mal müssen Sie sicherstellen, dass das Kontrollkästchen aktiviert ist. Fügen Sie Informationen in eine neue Zeile ein, anstatt die erste zu verwenden, und stellen Sie sicher, dass Sie das Datum auf das heutige Datum festlegen, damit der Workflow entsprechend dem linken Zweig der Verzweigung verläuft.

Koordinaten

Der US Weather Service verlangt maximal vier Nachkommastellen für die Koordinaten.

Erforderlicher Schritt

Es wäre am besten, Koordinaten zu haben, um sie in die Felder Längengrad und Breitengrad einzugeben. Sie können z. B. 47.6174 und -122.2001 verwenden, um das Wetter für das Smartsheet-Büro in Bellevue abzurufen.

Schritt 7: Den zweiten API-Aufruf einrichten

Der zweite API-Aufruf ruft die Vorhersage des US Weather Service basierend auf den zuvor gefundenen Grid Points ab. Um dies einzurichten, fügen Sie dem Workflow einen neuen Zustand und ein weiteres „Make API Call“-Modul hinzu. 

1. Ziehen Sie einen neuen Zustand aus den angehefteten Elementen oben im Menü auf der linken Seite, und nennen Sie ihn Get Forecast.
2. Ziehen Sie ein weiteres „Make API Call“ -Modul unter den neuen Zustand.
3. Wählen Sie im „Make API Call“-Modul das soeben angelegte Profil aus der Dropdown-Liste aus.
4. Geben Sie im Feld Endpoint Folgendes an: 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. Legen Sie die Methode auf GET fest.

6. Speichern Sie den Workflow.

   Brandfolder Image

   

Datenreferenzen für den Prognoseaufruf

Wenn Sie die im obigen Endpunkt verwendeten Datenreferenzen benötigen, lösen Sie den Workflow erneut aus. Stellen Sie sicher, dass die geänderte oder hinzugefügte Zeile das heutige Datum aufweist, damit das Kontrollkästchen aktiviert wird.

Wenn Sie die neue Zeile erstellt und das Sheet gespeichert haben, suchen Sie die letzte Ausführung im Ausführungsprotokoll und erweitern Sie den vorherigen Schritt: Call API: Make API Call. Suchen Sie unter Output > properties die Felder gridId, gridX, und gridY. Diese Verweise können Sie dann in der URL verwenden, um den Wetterdienst aufzurufen.

Schritt 8: Modul „Update Row“ (Zeile aktualisieren) einrichten

Da Sie nun Wetterdaten mit dem Workflow abrufen können, müssen Sie im letzten Schritt das Sheet mit der Prognose aktualisieren.

Sheet- und Zeilen-IDs hinzufügen

1. Lösen Sie den Workflow erneut aus. Stellen Sie sicher, dass die geänderte oder hinzugefügte Zeile das heutige Datum aufweist, damit das Kontrollkästchen aktiviert wird .
2. Fügen Sie unter dem letzten API-Aufrufmodul einen weiteren Zustand hinzu und nennen Sie ihn Update Row.
3. Suchen Sie nach dem Modul „Update Row“ oder erweitern Sie Integrationen > Smartsheet > Update Row.
4. Erweitern Sie im Ausführungsprotokoll den Trigger der letzten Ausführung und suchen Sie nach der Sheet-ID und der Zeilen-ID Werte.
5. Verwenden Sie die Datenreferenzen, um die Felder Sheet ID und Row ID für das Modul „Update Row“ festzulegen.

Detaillierte Referenz zu Prognosedaten hinzufügen

1. Kehren Sie zum Ausführungsprotokoll zurück und erweitern Sie den letzten Schritt (das letzte der beiden „Make API Call“-Module). Die Daten des US-Wetterdienstes, einschließlich sieben Tage Wettervorhersagen, bieten eine Vielzahl von Informationen. und das Datum ist 
2. Das aktuelle Wetter finden Sie unter Ausgabe > Eigenschaften > Zeiträume > 0.
3. Für diesen Workflow sollten Sie den Verweis auf die detaillierte Vorhersage verwenden. Kopieren Sie den Datenverweis. 
4. Öffnen Sie erneut das Modul „Zeile aktualisieren“ und erweitern Sie den Abschnitt Zellen. 
5. Fügen Sie den Verweis in das Feld Wert # ein. Der eingefügte Wert sollte lauten: {{states.Get Forecast.call_api.make_api_call.response.properties.periods.0.detailedForecast}} 
6. Geben Sie die Wettervorhersagespalte im Feld Schlüssel #1 ein.
7. Speichern Sie den Workflow.

Wenn Sie sicherstellen möchten, dass der Workflow nicht fehlschlägt, wenn der US-Wetterdienst keine Informationen zurückgeben kann, können Sie den Datenverweis im Feld Wert # wie folgt anpassen: {{states.Get Forecast.call_api.make_api_call.response.properties.periods.0.detailedForecast||Unable to fetch weather data}}
Dadurch wird sichergestellt, dass das Modul die Zeile mit dem Text nach dem Symbol „||“ aktualisiert, wenn in der detaillierten Vorhersage keine Daten vorhanden sind.

Brandfolder Image

Abgeschlossener Workflow

Ihr Workflow wird jedes Mal ausgeführt, wenn Sie eine neue Zeile hinzufügen (entweder im linken oder im rechten Zweig der Verzweigung). Er wird auch immer dann ausgeführt, wenn heute, das Datum in einer vorhandenen Zeile festgelegt ist. Die Spalte „Wettervorhersage“ in Ihrem Sheet wird automatisch ausgefüllt, wenn der Workflow über den linken Zweig der Verzweigung verläuft oder wenn das Kontrollkästchen Heute aktiviert ist.