CSV mapa přesměrování nejde načíst: jak opravit export

V Excelu jsou zdroj, cíl i kód ve správných sloupcích. Po exportu ale kontrola hlásí jiný počet polí, neuzavřené uvozovky nebo chybějící hlavičku. Nezačínejte mazáním adres: problém může být v předání souboru, nikoli v rozhodnutí o přesměrování.

CSV je text s pravidly pro oddělování hodnot. Vzhled otevřené tabulky sám nepotvrzuje, že tato pravidla zůstala při exportu zachovaná. Projdeme malý model, čtyři typické chyby a postup, který odliší nečitelný soubor od neplatného pravidla. Použijeme stávající kontrolu mapy přesměrování; nic se nenahrává na server ani nenastavuje na webu.

Rozlišujte formát souboru, hodnotu URL a logiku mapy

První vrstva je čitelnost tabulky. Nástroj musí rozpoznat sloupce a jednotlivé záznamy. Druhá vrstva je platnost jejich hodnot: zdroj má být úplná HTTP(S) adresa a kód musí být podporovaný. Třetí vrstva jsou vztahy mezi pravidly, například konflikt cílů nebo smyčka.

Pokud čtení CSV skončí chybou uvozovek, ještě nemáte výsledek kontroly všech přesměrování. Hlášení neříká, že jsou pravidla správná nebo špatná; nejprve potřebujete opravit strukturu předávaných dat. Teprve opakovaná kontrola se dostane k dalším vrstvám.

Nejistotu zapište přesně. „Export nejde načíst“ je jiný úkol než „vývojář má opravit konflikt přesměrování“. V prvním případě může být správný pracovní list a vadný export, ve druhém už tabulka obsahuje dvě odlišná rozhodnutí. Návazné řešení popisuje rozbor duplicit a konfliktů.

Začněte jedním správným řádkem

Pro ověření postupu si vezměte tuto modelovou mapu. První řádek je hlavička, středník odděluje hodnoty a poznámka je pomocný sloupec. Nástroj pro analýzu použije zdroj, cíl a kód; pomocná poznámka je zde kvůli ukázce formátu.

source;target;status;poznamka
https://example.com/stara/;https://example.com/nova/;301;"Schváleno; předat vývoji"

Středník v poznámce nevytváří další pole, protože celá hodnota je uzavřená v běžných dvojitých uvozovkách. V tomto modelu kontrola načte jeden záznam bez nálezu v mapě. To stále nepotvrzuje skutečnou dostupnost nové stránky; model pouze ukazuje správný vstup a jednoznačné pravidlo.

Pokud se vlastní export nenačte, porovnejte nejprve jeho hlavičku a první problémový záznam s tímto malým vzorem. Není nutné hned rozesílat celý produkční soubor. Pro hledání chyby často stačí bezpečná kopie se smyšlenými adresami, která zachová původní strukturu oddělovačů.

Jeden soubor má používat jeden způsob oddělení

Naše kontrola přijímá středník, čárku i tabulátor a volbu odvozuje z hlavičky. To však neznamená, že je můžete uvnitř jednoho exportu libovolně střídat. Hlavička se středníky a datový řádek oddělený čárkami neposkytují stejnou strukturu sloupců.

source;target;status
https://example.com/stara/,https://example.com/nova/,301

Výsledkem bude chyba počtu polí. Řešením není globálně nahradit všechny čárky středníkem. Čárka může být součástí skutečné hodnoty. Vraťte se k exportu správného listu a zvolte konzistentní formát. U ručně sestavené malé ukázky opravte pouze skutečné oddělovače mezi poli.

Přenos z tabulkového programu přes schránku může vytvořit tabulátory, zatímco uložený soubor používá středníky. Obě varianty mohou samostatně fungovat, ale nespojujte jejich řádky bez kontroly. Po sloučení podkladů znovu prověřte celou výslednou verzi, ne jen každý původní soubor zvlášť.

Uvozovky chrání hodnotu, nejsou jen dekorace

Pokud z prvního modelu odstraníte uvozovky kolem poznámky, její středník vytvoří další pole. Hlavička má čtyři sloupce, datový záznam jich má pět. Kontrola proto soubor odmítne ještě před výpočtem návazností.

source;target;status;poznamka
https://example.com/stara/;https://example.com/nova/;301;Schváleno; předat vývoji

Jiný problém nastane, když úvodní uvozovku ponecháte a závěrečnou ztratíte. Parser může až na konci zjistit, že pole nikdy neskončilo. Fyzický řádek souboru proto nemusí vždy odpovídat jednomu datovému záznamu; pole uzavřené uvozovkami může obsahovat i zalomení.

Nenahrazujte běžné uvozovky typografickými. Znaky používané v souvislém českém textu nejsou totéž co syntaktický znak dvojité uvozovky. Uvozovka uvnitř uzavřeného pole se v běžném CSV zapisuje zdvojením. Konkrétní export má toto ošetřit za vás; ruční přepisování dlouhé mapy je zbytečně náchylné k dalším chybám.

Hlavička patří na první datový řádek

Nad pracovní tabulkou může být v sešitu název projektu, datum nebo poznámka pro kolegu. Do vstupního CSV ale nezařazujte nad hlavičku dekorativní titulek. Nástroj očekává názvy sloupců na začátku, nikoli jejich hledání někde uprostřed dokumentu.

Stejně tak zkontrolujte, že exportujete správný list. Šablona mapy má pracovní mapu a návod; návod není seznam přesměrování. Přejmenování souboru na CSV z něj také neudělá textový export, pokud uvnitř zůstane původní formát sešitu.

• Hlavička má rozlišovat zdroj a cíl: doporučené názvy jsou source a target.
• Volitelný status obsahuje plánovaný kód; bez tohoto sloupce nástroj předpokládá 301.
• Názvy sloupců neopakujte. Dvojí source je nejednoznačné i tehdy, když jsou hodnoty stejné.
• Pomocné sloupce smějí zůstat, pokud mají vlastní názvy a každý záznam odpovídá jejich počtu.

Kódování kontrolujte na skutečném textu

Pro tento nástroj připravte textové CSV UTF-8. Pokud české znaky po otevření vypadají poškozeně, neposuzujte chybu jen podle jedné aplikace: může špatně zvolit kódování při čtení. Ověřte, co bylo skutečně vyexportováno a s jakým nastavením soubor otevíráte.

Chybně převedenou URL neopravujte podle odhadu. Znovu porovnejte původní hodnotu v pracovním listu a text po exportu. Pokud se změnil znak uvnitř cesty nebo parametru, měníte identitu popsaného vstupu. Podrobnosti významu hodnot rozebírá článek o parametrech URL.

Naše implementace toleruje úvodní značku BOM, takže její samotná přítomnost není důvod mazat první znak viditelné hlavičky. Naproti tomu nepovolené řídicí znaky mohou čtení zastavit. V takovém případě znovu vytvořte čistý textový export; nezkoušejte z binárního souboru ručně vyřezávat jednotlivé znaky.

Velký export rozdělte podle pracovního smyslu

Kontrola má limit dvou tisíc záznamů, třiceti dvou sloupců a délky jednoho pole. Tyto hranice chrání lokální výpočet. Jejich překročení neznamená, že máte z tabulky náhodně odstranit potřebné URL nebo zkrátit cílové adresy.

Odstraňte nepotřebné pomocné sloupce, nikoli rozhodující část zdroje. Je-li mapa větší, rozdělte ji na zdokumentované části a počítejte s tím, že samostatné kontroly neuvidí návaznosti mezi soubory. Pravidla sdílející zdroje nebo navazující cíle proto vyžadují zvláštní společnou kontrolu odpovídajícím postupem.

Rozdělení mapy není důkaz bezchybnosti celku. To je stejný princip jako u smyčky vzniklé sloučením podkladů. Do předání napište, které části byly posouzené společně a kde zůstávají vazby mimo rozsah použitého nástroje.

Číslo záznamu neberte automaticky jako řádek Excelu

Když hlášení uvádí problém u určitého záznamu, dohledávejte jej podle významu daného hlášení. Hlavička není přesměrovací pravidlo a prázdné řádky nemusí být datové záznamy. Navíc poznámka uzavřená v uvozovkách může v textovém souboru zabírat více fyzických řádků. Posun o jeden řádek proto není důkaz, že nástroj ukazuje na jinou URL.

Pracovní tabulce můžete přidat vlastní stabilní ID jako pomocný sloupec. Při vyšetřování se pak opřete o úplný zdroj, cíl a vlastní označení, nikoli jen o aktuální pořadí po seřazení. Při exportu výsledků si ověřte, které údaje nástroj skutečně vrací; neslibuje zachování každého pomocného sloupce z původního listu.

Pokud po opravě vznikne nové hlášení, neznamená to nutně zhoršení mapy. Parser se mohl poprvé dostat ke zbytku dat, který předtím kvůli neuzavřenému poli vůbec nešlo rozdělit. Uchovejte oba výstupy a popište, že první kontrola skončila ve fázi čtení, zatímco druhá už posuzovala pravidla.

Jak připravit malý příklad pro předání chyby

Zkopírujte hlavičku a nejmenší část, která problém stále vyvolává. Nahraďte soukromé adresy modelovou doménou, ale ponechte přesné oddělovače, uvozovky a počet pomocných polí. Když odstraníte samotný problémový znak, kolega už chybu nezopakuje a bude řešit jiný soubor.

Připojte očekávaný počet záznamů a doslovnou chybovou zprávu. Uveďte také, zda šlo o výběr souboru, nebo vložení textu do pole. Ověřte svůj malý příklad znovu stejnou cestou; není poctivé tvrdit, že chyba zůstává reprodukovatelná, pokud jste upravený model nezkontrolovali.

Po vyřešení vytvořte čerstvý export původní mapy a analyzujte ho celý. Oprava krátkého modelu ještě nedokládá, že v dlouhém souboru nejsou další poškozená pole. Do evidence patří finální skutečně kontrolovaná verze, ne jen screenshot pomocné ukázky.

Pět kontrol před odesláním kolegovi

1. Otevřete výsledný export jako text a ověřte správnou hlavičku i jeden řádek s poznámkou.
2. Porovnejte několik úplných zdrojů a cílů s pracovním listem, včetně parametrů a citlivých znaků.
3. Spusťte novou kontrolu přesně nad souborem určeným k předání.
4. Uložte verzi vstupu a odpovídající výstup, aby kolega mohl nález zopakovat.
5. Odlište úspěšné načtení CSV od následného schválení a nasazení přesměrování.

Před dalším otevřením exportu také věnujte pozornost tomu, jak tabulkový program interpretuje buňky. Zdejší export výsledků obsahuje ochranu proti hodnotám vyhodnotitelným jako vzorce, ale následná úprava nebo nový export může tuto ochranu změnit. Výsledky otevírejte jako data a nepovažujte pouhé znovuuložení za neutrální krok. Po důležitém převodu porovnejte skutečné hodnoty s původním výstupem.

Do předávacího záznamu připište, zda kolega dostává původní pracovní mapu, nebo export výsledků analýzy. Tyto soubory mají jiný účel a jinou hlavičku. Záměna dvou podobně pojmenovaných CSV může vyvolat chybu i při správném kódování a uzavření polí.

Cvičení: čtyři sloupce, ale pět hodnot

Hlavička obsahuje source, target, status a poznamka. Nástroj odmítne řádek s textem poznámky „původní článek; sloučeno do poradny“. Kolega navrhuje smazat problematickou URL. Co má být první oprava?

Zobrazit řešení CSV chyby

Prověřte, zda je celá poznámka správně uzavřená v běžných dvojitých uvozovkách. Její středník nemá vytvořit další sloupec. Obnovte korektní export, ponechte zdroj i cíl a spusťte kontrolu znovu. Teprve po úspěšném načtení posuzujte pravidla mapy. Smazání URL by změnilo řešený rozsah a chybu předání pouze skrylo.

Výsledkem není jen soubor, který „Excel otevře“. Potřebujete věrný textový přenos schválených hodnot a opakovatelný výsledek analýzy. Pokud se během exportu něco změnilo, zapište konkrétní krok do evidence nálezů, aby se stejná chyba nevrátila s další verzí podkladů.

Časté otázky

Proč CSV hlásí jiný počet polí než tabulka?

Zkontrolujte konzistentní oddělovač a uzavření hodnot v běžných dvojitých uvozovkách. Oddělovač uvnitř neuzavřené poznámky vytvoří další pole. Nejdřív opravte export; smazání problémové URL by pouze změnilo rozsah mapy.

Jak má vypadat hlavička mapy přesměrování?

Doporučený základ je source;target;status. Pomocné sloupce mají mít vlastní názvy a každý záznam odpovídající počet polí. Nad hlavičku nevkládejte titulek projektu ani návod z jiného listu.

Potvrzuje úspěšné načtení správnost přesměrování?

Nepotvrzuje. Úspěšné čtení CSV je první vrstva. Následuje kontrola platnosti hodnot a vztahů mezi pravidly, obsahové schválení cílů a po nasazení skutečné ověření odpovědí serveru.