Jak pracuje Importní modul Vlček

1. Obecné

  • Excel, který chceme importovat do Evolia musí mít data na prvním listě v sešitu pojmenovaném List1.

  • Excel musí být ve formátu Office 2003 xls.

  • Excel musí mít odstraněny všechny prázdné sloupce z List1. v opačném případě importer zahlásí chybu a k importu nedojde.

  • Všechno logování se ukládá do složky dokumenty\Evolio.Log ve formátu rrrrMMdd_hhmmss_VlcekExcelImport.log.

  • Importer před samotným importem zkonvertuje tabulku excelu do excelu nového (PUVODNI_JMENO_EXCELU_Converted.xls) a tabulku z excelu nového zanalyzuje dle definice uvedené v XML, které se nachází dokumenty\Evolio.Settings. Výsledkem je zkonvertovaná datová tabulka se zformátovanými hodnotami v jednotlivých buňkách. Importer, pak při samotném importu už nemusí přemýšlet, jak dotyčnou hodnotu formátovat. Výhodou tohoto je, že se chyby odhalí hned na začátku před samotným importem. Konverze sešitu excelu do nové sešitu excelu se provádí, protože původní excel, obsahuje formátování, kterým Importer nerozumí. Je tedy třeba tento původní excel převést na formát, kterému Importer už rozumí. Poté dokáže výslednou tabulku z nové sešitu zkonvertovat do datové tabulky, kterou pak použije pro import.

  • Základní premisou, aby konverze tabulky sešitu z excelu do datové tabulky proběhla úspěšně je, že žádný sloupeček se nesmí opakovat (duplicita názvů sloupců).

  • O konverzi tabulky ze sešitu z původního excelu do nové sešitu se stará Excel Converter.

  • O konverzi tabulky ze sešitu z excelu do datové tabulky se zformátovanými hodnotami se stará Excel Validator.

  • Excel Validator, když tvoří strukturu tabulky určené pro import, prochází jednotlivé sloupce z definice v XML. Každý sloupec pak projde následujícími kroky. Nejdřív se zjistí, jestli sloupec patří mezi neopakující se sloupce. Tzn. jestli název sloupce v XML se rovná názvu sloupce v Excelu. Pak je předpoklad, že sloupec je opakující se a tedy, že název sloupce v XML je obsažen v názvu některého sloupce Excelu.

  • Název žádného sloupce nesmí být součástí názvu jiného sloupce (např. "uhrada" a "uhrada datum"). Je však dovoleno "uhrada castka" a "uhrada datum".

  • Excel Validator validuje XML proti XSD jednoduchým způsobem skrze DataSet. Struktura XML a základní pravidla se načtou do DataSetu pomocí XSD a data (definice sloupců) pak pomocí XML. Pokud vznikne během zpracování vyjímka, Excel Validator o ní informuje.

  • Importer zakládá a přepisuje spisy. První číslo spisu importer navrhne uživateli k editaci. Uživatel si ho změní dle své vůle. Toto číslo pak použije importer jako odrazový můstek a bude postupně navyšovat pořadové číslo spisu pro každý nový spis z Excelu.

  • Importer kontroluje shodu spisů dle čísla exekučního titulu a Variabilního symbolu. U ČTÚ i dle BOSS_ID.

  • Po importu každého spisu, importer aktualizuje jeho finance.

2. Import VZP ČR

Importér přenáší sloupec „číslo jednací“ do značky spisu. Ze sloupce „částka celkem“ se zakládá jistinu. Ze sloupců „Název exekučního titulu“, „titul vydal“, „číslo titulu“, „vystavení“, „právní moc / vykonatelnost“ vytváří exekuční titul pro nově importovaný spis.
Protože se může v excelu vyskytnout povinný s týmž číslem více než jednou, přičemž má rozdílné hodnoty v sloupcích určené pro exekuční titul a ve sloupci „částka celkem“. Importér dle všech hodnot ze sloupce „číslo jednací“ zjistí, jestli už v Evoliu existují spisy s tímto číslem jednacím. Pokud nějaké shody najde, vypíše je v průběhu importu do logu a automaticky uloží k do dokumentové složky aktuálního uživatele windows do adresáře Evolio.Log pod názvem RRRRMMDD_HHmmss_ImportExcelShodneSpisy.txt. Shodné spisy si importér označí a bude je při následném importu ignorovat. Do logu o průběhu importu zapíše informace, že byly nalezeny shodné spisy a že se nebudou importovat. Obsahem seznamu bude číslo jednací a číslo spisu.
Dle hodnoty ve sloupci „číslo jednací“ v Excelu importér hledá v Evoliu spis, který má ve značce tutéž hodnotu. Pokud žádný takový spis importér v Evoliu nenajde, založí spis nový. Založí k němu povinného z excelu a oprávněného a právního zástupce zvoleného na začátku. Poté k němu založí ze sloupce „částka celkem“ jistinu a exekuční titul ze sloupců „Název exekučního titulu“, „titul vydal“, „číslo titulu“, „vystavení“, „právní moc / vykonatelnost“. Pokud importér spis najde, přidá k němu z excelu exekuční titul, pokud se odlišuje v čísle titulu, a jistinu.

3. Import Kňáva

Existenci spisu hledá dle čísla exekučního titulu z Excelu. Toto číslo si ale ukládá přímo do hlavní tabulky nikoliv mezi exekuční tituly. Nicméně další záznam z Excelu, který by měl shodné číslo exekučního titulu z něj se importuje pouze subjekt.

Od verze 7.0.24

Import Kňáva nemá kontrolu existenci spisu dle exekučního titulu, protože jeho vyhledává spisy (od této verze 7.0.24) dle exekučního titulu a rodného čísla. Import Kňáva tedy nyní kontroluje před importem každého spisu, jestli existuje dle exekučního titulu a rodného čísla a pokud ano je o tom uživatel informován a uživatel rozhodne jestli bude pokračovat v importu spisu čí nikoliv. Hodnotu pro vyhledávání pomocí exekučního titulu a rodného čísla bere import Kňáva z excelu a porovnáhá ho se sloupcem IDIS v tabulce SmlouvyProdukt.
Nyní nenajde spisy, které byly importovány starší verzí importéru.

Od verze 7.0.26

Import Kňáva má zpět kontrolu existenci spisu dle exekučního titulu, ale je i přidáno vyhledávání spisů dle rodného čísla povinného. Čili nejdříve je vyhledán spis dle titulu a pokud se uživatel rozhodne pokračovat, pak spis hledán dle rodného čísla povinného. O případně nalezeném spisu je uživatel informován. Hodnotu pro vyhledávání pomocí exekučního titulu a rodného čísla bere import Kňáva z excelu a porovnáhá ho se sloupcem IDIS v tabulce SmlouvyProdukt.
Nyní nenajde spisy, které byly importovány starší verzí importéru (< 7.0.25).

Od verze 7.0.27

Import Kňáva má přidáno vyhledávání spisů dle jména, příjmení a data narození povinného. Čili nejdříve je vyhledán spis dle titulu a pokud se uživatel rozhodne pokračovat, pak spis hledán dle rodného čísla povinného a pokud se uživatel rozhodne pokračovat, pak je spis hledán dle jména, příjemní a data narození povinného. O případně nalezeném spisu je uživatel informován. Hodnotu pro vyhledávání pomocí exekučního titulu a rodného čísla bere import Kňáva z excelu a porovnáhá ho se sloupcem IDIS v tabulce SmlouvyProdukt.
Nyní nenajde spisy, které byly importovány starší verzí importéru (< 7.0.25).
Povinní jsou v případě, že nemají vyplněno rč vyhledáváni dle jména, příjmení, data narození, ulice, města a psč. Jediné co může chybět je město. Pokud jsou i jiné hodnoty pro vyhledávání prázdné, pak je povinný v Excelu označen za nenalezeného a importován do Evolia.

Od verze 7.0.21

U každého typu importu se před samotným importem spisu dochází k jeho kontrole pomocí čísla exekučního titulu. {BR}Každý spis hledá pomocí SQL dotazu
SELECT        s.ID, s.ČÍSLO_SMLOUVY, s.spZadal, s.spZadáno, t.extCislo
FROM            SmlouvyProdukt AS s INNER JOIN
                         implExVazbaSpisTitul AS vt ON s.ID = vt.vstIDSpis INNER JOIN
                         implExTituly AS t ON vt.vstIDTitul = t.extID
WHERE        (replace(replace(replace(t.extCislo,' ',''),'/',''),'-','') = replace(replace(replace('číslo exekučního spisu',' ',''),'/',''),'-',''))

Pokud je nějaký spis nalezen, uživatel ho má možnost import aktuálního spisu z excelu přeskočit.

Varování u typu importu VZP ČR

V excelu se Vám mohou vyskytnout záznamy, které souvisí s 1 spisem. To kontrola existence dle čísla exekučního titulu netuší. Čili velmi pečlivě čtěte hlášení zobrazená v okénku. Jestli spis importovat, či nikoliv by Vám měly domoci doprovodné informace v hlášení jako jsou kdo a kdy nalezený spis v Evoliu zadal.