.. _api_v2_issues:

==============================
Zjištění (chyby a upozornění)
==============================

Zjištění se vztahuje k archivní entitě. Obvykle upozorňuje na chybu nebo možnou chybu. 
Vzniká buď při uložení požadavku na změnu, tj. při validaci změnové dávky nebo také 
až následně a to na základě validace entit a jejich vzájemných vztahů.

Zjištění je tvořeno:

 - svým identifikátorem (UUID)
 - míru závažnosti (ERROR, WARNING)
 - textovou zprávou pro uživatele
 - časem vzniku upozornění
 - případnou vazbou na část nebo prvek popisu

Při vyžádání záznamu entity jsou k ní současně vrácena i všechna zjištění, která se k ní vztahují.
Součástí *zjištění* může být požadavek na způsob jeho řešení. Zpravidla se jedná o požadavek na opravu
nebo případnou informaci, že *zjištění* je v pořádku a jedná se o výjimku. V takovém případě není 
požadována žádná akce ze strany uživatele. Výjimka se může vztahovat jen k dané revizi entity 
nebo mít podobu trvalé výjimky platné i pro budoucí revize.


.. _api_v2_issues_updates:

Zjištění v rámci změn
=======================

Zjištění vzniklá na základě změnové dávky vedou k jejímu odmítnutí.
Pokud existuje alespoň jedno zjištění, které je chybou, tak je celá dávka 
odmítnuta. V případě zjištění, která jsou pouze varováním, je možné dávku 
uložit na základě opakovaného zaslání s parametrem ``forceKey``.


.. _api_v2_issues_external_sys:

Zjištění z externích zdrojů
==============================

Zjištění mohou do systému vkládat i jednotlivé napojené systémy s příslušným oprávněním.
Takto vložená zjištění je možné také odstranit. Při vkládání zjištění k entitě je 
nutné uvést identifikátor verze entity a verze metadat.

V napojeném systému je také možné měnit stav upozornění, resp. požadavek na způsob jeho 
řešení nebo udělit příslušnou výjimku.