.. _impl_entryurl:

========================
Vstupní URL Elza
========================

Pro přímý přístup k vybraným záznamům uloženým v aplikaci Elza je 
možné použít URL v prohlížeči. Takové URL musí obsahovat 
identifikátor požadovaného záznamu. Možné přímé přístupy
kz prohlížeče jsou popsány v této kapitole.


Přístup k jednotce popisu
==========================

Každá jednotka popisu je identifikována svým UUID. Pomocí tohoto UUID 
je možné otevřít a zobrazit příslušný uzel.

URL pro zobrazení jednotky popisu: :code:`<ELZA_URL>/node/<UUID>`

Příklad: :code:`http://elza.archiv.cz/node/7c788c73-e120-46b9-91ce-2f40531b428e`


Přístup k archivní entitě
==========================

Každá archivní entita je identifikována svým ID a UUID. Pomocí těchto identifikátorů 
je možné otevřít a zobrazit příslušnou entitu. Druh identifikátoru je automaticky 
rozpoznán podle jeho hodnoty.

URL pro zobrazení archivní entity pomocí UUID: :code:`<ELZA_URL>/entity/<UUID>`

URL pro zobrazení archivní entity pomocí ID: :code:`<ELZA_URL>/entity/<ID>`

Příklad: :code:`http://elza.archiv.cz/entity/7c788c73-e120-46b9-91ce-2f40531b428e`


.. _impl_entryurl_createentity:

Založení nové entity
==========================

Do Elza je možné zaslat samostatný požadavek na založení nové entity.
Součástí zaslaného požadavku je návratové URL pro zaslání výsledku
a volitelné omezení na třídu/podtřídu archivní entity.

URL pro založení archivní entity: :code:`<ELZA_URL>/entity-create?response=<navratové URL>&entity-class=<kód třídy>`

Parametry:
 - :token:`response` - uvádí se návratové URL po dokončení požadavku,
   v návratové URL je parametrizované a slouží pro předání výsledku
 - :token:`entity-class` - volitelný parametr; třída archivní entity, uvádí se kód třídy

Příklad (čitelný): :code:`http://elza.archiv.cz/entity-create?entity-class=PARTY_GROUP&response=http://is.archiv.cz/entity-response?status={status}&entity={entityUuid}`

Příklad (po zakódování do URL): :code:`http://elza.archiv.cz/entity-create?entity-class=PARTY_GROUP&response=http%3A%2F%2Fis.archiv.cz%2Fentity-response%3Fstatus%3D%7Bstatus%7D%26entity%3D%7BentityUuid%7D`

Návratové URL
-----------------

Návratové URL může obsahovat proměnné v nichž bude předán výsledek.
Proměnné se zadávají ve složených závorkách (například: :token:`{status}`).

Dostupné proměnné v návratovém URL
 - :token:`{status}` - stav volání, nabývá jedné z hodnot: :token:`SUCCESS`, :token:`CANCEL`
 - :token:`{entityUuid}` - UUID nově založené entity, pokud entita není založena nastaví se na prázdný řetězec
 - :token:`{entityId}` - databázové ID nově založené entity, pokud entita není založena nastaví se na prázdný řetězec