Ř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

1. Problémy s tagy v DOCX dokumentech
2. Problémy při nahrazování tagů
3. Problémy s Excel soubory
4. Problémy s kategoriemi
5. Problémy s exportem
6. Problémy s importem dat
7. 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

• 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í: 

1. Cesta k obrázku musí být platná a soubor musí existovat
2. 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í:

1. Tagy nejsou správně formátované:

   • Zkontrolujte, že tagy mají formát {NAZEV}
   • Nesmí obsahovat mezery uvnitř závorek

2. Tagy jsou rozdělené (viz výše):

   • Přepište tagy znovu

3. 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)

4. 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í:

1. 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

2. Funkce funguje v:

   • DOCX souborech (plně podporováno)
   • Excel souborech (.xlsx, .xls)
   • DXF souborech 

Tabulka se nevložila správně

Problém: Tag pro vložení tabulky (např. {TABLE_DATA}) nefunguje nebo se tabulka zobrazuje chybně.

Řešení:

1. Zkontrolujte cestu k souboru s tabulkou. Tabulka musí existovat.

2. 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:

1. Soubor byl otevřený během zpracování
2. Nedostatečná oprávnění k zápisu
3. 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 .xlsx soubory by se formátování mělo zachovat
• Pro staré .xls soubory 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í:

1. Nejdřív přesuňte všechny tagy z kategorie do jiné kategorie nebo do „Základní  kategorie“
2. Teprve potom smažte prázdnou kategorii

Tagy se nepřesunuly do kategorie

Problém: Přetažení tagu do kategorie nefunguje.

Řešení:

1. 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

2. 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í:

1. Cesta k šabloně neexistuje:

   • Zkontrolujte, že cesta k šabloně DOCX je správná
   • Soubor šablony musí existovat a být přístupný

2. 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í

3. Šablona je poškozená:

   • Zkuste otevřít šablonu v Microsoft Word
   • Pokud nejde otevřít, je poškozená

4. 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í:

1. Zkontrolujte zdrojová data (CSV, Excel)
2. Ověřte, že názvy sloupců přesně odpovídají názvům tagů
3. Zkontrolujte kódování CSV souboru (mělo by být UTF-8)
4. 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í:

1. Š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)“

2. Chybí hlavička:

   • První řádek musí obsahovat názvy sloupců
   • Názvy sloupců by měly odpovídat názvům tagů

3. Nesprávný oddělovač:

   • Aplikace očekává čárku (,) jako oddělovač
   • Pokud váš CSV používá jiný oddělovač (;), upravte ho

4. 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í:

1. Uložte CSV jako „UTF-8“ kódování
2. V aplikaci Excel:
   • Soubor → Uložit jako
   • Typ souboru: „CSV UTF-8 (Comma delimited) (*.csv)“
3. 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:

1. Velký projekt s mnoha tagy
2. Kontrola licence při startu
3. 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í:

1. Používejte „Uložit projekt“ z menu Soubor
2. Zkontrolujte, že máte práva k zápisu do složky projektu
3. 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í:

1. Přečtěte si popis chyby ve validátoru
2. Pro rozdělené tagy použijte řešení z první sekce tohoto dokumentu
3. Pro duplicitní tagy: odstraňte nebo přejmenujte jeden z nich
4. Pro neshody: upravte názvy tagů tak, aby odpovídaly

Tipy pro bezproblémové používání

Osvědčené postupy

1. 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

2. 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ů

3. Při práci s daty:

   • Používejte UTF-8 kódování
   • Udržujte konzistentní názvy sloupců
   • Kontrolujte data před importem

4. 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:

1. Zkuste restartovat aplikaci:
   • Někdy pomůže jednoduchý restart

2. 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