Foreca Weather Add-on installieren

Ds Foreca Weather Add-on setzt Live Tags basierend auf Foreca UDC-Wetterdaten. Sie können es auf dem Windows Player und dem Linux Player installieren und konfigurieren, welche Live Tags für welche Wettereigenschaften gesetzt werden sollen.

Was sind Live Tags?

Live Tags sind spezielle Tags, die die Spot-Ausspielung zur Laufzeit beeinflussen. Sie werden über (lokale) Webdienste aktiviert und deaktiviert. Dieser Prozess wird durch ein angeschlossenes externes System ausgelöst, das den Webdienst des Players aufruft. Im Falle des Foreca Weather Add-ons handelt es sich um ein Wettervorhersagesystem. Sie können den Player so konfigurieren, dass bestimmte Spots angezeigt werden, denen Live Tags zugewiesen sind, die den aktuellen Bedingungen entsprechen.

Systemanforderungen

Bevor Sie mit der Installation und Konfiguration beginnen, beachten Sie, dass es zwei Add-on-Versionen gibt. Jede Version hat ihre eigene Kompatibilität.

Stellen Sie sicher, dass Sie die folgenden Anforderungen erfüllen:

Hinweis

Informationen zur Installation eines Update-Pakets auf allen Ihren Playern erhalten Sie von Ihrem Grassfish Partner.

Add-on installieren

Wenn Sie das Add-on manuell auf dem Player installieren möchten, befolgen Sie die Anweisungen, die Ihrem Playertyp entsprechen.

Add-on unter Linux installieren

Um das Add-on auf einem Linux Player zu installieren, führen Sie die folgenden Schritte aus:

1. Legen Sie die Add-on-ZIP-Datei in einem beliebigen Ordner auf dem Player ab. Beachten Sie, dass Sie Lese- und Schreibzugriff auf den Ordner benötigen.

2. Öffnen Sie ein Terminalfenster.

3. Um das Add-on zu installieren, führen Sie den folgenden Befehl aus: sudo /opt/grassfish/tools/current/gfBootstrap/gfBoostrap <archive.zip>

   Der Bootstrapper installiert die Dateien in: /opt/grassfish/addons/gfPlayer/forecaWeather

4. Starten Sie den Playerdienst gfPlayer neu oder starten Sie den gesamten Player neu.

5. Starten Sie das Add-on. Dadurch wird die Konfigurationsdatei erstellt, die Sie im nächsten Schritt verwenden.

Add-on in Windows installieren

Um das Add-on auf einem Windows Player zu installieren, führen Sie die folgenden Schritte aus:

1. Legen Sie die Add-on-ZIP-Datei in einem beliebigen Ordner auf dem Player ab. Beachten Sie, dass Sie Lese- und Schreibzugriff auf den Ordner benötigen.

2. Öffnen Sie eine Eingabeaufforderung.

3. Um das Add-on zu installieren, führen Sie den folgenden Befehl aus: C:\GVClient\tools\current\gfBootstrap\gfBootstrap.exe <archive.zip>

   Der Bootstrapper installiert die Dateien in: C:\GVClient\addons\gfPlayer\forecaWeather\

4. Starten Sie den Playerdienst gfPlayer neu oder starten Sie den gesamten Player neu.

5. Starten Sie das Add-on. Dadurch wird die Konfigurationsdatei erstellt, die Sie im nächsten Schritt verwenden.

System konfigurieren

Um das Add-on verwenden zu können, müssen Sie den Server, die IXM Plattform und den Player konfigurieren. Führen Sie dazu die folgenden Schritte aus:

UDC Importer-Dateien kopieren und einfügen

Das UDC-Plugin importiert Wetterdaten des Datenanbieters Foreca. Führen Sie die folgenden Schritte aus, um den UDC Importer auf dem Server zu aktivieren:

1. Beenden Sie den UDC-Dienst.

2. Greifen Sie auf die UDC-Importdateien zu, die sich unter \\gfstor002\gfrelease\Global\UDC\Grassfish\ForecaGenericWeatherTng\1.2 befinden.

3. Kopieren Sie die Dateien aus dem Ordner UDC-Importprogramm, und fügen Sie sie in den Ordner UDCService\Plugins auf dem Server ein.

4. Starten Sie den UDC-Dienst neu.

UDC Datenimporter hinzufügen

Um Daten über den UDC Importer zu importieren, müssen Sie sie in der IXM Plattform hinzufügen. Führen Sie dazu die folgenden Schritte aus:

1. Gehen Sie in der IXM Plattform zu Administration > Content > Datenimporter.

2. Klicken Sie auf Neu. Dadurch wird das Fenster Datenimporter anlagen geöffnet.

3. Geben Sie in der Registerkarte Allgemein Informationen zum Datenimporter an.

4. Wechseln Sie zur Registerkarte Feeds, und geben Sie die folgenden Werte an:

   • Geben Sie als Pfad https://pfa.foreca.com an.

   • Geben Sie als Benutzername den Benutzernamen für die Datenquelle ein.

   • Geben Sie als Kennwort das Kennwort für die Datenquelle ein.

5. Klicken Sie auf Speichern, um Ihre Änderungen zu speichern.

Location des Players festlegen

Sie müssen gültige Koordinaten festlegen, um reale Wetterdaten für eine bestimmte Position zu laden. Um die Koordinaten zu konfigurieren, führen Sie die folgenden Schritte aus:

1. Gehen Sie in der IXM Plattform zu Channels > Location.

2. Wählen Sie die Location des Players aus.

3. Doppelklicken Sie auf den Player. Dadurch wird das Fenster Player bearbeiten geöffnet.

4. Wechseln Sie zur Registerkarte Lokalisierung.

5. Geben Sie den Breitengrad und Längengrad der Location an. Geben Sie einen Breitengrad von -90 bis 90 und einen Längengrad von -180 bis 180 ein. Sie können Dezimalstellen verwenden, um die Genauigkeit zu erhöhen.

6. Klicken Sie auf Speichern, um Ihre Änderungen zu speichern.

Erstellen von Live Tags

Sie müssen Live Tags in der IXM Plattform erstellen, die Sie später mit den Foreca-Wettereigenschaften wie Temperaturbereichen oder Windgeschwindigkeiten abgleichen.

Hinweis

Windgeschwindigkeit ist ab Add-on-Version 2.1 verfügbar.

Um Ihre Live Tags zu erstellen, führen Sie die folgenden Schritte aus:

1. Gehen Sie in der IXM Plattform zu Administration > Content > Tags. 

2. Um Temperatur-Tags zu erstellen, wählen Sie Tags und klicken Sie auf das + in der unteren rechten Ecke.

3. Geben Sie im Dialogfeld Tag anlegen einen Namen für die Foreca-Temperatur-Tags ein. Der Foreca-Standardschlüssel ist ForecaTemp. Wenn Sie einen anderen Namen für das Live Tag verwenden, müssen Sie die Add-on-Konfigurationsdatei später anpassen.

4. Wählen Sie als Typ die Option Live Tag aus.

5. Klicken Sie auf Speichern, um Ihre Änderungen zu speichern.

6. Wählen Sie das neu erstellte Tag aus und klicken Sie auf das + in der unteren rechten Ecke.

7. Geben Sie im Dialogfeld Tag anlegen einen Temperaturbereich in Grad Celsius (°C) ein, z. B. -10-0 oder 30-40.

8. Klicken Sie auf Speichern, um Ihre Änderungen zu speichern.

9. Wiederholen Sie die Schritte 6 bis 8, um für jeden erforderlichen Temperaturbereich eine neue Temperaturkennzeichnung zu erstellen.

10. Um Wettertyp-Tags zu erstellen, wählen Sie Tags und klicken Sie auf das + in der unteren rechten Ecke.

11. Geben Sie im Dialogfeld Tag anlegen einen Namen für die Foreca-Wetter-Tags ein. Der Foreca-Standardschlüssel ist ForecaWeather. Wenn Sie einen anderen Namen für das Live Tag verwenden, müssen Sie die Add-on-Konfigurationsdatei später anpassen.

12. Wählen Sie als Typ die Option Live Tag aus.

13. Klicken Sie auf Speichern, um Ihre Änderungen zu speichern.

14. Wählen Sie das neue Tag aus und klicken Sie auf das + in der unteren rechten Ecke.

15. Geben Sie im Dialogfeld Tag erstellen einen Wettertyp wie "Sonnig" oder "Bewölkt" ein.

16. Klicken Sie auf Speichern, um Ihre Änderungen zu speichern.

17. Wiederholen Sie die Schritte 14 bis 16, um für jeden erforderlichen Wettertyp ein neues Wetter-Tag zu erstellen.

18. Um Windgeschwindigkeits-Tags zu erstellen, wählen Sie Tags und klicken Sie auf das + in der unteren rechten Ecke.

19. Geben Sie im Dialogfeld Tag anlegen einen Namen für die Foreca-Windgeschwindigkeits-Tags ein. Der Foreca-Standardschlüssel ist ForecaWindSpeed. Wenn Sie einen anderen Namen für das Live Tag verwenden, müssen Sie die Add-on-Konfigurationsdatei später anpassen.

20. Wählen Sie als Typ die Option Live Tag aus.

21. Klicken Sie auf Speichern, um Ihre Änderungen zu speichern.

22. Wählen Sie das neue Tag aus und klicken Sie auf das + in der unteren rechten Ecke.

23. Geben Sie im Dialogfeld Tag anlegen einen Windgeschwindigkeitsbereich in Metern pro Sekunde (m/s) ein, z. B. 0-10 oder 11-20.

24. Klicken Sie auf Speichern, um Ihre Änderungen zu speichern.

25. Wiederholen Sie die Schritte 22 bis 24, um für jeden erforderlichen Windgeschwindigkeitsbereich ein neues Windgeschwindigkeits-Tag zu erstellen.

Add-on konfigurieren

Bei größeren Rollouts können Sie die config.ini-Datei konfigurieren und vor dem Rollout im Add-on-Ordner ablegen, um die Konfiguration auf alle Player anzuwenden. Um die Konfigurationsdatei zu erhalten, installieren und starten Sie das Add-on auf einem Player.

Das Add-on setzt Live Tags basierend auf den UDC-Wetterdaten von Foreca. Sie müssen das Add-on konfigurieren, um anzugeben, welche Live Tags für welche Wettereigenschaften gesetzt werden sollen. Das bedeutet, dass Sie jedem Rückgabewert von Foreca in der Konfigurationsdatei des Add-ons ein Live Tag zuweisen müssen. In der Regel weisen Sie mehreren Foreca-Werten ein Live Tag zu.

Informationen zu den Foreca-Wettersymbolen finden Sie unter https://developer.foreca.com/resources.

Um das Add-on zu konfigurieren, führen Sie die folgenden Schritte aus:

1. Öffnen Sie die Datei config.ini :

   • Gehen Sie unter Linux zu / opt/grassfish/addonConfigs/gfPlayer/forecaWeather. Das Add-on befindet sich unter $CONFIG_DIR.

   • Unter Windows: C:\GVClient\addonConfigs\gfPlayer\forecaWeather. Das Add-on befindet sich unter $CONFIG_DIR.

2. Konfigurieren Sie unter Allgemein die folgenden Einstellungen:

   Name	Art	Standard	Beschreibung
   Loglevel	Loglevel (String)	Notice	Legen Sie die Protokollebene des Add-ons fest, um anzugeben, welche Benachrichtigungen gesammelt werden: Error Warning Notice Info Debug
   LiveTagKeyWeather	String	ForecaWeather	Dies ist der Standardschlüssel für das Live Tag, das das Wetter enthält. Wenn Sie einen anderen Namen für Ihr Live Tag angegeben haben, ändern Sie den Schlüssel entsprechend.
   LiveTagKeyTemp Bereich	String	ForecaTemp	Dies ist der Standardschlüssel für das Live Tag, das den Temperaturbereich enthält. Wenn Sie einen anderen Namen für Ihr Live Tag angegeben haben, ändern Sie den Schlüssel entsprechend. Die Werte für die möglichen Temperaturbereiche werden direkt von allen Stellen des aktuell aktiven Bildschirmlayouts ausgelesen. Sobald Sie die Temperaturwerte als Live Tags in der IXM Plattform gespeichert haben, wertet das Add-on diese automatisch aus.
   LiveTagKeyWind Drehzahlbereich	String	ForecaWind Speed	Dies ist die Standardtaste für den Windgeschwindigkeitsbereich. Wenn Sie einen anderen Namen für Ihr Live Tag angegeben haben, ändern Sie den Schlüssel entsprechend. Die Werte für die möglichen Windgeschwindigkeitsbereiche werden direkt von allen Spots des aktuell aktiven Bildschirmlayouts ausgelesen. Anmerkung Beachten Sie, dass Windgeschwindigkeit ab Add-on-Version 2.1 verfügbar ist.
   WeatherDataValid ForSecs	Ganze Zahl	86400	Geben Sie an, wie lange Wetterdaten in Sekunden gültig sind. Wenn keine gültigen Wetterdaten vorhanden sind, werden die Live Tags für den Wetter- und Temperaturbereich gelöscht.

3. Geben Sie unter LiveTagMap Schlüssel-Wert-Paare für die Zuordnung der Foreca-Wettersymbole zu Live Tag-Werten an. Gehen Sie folgendermaßen vor:

   • Schlüssel: Geben Sie einen dreistelligen Wettersymbolcode an, wie in https://developer.foreca.com/resources beschrieben.

   • Wert: Geben Sie den Live Tag-Wert an.

4. Speichern und schließen Sie die Konfigurationsdatei.

Beispiele für Schlüssel-Wert-Paare

000=Sonnig

100=Bewölkt

210=Regen

422=Verschneit

Datenimporter starten

Um die Installation abzuschließen, müssen Sie den Datenimport in der IXM Plattform starten. Führen Sie dazu die folgenden Schritte aus:

1. Gehen Sie in der IXM Plattform zu Administration > Content > Datenimporter.

2. Wählen Sie den Datenimporter aus, den Sie starten möchten.

3. Wählen Sie in der unteren rechten Ecke Extras aus.

4. Wählen Sie Import starten aus, um die Daten zu importieren.

5. Wählen Sie optional Daten anzeigen aus, um die importierten Daten zu überprüfen.

6. Klicken Sie auf OK, um das Fenster zu schließen.