Schnellstart: erster vollständiger Strategieablauf mit EMS Builder

Diese Anleitung erstellt in einer Testumgebung einen minimalen Ablauf: Erfassungsdatenpunkte lesen → Aggregationsausdruck testen → Aggregationsdatenpunkt erstellen → Ergebnis prüfen. Führen Sie keine ungeprüften Schreibzugriffe direkt auf Produktionsgeräten aus.

1. Voraussetzungen

• Edge-EMS Builder ist installiert und ordnungsgemäß gestartet.
• CommBridge ist mit mindestens einem Testgerät oder Simulator verbunden.
• Ein Administrator-Testkonto für Edge-EMS Builder ist vorhanden.
• Die Adresse von Edge-EMS Builder ist bekannt:
  • Direkter LAN-Zugriff: http://<Geräte-IP>:8988
  • JelinaCloud-Proxy: https://<Geräte-UUID>.proxy.jelina.wise-iot-cloud.com/api

Verwenden Sie für Adressen, Ports und Konten Ihre eigene Testumgebung. Nehmen Sie keine tatsächlichen Passwörter, Tokens oder Geräte-UUIDs in das Code-Repository auf.

2. Daten in EMS Builder und CommBridge prüfen

1. Melden Sie sich an der Verwaltungsoberfläche von Edge-EMS Builder an.
2. Öffnen Sie die Liste „Erfassungsdaten“.
3. Prüfen Sie, ob mindestens zwei numerische Erfassungsdatenpunkte vorhanden sind, beispielsweise:
   • voltage_a
   • voltage_b
4. Prüfen Sie aktuelle Werte und einen ordnungsgemäßen Kommunikationsstatus.

Falls keine Erfassungsdatenpunkte vorhanden sind, prüfen Sie zunächst:

• Sind CommBridge-Projekt, Knoten und Erfassungsaufgaben aktiviert?
• Ist die CommBridge-WebSocket-Adresse in Edge-EMS Builder korrekt?
• Ist das Gerät oder der Simulator online?
• Enthalten die Protokolle von Edge-EMS Builder oder CommBridge Verbindungs- oder Konfigurationsfehler?

3. Aggregationsausdruck testen

Wählen Sie auf der Seite „Aggregationsdaten“ die Funktion „Testberechnung“ und geben Sie Folgendes ein:

if ${voltage_a} == "__Null__" or ${voltage_b} == "__Null__" then
    return 0
end

local a = tonumber(${voltage_a}) or 0
local b = tonumber(${voltage_b}) or 0
return (a + b) / 2

Ersetzen Sie voltage_a und voltage_b durch tatsächlich vorhandene dataKey-Kennungen Ihrer Testumgebung.

Erwartetes Ergebnis:

• Die Syntaxprüfung des Ausdrucks ist erfolgreich.
• Ein numerischer Wert wird zurückgegeben.
• Der Wert entspricht dem Mittelwert der beiden Erfassungsdatenpunkte.

4. Ersten Aggregationsdatenpunkt erstellen

Erstellen Sie nach erfolgreicher Testberechnung einen Aggregationsdatenpunkt:

Feld	Beispiel
dataKey	voltage_avg
Name	Mittlere Spannung
Datentyp	float
Ausdruck	Den zuvor erfolgreich getesteten Lua-Ausdruck verwenden
Erfassungs-/Berechnungsintervall	Entsprechend der Testumgebung festlegen

Nach dem Speichern:

1. Kehren Sie zur Aggregationsdatenliste zurück.
2. Prüfen Sie, ob voltage_avg erstellt wurde.
3. Ändern Sie voltage_a oder voltage_b im Simulator.
4. Prüfen Sie, ob voltage_avg entsprechend aktualisiert wird.

5. Dieselben Schritte über die API ausführen

Die entsprechenden Edge-EMS Builder-Schnittstellen sind:

• POST /account/login
• GET /collection-data-config/list
• POST /aggregation-data-config/calculate
• POST /aggregation-data-config/add
• GET /aggregation-data-config/list

Beispiel einer Anmeldeanfrage:

{
  "mail": "<Testkonto>",
  "password": "<Testpasswort>"
}

Verwenden Sie für Folgeanfragen das von der Anmeldeschnittstelle zurückgegebene Token. Anfrageheader, Felder und Antwortstrukturen sind in der HTTP-Schnittstellendokumentation von Edge-EMS Builder beschrieben. Belassen Sie keine tatsächlichen Zugangsdaten in Dokumentation, Skripten oder Bildschirmaufnahmen.

6. Nächster Schritt: Triggerschema erstellen

Nach dem Aggregationsdatenpunkt können Sie sich mit folgenden Themen befassen:

• Triggerschemata
• Lua-Ausdrucksengine
• Cloud-Edge-Koordination mit MQTT
• Echtzeitübertragung und direkte Steuerung für Frontends

Erstellen Sie zunächst in der Testumgebung ein Triggerschema ohne Gerätesteuerrisiko, etwa einen Hochtemperaturalarm oder die Protokollierung von Testdatenpunktänderungen, bevor Sie tatsächliche Geräte beschreiben.

7. Abschlusskriterien

• Von CommBridge übertragene Erfassungsdatenpunkte sind sichtbar.
• Die Testberechnung des Aggregationsausdrucks ist erfolgreich.
• Der Aggregationsdatenpunkt wurde erstellt und wird aktualisiert.
• Bei Eingabe __Null__ verursacht das Skript keinen Fehler.
• Sämtliche Schritte wurden in der Testumgebung ausgeführt.
• Dokumentation, Skripte und Bildschirmaufnahmen enthalten keine tatsächlichen Zugangsdaten.