DBExport.exe

Defaultne dodávaný exe súbor, ktorý nájdete v adresári, v ktorom je umiestnená vlastná inštalácia ABRA Gen. Ide o servisný nástroj, ktorý slúži na export dát vybraného spojenia do súboru.

Využíva sa len na realizáciu prechodu medzi dvoma produktmiABRA Gen (napr. z ABRA Gen s podvojným účtovníctvom na ABRA Gen a pod.) tej istej verzie. Import do vyššej verzie nie je možné! Zo zadanej databázy vyexportuje čisté dáta do súboru formátu databázový export (*.DBE). Z tohto súboru je možné dáta naimportovať do iného spojenia inej inštalácie ABRA Gen. Viac viď Prechod medzi systémami ABRA Gen.

Obsahom súboru sú IBA:

  • dáta tabuliek
  • hodnoty sekvencií (generátorov), aby sa správne nastavili v novo vytváranej databáze
  • ak ide o závislé spojenie, tzn. v databáze sú použité synonymá odkazujúce na tabuľky iného spojenia (aktuálne možné len na databáze Oracle/MSSQL, tzn. týka sa iba produktu ABRA Gen, dáta týchto tabuliek sú tiež pripojené do súboru

Od v. 14.53 obsahuje exportný súbor tiež tabuľku Export_ExportHeaderTable s informáciami o verzii systému ABRA Gen, z ktorej boli dáta exportované. Pri vlastnom importe sa následne kontroluje, či je rovnaká major, minor a build verzia. Pokiaľ sa verzie líšia, zobrazí sa varovná hláška a súbor nebude možné naimportovať. Tzn. prevádzať dáta pomocou nástroja DBExport je možné LEN MEDZI PRODUKTMI TEJ ISTEJ VERZIE!

Pokiaľ by exportný súbor vznikol v nižšej verzii, ako je 14.53 (tzn. v ktorej sa ešte extra tabuľka Export_ExportHeaderTable s informáciou o verzii neukladá), nevykoná sa žiadna kontrola. Avšak i tak sa dôrazne odporúča dáta medzi verziami týmto nástrojom neprenášať.

Obsahom vyexportovaného súboru nie je nič iné, ako je uvedené tu príp. ako je uvedené v aktuálnejších Zmenách vo verziách. Tzn. ak ste na exportnej strane robili nejaké zákaznícke úpravy a chcete ich mať aj na tej importnej, je potrebné, aby ste si zabezpečili ich pridanie aj na importnej strane. Viac viď Prechod medzi systémami ABRA Gen.

Na použitie z príkazového riadka je určený DBExportCmd.exe.

Tip pre užívateľa ABRA Gen: Z vyššie uvedeného vyplýva, že ak používate závislé spojenia a chcete vybrané závislé spojenie tzv. "desynonymizovať" (tzn. vytvoriť z neho nezávislé spojenie), DBExport je vhodným nástrojom na vyhranie všetkých potrebných dát (tzn. vrát. dát z tabuliek, na ktoré sa odkazuje). Následne je možné tieto dáta naimportovať do iného nezávislého spojenia inej inštalácie ABRA Gen.

Tento nástroj je určený predovšetkým servisným konzultantom servisnej siete výrobcu a správcom systému. Bežný užívateľ tento nástroj k svojej práci nebude potrebovať.

Keďže ide o jeden z nástrojov, ktoré pri neznalom použití môžu mať deštruktívne následky alebo pri ktorých nie je žiadúce, aby s nimi pracoval bežný užívateľ, je možné prístup do neho chrániť bezpečnostným heslom.

Program po spustení nástroja najprv skontroluje, či pre danú inštaláciu už bolo bezpečnostné heslo zadané. Heslo je pre všetky chránené nástroje spoločné. Pokiaľ heslo zatiaľ v danej inštalácii nebolo zadané v rámci spustenia niektorého z chránených nástrojov či jeho chránenej funkcie, program na túto skutočnosť upozorní a ponúkne možnosť ho zadať.

Zadanie hesla nie je povinné, ale v každom prípade ho odporúčame využívať. Môžete tak predísť nežiaducim manipuláciám napr. zo strany neznalej osoby, ktoré môžu mať pre váš systém aj značne deštruktívne následky.

Pokiaľ bezpečnostné heslo na spúšťanie nástrojov bolo v rámci spustenia niektorého z chránených nástrojov v danej inštalácii už zadané, zobrazí sa prihlasovací dialóg do nástrojov, v ktorom sa užívateľ musí prihlásiť zadaním bezpečnostného hesla. Po stlačení OK sa overuje jeho správnosť. Ak nebolo heslo zadané správne, program užívateľovi umožní opätovné zadanie mena a hesla (napr. v prípade preklepu). Pokiaľ ani opakovane nie je heslo zadané správne, program sa ukončí (rovnako po vyvolaní akcie Storno z prihlasovacieho dialógu). Ak bolo prihlásenie úspešné, systém pokračuje zobrazením okna tohto nástroja.

Po spustení nástroja DBExport a prípadnom zadaní hesla, ako bolo uvedené vyššie, sa zobrazí okno na zadanie spojenia na databázu. Tu zvoľte spojenie na databázu, tzv. "connection" do systému ABRA Gen, z ktorého chcete dáta exportovať. V ďalšom kroku zadajte výstupný súbor, do ktorého sa má exportovať. Následne prebehne samotný export, pričom sa zobrazuje informácia o priebehu exportu.

V nástroji DBAdmin zvoľte "Pridať nové spojenie", v nasledujúcom kroku "Vlastnosti spojenia" začiarknite voľbu "Zobraziť pokročilé vlastnosti" a potom sprístupnenú voľbu "Editovať zákaznícke úpravy". Sprievodcu pridaním spojenia prejdite až do kroku "Zákaznícke úpravy". Tam je potrebné začiarknuť voľbu "Nahrať dáta zo súboru" a pripojiť súbor s vyexportovanými dátami.

Voliteľne je tu možné pripojiť vlastný *.DBO súbor(y) s vlastnými zákazníckymi úpravami, ktoré sa majú spustiť v priebehu vytvárania novej databázy. Zatiaľ neexistuje nástroj, ktorým by bolo možné takéto súbory získať automaticky a musíte si ich vytvoriť ručne pomocou nástroja DBOperations (DBO súbory sú totiž binárne súbory a nie je ich možné vytvoriť inak ako prostredníctvom nástrojov DBOperations alebo DBDesigner (z toho však nástroj DBDesigner nie je užívateľsky dostupný - nie je súčasťou inštalácie ABRA Gen)).

K dispozícii je tiež možnosť zadať "Adresár s DBO súbormi". Ak ju použijete, nová databáza sa vytvorí podľa *.DBO súborov v tomto adresári, pričom spojenie sa po vytvorení novej databázy prepne do stavu Update a spustí sa proces update opäť za použitia *.DBO súborov v tomto adresári. Využijete iba výnimočne, v prípade riešenia nejakých servisných ťažkostí (napr. potrebujete obnoviť dáta vyexportované pomocou DBExport zo staršej verzie ABRA Gen do novšej inštalácie ABRA Gen a potrebujete, aby sa databáza v novšej inštalácii vytvorila podľa DBO súborov zodpovedajúcich staršej verzii).

  • CreateDB.DBO - príkazy na vytvorenie novej databázy
  • UpdateDB.DBO - príkazy na zmenu aktuálnej databázy
  • InitData.DBO - príkazy na naplnenie inicializačných dát do novej databázy
  • InstallDB.DBO - príkazy, ktoré sa vykonajú v rámci inštalácie nového modulu do existujúcej inštalácie (doplní dáta novo inštalovaného modulu tak, aby zodpovedali aktuálnej inštalácii)
  • ExternalData.DAT - pomocný súbor pre súbory DBO, obsahuje dáta pre príkazy nad tabuľkou (vloženie a zmena, tzn. hlavne pre inicializačné dáta)
  • DBO súbory pre update sú súčasťou inštalácie ABRA Gen.

Počas importu môže nastať situácia, keď exportný súbor obsahuje tabuľku, stĺpec tabuľky alebo sekvenciu, ktorá neexistuje v cieľovom spojení. V takom prípade import zobrazí dialógové okno s voľbou Zopakovať alebo Preskočiť. Je teda možné takéto hodnoty buď vôbec do novo tvorenej databázy neimportovať (preskočiť) alebo import prerušiť, chýbajúci databázový objekt najskôr doplniť (ručne napr. pomocou nástroja DBOperations) a následne pokračovať v importe.

Samotný import takéto situácie AUTOMATICKY nijako nerieši. Môže k nim dôjsť typicky v prípade, keď ste si na exportnej strane pridávali vlastné databázové entity, ktorých hodnoty sú obsiahnuté v exportovaných dátach, a nezabezpečili ste ich pridanie na importnej strane. Ako bolo uvedené vyššie, obsahom exportu sú totiž iba dáta tabuliek a hodnoty sekvencií (vrátane užívateľských), nie informácie o pridaných entitách. Takže ak ste na exportnej strane pridávali napr. vlastné tabuľky, ktorých hodnoty chcete teraz naimportovať, musíte si pridanie týchto tabuliek zabezpečiť aj na importnej strane. To zaistíte v rámci DBAdmin práve prostredníctvom pripojenia vlastných *.DBO súborov so zákazníckymi úpravami (viď vyššie) s nadefinovanými vlastnými databázovými operáciami, ktoré vytvorenie príslušných entít na importnej strane zabezpečia. Pokiaľ to neurobíte, proces importu dát sa zastaví, ako bolo povedané vyššie.

To isté platí aj pre ďalšie databázové entity, ktoré ste na exportnej strane pridávali a ktoré nie sú súčasťou vyexportovaných dát (napr. procedúry, triggery, ...). Ak ich chcete mať opäť aj na importnej strane, musíte si ich pridanie taktiež zabezpečiť sami pripojením vlastných *.DBO súborov so zákazníckymi úpravami.

Systém vlastných *.DBO súborov nahrádza systém užívateľských *.NXD súborov, ktoré sa na vytváranie užívateľských entít používali do verzie 10.01. vrátane.