.. include:: /roles.rst
.. include:: /icons.rst

=================
Hlavní obrazovka
=================

Modul *Archivní entity* je určen pro správu archivních entit uložených v systému.
Modul se skládá z :ref:`horního panelu <ug_ap_screen_menu>`, 
:ref:`levého panelu <ug_ap_screen_left>` a :ref:`pracovní oblasti <ug_ap_screen_main>`.

.. _ug_ap_screen_menu:

Horní panel
-----------

Horní panel obsahuje volby pro založení archivní entity, jejich hromadný
import, vymazání (zneplatnění), zobrazení míst napojení na jednotky popisu
v modulu *Archivní soubory*, odstranění duplicit (deduplikaci), úpravy v prostředí editoru revizí aj.
Dle nastavení jsou možné také jednotlivé akce synchronizace s externími systémy (zejména CAM).

.. figure:: resources/hlavni_panel.png
       :align: center

       
Dostupné volby z menu:

 |crcl-pl| :ref:`ug_ap_new`

 |file-import| Import ze souboru

 |cloud-download| :ref:`Import ze systému <ug_ap_synchronization>`

 |link1| :ref:`Fronta synchronizace <ug_ap_synchronization_queue>`

 |trash| :ref:`Zneplatněné entity <ug_ap_invalidations_overview>`

 |wrench| :ref:`Správa oblastí entit <ug_ap_scopes>`

 |trash| :ref:`Smazat <ug_ap_invalidations>`
 
 |ico-search| :ref:`Místa použití <ug_ap_place_of_use>`

 |ban| :ref:`Odstranit duplicitu <ug_ap_duplications>`
 
 |clock| :ref:`ug_ap_state_history`

 |edit| :ref:`Změnit vlastnosti entity <ug_ap_state_change>`

 |img-copy| :ref:`Kopie entity <ug_ap_copies>`

 |plus| :ref:`Vytvořit revizi <ug_ap_revisions_editor>`

 |fa-undo| :ref:`Obnovit entitu <ug_ap_invalidations_restore>`

.. _ug_ap_place_of_use:

Místa použití
++++++++++++++

Funkcionalita umožňuje jednoduchý přehled o archivních souborech a jednotkách popisu,
k nimž je vybraná archivní entita napojena jako :ref:`přístupový bod <ug_ap_access_point>`.
Po kliknutí na odkaz se zobrazí konkrétní jednotka popisu v modulu *Archivní soubory*.

.. figure:: resources/mista_pouziti.png
      :align: center
      :width: 400pt

      Místa použití archivních entit

.. _ug_ap_invalidations_overview:

Zneplatněné entity
++++++++++++++++++

Ovládací prvek nabízí přehled všech archivních entit,
které byly :ref:`smazány <ug_ap_invalidations>` nebo :ref:`deduplikovány <ug_ap_duplications>`,
a aktuálně se nacházejí ve stavech *Zneplatněná*, respektive *Nahrazená*.

V plovoucím okně je vždy k dispozici název entity, včetně ID, přesné datum zneplatnění
a dle situace také identifikace záznamu v :ref:`externím systému <ug_ap_synchronization>`
nebo odkaz na :ref:`nahrazující entitu <ug_ap_duplications_related-substitute>`. 

Zneplatněné záznamy je možné zobrazit a v případě potřeby :ref:`obnovit <ug_ap_invalidations_restore>`.

.. figure:: resources/zneplatnene_entity.png
      :align: center
      :width: 400pt

      Přehled zneplatněných entit


.. _ug_ap_screen_left:

Levý panel
----------

Levý panel slouží k zobrazení seznamu archivních entit a jejich **vyhledávání**. 
K dispozici je filtrování archivních entit dle:

 - :ref:`oblasti <ug_ap_scopes>`
 - :ref:`stavu entity <ug_ap_state>`
 - :ref:`stavu revize <ug_ap_revisions_editor-state>`
 - :ref:`třídy / podtřídy <ug_ap_access_point_class>`

Archivní entity lze vyhledávat také dle textu v preferovaném nebo variantním označení
a dalších částech :ref:`záznamu entity <ug_ap_part>`.
Výsledky vyhledávání jsou řazeny s ohledem na závažnost a výskyt zadaného řetězce v hlavní části jména,
jiných prvcích preferovaného nebo variantního označení, v označení souvisejících entit atd.

.. figure:: resources/levy_panel.png
      :align: center

      Seznam entit v levém panelu


.. _ug_ap_screen_left-export_CSV:

Zobrazené záznamy je možné **exportovat do CSV** (ikony |dots| a |import|) včetně dalších informací o archivní entitě.

V souboru CSV jsou uvedeny tyto informace:

.. list-table::

 * - **Kód**
   - **Vlastnost**
 * - ``accessPointId``
   - Identifikátor archivní entity
 * - ``uuid``
   - Jednoznačný identifikátor archivní entity
 * - ``externalId``
   - Identifikátor archivní entity v :ref:`externím systému <ug_ap_synchronization>`
 * - ``scope``
   - :ref:`Oblast <ug_ap_scopes>`
 * - ``apType``
   - :ref:`Třída <ug_ap_access_point_class>`
 * - ``state``
   - :ref:`Stav archivní entity <ug_ap_state>`
 * - ``prefDisplayName``
   - :ref:`Preferované označení <ug_ap_part>` (textová podoba)
 * - ``nmMain``
   - Hlavní část jména
 * - ``nmMinor``
   - Vedlejší část jména
 * - ``ptCre``
   - Vznik (textová podoba)
 * - ``ptExt``
   - Zánik (textová podoba)
 * - ``ptBody``
   - Stručná charakteristika

.. note::
      Způsob popisu archivních entit v Elza je podrobně vysvětlen v `Dokumentaci CAM <https://cam.nacr.cz/doc/current/>`_,
      včetně uvedení veškerých prvků popisu, datových typů a pravidel.


.. _ug_ap_screen_left-advanced_filter:

Rozšířený filtr
+++++++++++++++

Pro dosažení přesnějších výsledků je možné využít **rozšířený filtr**
s volitelným vyhledáváním pouze v preferovaném označení, hlavní části označení
nebo ve všech částech popisu.

Na výběr je vyhledávání podle identifikátoru entity, uživatelů,
kteří záznam entity naposledy změnili [#f1]_ nebo jimž je :ref:`přidělen k vyřízení <ug_ap_state_assign>`.

Další možností je vyhledávání podle :ref:`stavu synchronizace <ug_ap_synchronization_state>`,
:ref:`stavu validace <ug_ap_part>` nebo jednotlivých prvků popisu entit a vztahů mezi záznamy.

V dostupných filtrech je možné kombinovat více hledisek najednou, např. fulltextové vyhledávání
s filtry dle :ref:`stavu revize <ug_ap_revisions_editor-state>` nebo autora poslední změny archivní entity.

Filtr **Moje úkoly** vyhledá všechny archivní entity,
které jsou :ref:`přiděleny <ug_ap_state_assign>` přihlášenému uživateli.

Viz :ref:`proces schvalování archivních entit <meths_schvalovani-entit>`.

.. warning::
      Fulltextové **vyhledávání je možné kombinovat** s rozšířeným filtrem a dotazem podle konkrétního prvku popisu entity,
      nikoli podle příslušné :ref:`části popisu entity <ug_ap_part>`.
      Drtivá většina prvků je přímo spojena s odpovídající částí popisu, kterou není nutné při zadání dotazu blíže specifikovat.
      Výjimkami jsou prvek *Poznámka*, který se používá ve všech částech popisu, a prvek *Související entita*,
      kde ovšem zpravidla záleží na konkrétní specifikaci vztahu mezi entitami.

.. figure:: resources/rozsireny_filtr.png
      :align: center

      Rozšířený filtr


.. _ug_ap_screen_main:

Pracovní oblast
---------------

Pracovní oblast slouží k detailnímu zobrazení :ref:`záznamu archivní entity <ug_ap_part>`
a jeho úpravám. Panel je rozdělen na záhlaví a jednotlivé části popisu.

.. figure:: resources/main_panel.png
      :align: center

      Záznam archivní entity


.. _ug_ap_screen_main_head:

Záhlaví entity
+++++++++++++++

V záhlaví archivní entity je uvedeno její preferované označení, stručná charakteristika,
identifikátory, :ref:`stav entity <ug_ap_state>`, :ref:`oblast <ug_ap_scopes>` a příznak :ref:`stavu validace <ug_ap_part>`.


Dosud nesdílené entity je možné odeslat do externího systému pomocí funkcionality:

|cloud-upload| :ref:`Zápis entity do externího systému <ug_ap_synchronization>`


V případě :ref:`napojení záznamu entity na jiný systém <ug_ap_connected>` je zde k dispozici také
citace externího zdroje včetně :ref:`ID a UUID <impl_entryurl_entity>`,
a dále identifikace zapisovatele poslední změny do externího systému,
odkaz na podrobnější **historii revizí**
nebo přehled případných **chyb a upozornění** ze `Správy upozornění IS CAM <https://portal.nacr.cz/camadmin/issues>`_.

Skryté údaje lze zobrazit a zkopírovat z nápovědy (tooltipu) při najetí kurzorem na příslušnou část záhlaví.

.. figure:: resources/zahlavi_napoveda.png
      :align: center

      Identifikace záznamu v externím systému


V záhlaví nahrazené (:ref:`deduplikované <ug_ap_duplications>`) entity je navíc uvedeno označení nahrazující entity,
včetně odkazu s možností zobrazení záznamu v jiném okně prohlížeče.

.. figure:: resources/entita-nahrazena.png
      :align: center

      Odkaz na nahrazující entitu


.. [#f1] Změnou záznamu je v tomto případě myšlena změna :ref:`stavu entity <ug_ap_state>` nebo :ref:`stavu revize <ug_ap_revisions_editor-state>`