ŘEŠENÍ PROBLÉMŮ - PYLOOP TAG MANAGER
Tento dokument obsahuje řešení nejčastějších problémů, se kterými se můžete setkat při používání PyLoop Tag Manager.
📋 Obsah
- Problémy s tagy v DOCX dokumentech
- Problémy při nahrazování tagů
- Problémy s Excel soubory
- Problémy s kategoriemi
- Problémy s exportem
- Problémy s importem dat
- Obecné problémy
Problémy s tagy v DOCX dokumentech
❌ Tag se jeví v pořádku, ale aplikace ho nenašla
Problém: Vytvořili jste tag v Microsoft Word (např. {NAZEV}), vizuálně vypadá správně, ale PyLoop Tag Manager ho nedetekuje nebo ho nemůže nahradit.
Příčina: Microsoft Word interně rozděluje text do tzv. „runs“ (úseků textu se stejným formátováním). Pokud během psaní tagu změníte formátování, opravíte překlep, nebo Word automaticky provede korekci, může se stát, že tag je vizuálně v pořádku, ale interně je rozdělen do několika částí.
Příklad interní struktury:
Vizuálně vidíte: {NAZEV}
Word má interně: {NAZ + EV} (rozděleno do 2 runs)
Řešení:
Nejjednodušší řešení – Přepsat tag:
- Smažte celý problematický tag
- Napište ho najednou znovu bez přerušení
- Nepoužívejte během psaní: backspace, copy-paste, změnu formátování
Kontrola formátování:
- Označte celý tag včetně složených závorek
{} - Zkontrolujte, zda nemá tag různé formátování uvnitř
- V pásu nástrojů Word zkontrolujte, zda celý tag má stejné: písmo, velikost, barvu, tučnost, kurzívu
- Pokud ne, sjednoťte formátování označením celého tagu a nastavením stejného stylu
- Označte celý tag včetně složených závorek
Použití nástroje „Vymazat formátování“:
- Označte problematický tag
- V aplikaci Word použijte funkci „Vymazat formátování“ (Clear Formatting)
- Tag přepište znovu
Kopírování z poznámkového bloku:
- Zkopírujte text s tagem do Poznámkového bloku (Notepad)
- Zkopírujte ho zpět do Wordu
- Tímto odstraníte všechno skryté formátování
- Kopírování z aplikace:
- Levým tlačítkem myši klikněte na popisek tagu v hlavním rozhraní aplikace, tag se automaticky zkopíruje do schránky
- Pomocí crtl+v vložte zkopírovaný tag do .docx
- Tímto odstraníte všechno skryté formátování
Prevence:
- Tagy pište vždy najednou bez přerušení
- Neměňte formátování uprostřed psaní tagu
- Pokud používáte copy-paste pro tagy, zkopírujte vždy celý tag najednou
- Po zkopírování tagu vložte pomocí „Vložit jen text“ (Paste as Plain Text)
⚠️ Tag se zobrazuje nesprávně po nahrazení
Problém: Po nahrazení tagu hodnotou se text zobrazuje nesprávně (jiné písmo, velikost, barva).
Příčina: Aplikace zachovává formátování prvního „run“ tagu.
Řešení:
- Před nahrazením označte celý tag a nastavte požadované formátování
- Ujistěte se, že celý tag má jednotné formátování
🔤 Tag obsahuje speciální znaky nebo mezery
Problém: Tag obsahuje nechtěné mezery nebo speciální znaky (např. { NAZEV } místo {NAZEV}).
Příčina: Mezery nebo neviditelné znaky uvnitř složených závorek.
Řešení:
- Aplikace automaticky čistí některé mezery, ale je lepší tagy psát bez mezer
- Formát tagu:
{NAZEV}ne{ NAZEV } - Používejte pouze alfanumerické znaky a podtržítka v názvech tagů
📝 Tag v záhlaví nebo zápatí nefunguje
Problém: Tag v záhlaví nebo zápatí dokumentu se nenahrazuje.
Řešení:
- Aplikace podporuje tagy v záhlaví a zápatí
- Zkontrolujte, zda tag není rozdělen (viz první problém výše)
- Ujistěte se, že používáte správný formát tagu
{NAZEV} - Tagy v tabulkách v záhlaví/zápatí jsou také podporován
🖼️ Tag pro obrázek nefunguje správně
Problém: Tag pro vložení obrázku (např. {IMG_LOGO}) se nenahrazuje obrázkem.
Příčina: Nesprávná konfigurace tagu pro obrázky v datech.
Řešení:
- Cesta k obrázku musí být platná a soubor musí existovat
- Podporované formáty: PNG, JPG, JPEG
Problémy při nahrazování tagů
❌ Žádné tagy se nenahradily
Problém: Po spuštění nahrazení se nenahradil žádný tag.
Možné příčiny a řešení:
Tagy nejsou správně formátované:
- Zkontrolujte, že tagy mají formát
{NAZEV} - Nesmí obsahovat mezery uvnitř závorek
- Zkontrolujte, že tagy mají formát
Tagy jsou rozdělené (viz výše):
- Přepište tagy znovu
Neshodné názvy:
- Zkontrolujte, že názvy tagů v dokumentu přesně odpovídají názvům v seznamu tagů
- Tagy jsou case-sensitive (záleží na velikosti písmen)
Prázdná data:
- Zkontrolujte, že máte vyplněné hodnoty pro tagy
- Prázdné tagy se buď zvýrazní žlutě nebo smažou (podle nastavení)
🎨 Prázdné tagy se nezvýraznily ani nesmazaly
Problém: Tagy s prázdnou hodnotou se nezvýraznily žlutě ani neodstranily z dokumentu.
Řešení:
Zkontrolujte nastavení „Prázdné tagy“:
- Možnost „Zvýraznit žlutě“ – prázdné tagy zůstanou v dokumentu a budou žluté
- Možnost „Smazat“ – prázdné tagy budou odstraněny z dokumentu
Funkce funguje v:
- ✅ DOCX souborech (plně podporováno)
- ✅ Excel souborech (.xlsx, .xls)
- ❌ DXF souborech (prozatím nepodporováno)
📊 Tabulka se nevložila správně
Problém: Tag pro vložení tabulky (např. {TABLE_DATA}) nefunguje nebo se tabulka zobrazuje chybně.
Řešení:
Zkontrolujte cestu k souboru s tabulkou. Tabulka musí existovat.
Tag musí být na samostatném řádku v dokumentu
Problémy s Excel soubory
📊 Excel soubor se neotevírá po zpracování
Problém: Excel soubor je po zpracování poškozený nebo se neotevírá.
Možné příčiny:
- Soubor byl otevřený během zpracování
- Nedostatečná oprávnění k zápisu
- Poškozený vstupní soubor
Řešení:
- Zavřete Excel soubor před zpracováním
- Zkontrolujte, že máte práva k zápisu do výstupní složky
- Zkuste zpracovat nový, nepoškozený soubor
⚠️ Formátování se v Excelu ztratilo
Problém: Po nahrazení tagů v Excelu se ztratilo původní formátování (barvy, rámečky, atd.).
Vysvětlení:
- Pro
.xlsxsoubory by se formátování mělo zachovat - Pro staré
.xlssoubory může dojít ke ztrátě některých pokročilých formátů
Řešení:
- Používejte moderní formát
.xlsx - Pokud potřebujete zachovat složité formátování, vytvořte si šablonu s formátováním a používejte tagy pro data
Problémy s kategoriemi
📁 Kategorie se nesmaže
Problém: Pokud se pokusíte smazat kategorii, zobrazí se chyba nebo kategorie zůstane.
Příčina: Kategorie obsahuje tagy.
Řešení:
- Nejdřív přesuňte všechny tagy z kategorie do jiné kategorie nebo do „Základní kategorie“
- Teprve potom smažte prázdnou kategorii
🔄 Tagy se nepřesunuly do kategorie
Problém: Přetažení tagu do kategorie nefunguje.
Řešení:
Použijte kontextové menu (pravé tlačítko myši):
- Klikněte pravým tlačítkem na tag
- Vyberte „Přesunout do kategorie“
- Zvolte cílovou kategorii
Nebo použijte správce kategorií:
- Menu: Nástroje → Správce kategorií
- Tam můžete spravovat všechny kategorie a jejich tagy
Problémy s exportem
💾 Export nefunguje nebo končí chybou
Problém: Při exportu dokumentů dojde k chybě nebo se nevytvoří žádné soubory.
Možné příčiny a řešení:
Cesta k šabloně neexistuje:
- Zkontrolujte, že cesta k šabloně DOCX je správná
- Soubor šablony musí existovat a být přístupný
Výstupní složka neexistuje:
- Ujistěte se, že výstupní složka existuje
- Aplikace by měla vytvořit složku automaticky, ale zkontrolujte oprávnění
Šablona je poškozená:
- Zkuste otevřít šablonu v Microsoft Word
- Pokud nejde otevřít, je poškozená
Nedostatečná oprávnění:
- Zkontrolujte, že máte práva k zápisu do výstupní složky
📝 Vygenerované dokumenty mají špatná data
Problém: Dokumenty se vygenerovaly, ale obsahují nesprávné hodnoty.
Řešení:
- Zkontrolujte zdrojová data (CSV, Excel)
- Ověřte, že názvy sloupců přesně odpovídají názvům tagů
- Zkontrolujte kódování CSV souboru (mělo by být UTF-8)
- Ujistěte se, že nemáte v datech extra mezery nebo speciální znaky
Problémy s importem dat
📥 Import CSV/Excel selhal
Problém: Při importu dat z CSV nebo Excel souboru došlo k chybě.
Možné příčiny a řešení:
Špatné kódování CSV:
- CSV soubor musí být v kódování UTF-8
- V Excelu při ukládání jako CSV vyberte „CSV UTF-8 (Comma delimited)“
Chybí hlavička:
- První řádek musí obsahovat názvy sloupců
- Názvy sloupců by měly odpovídat názvům tagů
Nesprávný oddělovač:
- Aplikace očekává čárku (,) jako oddělovač
- Pokud váš CSV používá jiný oddělovač (;), upravte ho
Prázdné buňky:
- Prázdné buňky jsou v pořádku
- Pro prázdné hodnoty se použije prázdný řetězec
🔤 Diakritika se zobrazuje nesprávně
Problém: Po importu se česká diakritika zobrazuje jako podivné znaky (např. á místo á).
Příčina: Špatné kódování souboru.
Řešení:
- Uložte CSV jako „UTF-8“ kódování
- V aplikaci Excel:
- Soubor → Uložit jako
- Typ souboru: „CSV UTF-8 (Comma delimited) (*.csv)“
- Nebo použijte Notepad++:
- Kódování → Převést na UTF-8
Obecné problémy
🚀 Aplikace se pomalu spouští
Možné příčiny:
- Velký projekt s mnoha tagy
- Kontrola licence při startu
- Načítání modulů
Řešení:
- Aplikace má splash screen, počkejte na načtení
- Pro velké projekty je načítání delší (normální chování)
💾 Projekt se neuložil
Problém: Změny v projektu se neukládají.
Řešení:
- Používejte „Uložit projekt“ z menu Soubor
- Zkontrolujte, že máte práva k zápisu do složky projektu
- Při zavírání aplikace budete dotázáni na uložení neuložených změn
❓ Tag se v seznamu nezobrazuje
Problém: Přidali jste tag, ale nezobrazuje se v seznamu.
Možné příčiny a řešení:
Zkontrolujte, zda nemáte aktivní filtr.
🔍 Validace tagů hlásí chyby
Problém: Validátor tagů hlásí chyby, i když tagy vypadají v pořádku.
Vysvětlení: Validátor kontroluje:
- Správný formát tagů
{NAZEV} - Shodu tagů v dokumentu s tagy v seznamu
- Prázdné hodnoty
- Duplicitní tagy
- Rozdělené tagy (nejčastější problém!)
Řešení:
- Přečtěte si popis chyby ve validátoru
- Pro rozdělené tagy použijte řešení z první sekce tohoto dokumentu
- Pro duplicitní tagy: odstraňte nebo přejmenujte jeden z nich
- Pro neshody: upravte názvy tagů tak, aby odpovídaly
💡 Tipy pro bezproblémové používání
✅ Osvědčené postupy
Při vytváření tagů v dokumentech:
- Pište tagy najednou bez přerušení
- Neměňte formátování uprostřed psaní tagu
- Používejte copy-paste celého tagu, ne po částech
Před zpracováním dokumentů:
- Zavřete všechny DOCX/Excel soubory
- Ověřte, že máte záložní kopii důležitých souborů
- Spusťte validátor tagů
Při práci s daty:
- Používejte UTF-8 kódování
- Udržujte konzistentní názvy sloupců
- Kontrolujte data před importem
Organizace práce:
- Používejte kategorie pro logické seskupení tagů
- Pravidelně ukládejte projekt
- Pro velké projekty vytvářejte šablony
🆘 Stále máte problém?
Pokud váš problém není v tomto dokumentu:
- Zkuste restartovat aplikaci:
- Někdy pomůže jednoduchý restart
Kontaktujte podporu:
- Uveďte přesný popis problému
- Připojte screenshot chyby (pokud je to možné)
- Uveďte verzi aplikace
📚 Související dokumentace
- Video tutoriály
- Často kladené otázky (FAQ)
- Novinky a aktualizace
Poslední aktualizace: Listopad 2025