====== 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, mazat a spravovat oprávnění jednotlivých uživatelů a skupin. K dispozici je také správa projektových souborů včetně nahrávání, úprav a historie mazání. 

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

^ Sloupec ^ Popis ^
| **Name** | Název projektu |
| **Guid** | Unikátní identifikátor projektu |
| **Status** | Stav projektu |
| **Required action** | Akce, kterou je potřeba provést, aby projekt dosáhl požadovaného stavu |
| **Datapoints** | Počet datapointů projektu |
| **Actions** | Tlačítka pro úpravu {{:cs:mervis-scada:30-portal:portal_edit_proj_icon.png?20|}} nebo odstraně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 na pravé straně obrazovky zobrazí panel s detailními informacemi:

**Vlastnosti:**
  * **Name** – název projektu
  * **Guid** – unikátní identifikátor projektu
  * **Last Change** – datum a čas poslední úpravy projektu
  * **Status** – aktuální stav projektu
  * **Target Project State** – požadovaný stav projektu
  * **Timezone** – časové pásmo projektu
  * **Latitude** / **Longitude** – souřadnice fyzické lokace projektu
  * **Control Status** – aktuální stav řízení projektu
  * **Required Action** – akce potřebná k uvedení projektu do požadovaného stavu
  * **Datapoints** – počet datapointů projektu

Zvláštní pozornost je třeba věnovat položkám **Control Status** a **Required Action**, protože informují uživatele o probíhajících nebo požadovaných změnách stavu projektu.

Vlastnost **Control Status** může nabývat následujících hodnot:
  * **None** – stav není relevantní informace (projekt není nahrán do SCADA)
  * **Waiting** – probíhá kontrola stavu projektu
  * **Stopping** – projekt se zastavuje
  * **Unloading** – projekt se odpojuje
  * **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 (bude proveden další automatický pokus)
  * **DoneFailed** – automatické řízení projektu selhalo (proces nepokračuje)
  * **Suspended** – automatické řízení projektu bylo pozastaveno (čeká na manuální zásah)

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

Pokud je **Control Status** nastaven na **Suspended**, doporučuje se uživateli s oprávněním **SCADA.Aggregated_Manage** obnovit stav projektu. To lze provést kliknutím na **Apply Changes** v [[en:mervis-scada:30-portal:04-projects#project_files_management|Správa projektových souborů]]. Projekt obvykle přechází do stavu **Suspended** při změně projektových souborů nebo při úpravách projektu pomocí administrativních nástrojů.

Pokud je **Control Status** nastaven na **DoneFailed**, znamená to, že systém nedokázal proces dokončit kvůli chybě. Uživatel s oprávněním **SCADA.Aggregated_Manage** by měl zkontrolovat položku **Required Action** a problém ručně vyřešit. Nejčastěji se jedná o chyby datových souborů (**UploadData**, **FixDataFormat**, **FixDataConflicts**), kdy je nutné nahrát správné soubory a znovu stisknout **Apply Changes**.

Vlastnost **Required Action** může nabývat následujících hodnot:
  * **None** – není vyžadována žá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 z instance SCADA
  * **FixInstance** – přesunout projekt z aktuální instance na cílovou instanci SCADA
  * **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é následující akce:
  * **Create Project** – vytvořit nový projekt
  * **Start Project** / **Stop Project** – spustit nebo zastavit vybraný projekt.
  * **Project Files Management** – otevře modální okno, ve kterém může uživatel nahrávat, upravovat, stahovat a mazat projektové soubory. K dispozici je také historie projektových souborů.
  * **Change Scada permissions** – správa SCADA oprávnění pro vybraný projekt

==== 3.1 Vytvoření projektu ====
Každý projekt se skládá z vlastností a datových souborů. Pomocí 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 následující položky:

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

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

**Project name** je jediné povinné pole formuláře, ale lze jej kdykoliv změnit. Pole **Guid** není nutné vyplňovat ručně; pokud zůstane prázdné, bude vygenerováno automaticky. Guid projektu však musí odpovídat Guid nahraných souborů .data. 

V současné době nelze datové soubory vytvářet přímo v Portálu – musí být vygenerovány externí aplikací. Prostřednictvím Portálu je lze následně nahrát a projekt spustit nebo stáhnout existující soubory. Více informací naleznete v části [[en:mervis-scada:30-portal:04-projects#project_files_management|Správa projektových souborů]].

Jakmile je záznam projektu vytvořen, bude viditelný v systému Mervis pro uživatele 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 projektových souborů nebude viditelný žádný obsah. Změna vlastností projektu, jako je název projektu, časové pásmo nebo umístění, neovlivní jeho běh; pokud projekt běží, bude pokračovat a nové vlastnosti se aplikují 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ší instanci SCADA.

==== 3.2 Spuštění / zastavení projektu ====
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 Správa projektových souborů ====
Do této sekce lze vstoupit kliknutím na tlačítko **Project Files Management**. V horní části modálního okna se nacházejí dvě záložky – **Overview** a **Project History**. Ve výchozím stavu je aktivní záložka **Overview** a okno je rozděleno do následujících částí:
  * **Seznam projektových souborů** – tabulka se soubory a složkami projektu (grafy, schémata, datové soubory)  
  * **Panel informací o projektu** (vpravo) – zobrazuje název, Guid, stav, cílový stav apod.  
  * **Historie souboru** – přehled nahrání a změn vybraného souboru  
  * **Ovládací tlačítka** (viz tabulka)  
\\
^ Název ^ Funkce ^
| **Add project files** | Umožňuje přidání nových projektových souborů. |
| **Add project folders** | Umožňuje přidání nových složek projektu. |
| **Clear unsaved changes** | Vymaže soubory připravené k nahrání. Neodstraní projektové soubory již uložené v Mervis! |
| **Download project files** | Stáhne aktuální projektové soubory. Doporučeno před každou aktualizací jako záloha. |
| **Upload project files** | Nahraje projektové soubory na server. |
| **Delete all project files** | Odstraní všechny projektové soubory ze serveru! |
| **Apply changes** | Provede všechny potřebné operace pro nasazení projektu do Mervis. |
^ ^ ^

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

=== 3.3.1 Přehled projektových souborů ===
V horní části tabulky se nachází filtr pro fulltextové vyhledávání souborů. Pod ním je zobrazen seznam všech projektových souborů se základními informacemi:

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

=== 3.3.2 Nahrávání projektových souborů ===
Postup: \\
1. Připravte soubory, které chcete nahrát. \\
2. Vyberte soubory pomocí **Add project files** / **Add project folders**, nebo je přetáhněte přímo do okna metodou drag & drop. \\
3. Nově přidané soubory jsou zvýrazněny. Nepodporované formáty jsou označeny červeně a nebudou nahrány do Mervis. \\
4. U schémat lze vyplnit **Name** a nastavit **Order** pro zobrazení. \\
5. Klikněte na **Upload project files** pro nahrání souborů do Mervis. \\
6. Klikněte na **Apply changes** pro provedení všech potřebných operací a nasazení projektu. \\

**Poznámka:** 
  * Po nahrání datových souborů (*.data, *.data_p*) a použití **Apply changes** se projekt zastaví a následně znovu spustí s novými soubory.  
  * Nahrání ostatních souborů a použití **Apply changes** se projeví bez zastavení projektu.  
  * Odstranění projektu způsobí jeho ukončení a odstranění ze systému. 

=== 3.3.3 Historie projektových souborů ===
Záložka **Project History** poskytuje přehled všech změn provedených v projektových souborech a slouží jako elektronická auditní stopa. Uživatel může zobrazit kompletní historii nahraných souborů, identitu uživatele, který změnu provedl (Author), přesné datum a čas úpravy a případné komentáře přidané ke změnám. To splňuje přísné požadavky na compliance a QA díky zachování spolehlivého a přístupného záznamu změn konfigurace systému.

^ Sloupec ^ Popis ^
| **Operation Type** | Typ operace provedené nad souborem |
| **Upload Time** | Datum a čas úpravy souboru |
| **Filename** | Název souboru |
| **Author** | Uživatel, který provedl změnu |
| **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** – odstraně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 Změna SCADA oprávnění ====
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 ke skupinám uživatelů lze vytvořit běžné provozní role (např. Viewer, Operator, QA, Admin).

Typy oprávnění: 
  * **View** – umožňuje zobrazení projektu.
  * **Control** – kromě zobrazení umožňuje ovládací akce. Tlačítka se stanou aktivními. K dispozici je plánování.
  * **Manage** – umožňuje nahrávání a restartování projektů. 

Oprávnění je nutné kombinovat. Pro ovládání jsou vyžadována oprávnění **View** i **Control**.  
Více informací naleznete v [[cs:mervis-scada:30-portal:100-permissions|Permissions]].

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