====== Projekty ======

Tato sekce poskytuje přehled projektů v dané doméně a umožňuje jejich správu. V hlavním přehledu lze projekty vyhledávat, vytvářet, upravovat a mazat a také spravovat oprávnění jednotlivých uživatelů a skupin. K dispozici je i správa souborů projektu včetně historie nahrávání, úprav a mazání.

===== 1. Přehled projektů =====

V horní části tabulky je pole **Filter** pro fulltextové vyhledávání projektů. Pod ním je seznam všech projektů v doméně se základními informacemi:

^ Sloupec ^ Popis ^
| **Name** | Název projektu |
| **Guid** | Jedinečný identifikátor projektu |
| **Status** | Stav projektu |
| **Required action** | Akce, kterou je nutné provést, aby projekt dosáhl požadovaného stavu |
| **Datapoints** | Počet datových bodů projektu |
| **Actions** | Tlačítka pro úpravu {{:cs:mervis-scada:30-portal:portal_edit_proj_icon.png?20|}} (viz [[#edit_project|Edit Project]]) nebo smazání {{:cs:mervis-scada:30-portal:portal_delete_proj_icon.png?20|}} projektu |

{{:cs:mervis-scada:30-portal:portal_projects_main_view.png?direct|}}

===== 2. Detail projektu =====

Po výběru konkrétního projektu se v pravé části obrazovky zobrazí panel s podrobnými informacemi:

**Vlastnosti:**
  * **Name** – název projektu
  * **Guid** – jedinečný identifikátor projektu
  * **Last Change** – datum a čas poslední změny projektu
  * **Status** – aktuální stav projektu
  * **Target Project State** – požadovaný stav projektu
  * **Timezone** – časové pásmo projektu
  * **Latitude** / **Longitude** – souřadnice fyzického umístění projektu
  * **Control Status** – aktuální stav řízení projektu
  * **Required Action** – akce potřebná k uvedení projektu do požadovaného stavu
  * **Datapoints** – počet datových bodů projektu

Zvláštní pozornost věnujte vlastnostem **Control Status** a **Required Action**, protože informují o probíhajících nebo nutných změnách stavu projektu.

Vlastnost **Control Status** může nabývat těchto hodnot:
  * **None** – stav není relevantní (projekt není nahraný do SCADA)
  * **Waiting** – probíhá kontrola stavu projektu
  * **Stopping** – projekt se zastavuje
  * **Unloading** – projekt se uvolňuje
  * **Loading** – projekt se načítá
  * **ReloadingProperties** – znovu se načítají vlastnosti projektu
  * **ReloadingData** – znovu se načítají datové soubory
  * **Starting** – projekt se spouští
  * **Failed** – řízení projektu dočasně selhalo (proběhne další automatický pokus)
  * **DoneFailed** – automatické řízení projektu selhalo (proces nepokračuje)
  * **Suspended** – automatické řízení projektu bylo pozastaveno (čeká na ruční zásah)

Většina těchto stavů nevyžaduje žádnou akci uživatele – jde jen o mezikroky, během kterých automatické řízení pokračuje. Výjimkou jsou stavy **Suspended** a **DoneFailed**.

Pokud má **Control Status** hodnotu **Suspended**, doporučujeme, aby uživatel s oprávněním **SCADA.Aggregated_Manage** obnovil stav projektu. To lze provést kliknutím na **Apply Changes** v [[#project_files_management|Project Files Management]]. Do stavu **Suspended** se projekt obvykle dostane při změně souborů projektu nebo při úpravě projektu administrátorskými nástroji.

Pokud má **Control Status** hodnotu **DoneFailed**, systém nemohl proces dokončit kvůli chybě. Uživatel s oprávněním **SCADA.Aggregated_Manage** by měl zkontrolovat **Required Action** a problém ručně vyřešit. Obvykle jde o chyby datových souborů (**UploadData**, **FixDataFormat**, **FixDataConflicts**), kdy je nutné nahrát správné soubory a znovu kliknout na **Apply Changes**.

Vlastnost **Required Action** může nabývat těchto hodnot:
  * **None** – není potřeba žádná akce, projekt je v požadovaném stavu
  * **Load** – načíst projekt do SCADA
  * **ReloadProperties** – znovu načíst vlastnosti projektu
  * **ReloadData** – znovu načíst datové soubory
  * **Start** – spustit projekt
  * **Stop** – zastavit projekt
  * **Unload** – odebrat projekt ze SCADA instance
  * **FixInstance** – přepnout projekt z aktuální instance na cílovou SCADA instanci
  * **UploadData** – nahrát chybějící datový soubor
  * **FixDataFormat** – opravit neplatný formát datového souboru
  * **FixDataConflicts** – vyřešit konflikty mezi více datovými soubory

===== 3. Panel akcí =====

Pro každý projekt jsou v pravém panelu dostupné tyto akce:
  * **Create Project** – vytvoření nového projektu
  * **Start Project** / **Stop Project** – spuštění, resp. zastavení vybraného projektu
  * **Project Files Management** – otevře modální okno, ve kterém lze nahrávat, upravovat, stahovat a mazat soubory projektu. Zpřístupňuje také historii souborů projektu.
  * **Change Scada permissions** – správa SCADA oprávnění pro vybraný projekt

==== 3.1 Create Project ====

Každý projekt se skládá z vlastností a datových souborů. V Portálu lze vytvořit nový projekt, tedy pouze jeho záznam s vlastnostmi. Formulář pro vytvoření nového projektu se otevře po kliknutí na **Create Project** v panelu akcí.
V dialogu lze nastavit tyto položky:

^ Pole ^ Popis ^
| **Name** | Název projektu (povinné pole) |
| **Guid** | Jedinečný identifikátor projektu |
| **Target Project State** | Požadovaný stav projektu |
| **Timezone** | Časové pásmo projektu |
| **Latitude** / **Longitude** | Souřadnice fyzického umístění projektu pro zobrazení na mapě v Mervisu {{:cs:mervis-scada:30-portal:mervis-scada-map_img.png?20|}} |

{{:cs:mervis-scada:30-portal:portal_projects_create_view.png?direct|}}

**Název projektu** je jediné povinné pole formuláře a lze ho kdykoli změnit. **Guid** není nutné zadávat ručně; pokud zůstane prázdný, vygeneruje se. Guid projektu se ale musí shodovat s Guid nahrávaných souborů .data.

Lokalizaci lze zapnout po vytvoření projektu v dialogu **Edit project** (viz [[#edit_project|Edit Project]]).

V současnosti nelze datové soubory vytvořit přímo v Portálu – musí je vygenerovat externí aplikace. Přes Portál je pak lze nahrát, projekt spustit nebo stáhnout existující soubory. Podrobnosti viz [[#project_files_management|Project Files Management]].

Po vytvoření záznamu bude projekt v systému Mervis viditelný uživatelům s odpovídajícími oprávněními. Po změně oprávnění může chvíli trvat, než se změny projeví (obvykle okamžitě nebo do půl minuty). V počáteční fázi bez souborů projektu se nezobrazí žádný obsah. Změna vlastností projektu, jako je název, časové pásmo nebo umístění, neovlivní jeho běh; běžící projekt poběží dál a nové vlastnosti se uplatní za běhu. Změna domény může způsobit zastavení a opětovné spuštění projektu, protože může být přesunut na vhodnější SCADA instanci.

==== 3.2 Start Project / Stop Project ====

Tlačítko **Start Project** nastaví požadovaný stav projektu na **LocalRun**. Naopak tlačítko **Stop Project** změní požadovaný stav na **Stopped**, což vede k zastavení projektu.

==== 3.3 Project Files Management ====

Do této sekce se dostanete kliknutím na tlačítko **Project Files Management**. V horní části modálního okna jsou dvě záložky – **Overview** a **Project History**. Ve výchozím stavu je aktivní záložka **Overview** a okno je rozdělené na tyto části:
  * **Seznam souborů projektu** – tabulka se soubory a složkami projektu (grafy, schémata, datové soubory)
  * **Informační panel projektu** (vpravo) – zobrazuje název, Guid, stav, cílový stav atd.
  * **Historie souboru** – přehled nahrání a změn vybraného souboru
  * **Ovládací tlačítka** (viz tabulka)

^ Tlačítko ^ Funkce ^
| **Add project files** | Umožňuje přidat nové soubory projektu. |
| **Add project folders** | Umožňuje přidat nové složky projektu. |
| **Clear unsaved changes** | Vymaže soubory připravené k nahrání. Nesmaže soubory projektu, které už jsou v Mervisu! |
| **Download project files** | Stáhne aktuální soubory projektu. Doporučujeme jako zálohu před každou aktualizací. |
| **Upload project files** | Nahraje soubory projektu na server. |
| **Delete all project files** | Smaže všechny soubory projektu ze serveru! |
| **Apply changes** | Provede všechny operace potřebné k nasazení projektu do Mervisu. |

{{:cs:mervis-scada:30-portal:portal_projects_pfm_view.png?direct|}}

=== 3.3.1 Přehled souborů projektu ===

V horní části tabulky je filtr pro fulltextové vyhledávání souborů. Pod ním je seznam všech souborů projektu se základními údaji:

^ Sloupec ^ Popis ^
| **Filename** | Název souboru |
| **Type** | Typ souboru (Chart, Schema, Datapoints, …) |
| **Name** | Uživatelský název (lze upravit) |
| **Order** | Pořadí zobrazení (lze upravit) |
| **Last Change** | Datum a čas poslední změny |
| **Size** | Velikost souboru |
| **Author** | Uživatel, který změnu provedl |
| **Actions** | Tlačítka pro stažení {{:cs:mervis-scada:30-portal:portal_download_icon.png?20}} nebo smazání {{:cs:mervis-scada:30-portal:portal_delete_proj_icon.png?20}} |

=== 3.3.2 Nahrávání souborů projektu ===

Postup:
  - Připravte soubory, které chcete nahrát.
  - Vyberte soubory pomocí **Add project files** / **Add project folders**, nebo je přetáhněte (drag & drop) přímo do okna.
  - Nově přidané soubory jsou zvýrazněné. Nepodporované formáty jsou označené červeně a do Mervisu se nenahrají.
  - U schémat můžete vyplnit **Name** a nastavit **Order** pro zobrazení.
  - Kliknutím na **Upload project files** nahrajete soubory do Mervisu.
  - Kliknutím na **Apply changes** provedete všechny potřebné operace a nasadíte projekt.

**Poznámka:**
  * Po nahrání datových souborů (''*.data'', ''*.data_p*'') a použití změn se projekt zastaví a znovu spustí s novými soubory.
  * Nahrání ostatních souborů a použití změn se projeví bez zastavení projektu.
  * Smazání projektu vede k jeho ukončení a odebrání ze systému.

> **Poznámka:** Stejným způsobem se nahrávají i slovníky pro překlad projektu (''.dict''). Viz [[cs:mervis-scada:30-portal:10-project-translation|Překlad projektu]].

=== 3.3.3 Historie souborů projektu ===

Záložka **Project History** poskytuje přehled všech změn souborů projektu a slouží jako elektronický auditní záznam. Uživatel vidí kompletní historii nahraných souborů, kdo změnu provedl (Author), přesné datum a čas změny a případné komentáře k úpravám. Díky spolehlivému a dohledatelnému záznamu změn konfigurace systému tak splňuje přísné požadavky na compliance a QA.

^ Sloupec ^ Popis ^
| **Operation Type** | Typ operace provedené se souborem |
| **Upload Time** | Datum a čas změny souboru |
| **Filename** | Název souboru |
| **Author** | Uživatel, který změnu provedl |
| **Comment** | Komentář ke změně |
| **Actions** | Tlačítko pro stažení {{:cs:mervis-scada:30-portal:portal_download_icon.png?20}} |

**Operace se soubory:**
  * {{:cs:mervis-scada:30-portal:portal_add_file_icon.png}} **CreateOrUpdate** – vytvoření nebo aktualizace souboru
  * {{:cs:mervis-scada:30-portal:portal_delete_file_icon.png}} **Delete** – smazání souboru
  * {{:cs:mervis-scada:30-portal:portal_cleanup_file_icon.png}} **CleanUp** – vyčištění historie souboru
  * {{:cs:mervis-scada:30-portal:portal_rename_file_icon.png}} **Rename** – přejmenování souboru

{{:cs:mervis-scada:30-portal:portal_projects_pfm_view_history.png?direct|}}

==== 3.4 Change Scada Permissions ====

Toto tlačítko otevře modální okno pro nastavení SCADA oprávnění vybraného projektu. Kombinací níže uvedených oprávnění a jejich přiřazením skupinám uživatelů můžete vytvořit běžné provozní role (např. Viewer, Operator, QA, Admin).

Typy oprávnění:
  * **View** – umožňuje zobrazit projekt.
  * **Control** – kromě zobrazení umožňuje i ovládání. Tlačítka jsou aktivní. Lze nastavovat časové plány.
  * **Manage** – umožňuje nahrávat a restartovat projekty.

Oprávnění se musí kombinovat. Pro ovládání jsou potřeba oprávnění **View** i **Control**.
Podrobnosti viz [[cs:mervis-scada:30-portal:100-permissions|Oprávnění]].

{{:cs:mervis-scada:30-portal:portal_projects_permissions.png?direct|}}

===== 4. Edit Project =====

Projekt upravíte kliknutím na ikonu úprav {{:cs:mervis-scada:30-portal:portal_edit_proj_icon.png?20|}} ve sloupci **Actions** v seznamu projektů. Dialog **Edit project** obsahuje tyto položky:

^ Pole ^ Popis ^
| **Name** | Název projektu |
| **Timezone** | Časové pásmo projektu |
| **Localization enabled** | Povolí překlad textů projektu pomocí slovníkových souborů. Viz [[cs:mervis-scada:30-portal:10-project-translation|Překlad projektu]]. |
| **Latitude** / **Longitude** | Souřadnice fyzického umístění projektu pro zobrazení na mapě v Mervisu |

Změny uložíte tlačítkem **Confirm**.

> **Poznámka:** Změna názvu, časového pásma nebo umístění projektu neovlivní běžící projekt. Nové vlastnosti se uplatní za běhu.