====== Nahrání historických dat do grafu ======

===== Účel dialogu =====
Dialog „Nahrání historických dat do grafu“ umožňuje uživatelům importovat historická data (ve formátu CSV nebo XLSX) pro konkrétní datapoint. Tato data lze dočasně vložit do grafu jako trend nebo je trvale uložit do databáze.

Pro přístup k této funkci přejděte do zobrazení grafu a klikněte na tlačítko **Nahrát data** (ikona se šipkou směřující nahoru) umístěné v horním panelu nástrojů.

{{upload_button.png?600|Kliknutím zvětšíte tlačítko Nahrát data}}

===== Režimy zadání dat =====
Přepínač v horní části dialogu umožňuje přepínat mezi dvěma metodami zadání dat:
  * **Soubor:** Přetáhněte soubor CSV/XLSX do oblasti pro přetažení nebo jej vyberte pomocí výběru souboru. Po načtení dialog zobrazí název souboru, velikost, počet řádků a kódování.
  * **Vložit text:** Vložte data CSV přímo do připraveného textového pole.

{{upload_modal.png?600|Kliknutím zvětšíte dialogové okno Nahrání historických dat}}

===== Automatická detekce formátu =====
Po zadání dat dialog automaticky rozpozná následující parametry bez nutnosti ruční konfigurace:
  * Oddělovač sloupců
  * Desetinný oddělovač
  * Formát data
  * Formát času
  * Kódování
  * Počet řádků záhlaví k přeskočení

===== Ruční úprava formátu =====
Uživatelé mohou rozbalit sbalitelný panel a přepsat automaticky detekované nastavení. Po provedení ruční změny se zobrazí odkaz **Znovu detekovat**, který umožní návrat k automatickému nastavení. Nastavitelné parametry zahrnují:
  * Oddělovač sloupců a desetinný oddělovač
  * Formát data a času
  * Režim času (spojený s datem, samostatný sloupec nebo pouze datum)
  * Kódování
  * Přeskočení řádků záhlaví

===== Náhled a statistiky =====
Dialog průběžně aktualizuje informace o zpracování dat:
  * **Platné / Chyby:** Zobrazuje počet úspěšně zpracovaných a neplatných řádků.
  * **Rozsah:** Zobrazuje časový rozsah dat (od–do).
  * **Detekovaný interval:** Udává rozestup mezi vzorky v sekundách.
  * **Tabulka náhledu:** Zobrazuje zpracované řádky obsahující datum, hodnotu a stav, přičemž chyby jsou viditelně zvýrazněny.

> **Poznámka:** Formát data použitý v náhledu a statistikách je `dd.MM.yyyy ddd HH:mm:ss` (např. `25.05.2026 Mon 10:00:00`).

===== Tlačítka v zápatí =====
  * **Zrušit:** Zavře dialog bez uložení. Pokud je v grafu aktuálně zobrazen trend (režim obnovení), vyžádá si potvrzení před jeho odstraněním.
  * **Vymazat:** Vymaže náhled při zachování nastavení formátu (zobrazuje se pouze po načtení dat). V režimu obnovení vyžádá potvrzení odstranění trendu z grafu bez zavření dialogu.
  * **Zobrazit v grafu:** Vloží zpracovaná data do grafu jako dočasný trend. Data se neukládají do databáze a musí být platná.
  * **Uložit do databáze:** Trvale zapíše data do historie datapointu. Před provedením zobrazí souhrnné potvrzovací okno (počet bodů, časový rozsah, interval a změny intervalu datapointu) a následně provede dávkové nahrání s indikátorem průběhu. Pokud dojde k chybě, dialog zůstane otevřený a zobrazí chybovou zprávu.

===== Režim obnovení =====
Pokud uživatel dříve zobrazil data v grafu a znovu otevře dialog, budou původní obsah i nastavení předvyplněny. Uživatelé pak mohou data upravit, uložit do databáze nebo operaci zrušit (čímž se trend odstraní).

===== Příklady vstupních formátů =====

==== CSV (textový formát) ====
Formát CSV standardně používá dva sloupce (časová známka a hodnota) oddělené středníkem `;`. Desetinným oddělovačem je čárka `,` (české národní prostředí). Záhlaví je volitelné.

> **Důležité:** Řádky, které nelze zpracovat (např. chybějící datum nebo nečíselná hodnota), jsou v náhledu označeny jako neplatné, započítávají se do statistiky **Chyby** a při ukládání jsou přeskočeny.

**1. Datum a čas v jednom sloupci (výchozí CZ formát):**
<code>
25.05.2026 10:00;42,5
25.05.2026 10:01;42,7
25.05.2026 10:02;42,3
</code>

**2. Včetně sekund (lze kombinovat s formátem bez sekund):**
<code>
25.05.2026 10:00:15;42,5
25.05.2026 10:01;42,7
25.05.2026 10:02:30;42,3
</code>

**3. Datum a čas ve dvou samostatných sloupcích (režim „samostatný sloupec“):**
<code>
25.05.2026;10:00;42,5
25.05.2026;10:01;42,7
</code>

**4. Pouze datum bez času (režim „pouze datum“):**
//(Každému řádku je přiřazen stejný čas nastavený v panelu)//
<code>
25.05.2026;42,5
26.05.2026;43,1
</code>

**5. Se záhlavím (automaticky rozpoznáno a přeskočeno):**
<code>
Time;Value
25.05.2026 10:00;42,5
25.05.2026 10:01;42,7
</code>

**6. US formát (rozpozná datum MM/DD/YYYY a desetinnou tečku):**
<code>
05/25/2026 10:00:00;42.5
05/25/2026 10:01:00;42.7
</code>

==== XLSX (formát Excel) ====
Data jsou standardně načítána od prvního řádku prvního listu. Úvodní titulky nebo řádky záhlaví jsou automaticky přeskočeny, jakmile dialog identifikuje první řádek obsahující datum ve sloupci A.

> **Poznámka:** XLSX podporuje výběr listu, pokud sešit obsahuje více listů. Počet řádků k přeskočení lze také ručně nastavit v panelu formátu.

**1. Základní formát (datum ve sloupci A, hodnota ve sloupci B):**
//(Buňky ve sloupci A mohou být zadány jako datum/čas ve formátu Excelu nebo jako text ve formátu `dd.MM.yyyy HH:mm`)//

^ A (Datum/čas) ^ B (Hodnota) ^
| 25.05.2026 10:00:00 | 20,0 |
| 25.05.2026 10:01:00 | 20,5 |
| 25.05.2026 10:02:00 | 21,0 |

**2. Datum a čas v samostatných sloupcích:**

^ A (Datum) ^ B (Čas) ^ C (Hodnota) ^
| 25.05.2026 | 10:00:00 | 42,5 |
| 25.05.2026 | 10:01:00 | 43,5 |

**3. S titulkem/záhlavím (automaticky přeskočeno):**

^ Sloupec A ^ Sloupec B ^
| Mervis SCADA — Export teplot | |
| Projekt: TestProject | |
| //(prázdný řádek)// | |
| Čas | Hodnota |
| 25.05.2026 10:00:00 | 20,0 |
| 25.05.2026 10:01:00 | 20,5 |