############################################################## Poskytované moduly ############################################################## Knihovna poskytuje rozhraní ve formě modulů pro tyto WSDP služby: * ctiOS - zjištění osobních údajů opravněných subjektů z VFK souboru * generujCernoveUdajeDleKu - vytvoření sestavy pro generování cenových údajů podle katastrálního území * seznamSestav, vratSestavu, smazSestavu - spravování sestav Jednotlivé moduly budou na dalších řádcích podrobněji popsány. Konkrétní obsah výstupních dat WSDP je možné dohledat na stránkách ČÚZK - https://www.cuzk.cz/Katastr-nemovitosti/Poskytovani-udaju-z-KN/Dalkovy-pristup/Webove-sluzby-dalkoveho-pristupu.aspx . ČtiOS ###### Rozhraní umožňuje získat a uložit v různých formátech osobní údaje k oprávněným subjektům (OS), které byly pseudonymizovány ve VFK souboru v souvislosti s nařízením GDPR. Dešifrování pseudonymizovaných identifikatorů oprávněných subjektů (tzv. POSIdentů) a zjišťování jejich osobních údajů není programovou součástí této knihovny. Knihovna přistupuje k WSDP službě ctiOS, která se stará o tuto "špinavou práci". Na straně ČÚZK je přístup ke službě ctiOS monitorován ukládáním záznamů o všech vyhledaných OS. Modul ČtiOS získává výstup ze serveru ve formě slovníků, které dále připraví pro uložení do souborů vybraných formátů. Při uložení úspěšně zpracovaných identifikátorů do souboru o vybraném výstupním formátu se automaticky ve stejné složce vytvoří JSON soubor obsahující neúspěšně zpracované identifikátory a odůvodnění. Důvody neúspěšného zpracování POSIdentů vychází z nastavení služby ctiOS a jsou následující: - NEPLATNY_IDENTIFIKATOR - každý POSIdent, který nebylo možné rozšifrovat - EXPIROVANY_IDENTIFIKATOR - POSIdent, kterému vypršela časová platnost - OPRAVNENY_SUBJEKT_NEEXISTUJE - POSIdent bylo možné rozšifrovat, ale oprávněný subjekt k němu neexistuje Vstupní formáty ------------------ Rozhraní umožňuje načítat data z SQLite databáze či JSON souboru. Dále umožňuje vstupní POSIdenty zadat i přímo jako slovník do volání služby. Pokud chceme pracovat s daty z VFK souboru, je pro nás určeno načítání vstupních dat z SQLite databáze. Tuto databázi musíme nejprve z VFK souboru vytvořit pomocí nástroje **ogrinfo**, který je součástí knihovny GDAL:: ogrinfo exportvse.vfk Tento driver vytvoří SQLite databázi ve stejném adresáři jako VFK soubor s příponou .db. To lze ověřit například pomocí aplikace SQLite Database Browser. Výstupní formáty ------------------ Získaná data oprávněných subjektů je možné uložit do tří formátů - JSON, CSV a SQlite databáze. V případě SQLite databáze je nutné mít i vstupní data ve formě SQLite databáze. Na základě vstupní databáze modul vytvoří ve zvolené cestě novou databázi s updatovanými atributy oprávněných subjektů. Sestavy ####################### GenerujCenoveUdajeDleKu ------------------------ Rozhraní umožňuje práci se sestavou na generování údajů o dosažených cenách nemovitostí podle zadaného kódu k.ú. pro dané časové období. Po dotazu na server modul vytvoří sestavu, se kterou je poté možné přes rozhraní dále pracovat - vypsat údaje o sestavě (cena, stav sestavy apod.), zaúčtovat sestavu a smazat sestavu. Můžeme načítat vstupní data ze souboru JSON nebo je zadat přímo jako slovník do volání služby. Výstupní ZIP soubor obsahuje XML soubory s cenovými údaji pro dané časové období. Po zaúčtování je možné zašifrovaný ZIP dokument pomocí modulu dešifrovat a uložit na disk. Spravování sestav ####################### Jedná se o specifické moduly, které je možné využívat v rámci API sestav. Kromě toho knihovna PyWSDP nabízí i samostatné moduly pro tyto specifické služby. Pokud znáte číslo sestavy, je možné nad takovou sestavou i samostatně zavolat požadovaný modul. SeznamSestav vrací údaje o sestavě - typu sestavy, ceně, stavu sestavy a informace o tom, zda je sestava opatřena el. značkou. VratSestavu zaúčtuje sestavu (pokud ještě nebyla zaúčtována) a vrátí vygenerovanou sestavu jako součást odpovědi. Dále vrátí informace o typu sestavy, ceně, stavu sestavy a informaci o tom, zda je sestava opatřena el. značkou. SmazSestavu smaže požadovanou sestavu, tzn. k sestavě již nebude možné přistupovat.