> For the complete documentation index, see [llms.txt](https://docs.myrspoven.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.myrspoven.com/myrspoven-docs/myrspoven-docs-fr/integrations/overview/bms-integrations/web-port.md).

# Web Port

Web Port est une passerelle vers un système de gestion technique du bâtiment (BMS). myCoreAI l’utilise pour lire des signaux, écrire des points de consigne et piloter des automates programmables (PLC) via Modbus, BACnet et d’autres protocoles industriels. Cette page couvre l’intégration complète : installation d’un serveur Web Port local, connexion à Web Port-Cloud de Myrspoven, configuration des appareils et des tags, puis finalisation du flux de signaux dans myPortal.

## Pourquoi Web Port est important

Web Port n’est pas qu’une simple intégration avec un fournisseur. C’est une passerelle de protocoles avec prise en charge de pilotes pour une large gamme d’équipements du bâtiment et industriels.

Cela signifie que Myrspoven n’est pas limité à une courte liste de fournisseurs lorsque Web Port est le canal de livraison. Si le système local expose les signaux requis via un pilote pris en charge, Myrspoven peut souvent s’intégrer via Web Port au lieu d’avoir besoin d’un connecteur dédié pour cette marque de BMS.

L’adéquation finale dépend toujours de la disponibilité des signaux, du périmètre d’écriture, de l’accès réseau et des exigences de mise en service. Voir [Prise en charge des pilotes Web Port](https://kiona.com/products/web-port/driver-support) pour la couverture actuelle des pilotes.

## Composants

L’intégration comporte trois parties :

1. **Web Port local.** Un service Windows exécuté sur site (ou derrière un VPN) qui communique directement avec les armoires de commande et les DUC. Peut aussi être hébergé par un partenaire sous forme de service cloud.
2. **Web Port-Cloud de Myrspoven.** Une instance Web Port cloud partagée. Le Web Port local s’y connecte vers le haut ; myCoreAI lit les tags à partir de là.
3. **myPortal.** Génère le signal final et les scripts de secours qui relient le bâtiment à myCoreAI.

## Prérequis

* Un hôte Windows pour exécuter Web Port en tant que service. Windows 10 ou version ultérieure recommandé. Les versions plus anciennes nécessitent .NET Framework 4.8 ou ultérieur (depuis [Microsoft](https://dotnet.microsoft.com/en-us/download/dotnet-framework/net481)).
* Un fichier de licence Web Port (`WebPort.lic`) provenant de [market.webport.se](https://market.webport.se/webport).
* Un accès réseau depuis l’hôte vers les dispositifs d’E/S sur site et vers Web Port-Cloud de Myrspoven à `https://myrspoven.webport.se`.
* Des droits administrateur sur l’hôte (nécessaires pour installer Web Port en tant que service Windows).
* Un contact Myrspoven pour les identifiants côté cloud, le modèle de liste de signaux et la version edge Myrspoven.

## Installer le Web Port local

{% stepper %}
{% step %}

## Télécharger la dernière version

Téléchargez la dernière version du serveur Web Port depuis la [page des versions de Web Port](https://iwmac.zendesk.com/hc/sv/articles/5100183398684-Senaste-releasen-Web-Port).
{% endstep %}

{% step %}

## Exécuter l’installateur

Exécutez l’installateur. Le [guide d’installation complet](https://iwmac.zendesk.com/hc/en-gb/articles/6253490179996-Installation#Server) du fournisseur couvre chaque écran. Choix clés :

* **Pilotes :** sélectionnez les pilotes requis pour les protocoles du site (Modbus TCP, BACnet, etc.).
* **Mode d’exécution :** **Exécuter en tant que service Windows** afin que Web Port démarre avec l’hôte.
* **Port du serveur :** par défaut `8090`. Ne changez qu’en cas de conflit de port.
  {% endstep %}

{% step %}

## Placer le fichier de licence

Placez le `WebPort.lic` fichier dans le répertoire de données de Web Port.
{% endstep %}

{% step %}

## Se connecter

Ouvrez `http://localhost:8090` et connectez-vous.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
**Modifiez immédiatement les identifiants par défaut.** Web Port est livré avec une connexion administrateur par défaut. Après la première connexion, créez un nouveau compte admin et désactivez ou modifiez les identifiants par défaut avant que l’hôte ne soit exposé au-delà de localhost.
{% endhint %}

## Configurer le Web Port local

### Se connecter à Web Port-Cloud

Passez cette section pour un Web Port cloud hébergé par un partenaire — allez directement à [Créer un dispositif E/S](#create-an-io-device).

{% stepper %}
{% step %}

## Se connecter depuis le Web Port local

Sur le Web Port local :

1. Ouvrez **Paramètres système → Communication → Configuration des nœuds**.
2. Cliquez sur **Connect portal**.
3. Renseignez :
   * **Nom :** nom de l’entreprise ou de la propriété.
   * **Description :** p. ex. « Web Port-Cloud Myrspoven ».
   * **Adresse du portail :** `https://myrspoven.webport.se/`
4. Enregistrez.
   {% endstep %}

{% step %}

## Activer la connexion dans Web Port-Cloud

Activez la connexion du côté Myrspoven :

1. Connectez-vous à [https://myrspoven.webport.se](https://myrspoven.webport.se/).
2. Ouvrez **Paramètres système → Communication → Configuration des nœuds**.
3. Sélectionnez le nouveau nœud.
4. Cochez **Dispositif actif** et enregistrez.

Une connexion active apparaît en vert des deux côtés.
{% endstep %}
{% endstepper %}

### Activer la journalisation des tendances

La journalisation des tendances doit être activée, sinon aucun historique de signal n’est enregistré.

1. Ouvrez **Paramètres système → Tendances → Paramètres de base**.
2. Activer **la prise en charge des tendances** et enregistrez.

### Vérifier le fuseau horaire de l’hôte

Des fuseaux horaires Windows incorrects provoquent une dérive des horodatages des signaux et perturbent l’analyse en aval. Vérifiez avant de continuer.

### Créer un dispositif E/S

Un dispositif d’E/S relie Web Port à une armoire de commande ou à un DUC. Au moins un dispositif TCP/IP est requis. Lorsque chaque armoire ou DUC possède sa propre IP, Web Port communique directement avec chacun d’eux.

L’exemple utilise Modbus TCP — la création est identique quel que soit le pilote.

{% stepper %}
{% step %}

## Ajouter le dispositif

1. Ouvrez **Paramètres système → Communication → Dispositif**.
2. Cliquez sur **Ajouter un dispositif**.
3. Renseignez :
   * **Nom :** nom de l’armoire de commande, ou numéro du DUC suffixé par le nom du bâtiment (p. ex. `DUC1-ExampleBuilding`).
   * **Description :** facultatif.
   * **Pilote :** le pilote du site (Modbus dans cet exemple).
4. Enregistrez. Le dispositif apparaît dans la liste et reste rouge jusqu’à sa configuration.
   {% endstep %}
   {% endstepper %}

### Configurer le dispositif E/S

Cet exemple couvre Modbus TCP. D’autres pilotes exposent différents champs — voir le [manuel du pilote](https://iwmac.zendesk.com/hc/sv/articles/10579102738332-Drivrutinsmanualer-Web-Port).

{% stepper %}
{% step %}

## Ouvrir la configuration du dispositif

Ouvrez le nouveau dispositif E/S.
{% endstep %}

{% step %}

## Définir les champs Modbus

Faites défiler jusqu’à **Adresse esclave**, **Type Modbus**, **Hôte (TCP)**, **Port (TCP)**.
{% endstep %}

{% step %}

## Renseignez les valeurs

Définissez :

* **Adresse esclave :** `1` pour le maître ou le premier DUC, `2` pour le suivant, et ainsi de suite.
* **Type Modbus :** généralement **Modbus TCP**.
* **Hôte (TCP) :** l’adresse IP de l’armoire de commande ou du DUC.
* **Port (TCP) :** `502` est standard pour Modbus. S’il est fermé sur l’IP cible, remontez le problème au propriétaire du site ou à l’équipe réseau avant de continuer.
  {% endstep %}

{% step %}

## Enregistrer et vérifier

Enregistrez. Une IP joignable avec le port ouvert met le pilote en vert avec l’état **OK**.
{% endstep %}
{% endstepper %}

### Créer une liste de tags

L’approche la plus simple consiste à créer une liste vide, remplie manuellement.

{% stepper %}
{% step %}

## Ouvrir les tags

Ouvrez **Paramètres système → Tags**.
{% endstep %}

{% step %}

## Créer la liste

Cliquez sur **Nouvelle liste de tags**.
{% endstep %}

{% step %}

## Nommer et enregistrer

**Nom :** même convention que pour le dispositif E/S — nom du bâtiment plus le dispositif.

Enregistrez.

Pour modifier plus tard, cliquez sur l’icône de tag à gauche du nom, ou cliquez sur la ligne et choisissez **Modifier**.
{% endstep %}
{% endstepper %}

### Créer des tags

La création de tags est identique pour tous les protocoles — seul le format de l’adresse change.

{% stepper %}
{% step %}

## Créer un nouveau tag

Cliquez sur **Nouveau tag**.
{% endstep %}

{% step %}

## Renseignez les champs

Renseignez :

* **Nom :** structure `NomBâtiment_Unité_Capteur_Propriété` — p. ex. `ExampleBuilding_HC1_AHU1_TE1_SP`. Des préfixes cohérents rendent les listes de signaux portables d’un bâtiment à l’autre. Évitez Å, Ä, Ö — la base de données les remplace parfois par un trait de soulignement.
* **Dispositif E/S :** le dispositif auquel appartient le tag.
* **Adresse :** associe le tag à l’objet sous-jacent et contrôle l’accès en lecture/écriture.
* **Type de données :** `INT` pour les E/S analogiques ; `DIGITAL` pour les signaux numériques (0/1).
* **Min/max brut** et **Valeur min/max finale :** met à l’échelle la valeur brute.
* **Unité :** unité SI.
* **Format :** quatre décimales est la norme.
* **Description :** ce que représente le tag.
* **Journalisation des tendances :** doit être activée. Un intervalle de 300 secondes est suffisant.
  {% endstep %}

{% step %}

## Enregistrer

Enregistrez le tag, puis la liste de tags.
{% endstep %}
{% endstepper %}

### Filtrer les signaux

Excluez tout signal non utilisé pour l’optimisation ou le reporting. Moins de signaux non pertinents signifie un mappage plus propre plus tard et moins de bruit en aval dans myCoreAI.

## Configurer Web Port-Cloud

Ces étapes se déroulent dans [myrspoven.webport.se](https://myrspoven.webport.se/) et relient le Web Port cloud à myCoreAI.

### Créer un groupe

Chaque bâtiment reçoit son propre groupe. Les membres du groupe héritent de l’accès à l’API de Web Port et aux tags du bâtiment, et sont liés à myCoreAI.

{% stepper %}
{% step %}

## Créer le groupe

1. Ouvrez **Paramètres système → Groupes**.
2. Cliquez sur **Nouveau groupe**.
3. **Nom du groupe :** nom du bâtiment plus suffixe du protocole — p. ex. `ExampleBuilding_Modbusgroup`.
4. Laissez le reste par défaut et enregistrez.
   {% endstep %}
   {% endstepper %}

### Créer des utilisateurs

Trois utilisateurs par bâtiment : **découverte**, **lecture**, **écriture**.

{% stepper %}
{% step %}

## Créer un utilisateur

1. Ouvrez **Paramètres système → Utilisateurs**.
2. Cliquez sur **Nouvel utilisateur**.
3. Définissez le nom d’utilisateur :
   * `NomBâtiment_découverte`
   * `NomBâtiment_lecture`
   * `NomBâtiment_écriture`
4. Définissez un mot de passe fort et unique pour chaque utilisateur et stockez-le dans un gestionnaire de mots de passe. Ne réutilisez jamais les mots de passe entre bâtiments. Pas d’espace au début ni à la fin.
5. Attribuez l’utilisateur au groupe du bâtiment et enregistrez.
6. Répétez pour les autres utilisateurs.
   {% endstep %}
   {% endstepper %}

### Accorder des autorisations

#### Autorisations de tags

{% stepper %}
{% step %}

## Créer l’autorisation de tag

1. Ouvrez **Paramètres système → Accès → Autorisations**.
2. Cliquez sur **Nouvelle autorisation → Nouvelle autorisation de tag**.
3. Définissez :
   * **Utilisateur/Groupe :** le groupe du bâtiment.
   * **Filtre de tags :** nom du bâtiment suivi de `_*` (p. ex. `ExampleBuilding_*`). Restreint l’autorisation aux tags de ce bâtiment.
   * **Autorisations :** **ADMIN**.
4. Enregistrez.
   {% endstep %}
   {% endstepper %}

#### Autorisations de fonction

{% stepper %}
{% step %}

## Créer l’autorisation de fonction

1. Ouvrez **Paramètres système → Accès → Autorisations**.
2. Cliquez sur **Nouvelle autorisation → Nouvelle autorisation de fonction**.
3. Définissez :
   * **Utilisateur/Groupe :** le groupe du bâtiment.
   * **Fonction :** **Accès API**.
   * **Autorisations :** **ADMIN**.
4. Enregistrez.
   {% endstep %}
   {% endstepper %}

## Installer l’edge Myrspoven

L’edge Myrspoven lit les tags depuis Web Port et les transfère à myCoreAI. Il s’exécute sur le même hôte que Web Port ou sur un hôte ayant un accès réseau à celui-ci.

{% stepper %}
{% step %}

## Obtenir la version

Obtenez la dernière version de l’edge Myrspoven auprès de Myrspoven.
{% endstep %}

{% step %}

## Créer le dossier

Créez `C:\Myrspoven` sur l’hôte.
{% endstep %}

{% step %}

## Copier et extraire le paquet

Copiez le paquet edge dans `C:\Myrspoven\MyrspovenEDGE` puis décompressez-le. Nommez le dossier décompressé `Myrspoven Edge`. Supprimez le fichier zip une fois l’extraction vérifiée.
{% endstep %}

{% step %}

## Créer le dossier du planificateur

Ouvrez le Planificateur de tâches Windows et créez un dossier `Myrspoven` .
{% endstep %}

{% step %}

## Ajouter les tâches planifiées

À l’intérieur, créez les tâches planifiées fournies par Myrspoven (noms, actions et déclencheurs sont prédéfinis).
{% endstep %}

{% step %}

## Configurer les identifiants

Configurez les identifiants sous lesquels les tâches planifiées s’exécutent.
{% endstep %}

{% step %}

## Tester l’edge

Testez manuellement l’edge Myrspoven depuis l’invite de commandes avant de vous fier aux déclencheurs. Confirmez que les signaux apparaissent dans myCoreAI dans l’intervalle attendu.
{% endstep %}
{% endstepper %}

## Finaliser dans myPortal

Les dernières étapes se déroulent dans myPortal :

{% stepper %}
{% step %}

## Sélectionner le bâtiment

Sélectionnez le bâtiment.
{% endstep %}

{% step %}

## Ouvrir l’outil de script Web Port

Ouvrez **Outils → Script Web Port**.
{% endstep %}

{% step %}

## Générer les scripts

Suivez les instructions dans l’application pour générer le script des signaux et le script de secours.
{% endstep %}

{% step %}

## Ajuster si nécessaire

Ajustez le script dans un éditeur de texte si nécessaire.
{% endstep %}

{% step %}

## Coller dans Web Port

Collez le script dans le Web Port local.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Les instructions intégrées de myPortal font autorité. En cas de conflit avec cette page pendant la génération du script, myPortal prime.
{% endhint %}

## Dépannage

* **Web Port ne démarre pas en tant que service.** Vérifiez le Journal des événements Windows. Causes les plus courantes : fichier de licence manquant ou expiré, ou autre processus utilisant le port configuré.
* **Signaux collectés mais horodatages incorrects.** Revérifiez le fuseau horaire de l’hôte et confirmez que Paramètres de base des tendances est activé.
* **L’edge Myrspoven s’exécute manuellement mais pas via le Planificateur de tâches.** Vérifiez que les identifiants de la tâche planifiée ont un accès en lecture au répertoire de données de Web Port et un accès réseau sortant.
* **Le pilote est rouge, pas OK.** Confirmez que l’IP cible est joignable depuis l’hôte et que le port TCP configuré (502 pour Modbus) est ouvert de bout en bout.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.myrspoven.com/myrspoven-docs/myrspoven-docs-fr/integrations/overview/bms-integrations/web-port.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.