Démarrage rapide : créer une première boucle de stratégie EMS Builder

Ce guide utilise un environnement de test pour réaliser une boucle minimale : lire les points acquis → tester une expression d’agrégation → créer un point agrégé → vérifier le résultat. N’effectuez aucune écriture non révisée directement sur des équipements de production.

1. Prérequis

• Edge-EMS Builder est installé et fonctionne normalement.
• CommBridge est connecté à au moins un équipement de test ou simulateur.
• Un compte administrateur de test Edge-EMS Builder est disponible.
• L’adresse d’Edge-EMS Builder a été vérifiée :
  • Accès direct sur le réseau local : http://<IP-équipement>:8988.
  • Proxy JelinaCloud : https://<UUID-équipement>.proxy.jelina.wise-iot-cloud.com/api.

Utilisez les adresses, ports et comptes de votre propre environnement de test. N’enregistrez pas de mots de passe réels, tokens ou UUID d’équipements dans le dépôt de code.

2. Vérifier les données EMS Builder et CommBridge

1. Connectez-vous à l’interface d’administration Edge-EMS Builder.
2. Ouvrez la liste « Données acquises ».
3. Vérifiez la présence d’au moins deux points numériques, par exemple :
   • voltage_a
   • voltage_b
4. Vérifiez que les points ont une valeur récente et un état de communication normal.

Si aucun point n’est présent, vérifiez :

• l’activation du projet, des nœuds et des tâches d’acquisition CommBridge ;
• l’adresse WebSocket CommBridge configurée dans Edge-EMS Builder ;
• la disponibilité de l’équipement ou du simulateur ;
• les erreurs de connexion ou de configuration dans les journaux Edge-EMS Builder et CommBridge.

3. Tester une expression d’agrégation

Sur la page « Données agrégées », sélectionnez « Tester le calcul », puis saisissez :

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

Remplacez voltage_a et voltage_b par des dataKey réellement présents dans l’environnement de test.

Résultat attendu :

• La validation syntaxique de l’expression réussit.
• Une valeur numérique est renvoyée.
• Cette valeur est la moyenne des deux points acquis.

4. Créer un premier point agrégé

Après validation du calcul, créez le point agrégé :

Champ	Exemple
dataKey	voltage_avg
Nom	Tension moyenne
Type de données	float
Expression	Script Lua validé à l’étape précédente
Période d’acquisition/calcul	Selon les besoins de l’environnement de test

Après l’enregistrement :

1. Revenez à la liste des données agrégées.
2. Vérifiez la création de voltage_avg.
3. Modifiez voltage_a ou voltage_b dans le simulateur.
4. Vérifiez que voltage_avg est actualisé en conséquence.

5. Réaliser les mêmes opérations par API

Les interfaces Edge-EMS Builder correspondantes sont les suivantes :

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

Exemple de requête de connexion :

{
  "mail": "<compte-test>",
  "password": "<mot-de-passe-test>"
}

Les requêtes suivantes utilisent le token renvoyé par l’interface de connexion. Consultez la documentation HTTP Edge-EMS Builder pour les en-têtes, champs et structures de réponse. Ne conservez pas d’identifiants réels dans les documents, scripts ou captures d’écran.

6. Étape suivante : créer un plan de déclenchement

Après la création du point agrégé, poursuivez avec :

• Plans de déclenchement
• Moteur d’expressions Lua
• Coordination cloud-edge MQTT
• Diffusion temps réel et contrôle direct pour l’interface

Commencez dans l’environnement de test par un plan sans risque de commande d’équipement, tel qu’une alarme de température élevée ou l’enregistrement des changements d’un point de test, avant de passer aux écritures sur des équipements réels.

7. Critères de réussite

• Les points acquis transmis par CommBridge sont visibles.
• Le test de l’expression d’agrégation réussit.
• Le point agrégé est créé et actualisé.
• Le script ne produit pas d’erreur avec une entrée __Null__.
• Toutes les opérations utilisent l’environnement de test.
• Documents, scripts et captures ne contiennent aucun identifiant réel.