Import a export aplikací

1. Základní informace

• Import a export aplikací v NET Geniu slouží k přenášení aplikací mezi různými instalacemi systému, k nasazování nových verzí aplikací a k vytváření záložních kopií.
• Funkce importu nové aplikace, aktualizace stávající aplikace i exportu aplikace jsou určeny pouze pro uživatele s nejvyšším oprávněním – uživatele Administrator s databázovým ID 1. Toto oprávnění je vyžadováno zejména kvůli možnosti zásahu do struktury, práv a vazeb aplikace.
• Import nové aplikace je dostupný prostřednictvím ikony „Importovat aplikaci“ v navigační oblasti, nebo na hlavní stránce v administrátorském režimu.
• Aktualizace již existující aplikace probíhá v dialogu „Upravit aplikaci“ na záložce „Administrace“, která obsahuje samostatnou sekci „Importovat aplikaci“ určenou výhradně pro aktualizační import.
• Export aplikace je dostupný v navigační oblasti prostřednictvím ikony „Exportovat aplikaci“, a umožňuje vytvoření souboru s příponou „.nga“. Ta obsahuje kompletní definici aplikace, a případně také data nebo souborové přílohy, obojí podle zvolených možností v dialogu „Export aplikace“.
• Import nové aplikace a aktualizace aplikace představují dva odlišné procesy:
  • import nové aplikace zakládá zcela novou instanci aplikace,
  • aktualizace aplikace nahrazuje existující aplikaci a mění její strukturu a konfiguraci podle importovaného souboru.

2. Import nové aplikace

• Možnosti uvedené v této kapitole se vztahují výhradně k importu zcela nové aplikace.
• Import nové aplikace vytváří v NET Geniu samostatnou instanci aplikace a neprovádí žádnou aktualizaci aplikace stávající. Postup pro aktualizaci již existující aplikace je popsán samostatně v kapitole "" HYPERLINK \l "_Aktualizace_stávající_aplikace" Aktualizace stávající aplikace "".
• Import nové aplikace je dostupný výhradně uživatelům s nejvyšším oprávněním, tedy uživateli Administrator s databázovým ID 1.
• Import nové aplikace je dostupný prostřednictvím ikony „Importovat aplikaci“ v navigační oblasti, nebo na hlavní stránce v administrátorském režimu.
• Dialog „Import aplikace“ umožňuje import ze souboru „.nga“, „.xlsx“ nebo „.xls“, případně ze šablony, jejichž seznam je uvedený na záložce „Šablony“.

2.1. Záložka „Ze souboru“

2.1.1. Možnosti

• Jsem vlastníkem importovaných dat
  • Zaškrtnutí tohoto pole určuje, zda má importem dojít k přepsání vlastníka všech databázových záznamů ve všech importovaných databázových tabulkách.
  • Detailní popis vlastnictví a spoluvlastnictví záznamů je uveden v samostatné příručce „Editační formulář“.
• Importovat historii záznamů
  • Zaškrtnutí tohoto pole určuje, zda má být importována historie záznamů všech importovaných databázových tabulek.
  • Podmínkou této funkce je, aby soubor s vyexportovanou aplikací historické záznamy obsahoval.
• Importovat práva
  • Zaškrtnuto – Při importu práv budou použita ID uživatelů a uživatelských skupin přesně podle nastavení práv ve zdrojové (exportované) aplikaci a ve všech jejích podřízených objektech. Tato forma importu může způsobit datovou nekonzistenci mezi právy ve zdrojové a cílové aplikaci. Stejná ID mohou ve dvou různých NET Geniích značit rozdílné uživatele nebo uživatelské skupiny. Zároveň nemusí některá ID v cílovém NET Geniu existovat. V nastavení práv importované aplikace se pak budou zobrazovat místo názvu uživatelů nebo uživatelských skupin pouze čísla ID.
  • Nezaškrtnuto – Importovaná aplikace a všechny její podřízené objekty budou mít nastavená práva na uživatelskou skupinu „Users“.
• Zachovat vazby na jiné aplikace
  • Zaškrtnuto – Provázanost vazeb na jiné aplikace bude zachována přesně podle provázanosti vazeb ve zdrojové (exportované) aplikaci a ve všech jejích podřízených objektech. Provázané aplikace nebo podřízené objekty nemusí v cílovém NET Geniu existovat. V takovém případě je pak zobrazena chybová hláška o porušení konzistence dat a import je zastaven.
  • Nezaškrtnuto – Provázanost vazeb na jiné aplikace a jejich podřízené objekty nebude zachována. Při případné existenci vazeb na jiné aplikace je zapotřebí tyto vazby projít a upravit.

2.1.2. Vyberte soubor

• Tlačítko „Procházet…“ pro upload souboru importované aplikace s příponou „nga“, „xlsx“ nebo „xls“.
• Formát souboru „nga“ představuje standardní exportní a importní formát aplikací NET Genium, který obsahuje kompletní definici aplikace včetně její struktury, ovládacích prvků, vazeb a případně i dat nebo souborových příloh.
• Formáty „xlsx“ a „xls“ slouží pro automatické vytvoření nové aplikace na základě dat z aplikace Microsoft Excel.
  • Při importu ze souboru Excel je vytvořena aplikace obsahující právě jednu databázovou tabulku, která odpovídá první záložce importovaného souboru.
  • Pro každý sloupec v této záložce je automaticky vytvořen ovládací prvek typu Textbox s datovým typem String.
  • Všechna data obsažená v první záložce souboru Excel jsou při importu automaticky naimportována do vytvořené databázové tabulky.

2.1.3. Záložka „Šablony“

• Každé NET Genium má na disku adresář „Store“ a v něm uložené ukázkové aplikace, které je možné tímto způsobem importovat.

3. Aktualizace stávající aplikace

• Tato kapitola popisuje výhradně aktualizaci již existující aplikace. Import nové aplikace, který vytváří zcela novou instanci aplikace v NET Geniu, je popsán samostatně v kapitole „ HYPERLINK \l "_Import_nové_aplikace" Import nové aplikace “.
• Aktualizace stávající aplikace je dostupná výhradně uživatelům s nejvyšším oprávněním, tedy uživateli Administrator s databázovým ID 1.
• Aktualizace stávající aplikace se provádí v dialogu „Upravit aplikaci“ na záložce „Administrace“, kde je k dispozici sekce „Importovat aplikaci“.

• Aktualizace probíhá pomocí importu souboru s příponou „nga“, který nahrazuje strukturu a konfiguraci aplikace podle obsahu importovaného souboru.
• Zachování existujících dat je možné pouze v případě, že databázová struktura importovaného souboru odpovídá struktuře aplikace v cílovém prostředí — tabulky nebo sloupce, které se v importované verzi nevyskytují, nemohou být zachovány.

3.1. Dialog „Upravit aplikaci“, záložka „Administrace“

3.1.1. Importovat aplikaci

3.1.1.1. Možnosti

• Aktualizovat a zachovat stávající data
  • Zaškrtnutím tohoto pole se zobrazí tlačítko „Procházet…“, které slouží k aktualizaci aplikace se zachováním stávajících dat ve všech databázových tabulkách aplikace.
  • Zachování stávajících dat je založeno na porovnání databázové struktury – importovaná verze aplikace musí obsahovat databázové tabulky se stejným názvem a stejnou strukturou. Tabulky, které se ve stejné podobě v nové verzi nevyskytují, zachovány nebudou. Stejně tak nebudou zachovány sloupce tabulek, které v nové verzi aplikace neexistují.
• Importovat práva
  • Zaškrtnuto – Při importu práv budou použita ID uživatelů a uživatelských skupin přesně podle nastavení práv ve zdrojové (exportované) aplikaci a ve všech jejích podřízených objektech. Tato forma importu může způsobit datovou nekonzistenci mezi právy ve zdrojové a cílové aplikaci. Stejná ID mohou ve dvou různých NET Geniích značit rozdílné uživatele nebo uživatelské skupiny. Zároveň nemusí některá ID v cílovém NET Geniu existovat. V nastavení práv importované aplikaci se pak budou zobrazovat místo názvu uživatelů nebo uživatelských skupin pouze čísla ID.
  • Nezaškrtnuto – Importovaná aplikace a všechny její podřízené objekty budou mít nastavená práva na uživatelskou skupinu „Users“.
• Zachovat vazby na jiné aplikace
  • Zaškrtnuto – Provázanost vazeb na jiné aplikace bude zachována přesně podle provázanosti vazeb ve zdrojové (exportované) aplikaci a ve všech jejích podřízených objektech. Provázané aplikace nebo podřízené objekty nemusí v cílovém NET Geniu existovat. V takovém případě je pak zobrazena chybová hláška o porušení konzistence dat a import je zastaven.
  • Nezaškrtnuto – Provázanost vazeb na jiné aplikace a jejich podřízené objekty nebude zachována. Při případné existenci vazeb na jiné aplikace je zapotřebí tyto vazby projít a upravit.

3.1.1.2. Vyberte soubor

• Tlačítko „Procházet…“ pro upload souboru importované aplikace s příponou „nga“
• Zobrazí se po zaškrtnutí možnosti „Aktualizovat a zachovat stávající data“

4. Export aplikace

• Export aplikace je dostupný prostřednictvím ikony „Exportovat aplikaci“, a je určen výhradně uživatelům s nejvyšším oprávněním — uživateli Administrator s databázovým ID 1.

• Po stisknutí ikony „Exportovat aplikaci“ je vygenerován exportní soubor s příponou „nga“, který obsahuje kompletní definici aplikace. Export zahrnuje strukturu aplikace, ovládací prvky, vazby a podle zvolených voleb také data nebo souborové přílohy.
• Export aplikace slouží k přenosu do jiného prostředí NET Genia nebo k vytvoření záložní kopie. Probíhá jednorázově bez dalších kroků uživatele. Po zvolení voleb exportu systém vytvoří soubor a nabídne jeho stažení.

4.1. Možnosti

• Včetně dat
  • Zaškrtnutí tohoto pole určuje, zda mají být součástí výsledného exportu i databázové záznamy všech exportovaných databázových tabulek.
• Včetně příloh (soubory/obrázky)
  • Zaškrtnutí tohoto pole určuje, zda mají být součástí výsledného exportu i souborové přílohy všech exportovaných databázových tabulek.
• Systémová aplikace
  • Zaškrtnutí tohoto pole určuje, zda má být exportovaná aplikace označená jako systémová, a v cílovém NET Geniu nebude možné mazat její podřízené objekty.
• Součást aplikace „Nastavení“
  • Zaškrtnutí tohoto pole určuje, zda má být exportovaná aplikace označená jako součást aplikace „Nastavení“. Do cílového NET Genia pak nebude naimportována jako celek, ale budou naimportovány pouze její podřízené objekty přímo do aplikace „Nastavení“ v cílovém NET Geniu.