> 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/docs-us-cs/integrace/overview/bms-integrations/web-port.md).

# Web Port

Web Port je brána systému správy budov (BMS). myCoreAI ji používá ke čtení signálů a zápisu žádaných hodnot pro řízení PLC přes Modbus, BACnet a další průmyslové protokoly. Tato stránka pokrývá celou integraci: instalaci lokálního serveru Web Port, jeho připojení ke cloudu Web Port společnosti Myrspoven, konfiguraci zařízení a tagů a dokončení toku signálů v BackOffice.

## Proč je Web Port důležitý

Web Port není jen integrace jednoho dodavatele. Je to protokolová brána s podporou ovladačů pro širokou škálu zařízení budov i průmyslových zařízení.

To znamená, že Myrspoven není při použití Web Portu omezen na krátký seznam dodavatelů. Pokud lokální systém vystavuje požadované signály prostřednictvím podporovaného ovladače, může se Myrspoven často integrovat přes Web Port místo toho, aby potřeboval dedikovaný konektor pro danou značku BMS.

Konečná vhodnost stále závisí na dostupnosti signálů, rozsahu zápisu, přístupu k síti a požadavcích na zprovoznění. Viz [podpora ovladačů Web Port](https://kiona.com/products/web-port/driver-support) pro aktuální pokrytí ovladačů.

## Komponenty

Integrace má tři části:

1. **Lokální Web Port.** Služba Windows běžící na místě (nebo za VPN), která komunikuje přímo s rozváděči a DUC. Může být také provozována partnerem jako cloudová služba.
2. **Web Port-Cloud společnosti Myrspoven.** Sdílená cloudová instance Web Portu. Lokální Web Port se k ní připojuje směrem nahoru; myCoreAI odtud čte tagy.
3. **BackOffice.** Generuje finální signálové a fallback skripty, které propojí budovu s myCoreAI.

## Předpoklady

* Hostitel Windows pro spuštění Web Portu jako služby. Doporučeno Windows 10 nebo novější. Starší verze vyžadují .NET Framework 4.8 nebo novější (od [Microsoftu](https://dotnet.microsoft.com/en-us/download/dotnet-framework/net481)).
* Licenční soubor Web Portu (`WebPort.lic`) z [market.webport.se](https://market.webport.se/webport).
* Síťový přístup z hostitele k I/O zařízením na místě a ke cloudu Web Port společnosti Myrspoven na `https://myrspoven.webport.se`.
* Práva správce na hostiteli (vyžadováno pro instalaci Web Portu jako služby Windows).
* Kontakt v Myrspovenu pro cloudové přihlašovací údaje, šablonu seznamu signálů a build edge aplikace Myrspoven.

## Nainstalujte lokální Web Port

{% stepper %}
{% step %}

## Stáhněte si nejnovější verzi

Stáhněte si nejnovější vydání serveru Web Port z [stránky vydání Web Portu](https://iwmac.zendesk.com/hc/sv/articles/5100183398684-Senaste-releasen-Web-Port).
{% endstep %}

{% step %}

## Spusťte instalátor

Spusťte instalátor. Úplný [návod k instalaci](https://iwmac.zendesk.com/hc/en-gb/articles/6253490179996-Installation#Server) pokrývá každou obrazovku. Klíčové volby:

* **Ovladače:** vyberte ovladače požadované pro protokoly daného objektu (Modbus TCP, BACnet atd.).
* **Režim spuštění:** **Spustit jako službu Windows** aby se Web Port spouštěl spolu s hostitelem.
* **Port serveru:** výchozí `8090`. Měňte jen při konfliktu portů.
  {% endstep %}

{% step %}

## Umístěte licenční soubor

Umístěte `WebPort.lic` soubor do datového adresáře Web Portu.
{% endstep %}

{% step %}

## Přihlaste se

Otevřete `http://localhost:8090` a přihlaste se.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
**Ihned změňte výchozí přihlašovací údaje.** Web Port je dodáván s výchozím účtem správce. Po prvním přihlášení vytvořte nový účet správce a výchozí účet deaktivujte nebo změňte, než bude hostitel vystaven mimo localhost.
{% endhint %}

## Nakonfigurujte lokální Web Port

### Připojte se k Web Port-Cloud

Tuto sekci přeskočte pro cloudový Web Port hostovaný partnerem — přejděte rovnou na [Vytvořit I/O zařízení](#create-an-io-device).

{% stepper %}
{% step %}

## Připojení z lokálního Web Portu

V lokálním Web Portu:

1. Otevřete **Nastavení systému → Komunikace → Nastavení uzlu**.
2. Klikněte na **Připojit portál**.
3. Vyplňte:
   * **Název:** název společnosti nebo nemovitosti.
   * **Popis:** např. "Web Port-Cloud Myrspoven".
   * **Adresa portálu:** `https://myrspoven.webport.se/`
4. Uložte.
   {% endstep %}

{% step %}

## Aktivujte připojení v Web Port-Cloud

Aktivujte připojení na straně Myrspovenu:

1. Přihlaste se do [https://myrspoven.webport.se](https://myrspoven.webport.se/).
2. Otevřete **Nastavení systému → Komunikace → Nastavení uzlu**.
3. Vyberte nový uzel.
4. Zaškrtněte **Aktivní zařízení** a uložte.

Aktivní připojení se na obou stranách zobrazuje zeleně.
{% endstep %}
{% endstepper %}

### Povolte trendové logování

Trendové logování musí být zapnuté, jinak se neukládá historie signálů.

1. Otevřete **Nastavení systému → Trend → Základní nastavení**.
2. Povolte **podporu trendů** a uložte.

### Ověřte časové pásmo hostitele

Chybné časové pásmo Windows způsobí posun časových značek signálů a naruší následnou analýzu. Před pokračováním ověřte nastavení.

### Vytvořit I/O zařízení

I/O zařízení propojuje Web Port s rozváděčem nebo DUC. Je vyžadováno alespoň jedno zařízení TCP/IP. Když má každý rozváděč nebo DUC vlastní IP adresu, Web Port komunikuje s každým z nich přímo.

Příklad používá Modbus TCP — vytvoření je stejné bez ohledu na ovladač.

{% stepper %}
{% step %}

## Přidejte zařízení

1. Otevřete **Nastavení systému → Komunikace → Zařízení**.
2. Klikněte na **Přidat zařízení**.
3. Vyplňte:
   * **Název:** název rozváděče nebo číslo DUC s příponou názvu budovy (např. `DUC1-ExampleBuilding`).
   * **Popis:** volitelné.
   * **Ovladač:** ovladač pro daný objekt (v tomto příkladu Modbus).
4. Uložte. Zařízení se objeví v seznamu a zůstane červené, dokud nebude nakonfigurováno.
   {% endstep %}
   {% endstepper %}

### Nakonfigurujte I/O zařízení

Tento příklad pokrývá Modbus TCP. Jiné ovladače vystavují jiné položky — viz příslušný [manuál ovladače](https://iwmac.zendesk.com/hc/sv/articles/10579102738332-Drivrutinsmanualer-Web-Port).

{% stepper %}
{% step %}

## Otevřete konfiguraci zařízení

Otevřete nové I/O zařízení.
{% endstep %}

{% step %}

## Nastavte pole Modbus

Přejděte na **Slave Address**, **Typ Modbus**, **Hostitel (TCP)**, **Port (TCP)**.
{% endstep %}

{% step %}

## Vyplňte hodnoty

Nastavte:

* **Slave Address:** `1` pro master nebo první DUC, `2` pro další a tak dále.
* **Typ Modbus:** obvykle **Modbus TCP**.
* **Hostitel (TCP):** IP adresa rozváděče nebo DUC.
* **Port (TCP):** `502` je standard pro Modbus. Pokud je na cílové IP uzavřený, eskalujte to vlastníkovi objektu nebo síťovému týmu před pokračováním.
  {% endstep %}

{% step %}

## Uložte a ověřte

Uložte. Dostupná IP s otevřeným portem zbarví ovladač zeleně se stavem **OK**.
{% endstep %}
{% endstepper %}

### Vytvořte seznam tagů

Nejjednodušší postup je prázdný seznam, ručně doplněný.

{% stepper %}
{% step %}

## Otevřete Tagy

Otevřete **Nastavení systému → Tagy**.
{% endstep %}

{% step %}

## Vytvořte seznam

Klikněte na **Nový seznam tagů**.
{% endstep %}

{% step %}

## Pojmenujte a uložte

**Název:** stejná konvence jako u I/O zařízení — název budovy plus zařízení.

Uložte.

Chcete-li později upravit, klikněte na ikonu tagu vlevo od názvu nebo klikněte na řádek a zvolte **Upravit**.
{% endstep %}
{% endstepper %}

### Vytvořte tagy

Vytváření tagů je napříč protokoly stejné — mění se pouze formát adresy.

{% stepper %}
{% step %}

## Vytvořte nový tag

Klikněte na **Nový tag**.
{% endstep %}

{% step %}

## Vyplňte pole

Vyplňte:

* **Název:** struktura `NázevBudovy_Jednotka_Senzor_Vlastnost` — např. `ExampleBuilding_HC1_AHU1_TE1_SP`. Konzistentní předpony udržují seznamy signálů přenositelné napříč budovami. Vyhněte se Å, Ä, Ö — databáze je někdy nahradí podtržítkem.
* **I/O zařízení:** zařízení, ke kterému tag patří.
* **Adresa:** mapuje tag na podkladový objekt a řídí přístup pro čtení/zápis.
* **Datový typ:** `INT` pro analogové I/O; `DIGITAL` pro digitální signály (0/1).
* **Raw min/max** a **End min/max:** škáluje surovou hodnotu.
* **Jednotka:** jednotka SI.
* **Formát:** čtyři desetinná místa jsou standard.
* **Popis:** co tag představuje.
* **Trend log:** musí být povolen. Interval 300 sekund je dostačující.
  {% endstep %}

{% step %}

## Uložit

Uložte tag a poté seznam tagů.
{% endstep %}
{% endstepper %}

### Filtrovat signály

Vylučte všechny signály, které se nepoužívají pro optimalizaci nebo reporting. Méně irelevantních signálů znamená čistší mapování později a méně šumu downstream v myCoreAI.

## Nakonfigurujte Web Port-Cloud

Tyto kroky probíhají v [myrspoven.webport.se](https://myrspoven.webport.se/) a propojí cloudový Web Port s myCoreAI.

### Vytvořte skupinu

Každá budova dostane vlastní skupinu. Členové skupiny dědí přístup k API Web Portu a k tagům budovy a jsou propojeni s myCoreAI.

{% stepper %}
{% step %}

## Vytvořte skupinu

1. Otevřete **Nastavení systému → Skupiny**.
2. Klikněte na **Nová skupina**.
3. **Název skupiny:** název budovy plus přípona protokolu — např. `ExampleBuilding_Modbusgroup`.
4. Zbytek ponechte na výchozích hodnotách a uložte.
   {% endstep %}
   {% endstepper %}

### Vytvořte uživatele

Tři uživatelé na budovu: **objevování**, **čtení**, **zápis**.

{% stepper %}
{% step %}

## Vytvořte uživatele

1. Otevřete **Nastavení systému → Uživatelé**.
2. Klikněte na **Nový uživatel**.
3. Nastavte uživatelské jméno:
   * `BuildingName_discovery`
   * `BuildingName_read`
   * `BuildingName_write`
4. Pro každého uživatele nastavte silné, jedinečné heslo a uložte ho do správce hesel. Nikdy znovu nepoužívejte hesla napříč budovami. Žádné úvodní ani závěrečné mezery.
5. Přiřaďte uživatele do skupiny budovy a uložte.
6. Opakujte pro zbývající uživatele.
   {% endstep %}
   {% endstepper %}

### Udělte oprávnění

#### Oprávnění tagů

{% stepper %}
{% step %}

## Vytvořte oprávnění tagu

1. Otevřete **Nastavení systému → Přístup → Oprávnění**.
2. Klikněte na **Nové oprávnění → Nové oprávnění tagu**.
3. Nastavte:
   * **Uživatel/Skupina:** skupina budovy.
   * **Filtr tagů:** název budovy následovaný `_*` (např. `ExampleBuilding_*`). Omezuje oprávnění na tagy této budovy.
   * **Oprávnění:** **ADMIN**.
4. Uložte.
   {% endstep %}
   {% endstepper %}

#### Oprávnění funkcí

{% stepper %}
{% step %}

## Vytvořte oprávnění funkce

1. Otevřete **Nastavení systému → Přístup → Oprávnění**.
2. Klikněte na **Nové oprávnění → Nové oprávnění funkce**.
3. Nastavte:
   * **Uživatel/Skupina:** skupina budovy.
   * **Funkce:** **přístup k API**.
   * **Oprávnění:** **ADMIN**.
4. Uložte.
   {% endstep %}
   {% endstepper %}

## Nainstalujte Myrspoven edge

Myrspoven edge čte tagy z Web Portu a předává je do myCoreAI. Běží na stejném hostiteli jako Web Port nebo na hostiteli s přístupem k síti k němu.

{% stepper %}
{% step %}

## Získejte build

Získejte nejnovější build Myrspoven edge od Myrspovenu.
{% endstep %}

{% step %}

## Vytvořte složku

Vytvořte `C:\Myrspoven` na hostiteli.
{% endstep %}

{% step %}

## Zkopírujte a rozbalte balíček

Zkopírujte edge balíček do `C:\Myrspoven\MyrspovenEDGE` a rozbalte ho. Pojmenujte rozbalenou složku `Myrspoven Edge`. ZIP smažte, jakmile ověříte rozbalení.
{% endstep %}

{% step %}

## Vytvořte složku plánovače

Otevřete Plánovač úloh Windows a vytvořte složku `Myrspoven` .
{% endstep %}

{% step %}

## Přidejte plánované úlohy

Uvnitř ní vytvořte plánované úlohy dodané Myrspovenem (názvy, akce i spouště jsou předdefinované). Úlohy pouze spouštějí edge. Co čte a zapisuje a jak často, je nastaveno centrálně pro budovu, takže ponechte spouště tak, jak jsou dodány.
{% endstep %}

{% step %}

## Nakonfigurujte přihlašovací údaje

Nakonfigurujte přihlašovací údaje, pod kterými se plánované úlohy spouštějí.
{% endstep %}

{% step %}

## Otestujte edge

Před spoléháním na spouště otestujte Myrspoven edge ručně z příkazového řádku. Potvrďte, že se signály objeví v myCoreAI v rámci intervalu čtení budovy (výchozí 12 minut pro Web Port).
{% endstep %}
{% endstepper %}

## Dokončení v BackOffice

Poslední kroky probíhají v BackOffice:

{% stepper %}
{% step %}

## Vyberte budovu

Vyberte budovu.
{% endstep %}

{% step %}

## Otevřete nástroj Web Port Script

Otevřete **Web Port Script** nástroj pro budovu.
{% endstep %}

{% step %}

## Vygenerujte skripty

Postupujte podle pokynů v aplikaci a vygenerujte signálový skript a fallback skript.
{% endstep %}

{% step %}

## Upravte podle potřeby

Pokud je potřeba, upravte skript v textovém editoru.
{% endstep %}

{% step %}

## Vložte do Web Portu

Vložte skript do lokálního Web Portu.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Pokyny v aplikaci BackOffice jsou závazné. Při jakémkoli konfliktu s touto stránkou během generování skriptu má přednost BackOffice.
{% endhint %}

## Řešení problémů

* **Web Port se jako služba nespustí.** Zkontrolujte Prohlížeč událostí Windows. Nejčastější příčiny: chybějící nebo expirovaný licenční soubor, nebo jiný proces, který drží nakonfigurovaný port.
* **Signály byly načteny, ale časové značky vypadají špatně.** Znovu zkontrolujte časové pásmo hostitele a ověřte, že je zapnuto Basic Settings trendů.
* **Myrspoven edge běží ručně, ale ne z Plánovače úloh.** Ověřte, že přihlašovací údaje plánované úlohy mají přístup pro čtení do datového adresáře Web Portu a odchozí síťový přístup.
* **Ovladač je červený, ne OK.** Potvrďte, že cílová IP je z hostitele dosažitelná a že nakonfigurovaný TCP port (502 pro Modbus) je otevřený end-to-end.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.