ÚVOD

PyLoop Tag Manager je aplikace pro správu tagů a automatické generování dokumentů. Umožňuje vytvářet vlastní tagy, spravovat je v kategoriích a používat je k nahrazování hodnot v šablonových dokumentech.

Podporované formáty:

– Word dokumenty (.docx)

– Excel sešity (.xlsx)

– CAD výkresy (.dxf)

PŘEHLED ZÁKLADNÍCH POJMŮ

HLAVNÍ UŽIVATELSKÉ ROZHRANÍ – jako uživatelské rozhraní se označuje úvodní dialogové okno aplikace, kde se budou zobrazovat vytvořené tagy.

VZOR – Vzor je skupina dokumentů ve formátu .docx (Word), .xlsx (Excel), anebo .dxf (AutoCAD). Do vzorů se umísťují tagy.

SLOŽKA VZORŮ – uživatelský adresář obsahující vzory.

TAG – Proměnná, kterou uživatel vytvoří ve správce tagů, kde přiřadí název, typ a následně v hlavním uživatelském rozhraní i hodnotu. Tato proměnná ve formátu {TAG} se umísťuje do vzorů.

POPISEK TAGU – Libovolný textový popisek tagu umožňující lepší orientaci v hlavním uživatelském rozhraní.

POLE – pole umožňující zadat hodnotu proměnné (tagu).

FORMULÁŘ – Sestava tagů a polí nacházející se v hlavním uživatelském rozhraní.

KATEGORIE TAGŮ – vytvořené tagy je možné pro větší přehlednost třídit do uživatelských kategorií.

PROJEKT – jako projekt se nazývá soubor s příponou „.pyloop“ aplikace PyLoop Tag Manager, který obsahuje strukturu tagů s vyplněnými hodnotami. Projekt PyLoop je označen modrou ikonou.

ŠABLONA – jako šablona se označuje soubor s příponou „.pyloogt“ aplikace PyLoop Tag Manager, který obsahuje strukturu tagů s prázdnými poli (bez vyplněných hodnot). Šablona PyLoop je označena žlutou ikonou.

HORNÍ PANEL – HLAVNÍ NABÍDKA:

PROJEKT

– Uložit projekt (s hodnotami) – Uloží kompletní projekt s tagy i vyplněnými hodnotami

– Načíst projekt (s hodnotami) – Načte uložený projekt s tagy i vyplněnými hodnotami

– Uložit šablonu tagů – Uloží formulář s prázdnými hodnotami v polích

– Načíst šablonu tagů – Načte formulář s prázdnými hodnotami v polích

– Vyčistit formulář – vymaže z hlavního uživatelského rozhraní všechny tagy i jejich hodnoty.

– Načíst vzory – umožní uživateli vybrat složku se vzory. Tato složka se bude načítat při každém dalším spuštění.

– Resetovat složku vzorů – funkce umožňující nastavit jako výchozí složku pro vzory složku „data_vzor“, která byla vytvořena v počítači při prvním spuštění PyLoop Tag Manageru.

– Uživatelský návod – otevře okno internetového prohlížeče s uživatelskou nápovědou.

– O aplikaci – otevře dialogové okno s informacemi o aplikaci.

EXPORT/IMPORT  

– Export do Excelu / CSV – Vytvoří Excel, nebo CSV se strukturovanými daty

– Import z CSV/Excel – Importuje data z externích souborů Excel, nebo CSV

MODULY

• Správa modulů – Aktivace/deaktivace pokročilých funkcí

• Územní analýza (pokud je aktivní) – Otevře nové dialogové okno umožňující vytvořit rozsáhlé územní analýzy zájmové oblasti (AOPK, radonové riziko, výskyt meliorací v oblasti, názvy a ID toků, ulice v zájmové oblasti, výskyt lesních pozemků, zjištění parcel v oblasti podle druhu pozemku, územní omezení z RÚIAN, památkové oblasti, poddolovaná území atd.). Data z územní analýzy je možné uložit jako .txt výstup, nebo automaticky vytvořit sestavu tagů v kategorii Analýza.

• Geoexport (pokud je aktivní) –
  • Záložka ČUZK Parcely – Umožňuje exportovat data katastrálních parcel podle zadaných kritérií do formátu .dxf. Umožňuje parsovat data katastru s csv tabulkami a tím tak dosáhnout exportu například pozemků se specifickým LV, podle druhu pozemku atd.  

• • Záložka ZABAGED Polohopis – Umožňuje na základě vyznačení zájmového území v interaktivní mapě, nebo importování S-JTSK souřadnic zájmového polygonu (.txt, nebo .csv) rychlý export linií polohopisu z Geoportálu ČUZK do formátu .dxf.  

• • Záložka ZABAGED Vrstevnice – Umožňuje na základě vyznačení zájmového území v interaktivní mapě, nebo importování S-JTSK souřadnic zájmového polygonu (.txt, nebo .csv) rychlý export linií vrstevnic z Geoportálu ČUZK do formátu .dxf.

• DXF Prostorová analýza (pokud je aktivní) – Analýza DXF výkresů vytvoří průniky objektů a linií v DXF s katastrálními parcelami. Jako zdroj dat používá aktuální katastrální data z RÚIAN. Vytvoří přehledné tabulky s výsledky analýzy. Tabulky je možné uložit jako excelový soubor, nebo načíst do hlavního uživatelského rozhraní jako tag typu tabulka.

• WKT Konvertor (pokud je aktivní) – Umožňuje rychlý převod souřadnic S-JTSK získaných z Microstation, nebo AutoCAD do formátu WKT podporovaného portálem DMVS pro získání dat základní prostorové situace a technické infrastruktury.

• Export pro Portál stavební správy (pokud je aktivní) – Vytvoří export dotčených katastrálních parcel pro Portál stavební správy. Modul umožňuje vygenerovat soupis dotčených parcel, odstraní případné duplicity katastrálních parcel, doplní číslo katastrálního území a vytvoří finální CSV soubor připravený k nahrání do Portálu stavební správy. Je optimalizován pro práci s velkým objemem záznamů.

NASTAVENÍ

• Správa licence – umožňuje aktivovat či deaktivovat licenci aplikace PyLoop Tag Manager.

SPRÁVCE TAGŮ

Dialogové okno umožňující přidávání, mazání, nebo správu tagů.

Typy tagů:

———-

• TEXT – Základní textový tag pro názvy, adresy, poznámky
• ČÍSLO –    Numerická hodnota, lze použít ve vzorcích. Jako oddělovač desetinných míst vyžaduje tečku.  
• VZOREC – Automaticky počítaný tag používající číselné tagy, nebo tagy typu vzorec.
• SUBJEKT – Vytvoří 3 spojené tagy pro právnickou, nebo fyzickou osobu podnikající (IČO+Název+Adresa). Při zadání platného IČ se data o názvu subjektu a adresa načtou z ARES.
• SOUBOR – Umožní přejmenovat soubory vzorů pomocí tagů umístěných v jejich názvu (tagy typu soubor přepisují tagy výhradně v názvu souboru)
• VÝBĚR – Vytvoří roletku s výběrem předdefinovatelných možností.
• TABULKA – Vytvoří tabulku s řádky a sloupci pro strukturovaná data – umožňuje načíst tabulky z DXF Prostorové analýzy, nebo vložit data z externí Excel tabulky (podporováno pouze ve vzorech s příponou .docx)
• OBRÁZEK – Tag pro vložení externího obrázku do dokumentu (podporováno pouze ve vzorech s příponou .docx)

Přidání nového tagu:

1. Klikněte Přidat nový tag

1. V novém dialogovém okně vyberte typ tagu

1. Vyplňte popisek a podobu tagu (popisek se automaticky bez diakritiky a velkými písmeny přepisuje do políčka tagu. Výslednou podobu tagu je následně možné upravit. Délka tagu se automaticky zkrátí na 30 znaků. Tag může obsahovat pouze písmena bez diakritiky, číslice a podtržítka. Každý tag musí být unikátní.
2. U vzorců zadejte matematický výraz, Případně u tabulkových tagů zvolte tabulku a její strukturu. Pro vytvoření tagu typu vzorec musí existovat alespoň jeden tag typu číslo.
3. Klikněte na Vytvořit. V případě, že kliknete na zrušit, žádný tag nebude vytvořen.

Mazání existujících tagů

Existující tag můžete smazat kliknutím pravým tlačítkem myši na příslušný tag ve Správci tagů a volbou smazat tag. Pomocí tlačítka shift můžete ve Správci tagů označit i několik tagů a ty smazat hromadně. Existující tagy je možné mazat i z hlavního uživatelského rozhraní – tedy formuláře, kam se vkládají hodnoty tagů (lze pouze jednotlivě).

POZOR! TATO AKCE JE NEVRATNÁ.

Vymazání hodnot tagů

Hodnotu tagu můžete vymazat kliknutím pravým tlačítkem myši na příslušný tag ve Správci tagů a volbou Vymazat hodnotu tagu. Pomocí tlačítka shift můžete ve Správci tagů označit i několik tagů a ty smazat hromadně. Existující hodnoty tagů je možné mazat i z hlavního uživatelského rozhraní – tedy formuláře, kam se vkládají hodnoty tagů (lze pouze jednotlivě).

POZOR! TATO AKCE JE NEVRATNÁ.

Změna pořadí tagů v hlavním uživatelském rozhraní a ve správci tagů.

Pomocí klinutí pravým tlačítkem na příslušný tag ve správci tagů, nebo v hlavním uživatelském rozhraní a vyvoláním kontextové nabídky lze libovolně měnit pořadí tagů.

KATEGORIE TAGŮ

Dialogové okno sloužící k vytváření uživatelských kategorií pro lepší organizaci tagů. Aplikace primárně umísťuje nové tagy do výchozí kategorie Základní tagy. V případě, že chcete pro tagy jinou kategorii než výchozí (například pro výpočty, nebo subjekty) můžete ve správci kategorií tagů vytvářet, editovat a mazat kategorie. Pro smazání musí být kategorie prázdná – pokud bude mazána kategorie obsahující tagy, ty budou přesunuty do výchozí kategorie Základní tagy. Výchozí kategorie nemůže být smazána. Ve správci kategorií tagů lze měnit pořadí kategorií, přiřazovat jim barvu pro lepší vizuální rozlišení a zvolit ikonku, která se bude zobrazovat v hlavním uživatelském rozhraní.

KONTROLA VZORŮ

Aplikace má vestavěnou funkci kontroly existujících vzorů. Tato funkce je přístupná z panelu s rychlými akcemi a umožňuje získat přehled o tazích použitých ve vzorech.

GENEROVÁNÍ DOKUMENTŮ

1. Příprava šablon

Vytvořte dokumenty se zástupnými symboly {NAZEV_TAGU}

Příklad: „Celková cena je {CELKOVA_CENA} Kč“

2. Výběr složky se vzory

Klikněte načíst vzory

Vyberte složku se vzory (v případě, že jste to již někdy v minulosti udělali, bude se automaticky používat poslední použitá složka)

3. Generování

V hlavním uživatelském rozhraní vyplňte hodnoty tagů.

Klikněte Generovat dokumenty

Vyberte složku, kam mají být dokumenty exportovány. Typicky to bývá složka s názvem Výstup, nebo Export.

Vygenerované soubory se za pár okamžiků objeví ve vybrané složce. Rychlost generování závisí na výkonu počítače a na množství a rozsahu vzorů.

VOLBY PŘI EXPORTU

Při samotném exportu máte možnost vybrat, které typy dokumentů se budou exportovat. Lze volit buď všechny dokumenty .docx, .xlsx, .dxf, nebo některé z nich. V případě, že složka se vzory neobsahuje některý z formátů, ale zůstane zaškrtnutá volba exportovat vše, chybějíc vzor prostě nebude exportován. Všechny ostatní vzory se vyexportují nezávisle na chybějícím. Před samotným exportem máte možnost vybrat si, co se stane s tagy, kterým nebyla v hlavním uživatelském rozhraní přidělena žádná hodnota. Chybějící tagy můžete nechat zažlutit, nebo odstranit. Ve většině případů doporučujeme zažlutit pro lepší kontrolu.

Rizika! Vzhledem k tomu, že Word někdy existující tagy nevhodně rozděluje do „runů“, je možné, že se zažlutí celý odstavec obsahující tag. Ze stejného důvodu je na místě opatrnost při volbě Odstranit ze vzoru. Pokud se pro volbu Odstranit ze vzoru rozhodnete, doporučujeme nejprve otestovat používané vzory.

TIPY A TRIKY

Matematické vzorce

Používejte operátory: +, -, *, /

Příklad: {DELKA} * {SIRKA} pro výpočet plochy

Podporováno: závorky, oddělovač desetinných míst (tečka)

Vzájemně lze kombinovat číselné tagy a tagy typu vzorec.

Pro dosažení nejlepších výsledků ve Word dokumentech doporučujeme důsledně kontrolovat výskyt skrytých znaků v těsné blízkosti tagů. Problematické jsou typicky konce stránek a konce oddílů navazující těsně na tag. Ideální je konec stránky / oddílu umístit až na další řádek.

Časté chyby

Tagy ve vzorech musejí přesně odpovídat tagům v aplikaci

Složka vzorů nesmí být stejná jako výstupní složka (aplikace má zabudovanou kontrolu)

Vzorce vyžadují existující číselné tagy

Verze: PyLoop Tag Manager 3.0.0

Vývojář: PyLoop Studio – www.pyloop.cz

Řešení problémů https://pyloop.cz/reseni-problemu/