====== S0900 – Import dat ======

[[orfertopen:s0900:start|← Zpět na přehled S0900]]

Funkce Import umožňuje načíst data ze souboru do vybrané databázové tabulky.

> ⚠️ **Upozornění:**
Import zapisuje data přímo do databáze. Nesprávně naformátovaný soubor nebo chybná mapování polí mohou způsobit nekonzistenci dat.
Před importem do produkční tabulky vždy otestujte na testovacích datech.


===== Spuštění importu =====

**Spuštění:** Menu → Import…

===== Dialog Import =====

^ Prvek                  ^ Popis                                                                 ^
| **Soubor**             | Cesta ke vstupnímu souboru (tlačítko **Procházet…** pro výběr)       |
| **Formát**             | CSV (oddělený znakem) nebo Pevná délka                               |
| **Oddělovač**          | Znak oddělující pole v CSV (čárka, středník, tabulátor, vlastní)     |
| **Záhlaví**            | Zaškrtněte, pokud první řádek souboru obsahuje názvy sloupců         |
| **Kódování**           | Znaková sada vstupního souboru (UTF-8, Windows-1250, ISO-8859-2...)  |
| **Mapování polí**      | Přiřazení sloupců souboru k polím tabulky                            |
| **Při duplicitě PK**   | Přeskočit / Přepsat (aktualizovat existující záznam)                 |

===== Postup importu =====

  - Zvolte vstupní soubor tlačítkem **Procházet…**.
  - Nastavte formát a kódování souboru.
  - Program automaticky analyzuje první řádky souboru a nabídne návrh mapování sloupců.
  - Zkontrolujte nebo upravte mapování: každý sloupec souboru přiřaďte k odpovídajícímu poli tabulky. Nepotřebné sloupce nechejte nemapovány.
  - Zvolte chování při duplicitě primárního klíče.
  - Klikněte **OK** – soubor se přenese na server a zahájí se import.
  - Po dokončení se zobrazí souhrn: počet importovaných, přeskočených a chybných řádků.

===== Mapování polí =====

Dialog mapování zobrazuje tabulku:

^ Sloupec souboru        ^ Pole tabulky                                                         ^
| Sloupec 1 (nebo název) | Výběr ze seznamu polí tabulky (nebo „– nemapovat –")                 |
| Sloupec 2 (nebo název) | ...                                                                  |
| ...                    | ...                                                                  |

Pokud soubor obsahuje záhlaví se jmény sloupců a tato jména odpovídají fyzickým názvům DB polí, mapování se vyplní automaticky.

===== Chování při chybách =====

Import probíhá řádek po řádku v samostatných transakcích. Chyba na jednom řádku nezastaví celý import:

  * **Chyba konverze typu** – řádek je přeskočen, chyba zalogována.
  * **Porušení unikátního klíče** – záleží na nastavení „Při duplicitě PK":
    * **Přeskočit** – řádek se vynechá.
    * **Přepsat** – existující záznam se aktualizuje hodnotami ze souboru.
  * **Jiná DB chyba** – řádek je přeskočen, chyba zalogována.

Detailní log chyb je dostupný v systémovém logu OR-SYSTEMu.

===== Podporované formáty vstupních souborů =====

^ Formát         ^ Přípona       ^ Poznámka                                           ^
| CSV            | .csv, .txt    | Libovolný oddělovač, volitelné záhlaví             |
| Pevná délka    | .txt, .dat    | Délky polí dle datového slovníku tabulky           |

> 💡 **Tip:**
Soubor pro import lze snadno připravit exportem z jiné tabulky nebo instance OR-SYSTEMu pomocí funkce [[orfertopen:s0900:export|Export]].
Formáty jsou kompatibilní – CSV exportovaný z S0900 lze přímo importovat do S0900.