Leeren Workflow für den US Weather Service starten

Sie verwenden den US-Wetterdienst, um Vorhersagen zu erhalten, da Sie kein Konto benötigen, um auf die Wetterdaten zuzugreifen.

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

• Eine, um den Gitterpunkt zu lokalisieren, an dem sich ein geografischer Standort befindet.
• 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 enthält, 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. Wählen Sie in Bridge im Dashboard "Workflows" die Option Neuer Workflow aus.

2. Geben Sie Ihrem Workflow einen Namen und wählen Sie Create New (Neu erstellen) aus. So gelangen Sie zum Designer.

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

Brandfolder Image

Schritt 2: Sheet erstellen

Bevor Sie den Auslöser in Bridge einrichten, benötigen Sie ein Smartsheet Blatt mit mindestens fünf Spalten.

Richten Sie Ihr Sheet mit den folgenden Spaltennamen und -typen ein:

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

1.  Fügen Sie in der ersten Zelle der Spalte Heute die folgende Formel ein:

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

2. Drücken Sie die Eingabetaste. 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 für alle neuen Zeilen, die dem Blatt hinzugefügt werden, diese Formel in der Spalte Heute verwendet wird.
4. Speichern Sie das Sheet.
5. Bevor Sie zum Designer in Bridge zurückkehren, kopieren Sie die Blatt-ID. Sie finden die Sheet-ID unter Datei > Eigenschaften.

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 Typ des Triggers einrichten können, den Sie verwenden möchten. Da der Workflow durch ein Ereignis in Smartsheet ausgelöst werden soll, wird als Typ Trigger ein Integrationstrigger verwendet.

Wählen Sie im Bereich unter dem automatisch erweiterten Abschnitt Integrations (Integrationen) die Option Integrations Page (Seite „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 aus.
4. Daraufhin wird ein weiteres Fenster angezeigt, in dem Sie gefragt werden, ob Sie Smartsheet Bridge den Zugriff auf Ihr Smartsheet-Konto erlauben möchten. Wählen Sie Allow (Erlauben) aus.

Wenn die Authentifizierung erfolgreich war, wechselt das Fenster zur Registerkarte Auslöser .

Brandfolder Image

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

1. Fügen Sie im Feld Sheet ID (Sheet-ID) die Sheet-ID ein, die Sie beim Anlegen des Sheets kopiert haben. Wenn Sie wissen, dass der Blattname eindeutig ist, geben Sie ihn ein.
2. Wählen Sie in der Dropdown-Liste Event Type (Ereignistyp) den Auslöser When Column Values are Changed (Wenn Spaltenwerte geändert werden) 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 und der Abschnitt Triggers (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 Sie es im Blatt getan haben. 
• Wenn Sie den Blattnamen statt der Blatt-ID eingegeben haben, überprüfen Sie, ob Sie diesen genau richtig geschrieben haben. 
• Sollten Sie nicht der Sheetinhaber sein, überprüfen Sie Ihre Sheetberechtigungen, um sicherzustellen, dass Sie noch Zugriff haben.
• Wenn bereits andere Auslöser eingerichtet sind, kann ein anderer Auslöser ein Problem verursachen. Überprüfen Sie die anderen Auslöser, um sicherzustellen, dass sich die Berechtigungen für einen von ihnen nicht geändert haben oder dass das Blatt, auf das im Auslöser verwiesen wird, noch existiert

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

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

1. Legen Sie für die Datumszelle in der ersten Zeile das aktuelle Datum fest. Dadurch wird das Kästchen in der Spalte Heute aufgrund der zuvor eingegebenen Formel automatisch aktiviert. 
2. Speichern Sie das Sheet und kehren Sie zum Designer in Smartsheet Bridge zurück.
3. Öffnen Sie das Run Log. Es wird zunächst leer sein, wählen Sie also Aktualisieren aus. Dadurch wird der Bereich aktualisiert. Es sollte ein Durchlauf mit dem Status Abgeschlossen angezeigt werden.
4. Um die anfänglichen Daten anzuzeigen, die von Smartsheet an Bridge gesendet wurden, wählen Sie während der Ausführung aus, erweitern Sie die Zeile Trigger und dann die Zeile Ereignis. 
5. Bewegen Sie den Mauszeiger über rowId in den Auslöserdaten und wählen Sie das Symbol für Mehr aus, um eine Dropdown-Liste anzuzeigen. 

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

   Wenn die Referenz anstelle der JSON-Quelle verwendet wird, ruft der Workflow immer die geänderte Zeile ab, anstatt immer dieselbe Zeile zu betrachten. Dies ist wichtig, da sich die Zeilenänderung wahrscheinlich zwischen den einzelnen Workflows unterscheiden wird. 

Brandfolder Image

Zustand aktualisieren und Modul hinzufügen

1. Wählen Sie den grauen Status aus und ändern Sie das FeldNamein Get Row (Zeile abrufen).

   Es empfiehlt sich, die Zustände nach der Funktion der Module darunter zu benennen, damit Ihre Workflows leichter zu lesen sind.

2. Suchen Sie das Modul Get Row im Menü auf der linken Seite. Verwenden Sie das Suchfeld oder suchen Sie es, indem Sie Integrations > Smartsheet > Get Row (Integrationen > Smartsheet > Zeile abrufen) erweitern.
3. Ziehen Sie das Modul in den Workflow unter dem grauen Status. 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 der rowId in das Ausführungsprotokoll kopiert haben. Der eingefügte Wert sollte {{runtime.event.rowId}} lauten.
5. Um die Blatt-ID abzurufen, öffnen Sie das Ausführungsprotokoll erneut und erweitern Sie die Triggerdaten, um sie zu finden. Kopieren Sie den Verweis auf die Blatt-ID wie zuvor für die Zeilen-ID, indem Sie das Symbol mehr auswählen.
6. Wählen Sie das Modul Zeile abrufen erneut aus und fügen Sie es in die Referenz im Feld Blatt ein. Der eingefügte Wert sollte {{runtime.sheetID}} lauten.

7. Wählen Sie oben auf der Seite Löschen aus.

   Brandfolder Image

   

Schritt 5. Verzweigung einrichten

Sie müssen feststellen, ob die Änderung am Kontrollkästchen im Blatt darauf zurückzuführen ist, dass das Kontrollkästchen aktiviert oder deaktiviert wurde. Ein deaktiviertes Kästchen sollte ignoriert werden. Wenn das Kästchen jedoch zu "Aktiviert" geändert wird, bedeutet dies, dass das in der Datumsspalte 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. Kehren Sie zum Blatt zurück und ändern Sie das Datum in der zuvor hinzugefügten Zeile, um das Kontrollkästchen zu deaktivieren. Speichern Sie anschließend das Sheet.
2. Öffnen Sie in Smartsheet Bridge erneut das Ausführungsprotokoll und wählen Sie oben links im Bereich All Runs (Alle Ausführungen) aus. Aktualisieren Sie die Liste, um oben eine neue abgeschlossene Ausführung anzuzeigen. 
3. Öffnen Sie diese neue Ausführung und erweitern Sie den Schritt Smartsheet - Get Row (Smartsheet – Zeile abrufen), um die Zeilendaten anzuzeigen.
4. Unter Zeile > Zellen > Heute können Sie sehen, dass der Wert false ist. Dadurch sehen Sie, dass das Kontrollkästchen in der Spalte Heute in der geänderten Zeile 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 Übereinstimmung ein, oder erweitern Sie Dienstprogramme > bedingte Knoten > Übereinstimmung, um den Knoten zu suchen. 
2. Ziehen Sie die Verknüpfung unter das Modul Get Row , und nennen Sie sie Today's Date.

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 Angeheftete Elemente > neuen Status.

Hinzufügen von Zuständen zur Verzweigung

1. Ziehen Sie einen neuen Zustand in den Platzhalter success und nennen Sie ihn true. 
2. Ziehen Sie einen weiteren neuen Zustand in den Platzhalter failure und nennen Sie ihn false.

Datenverweis zur Verzweigung hinzufügen

1. Wählen Sie die Verzweigung Heutiges Datum aus, um den Einrichtungsbereich 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}} lauten.
3. Tippen Sie im Feld Second Value (Zweiter Wert) das Wort true (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 speichern Schlüsselinformationen für die System-APIs, mit denen Sie Ihre Workflows verbinden möchten.

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

3. Wählen Sie Continue > Add to Profiles (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 Base URL (Basis-URL) https://api.weather.gov ein.
6. Erweitern Sie das Dropdown-Menü Headers (Header):
   • Geben Sie im Feld Key #1 (Schlüssel Nr. 1) „User-Agent“ ein.

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

     Der US-Wetterdienst benötigt 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 ausführen zu finden, oder erweitern Sie Dienstprogramme > Hilfsfunktionen> API-Aufruf durchführen.
2. Ziehen Sie es in den Workflow unter dem Zustand true (wahr).
3. Wählen Sie im „Make API Call“-Modul das soeben angelegte Profil aus der Dropdown-Liste aus.
4. Geben Sie im Feld Endpoint (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 Method (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 dieses Handbuch 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 zu einer neuen Zeile hinzu, anstatt die erste zu verwenden, und stellen Sie sicher, dass Sie das Datum auf das heutige Datum festlegen, sodass der Workflow den linken Zweig der Kreuzung hinuntergeht.

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ängen- 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. Fügen Sie dem Workflow einen neuen Status und ein weiteres Modul API-Aufruf erstellen hinzu, um dies einzurichten. 

1. Ziehen Sie einen neuen Status aus den angehefteten Elementen oben im Menü auf der linken Seite und legen Sie ihn ab und nennen Sie ihn Prognose.
2. Ziehen Sie dann ein weiteres Modul API-Aufruf erstellen unter den neuen Status.
3. Wählen Sie im „Make API Call“-Modul das soeben angelegte Profil aus der Dropdown-Liste aus.
4. Geben Sie im Feld Endpoint (Endpunkt) 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 Method (Methode) auf GET fest.

6. Speichern Sie den Workflow.

   Brandfolder Image

   

Datenreferenzen für den Prognoseaufruf

Wenn Sie möchten, dass die Datenreferenzen im Endpunkt über Ihnen selbst verwendet werden, 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 letzten Schritt: Call API: Make API Call (API aufrufen: API-Aufruf durchführen). Suchen Sie unter Ausgabe>Eigenschaften die Felder gridId, gridX und gridY. Sie können diese Verweise dann in der URL verwenden, um den Wetterdienst aufzurufen.

Schritt 8: 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 (Zeile aktualisieren).
3. Suchen Sie nach dem Modul Zeile aktualisieren, oder erweitern Sie Integrationen > Smartsheet > Zeile aktualisieren.
4. Erweitern Sie im Ausführungsprotokoll den Trigger (Auslöser) der letzten Ausführung und suchen Sie nach der Sheet- und Zeilen-ID.  
5. Verwenden Sie die Datenreferenzen, um die Felder "Blatt-ID" und "Zeilen-ID" für das Modul "Zeile aktualisieren" 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 Module API-Aufruf erstellen). Die Daten des US-Wetterdienstes, einschließlich der Sieben-Tage-Wettervorhersagen, liefern eine Reihe von Informationen. 
2. Das aktuelle Wetter finden Sie unter Output > properties > periods > 0 (Ausgabe > Eigenschaften > Zeiträume > 0).
3. Für diesen Workflow sollten Sie den Verweis auf detailedForecast 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 Value # (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 Spalte Wettervorhersage in das 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. Holen Sie sich Forecast.call_api.make_api_call.response.properties.periods.0.detailedForecast||Wetterdaten können nicht abgerufen werden}}
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 in der linken oder rechten Verzweigung der Kreuzung). Sie wird auch immer am heutigen Tag ausgeführt, und zwar zu dem Datum, das für eine vorhandene 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 Today (Heute) aktiviert ist.