> 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 de système de gestion technique du bâtiment (BMS) de Kiona. myCoreAI l’utilise pour lire des signaux depuis — et écrire des consignes vers — des armoires de commande et des DUC 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 balises, puis finalisation du flux de signaux dans myPortal.

## 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 également être hébergé par un partenaire en tant que service cloud.
2. **Web Port-Cloud de Myrspoven.** Une instance Web Port cloud partagée. Le Web Port local s’y connecte en amont ; myCoreAI lit les balises depuis là.
3. **myPortal.** Génère le signal final et les scripts de repli 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 antérieures nécessitent .NET Framework 4.8 ou version ultérieure (depuis [Microsoft](https://dotnet.microsoft.com/en-us/download/dotnet-framework/net481)).
* Un fichier de licence Web Port (`WebPort.lic`) de [market.webport.se](https://market.webport.se/webport).
* Un accès réseau depuis l’hôte vers les périphériques d’E/S sur site et vers Web Port-Cloud de Myrspoven à `https://myrspoven.webport.se`.
* Des droits d’administrateur sur l’hôte (requis 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 build 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 de versions de Web Port](https://iwmac.zendesk.com/hc/sv/articles/5100183398684-Senaste-releasen-Web-Port).
{% endstep %}

{% step %}

## Exécuter le programme d’installation

Exécutez le programme d’installation. Le [guide d’installation](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 le modifiez qu’en cas de conflit de ports.
  {% 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 un identifiant administrateur par défaut. Après la première connexion, créez un nouveau compte admin et désactivez ou modifiez l’identifiant 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

Ignorez cette section pour le Web Port cloud hébergé par un partenaire — allez directement à [Créer un appareil d’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 du nœud**.
2. Cliquez sur **Connecter le portail**.
3. Renseignez :
   * **Nom :** nom de l’entreprise ou du bien immobilier.
   * **Description :** par ex. « Web Port-Cloud Myrspoven ».
   * **Adresse du portail :** `https://myrspoven.webport.se/`
4. Enregistrer.
   {% endstep %}

{% step %}

## Activer la connexion dans Web Port-Cloud

Activez la connexion côté Myrspoven :

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

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

### Activer l’enregistrement des tendances

L’enregistrement des tendances doit être activé, sinon aucun historique des signaux n’est stocké.

1. Ouvrez **Paramètres système → Tendance → Paramètres de base**.
2. Activer **Support des tendances** et enregistrez.

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

Des fuseaux horaires Windows incorrects font dériver les horodatages des signaux et perturbent l’analyse en aval. Vérifiez avant de continuer.

### Créer un appareil d’E/S

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

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

{% stepper %}
{% step %}

## Ajouter l’appareil

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

### Configurer l’appareil d’E/S

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

{% stepper %}
{% step %}

## Ouvrir la configuration de l’appareil

Ouvrez le nouvel appareil d’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’IP de l’armoire de commande ou du DUC.
* **Port (TCP) :** `502` est la norme pour Modbus. Si ce port est fermé sur l’IP cible, escaladez vers le 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 fait passer le pilote au vert avec l’état **OK**.
{% endstep %}
{% endstepper %}

### Créer une liste de balises

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

{% stepper %}
{% step %}

## Ouvrir les balises

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

{% step %}

## Créer la liste

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

{% step %}

## Nommer et enregistrer

**Nom :** même convention que pour l’appareil d’E/S — nom du bâtiment plus l’appareil.

Enregistrer.

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

### Créer des balises

La création de balises est identique quel que soit le protocole — seul le format de l’adresse change.

{% stepper %}
{% step %}

## Créer une nouvelle balise

Cliquez sur **Nouvelle balise**.
{% endstep %}

{% step %}

## Renseignez les champs

Renseignez :

* **Nom :** structure `NomDuBâtiment_Unité_Capteur_Propriété` — par ex. `ExampleBuilding_HC1_AHU1_TE1_SP`. Des préfixes cohérents rendent les listes de signaux portables entre les bâtiments. Évitez Å, Ä, Ö — la base de données les remplace parfois par un underscore.
* **Appareil d’E/S :** l’appareil auquel la balise appartient.
* **Adresse :** associe la balise à 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 **Min./max. fin :** met à l’échelle la valeur brute.
* **Unité :** unité SI.
* **Format :** quatre décimales est la norme.
* **Description :** ce que la balise représente.
* **Journalisation des tendances :** doit être activée. Un intervalle de 300 secondes est suffisant.
  {% endstep %}

{% step %}

## Enregistrer

Enregistrez la balise, puis la liste de balises.
{% 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 obtient son propre groupe. Les membres du groupe héritent de l’accès à l’API de Web Port et aux balises 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 — par ex. `ExampleBuilding_Modbusgroup`.
4. Laissez le reste aux valeurs 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 :
   * `NomDuBâtiment_découverte`
   * `NomDuBâtiment_lecture`
   * `NomDuBâ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’espaces au début ni à la fin.
5. Attribuez l’utilisateur au groupe du bâtiment et enregistrez.
6. Répétez pour les utilisateurs restants.
   {% endstep %}
   {% endstepper %}

### Accorder des autorisations

#### Autorisations de balises

{% stepper %}
{% step %}

## Créer l’autorisation de balise

1. Ouvrez **Paramètres système → Accès → Autorisations**.
2. Cliquez sur **Nouvelle autorisation → Nouvelle autorisation de balise**.
3. Définissez :
   * **Utilisateur/Groupe :** le groupe du bâtiment.
   * **Filtre de balises :** le nom du bâtiment suivi de `_*` (par ex. `ExampleBuilding_*`). Limite l’autorisation aux balises de ce bâtiment.
   * **Autorisations :** **ADMIN**.
4. Enregistrer.
   {% 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 à l’API**.
   * **Autorisations :** **ADMIN**.
4. Enregistrer.
   {% endstep %}
   {% endstepper %}

## Installer l’edge Myrspoven

L’edge Myrspoven lit les balises de Web Port et les transmet à myCoreAI. Il s’exécute sur le même hôte que Web Port ou sur un hôte disposant d’un accès réseau à celui-ci.

{% stepper %}
{% step %}

## Obtenir la build

Obtenez la dernière build 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 package

Copiez le package edge dans `C:\Myrspoven\MyrspovenEDGE` et décompressez-le. Nommez le dossier décompressé `Myrspoven Edge`. Supprimez le 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 `Myrspoven` dossier.
{% endstep %}

{% step %}

## Ajouter les tâches planifiées

À l’intérieur, créez les tâches planifiées fournies par Myrspoven (les 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 l’edge Myrspoven manuellement depuis une 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 Web Port Script

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

{% step %}

## Générer les scripts

Suivez les instructions dans l’application pour générer le script de signal et le script de repli.
{% 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 à 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 les paramètres de base des tendances sont activés.
* **L’edge Myrspoven fonctionne manuellement mais pas depuis 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:

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

The question should be specific, self-contained, and written in natural language.
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.