Přehled kolizí při nahrávání a zpracování v Národním archivním portále
Obsah
1. Úvod
2. Kolize při nahrávání na portál (modul eVýběr z datových balíčků SIP, ePředání datových balíčků SIP)
3. Kolize při zpracování datových balíčků SIP – modul ePředání
4. Aktualizace komponent v návaznosti na předchozí procesy (eVýběr, ePředání)
5. Kolize při zpracování datových balíčků SIP – modul eVýběr
6. Nahrávání volných souborů (mimo eSSL)
| verze | Datum | Popis změn |
| 001 | 9. 3. 2021 | Vložen přehled |
| 002 | 8. 12. 2021 | Doplněny kolize a vysvětlení |
| 003 | 3. 11. 2022 | Doplněny interní kolize, upraveny popisy chyb |
| 004 | 19. 5. 2023 | Přidána kolize V1414 |
1. Úvod
Při kontrole SIP na Národním archivním portále (dále též „NArP“) se uplatňují dvě úrovně ověření zpracovatelnosti:
- Kontrola validátorem SIP Národního archivu. Pravidla pro validaci jsou zveřejňována v Přehledu pravidel pro validaci SIP v příslušné verzi
- Kontroly (kolize) v NArP.
Spíše než o kontroly se jedná o kolize vznikající při zpracování všech SIP najednou, v kontextu a v konkrétním řízení.
Vyvolány mohou být nesouladem v metadatech či komponentách. Např. se může jednat o vícekrát použitý totožný „jednoznačný“ identifikátor s různým obsahem, nesoulad v hodnotách při vyžádání komponent nebo při předávání za archiválie vybraných SIP, při předání SIP k trvalému uložení jsou nahrány SIP obsahující jiné než vybrané dokumenty atd.
Oznámeny jsou uživatelům reportem „Chyby importu“, společně s výsledky z validátoru SIP, ihned po nahrání každé dávky.
Při řešení problému je vhodné analyzovat situaci s dodavatelem eSSL, příp. se obrátit na helpnda@nacr.cz, s uvedením čísla řízení, kde kolize nastala, stručným popisem kroků, jak a v jaké situaci ke kolizi došlo. Při přezkoumání je většinou nutné dodat i SIP balíčky, které kolizi vyvolávají.
Stejně jako ve validátoru SIP, i zde se můžete setkat se dvěma úrovněmi hlášení:
- Chyba -> SIP balíček/soubor nebude zpracováván, na portál nelze nahrát
- Upozornění -> SIP balíček lze zpracovat, jedná se o upozornění na potenciální problém, je v kompetenci archiváře zhodnotit, zda z metodického hlediska lze dále pokračovat ve výběru nebo přejímce. Při trvalém uložení bude uloženo s hlášeným jevem.
Pro předání archiválií se můžete setkat ještě se stavem - S výhradou -> ten nastává tehdy, kdy je k předání k trvalému uložení v archivu vkládána komponenta, která není v souladu s Formátovými pravidly NA. Řešením v tom případě je dodat ke stávající komponentě i komponentu pravidlům odpovídající (často ve výstupním datovém formátu dle § 23 vyhlášky 259/2012 Sb.)
2. Kolize při nahrávání na portál (modul eVýběr z datových balíčků SIP, ePředání datových balíčků SIP)
| Vypsané hlášení | kód stavu | Možná příčina | Důsledek chyby, příp. možné řešení |
| Soubor neprošel antivirovou kontrolou | 3 | V souboru byla nalezena potenciální hrozba. | Chyba Soubor nebude zpracováván. |
| Mets.xml nečitelný, zip nečitelný | 3 | Soubory jsou pro system nečitelné, pravděpodobně nebyl nahrán relevantní obsah. | Chyba Soubor nebude zpracováván. |
| chybná struktura souborů | 3 | Nebyl rozpoznán SIP. Např. v režimu nahrávání SIP byl uploadován pouze soubor neodpovídající structuře SIP, např. jakýkoliv samostatný soubor | Chyba Soubor nebude zpracováván, v řízení se může pokračovat |
| upozornění – znak(y) ve jméně podřízeného souboru nepatří do české abecedy | 4 | V názvech souborů se vyskytují nečeské znaky, např. å, ð apod. | Upozornění. SIP bude běžně zpracován. |
| SIP byl přepsán | Bez kódu | Nahráván SIP, jehož obsah (spis, dokument) se shoduje s již dříve nahrávanými entitami, bez ohledu na název SIPu. | Upozornění SIP bude běžně zpracován, je použit posledně nahraný SIP.. |
3. Kolize při zpracování datových balíčků SIP – modul ePředání
| Vypsané hlášení | kód stavu | Možná příčina | Důsledek chyby, příp. možné řešení |
| import obsahuje neznámý soubor | V1200 | import obsahuje neznámý soubor Zkontrolujte sadu SIP, kterou nahráváte. | Kolize v ePředání, daný SIP nebude do ePředání přijat, je možné nahrávat opravený znovu. |
| jednací číslo archivu není vyplněno | V1201 | jednací číslo archivu není vyplněno | Kolize v ePředání, daný SIP nebude do ePředání přijat, je možné nahrávat opravený znovu. |
| přejímající archiv není vyplněn | V1202 | přejímající archiv není vyplněn | Kolize v ePředání, daný SIP nebude do ePředání přijat, je možné nahrávat opravený znovu. |
| předávající osoba není vyplněna | V1203 | předávající osoba není vyplněna | Kolize v ePředání, daný SIP nebude do ePředání přijat, je možné nahrávat opravený znovu. |
| zařazení nemá vyplněny všechny hodnoty | V1204 | zařazení nemá vyplněny všechny hodnoty | Kolize v ePředání, daný SIP nebude do ePředání přijat, je možné nahrávat opravený znovu. |
| základní entita nemá platný typ | V1205 | základní entita nemá platný typ | Kolize v ePředání, daný SIP nebude do ePředání přijat, je možné nahrávat opravený znovu. |
| Kolize při předání archiválií: SIP (soubor) nebyl v tomto skartačním řízení vybrán za archiválii. | V1206 | vybraná archiválie nebyla nalezena (např. do ePředání byla nahrána entita/SIP, soubor/, která nebyla vybrána za archiválii) .Zkontrolujte sadu SIP, kterou nahráváte .Pokud jsou tyto soubory nahrány „navíc“, není nutné nic dalšího nahrávat ani opravovat | Kolize v ePředání, daný SIP nebude do ePředání přijat, je možné nahrávat opravený znovu. |
| vybrané archiválie nového SIPu odkazují do více existujících SIPů | V1207 | vybrané archiválie nového SIPu odkazují do více existujících SIPů | Kolize v ePředání, daný SIP nebude do ePředání přijat, je možné nahrávat opravený znovu. |
| SIP má více odkazů na stejnou vybranou archiválii | V1208 | SIP má více odkazů na stejnou vybranou archiválii | Kolize v ePředání, daný SIP nebude do ePředání přijat, je možné nahrávat opravený znovu. |
| Kolize při předání archiválií: Tento SIP (soubor) neobsahuje všechny vybrané archiválie (např. chybí dokument, komponenta). Opravený SIP nahrajte, prosím, znovu. | V1209 | při pokusu o napárování na existující SIP se nepodařilo nalézt všechny vybrané archiválie | Kolize v ePředání, daný SIP nebude do ePředání přijat, je možné nahrávat opravený znovu. |
| nepodařilo se napárovat novou úroveň popisu | V1210 | nepodařilo se napárovat novou úroveň popisu (např. existuje nesoulad mezi očekávaným SIP a nahraným SIP, může být rozpor v metadatech, nelze napárovat identifikátory entit) | Kolize v ePředání, daný SIP nebude do ePředání přijat, je možné nahrávat opravený znovu. |
| nepodařilo se napárovat původní úroveň popisu | V1211 | nepodařilo se napárovat původní úroveň popisu (obsah prvků neodpovídá očekávanému nebo chybí prvek povinný prvek, který ve Výběru byl zahrnut; mezi metadaty zaslanými do eVýběru a do ePředání jsou takové rozdíly, že nebyla rozpoznána shoda | Kolize v ePředání, daný SIP nebude do ePředání přijat, je možné nahrávat opravený znovu. |
| vybraná archiválie není přiřazena k platnému SIPu | V1212 | vybraná archiválie není přiřazena k platnému SIPu | Kolize v ePředání, daný SIP nebude do ePředání přijat, je možné nahrávat opravený znovu. |
| nebyla nalezena žádná vybraná archiválie | V1213 | nebyla nalezena žádná vybraná archiválie | Kolize v ePředání, daný SIP nebude do ePředání přijat, je možné nahrávat opravený znovu. |
| SIP s aktualizovanými komponentami obsahuje úpravy archivního popisu | V1221 | UPOZORNĚNÍ SIP s aktualizovanými komponentami obsahuje úpravy archivního popisu {levelName=xxx [Puvodce=xxx,CisloJednaci=03673/13/Star/Pav], fieldNames=datace} | Upozornění SIP bude dále zpracováván, pouze se upozorňuje na změnu v metadatech |
4. Aktualizace komponent v návaznosti na předchozí procesy (eVýběr, ePředání)
| Vypsané hlášení | kód stavu | Možná příčina | Důsledek chyby, příp. možné řešení |
| zdrojová komponenta nemá id původce | V0600 | zdrojová komponenta nemá id původce | Kolize při aktualizaci komponent, daný SIP nebude zpracováván; je možné nahrát opravenou verzi, pravděpodobný nesoulad při generování SIP |
| zdrojová komponenta nemá unikátní id původce | V0601 | zdrojová komponenta nemá unikátní id původce | Kolize při aktualizaci komponent, daný SIP nebude zpracováván; je možné nahrát opravenou verzi, pravděpodobný nesoulad při generování SIP |
| pro zdrojovou komponentu se nepodařilo nalézt cílovou úroveň | V0602 | pro zdrojovou komponentu se nepodařilo nalézt cílovou úroveň | Kolize při aktualizaci komponent, daný SIP nebude zpracováván; je možné nahrát opravenou verzi, pravděpodobný nesoulad při generování SIP |
| cílová komponenta nemá id původce | V0603 | cílová komponenta nemá id původce | Kolize při aktualizaci komponent, daný SIP nebude zpracováván; je možné nahrát opravenou verzi, pravděpodobný nesoulad při generování SIP |
| cílová komponenta nemá unikátní id původce | V0604 | cílová komponenta nemá unikátní id původce | Kolize při aktualizaci komponent, daný SIP nebude zpracováván; je možné nahrát opravenou verzi, pravděpodobný nesoulad při generování SIP |
| pro cílovou komponentu nebyla nalezena aktualizace | V0605 | pro cílovou komponentu nebyla nalezena aktualizace (např. při nesouladu identifikátorů komponent při nahrávání do předání) | Kolize při aktualizaci komponent, daný SIP nebude zpracováván; je možné nahrát opravenou verzi, pravděpodobný nesoulad při generování SIP |
| cílová komponenta byla napárována na jinou část zdrojového stromu nežli její sourozenci | V0606 | cílová komponenta byla napárována na jinou část zdrojového stromu nežli její sourozenci | Kolize při aktualizaci komponent, daný SIP nebude zpracováván; je možné nahrát opravenou verzi, pravděpodobný nesoulad při generování SIP |
5. Kolize při zpracování datových balíčků SIP – modul eVýběr
| Vypsané hlášení | kód stavu | Možná příčina | Důsledek chyby, příp. možné řešení |
| import obsahuje neznámý soubor | V1400 | import obsahuje neznámý soubor | Kolize v eVýběru, daný SIP nebude nahrán ani zobrazen, v eVýběru zůstává původní verze SIPu. Nutno nahrát SIP s odpovídajícími komponentami. |
| Kolize při vyžádání komponent: SIP (soubor) nelze napárovat na žádný SIP v tomto skartačním návrhu. | V1401 | úroveň popisu v databázi se neshoduje s úrovní z průvodky (při vyžádání komponent k přeložení jsou nahrány entity s odlišným identifikátorem nebo s jinak zmenenymi metadaty/např. jiné časové údaje) | Kolize v eVýběru, daný SIP nebude nahrán ani zobrazen, v eVýběru zůstává původní verze SIPu. Nutno nahrát SIP s odpovídajícími metadaty. |
| Kolize při vyžádání komponent: SIP (soubor) nelze napárovat na žádný SIP v tomto skartačním návrhu. | V1402 | nepodařilo se napárovat původní úroveň popisu (při vyžádání komponent k přeložení jsou nahrány entity s odlišným identifikátorem nebo s jinak změněnymi metadaty /např. jiné časové údaje, jiné evidenční číslo spisu či dokumentu apod.) | Kolize v eVýběru, daný SIP nebude nahrán ani zobrazen, v eVýběru zůstává původní verze SIPu. Pro dodání komponent je nutno nahrát SIP s odpovídajícími metadaty. |
| kořenová úroveň popisu nebyla v databázi nalezena | V1403 | kořenová úroveň popisu nebyla v databázi nalezena (při vyžádání komponent) | Kolize v eVýběru, daný SIP nebude nahrán ani zobrazen, v eVýběru zůstává původní verze SIPu. Nutno nahrát SIP s odpovídajícími metadaty. |
| nepodařilo se napárovat novou úroveň popisu | V1404 | nepodařilo se napárovat novou úroveň popisu (vzniká při vyžádání komponent, pokud jsou nahrány entity s nevyžádaným identifikátorem nebo s neznámými metadaty pro danou entitu /např. jiné časové údaje, jiné evidenční číslo spisu či dokumentu apod.) | Kolize v eVýběru, daný SIP nebude nahrán ani zobrazen. Může jít o situaci, kdy je nahrán nevyžádaný SIP, pak zkontrolujte, zda byl daný SIP vyžádán. Příp. jsou v SIP odpovídající entity, ale s odlišnými metadaty, pak je třeba je dodat s odpovídajícími metadaty (např. stejný název souboru, datum vytvoření, čj. nebo spisová značka, stejná věcná skupina). |
| úroveň popisu nebyla v databázi nalezena | V1405 | úroveň popisu nebyla v databázi nalezena (při vyžádání komponent) | Kolize v eVýběru, daný SIP nebude nahrán ani zobrazen, v eVýběru zůstává původní verze SIPu. Nutno nahrát SIP s odpovídajícími metadaty. |
| nepodařilo se vytvořit komponentu | V1406 | nepodařilo se vytvořit komponentu (při vyžádání komponent) | Kolize v eVýběru, daný SIP nebude nahrán ani zobrazen, v eVýběru zůstává původní verze SIPu. Nutno nahrát SIP s odpovídajícími metadaty a komponentami. |
| nalezena komponenta bez odkazu na soubor | V1407 | nalezena komponenta bez odkazu na soubor tzn. po vyžádání komponent k předložení (V) nebyly nahrány SIP s komponentami (pokud mají být součástí dokumentu) | Kolize v eVýběru, nelze zpracovat daný SIP, komponenty nejsou přidány, nutno nahrát SIP s komponentami |
| základní entita nemá platný typ | V1408 | základní entita nemá platný typ | Kolize v eVýběru, nelze zpracovat |
| základní entity nového SIPu odkazují do více existujících SIPů | V1409 | základní entity nového SIPu odkazují do více existujících SIPů | Kolize v eVýběru, nelze zpracovat |
| SIP obsahuje duplicitní id základní entity | V1410 | SIP obsahuje duplicitní id základní entity | Kolize v eVýběru, nelze zpracovat, jedna se o chybnou kontrukci SIP |
| Kolize při vyžádání komponent: v tomto SIPu chybí některé základní entity oproti SIPu, který byl vložen do skartačního návrhu. Opravený SIP nahrajte, prosím, znovu. | V1411 | při pokusu o napárování na existující SIP se nepodařilo nalézt všechny základní entity (např. při použití totožného identifikátoru dokumentu/spisu/komponenty ve více SIP) | Kolize v eVýběru, daný SIP nebude nahrán ani zobrazen |
| Kolize při vyžádání komponent: v tomto SIPu přebývají některé základní entity oproti SIPu, který byl vložen do skartačního návrhu. Opravený SIP nahrajte, prosím, znovu. | V1412 | nebyla nalezena existující základní entita (např. při předání vyžádaných komponent V byly nahrány nevyžádané SIP) | Kolize v eVýběru, daný SIP nebude nahrán ani zobrazen; ve výběru lze pokračovat |
| nahraný SIP nebyl dle skartačního protokolu vybrán k trvalému uložení, tento SIP byl proto smazán | V1413 | ||
| nahraný SIP neobsahuje komponenty, které byly vyžádány | V1414 | Ve stavu vyžádání komponent je nahrán balíček z nějž žádná komponenta vyžádána není. |
6. Nahrávání volných souborů (mimo eSSL)
| Vypsané hlášení | kód stavu | Možná příčina | Důsledek chyby, příp. možné řešení |
| Exception message: … is not valid value for ‘any URI’ | V0051 | V názvech souborů se nachází problematické znaky | Kontaktujte helpnda@nacr.cz pro zjištění příčiny a odstranění kolize |
7. Interní kolize
Při výskytu chyb z této sekce se, prosím, obraťte na helpnda@nacr.cz.
| Obecné chyby XML (průvodka.xml) | |
| V0001 | element obsahuje neznámé potomky |
| V0002 | potomek má menší počet výskytů než je definované minimum |
| V0003 | potomek má větší počet výskytů než je definované maximum |
| V0004 | element obsahuje neznámé atributy |
| V0005 | element nemá všechny povinné atributy |
| V0006 | element typu choice musí obsahovat právě jednoho potomka |
| V0007 | element nesmí být prázdný |
| V0008 | element musí být prázdný |
| V0009 | hodnota elementu musí vyjadřovat pouze stav ano/ne |
| V0010 | obsah elementu není platnou hodnotou výčtu |
| V0011 | element musí obsahovat pouze číslo |
| V0012 | element musí mít pouze textový obsah |
| V0030 | atribut nemá platnou hodnotu |
| V0031 | atribut nesmí být prázdný |
| V0032 | obsah atributu není platnou hodnotou výčtu |
| V0050 | nastal problém během validace podle XSD schéma |
| V0051 | validace podle XSD schéma selhala |
| V0052 | nastala chyba při čtení XML souboru |
| Validace Seznamu | |
| V0200 | entita původce v Seznamu obsahuje neplatnou operaci |
| V0201 | entita původce v Seznamu obsahuje duplicitní identifikátor |
| Validace Přejímky | |
| V0400 | povinný soubor nebyl nalezen |
| V0401 | nastala chyba při čtení složky Přejímky |
| V0402 | složka Přejímky obsahuje neznámé/nepovolené soubory |
| V0403 | Přejímka nesmí obsahovat SIPy |
| V0404 | Přejímka neobsahuje žádné SIPy |
| V0405 | id archivu v Zařazení se neshoduje s hodnotou v Seznamu |
| V0406 | číslo předávajícího v Zařazení se neshoduje s hodnotou v Seznamu |
| V0407 | id přejímky v Zařazení se neshoduje s hodnotou v Seznamu |
| V0408 | nebyly nazeleny SIPy pro všechny vybrané archiválie |
| V0409 | vybraná archiválie již byla nalezena v jednom ze SIPů Přejímky |
| V0410 | SIP obsahuje id vybrané archiválie které není v Seznamu |
| Validace Průvodky | ||
| V0800 | rozsah musí mít alespoň jeden z potomků fromDate, toDate | |
| V0801 | počáteční datum rozsahu je větší než koncové | |
| V0802 | bylo nalezeno více identifikátorů stejného typu | |
| V0803 | úroveň popisu s potomky nemůže obsahovat Dao element | |
| V0804 | byl nalezen subjekt bez vyplněného typu identifikátoru | |
| V0805 | byl nalezen subjekt bez hodnoty identifikátoru, pouze s uvedeným typem | |
| V0806 | element musí obsahovat pouze číslo vyjadřující počet evidenčních jednotek | |
| V0807 | Dao id již bylo použito u jiné úrovně popisu | |
| V0808 | nalezen Div element bez odkazovaného Dao | |
| V0809 | nalezen Div element s duplicitním id | |
| V0810 | nalezen File element s duplicitním id | |
| V0811 | Fptr element odkazuje na neexistující File element | |
| V0812 | více Fptr elementů odkazuje na stejný File element | |
| V0813 | cesta ke komponentě nemá platný formát | např. při chybném dekódování diakritiky a speciálních znaků („+“ aj.) |
| V0814 | nalezeno více odkazů na stejnou komponentu | |
| V0815 | nebyla nalezena žádná datace | |
| V0816 | byly nalezeny File elementy bez Fptr elementů | |
| V0817 | byly nalezeny Dao elementy bez Div elementů | |
| V0818 | hodnota elementu se neshoduje s record id v control sekci | |
| V0819 | datace nemá platný formát | Objevuje se například v případě, kdy je datum otevření spisového plánu 0005-01-01 |
| Validace SIPu | |
| V1000 | složka s komponentami nebyla nalezena nebo je prázdná |
| V1001 | nastala I/O chyba při validaci komponent |
| V1002 | mezi komponentami byly nalezeny neznámé soubory |
| V1003 | SIP nesmí obsahovat soubory komponent |
| V1004 | soubor komponenty nebyl nalezen |
| V1005 | povinný soubor nebyl nalezen |
| V1006 | nastala chyba při čtení obsahu SIP složky |
| V1007 | složka SIPu obsahuje neznámé/nepovolené soubory |
| V1008 | byla nalezena úroveň popisu která není součástí základní entity |
