DBExport.exe

Defaultně dodávaný exe soubor, který najdete v adresáři, v němž je umístěna vlastní instalace ABRA Flores. Jedná se o servisní nástroj, který slouží k exportu dat vybraného spojení do souboru.

Využívá se pouze pro realizaci přechodu mezi systémyABRA Flores téže verze. Import do vyšší verze není možný! Ze zadané databáze vyexportuje čistá data do souboru formátu databázový export (*.DBE). Z tohoto souboru je možné data naimportovat do jiného spojení jiné instalace ABRA Flores. Více viz Přechod mezi systémy ABRA Flores.

Obsahem souboru jsou POUZE:

  • data tabulek
  • hodnoty sekvencí (generátorů), aby se správně nastavily v nově vytvářené databázi
  • pokud se jedná o závislé spojení, tj. v databázi jsou použita synonyma odkazující na tabulky jiného spojení (aktuálně možné jen na databázi /MSSQL, jsou data těchto tabulek rovněž připojena do souboru

Od v. 5.01 obsahuje exportní soubor také tabulku Export_ExportHeaderTable s informacemi o verzi systému ABRA Flores, ze které byla data exportována. Při vlastním importu se pak kontroluje, jestli je stejná major, minor a build verze. Pokud se verze liší, zobrazí se varovná hláška a soubor nebude možné naimportovat. Tj. převádět data pomocí nástroje DBExport je možné POUZE MEZI PRODUKTY TÉŽE VERZE!

Pokud by exportní soubor vznikl v nižší verzi, než je 5.01 (tj. ve které se ještě extra tabulka Export_ExportHeaderTable s informací o verzi neukládá), neprovede se žádná kontrola. Nicméně i tak je důrazně doporučeno data mezi verzemi tímto nástrojem nepřenášet.

Obsahem vyexportovaného souboru není nic jiného, než je uvedeno zde příp. než je uvedeno v aktuálnějších Změnách ve verzích. Tzn. pokud jste na exportní straně prováděli nějaké zákaznické úpravy a chcete je mít i na importní, je třeba si zajistit jejich přidání i na importní straně. Více viz Přechod mezi systémy ABRA Flores.

Pro použití z příkazové řádky je určen DBExportCmd.exe.

Tip pro uživatele ABRA Flores: Z výše uvedeného plyne, že pokud používáte závislá spojení a chcete vybrané závislé spojení tzv. "desynonymizovat" (tj. vytvořit z něj nezávislé spojení), je DBExport vhodným nástrojem na vyhrání všech potřebných dat (tj. vč. dat z tabulek, na něž je odkazováno). Následně je možné tato data naimportovat do jiného nezávislého spojení jiné instalace ABRA Flores.

Tento nástroj je určen především servisním konzultantům a správcům systému. Běžný uživatel tento nástroj ke své práci nebude potřebovat.

Jelikož se jedná o jeden z nástrojů, které při neznalém použití mohou mít destruktivní následky nebo u nichž není žádoucí, aby s nimi pracoval běžný uživatel, je možno přístup do něj chránit bezpečnostním heslem.

Program po spuštění nástroje nejdříve zkontroluje, zda pro danou instalaci již bylo bezpečnostní heslo zadáno. Heslo je pro všechny chráněné nástroje společné. Pokud heslo dosud v dané instalaci nebylo zadáno v rámci spuštění některého z chráněných nástrojů či jeho chráněné funkce, program na tuto skutečnost upozorní a nabídne možnost jej zadat.

Zadání hesla není povinné, ale v každém případě jej doporučujeme využívat. Můžete tak předejít nežádoucím manipulacím např. ze strany neznalé osoby, které mohou pro váš systém mít i značně destruktivní následky.

Pokud bezpečnostní heslo pro spouštění nástrojů bylo v rámci spuštění některého z chráněných nástrojů v dané instalaci již zadáno, zobrazí se přihlašovací dialog do nástrojů, v němž se uživatel musí přihlásit zadáním bezpečnostního hesla. Po stisku OK se ověřuje jeho správnost. Nebylo-li heslo zadáno správně, program umožní uživateli opětovné zadání jména a hesla (např. pro případ překlepu). Pokud ani opakovaně není heslo zadáno správně, program je ukončen (totéž po vyvolání akce Storno z přihlašovacího dialogu). Bylo-li přihlášení úspěšné, systém pokračuje zobrazením okna tohoto nástroje.

Po spuštění nástroje DBExport a případném zadání hesla, jak bylo uvedeno výše, se zobrazí okno pro zadání spojení na databázi. Zde zvolte spojení na databázi, tzv. "connection" do systému ABRA Flores, z něhož chcete data exportovat. V dalším kroku zadejte výstupní soubor, do něhož se má exportovat. Následně proběhne samotný export, přičemž se zobrazuje informace o průběhu exportu.

V nástroji DBAdmin zvolte "Přidat nové spojení", v následujícím kroku "Vlastnosti spojení" zatrhněte volbu "Zobrazit pokročilé vlastnosti" a poté zpřístupněnou volbu "Editovat zákaznické úpravy". Průvodce přidáním spojení projděte až do kroku "Zákaznické úpravy". Zde je třeba zatrhnout volbu "Nahrát data ze souboru" a připojit soubor s vyexportovanými daty.

Volitelně je zde možné připojit vlastní *.DBO soubor(y) s vlastními zákaznickými úpravami, které se mají spustit v průběhu vytváření nové databáze. Zatím neexistuje nástroj, jak takové soubory získat automaticky a musíte si je vytvořit ručně pomocí nástroje DBOperations (DBO soubory jsou totiž binární soubory a nelze je vytvořit jinak než prostřednictvím nástrojů DBOperations nebo DBDesigner (z toho ovšem nástroj DBDesigner není uživatelsky dostupný - není součástí instalace ABRA Flores)).

K dispozici je i možnost zadat "Adresář s DBO soubory". Je-li použita, pak se nová databáze vytvoří podle *.DBO souborů v tomto adresáři, přičemž spojení se po vytvoření nové databáze přepne do stavu Update a spustí se proces update opět za použití *.DBO souborů v tomto adresáři. Využijete pouze výjimečně, v případě řešení nějakých servisních potíží (např. potřebujete obnovit data vyexportovaná pomocí DBExport ze starší verze ABRA Flores do novější instalace ABRA Flores a potřebujete, aby se databáze v novější instalaci vytvořila podle DBO souborů odpovídajících starší verzi).

  • CreateDB.DBO - příkazy pro vytvoření nové databáze
  • UpdateDB.DBO - příkazy pro změnu stávají databáze
  • InitData.DBO - příkazy pro naplnění inicializačních dat do nové databáze
  • InstallDB.DBO - příkazy, které se provedou v rámci instalace nového modulu do existující instalace (doplní data nově instalovaného modulu tak, aby odpovídala stávající instalaci)
  • ExternalData.DAT - pomocný soubor pro soubory DBO, obsahuje data pro příkazy nad tabulkou (vložení a změna, tedy hlavně pro inicializační data)
  • DBO soubory pro update jsou součástí instalace ABRA Flores.

V průběhu importu může nastat situace, kdy exportní soubor obsahuje tabulku, sloupec tabulky nebo sekvenci, která neexistuje v cílovém spojení. V takovém případě import zobrazí dialogové okno s volbou Zopakovat nebo Přeskočit. Je tedy možné takové hodnoty buď vůbec do nově tvořené databáze neimportovat (přeskočit) anebo import přerušit, chybějící databázový objekt nejdříve doplnit (ručně např. pomocí nástroje DBOperations) a poté pokračovat v importu.

Vlastní import takové situace AUTOMATICKY nijak neřeší. Může k nim dojít typicky v případě, kdy jste si na exportní straně přidávali vlastní databázové entity, jejichž hodnoty jsou obsaženy v exportovaných datech, a nezajistili jste jejich přidání na importní straně. Jak bylo řečeno výše, obsahem exportu jsou totiž pouze data tabulek a hodnoty sekvencí (včetně uživatelských), nikoli informace o přidaných entitách. Čili pokud jste na exportní straně přidávali např. vlastní tabulky, jejichž hodnoty chcete nyní naimportovat, musíte si přidání takových tabulek zajistit i na importní straně. To zajistíte v rámci DBAdmin právě prostřednictvím připojení vlastních *.DBO souborů se zákaznickými úpravami (viz výše) s nadefinovanými vlastními databázovými operacemi, které vytvoření příslušných entit na importní straně zajistí. Pokud tak neučiníte, proces importu dat se zastaví, jak bylo řečeno výše.

Totéž platí i pro další databázové entity, které jste na exportní straně přidávali a které nejsou součástí vyexportovaných dat (např. procedury, triggery, ...). Pokud je chcete mít opět i na importní straně, musíte si jejich přidání rovněž zajistit sami připojením vlastních *.DBO souborů se zákaznickými úpravami.