.. _ug_arr_intro:

.. include:: /roles.rst
.. include:: /icons.rst
.. include:: /as-images.rst

Úvodní obrazovka
================
Úvodní obrazovka modulu *Archivní soubory* slouží jako přehled všech archivních souborů,
ke kterým má právě přihlášený uživatel přístup.

Horní panel
-----------
|as-uo-hp|

V kontextové části horního panelu se nachází obecné **ovládací prvky**:

.. _ug_arr_intro_new:

|crcl-pl| :sm:`Nový AS`

Slouží k vytvoření nového archivního souboru. Pro jeho úspěšné založení je nutné vyplnit:

    - **Název (POVINNÉ)**
    - :ref:`Interní kód <ug_arr_intro_internal_code>`

      - Kód pro podrobnější identifikaci archivního souboru v systému

    - **Instituce (POVINNÉ)**

      - Instituce pořádající archivní soubor.

    - **Pravidla tvorby (POVINNÉ)**

      - Pravidla, podle kterých bude archivní soubor pořádán.
   
    - **Oblast entit (POVINNÉ)**

      - :ref:`Oblasti <ug_ap_scopes>`, z nichž bude možné napojovat entity k archivnímu souboru jako :ref:`přístupové body <ug_ap_access_point>`.

    - Správci

      - Uživatelé, jimž jsou při vytvoření archivního souboru přidělena všechna :ref:`oprávnění <ug_admin_perms>` k jeho správě (Čtení, Pořádání, Tvorba výstupů, Export, Spouštění hromadných akcí, Drobné úpravy, Verzování a editace, Správa lektorování).

    - Číslo archivního souboru

    - Datace

    - Značka archivního souboru

.. _ug_arr_intro_internal_code:

.. note::
  **Interní kód** je používán například ve státních oblastních archivech, kde jsou do jedné instance ELZA shromážděny archivní soubory jednotlivých státních okresních archivů (SOkA)
  a samotné *Číslo archivního souboru* přebírané ze systému pro evidenci NAD (PEvA) proto není jedinečné.
  Hodnotu interního kódu pak zpravidla tvoří zkratka příslušného SOkA a číslo archivního souboru.


.. _ug_arr_intro_search:

|ico-search-svg| :sm:`Vyhledat v arch. souborech`

Vyhledání záznamů obsahujících určitou hodnotu ve **všech archivních souborech**.

Funkce je dostupná nejen z :ref:`přehledu archivních souborů <ug_arr_intro>` na úvodní obrazovce modulu *Archivní soubory*,
ale také z horního panelu na :ref:`domovské stránce <ug_home>` nebo při zobrazení konkrétního :ref:`archivního souboru <ug_arr_poradani>`.

Po aktivaci funkce dojde k zobrazení plovoucího okna,
kde je možné zadat hledaný výraz.

K dispozici je obecné **fulltextové vyhledávání** (ikona |ico-search-svg|),
které nezohledňuje velikost písmen, diakritiku nebo pořadí slov v příslušném dotazu.
Příslušný index ignoruje interpunkci a další speciální znaky.

Další možností je použití **filtrů dle prvků popisu** (ikona |filter|),
které hledají přesně dle zadaného řetězce a respektují velikost písmen, diakritiku nebo pořadí slov.
Filtry k vybraným prvkům popisu lze v konfiguraci ELZA připnout přímo do plovoucího okna,
nebo vybrat z nabídky všech dostupných prvků v menu.

Kromě univerzálních dotazů (*Je* / *Není*, *Vyplněn* / *Nevyplněn*) se v závislosti na :ref:`datovém typu <ZP2015_PP_Datove_typy>`
nabízejí různé **operace** pro vyhledávání.
U textových prvků popisu je možné hledat dle částečné shody (*Obsahuje*),
další možnosti jsou dostupné u datací (*Před* / *Po*, *Spadá zcela do* / *Spadá částečně do*),
číselných hodnot (*Menší než* / *Větší než*, *Menší nebo rovno*, *Větší nebo rovno*) apod.

Srov. :ref:`Tabulkové zobrazení <ug_arr_table_view_table_operation>`

.. figure:: resources/search-dialog-filter.png
    :align: center
    :width: 400pt

    Vyhledat v archivních souborech – dotaz

Z přehledu **výsledků** je možné přejít na konkrétní záznam.
Při opětovném vyvolání dialogu jsou zachovány výsledky posledního vyhledávání a je možné se k nim vrátit.
Po změně hodnot v archivním popisu a použití již dříve zadaného dotazu je třeba občerstvit výsledky vyhledávání (ikona |refresh-3|).

.. figure:: resources/search-dialog.png
    :align: center
    :width: 400pt

    Vyhledat v archivních souborech – nalezené záznamy

.. warning::
  Funkcionalita *Vyhledat v archivních souborech* je **dostupná** u :ref:`prvků popisu <ZP2015_PP_Seznam>`
  těchto :ref:`datových typů: <ZP2015_PP_Datove_typy>`
    - ENUM
    - STRING
    - TEXT
    - UNITDATE
    - INT
    - DECIMAL
    - RECORD_REF
    - STRUCTURED
    - URI_REF
    - FILE_REF
    - UNIT_ID
    - *COORDINATES*
    - *BIT*
    
  U :ref:`datových typů <ZP2015_PP_Datove_typy>` odlišených kurzívou jsou k dispozici pouze operace *Vyplněn* / *Nevyplněn*.

  Funkcionalitu **nelze použít** pro vyhledání hodnot :ref:`prvků popisu <ZP2015_PP_Seznam>`
  těchto :ref:`datových typů: <ZP2015_PP_Datove_typy>`
    - DATE (není indexováno)
    - FORMATTED_TEXT (bude zrušeno a změněno na TEXT)
    - JSON_TABLE (je součástí :ref:`výstupů <ug_arr_vystupy>`)

  Prvky :ref:`Ukládací jednotka <ZP2015_STORAGE_ID>`, :ref:`Druh omezení přístupnosti <ZP2015_RESTRICTION_ACCESS_SHARED>`
  a :ref:`Příloha <ZP2015_ATTACHMENT>` jsou vyhledány pouze v případě napojení k jednotce popisu.

  Pro vyhledávání dle přesné shody (*Je*) u prvků :ref:`datového typu <ZP2015_PP_Datove_typy>` **URI_REF**
  je třeba zadat **serializovanou hodnotu** ve tvaru:
  
      *[URI];[Popisek]*


Kromě filtrů dle :ref:`prvků popisu <ZP2015_PP_Seznam>` lze vyhledat jednotky popisu také podle **dalších vlastností**:
    
    Chyba
        Dle popisu :ref:`nesrovnalosti <ZP2015_PRAVIDLA_NESROVNALOSTI>` vyhledá záznamy s chybnými hodnotami.

    Chybějící prvek    
        Dle popisu  :ref:`nesrovnalosti <ZP2015_PRAVIDLA_NESROVNALOSTI>` vyhledá záznamy s chybějícími hodnotami prvků popisu.

    UUID
        Vyhledá jednotku popisu dle UUID.


.. warning::
  U funkcionality *Vyhledat v archivních souborech* jsou v zájmu zachování stability aplikace
  uplatněna **technická omezení** při zpracování dotazu.
  V případě uplatnění omezení je uveden rozdíl mezi nalezenými a zobrazenými záznamy.
  Při zobrazení neúplného přehledu vyhledaných záznamů je třeba dotaz zpřesnit pomocí dalších filtrů.

  Konkrétní parametry lze nastavit v konfiguraci. Výchozí limity jsou:

    - 10 000 záznamů celkem
    - 1 000 záznamů v rámci jednoho :ref:`archivního souboru <ZP2015-PP-UrovenPopisu_Soubor>`
    - 10 sekund pro zpracování dotazu

.. note::  
  - Další možnosti hledání dle přesné shody v konkrétním archivním souboru jsou k dispozici ve
    **filtrech** :ref:`Tabulkového zobrazení <ug_arr_table_view_table>`.


|import-AS| :sm:`Import`

Slouží k přidání nového archivního souboru z externího souboru. Uvádí se:

    - **Oblast entit (POVINNÉ)**

      - :ref:`Oblast <ug_ap_scopes>`, do níž se naimportují archivní entity napojené k archivnímu souboru jako :ref:`přístupové body <ug_ap_access_point>`.

    - **Soubor (POVINNÉ)**


.. _ug_arr_intro-left:

Levý panel
----------
|as-uo-lp|

V levém panelu se nachází výpis všech uživateli přístupných nebo jím vyhledaných archivních souborů,
včetně jejich identifikace podle názvu, čísla, značky aj.

Základní **vyhledávání** (ikona |ico-search-svg|) nezohledňuje velikost písmen,
ale respektuje diakritiku nebo pořadí slov v příslušném dotazu.

Další možností je **použití filtrů**,
které hledají přesně dle zadaného řetězce a respektují velikost písmen, diakritiku nebo pořadí slov.

Odkaz otevírá aktuální verzi archivního souboru.

.. note::
  Informace o **instituci** se zobrazuje pouze u instancí,
  kde jsou spravovány archivní soubory více institucí
  (např. státní oblastní archivy s archivními soubory jednotlivých státních okresních archivů).

Zobrazené záznamy je možné **stáhnout do CSV** včetně dalších informací o archivním souboru, příslušné instituci, kořenové jednotce popisu nebo pravidlech.

.. _ug_arr_export_CSV:

V souboru CSV jsou uvedeny tyto informace:

.. list-table::

 * - **Kód**
   - **Vlastnost**
 * - ``fundId``
   - Identifikátor archivního souboru
 * - ``name``
   - Název
 * - ``createDate``
   - Datum vytvoření archivního souboru
 * - ``internalCode``
   - Interní kód
 * - ``fundNumber``
   - Číslo archivního souboru
 * - ``unitDate``
   - Datace
 * - ``mark``
   - Značka archivního souboru
 * - ``managed``
   - Informace o načtení záznamu z `IS PEvA <https://mv.gov.cz/clanek/provoz-informacniho-systemu-evidence-narodniho-archivniho-dedictvi-na-narodnim-portalu.aspx>`_ a omezení změny :ref:`vlastností AS <ug_arr_properties>` v Elza
 * - ``institutionId``
   - Identifikátor instituce (archivní entity)
 * - ``institutionCode``
   - Kód instituce (dle číselníku archivů a kulturně vědeckých institucí)
 * - ``institutionName``
   - Instituce
 * - ``fundversionId``
   - Identifikátor aktuální verze archivního souboru
 * - ``rootNodeId``
   - Identifikátor kořenové jednotky popisu – úrovně :ref:`archivní soubor <ZP2015-PP-UrovenPopisu_AS>`
 * - ``uuid``
   - UUID kořenové jednotky popisu – úrovně :ref:`archivní soubor <ZP2015-PP-UrovenPopisu_AS>`
 * - ``rulesetCode``
   - Kód pravidel


U každého záznamu jsou k dispozici akce (ikona |dots-v|) pro základní **správu archivních souborů**:

.. _ug_arr_properties:

|edit| :sm:`Upravit vlastnosti`

Umožňuje změnit některé základní :ref:`údaje o archivním souboru <ug_arr_intro_new>`.

.. note::
  Úprava **vlastností AS** je omezena na uživatele s oprávněním :ref:`ug_admin_perms_other_superuser`,
  pokud jsou záznamy archivních souborů načítány z
  `IS PEvA <https://mv.gov.cz/clanek/provoz-informacniho-systemu-evidence-narodniho-archivniho-dedictvi-na-narodnim-portalu.aspx>`_
  (pole :ref:`managed <ug_arr_export_CSV>` = TRUE).
  

|note-chk| :sm:`Změnit pravidla`

Umožňuje změnit pravidla používaná při zpracování archivního souboru.

.. _ug_arr_version:

|branch| :sm:`Nová verze AS`

Vytvoří novou verzi archivního souboru a uzavře verzi předešlou.

|commenting| :sm:`Nastavení lektorování`

Umožňuje spravovat protokoly :ref:`lektorování <ug_arr_lecture>` a přidělovat uživatelům oprávnění pro čtení a zápis připomínek.

.. _ug_arr_export:

|export-AS| :sm:`Export`

Vytvoří soubor, který je možné importovat do ELZA nebo využít pro publikaci. Při exportu lze uplatnit příslušný :ref:`filtr <meths_filtry>`.   

|times-circle| :sm:`Vymazání historie změn`

Odstraní :ref:`historii změn <ug_admin_drophist>` v daném archivním souboru.

|trash| :sm:`Smazat AS`

Smaže archivní soubor.
  

.. _ug_arr_intro-right:

Pravý panel
-----------
|as-uo-pp|

Panel slouží pro zobrazení dalších informací o archivních souborech.

Jedná se zejména o přehled :ref:`výstupů <ug_arr_vystupy>` a přesně datovaných :ref:`verzí <ug_arr_version>` vybraného archivního souboru
s možností zobrazení pomocí odkazů.

:ref:`Oblasti <ug_ap_scopes>`, z nichž je možné napojovat entity k archivnímu souboru jako :ref:`přístupové body <ug_ap_access_point>`,
lze upravit ve :ref:`Vlastnostech archivního souboru <ug_arr_properties>`.
