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 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 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.