.. _ug_arr_table_view:

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

Tabulkové zobrazení
===================

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

|export-AS| :sm:`Export`
  
Uloží záznamy do souboru.

Viz :ref:`Export tabulkového zobrazení <ug_arr_table_view_export>`.

|import-AS| :sm:`Import prvků popisu`

Přidá hodnoty prvků popisu ze souboru.

Viz :ref:`Import prvků popisu <ug_arr_table_view_import>`.


Panel nad tabulkou
------------------
|tz-pnt|

:sm:`Vyhledávání`


V panelu nad tabulkou se nachází textové pole pro **vyhledávání**. Nalezená položka se zvýrazní a pokud se nachází na jiné stránce, pak na ní tabulka přeskočí.

Vyhledány jsou také hodnoty prvků, které nejsou vybrány k zobrazení v :ref:`nastavení sloupců <ug_arr_table_columns>`.

.. note::
  Vyhledávání **nezohledňuje velikost písmen** nebo **pořadí slov** v příslušném dotazu. **Interpunkce a další speciální znaky** na začátku nebo konci slov jsou při indexování jednotek popisu ignorovány.
  Hledání dle přesné shody je k dispozici ve :ref:`filtrech <ug_arr_table_view_table>`.

|zoom-in| :sm:`Rozšířené vyhledávání`

Pro pokročilé vyhledávání je použito `Apache Lucene <http://lucene.apache.org/>`_.


|columns| :sm:`Nastavit zobrazení sloupců`

Umožňuje vybrat sloupce, které se zobrazí v tabulkovém zobrazení.

|refresh| :sm:`Aktualizovat data podle filtru`

Aktualizuje data v tabulce podle zadaných filtrů.

|trash| :sm:`Odebrat všechny filtry`

Odebere filtry ze všech sloupců v tabulce.


.. _ug_arr_table_view_table:

Tabulka
-------
|tz-t|

|filter| :sm:`Nastavit filtr pro prvek popisu`

Otevírá formulář pro přidání **filtru**. Aktivní filtr je poté značen tmavě zabarveným záhlavím sloupce na němž je filtr aktivován.

.. note::
  Filtry tabulkového zobrazení **zohledňují velikost písmen** a **pořadí slov** v příslušném dotazu. **Interpunkce a další speciální znaky** na začátku nebo konci slov jsou zahrnuty do indexování prvků popisu.


Na spodní hraně tabulky se nachází tlačítka pro **procházení stránek** výpisu a možnost výběru počtu vypsaných záznamů na stránku.


.. _ug_arr_table_view_edit:

Režim úprav
^^^^^^^^^^^
|tz-ru|

|edit| :sm:`Hromadná úprava prvku popisu`

V režimu úprav je možné nad sloupci tabulky provádět hromadné operace.
Níže uvedené akce lze aplikovat na vybrané záznamy *(jednotky popisu)* nebo *hodnoty*.

Najít a nahradit část obsahu
    Prohledá záznamy a provede záměnu části obsahu dle zadání.

  Nastavit celý obsah prvku
    Zapíše zadanou hodnotu ke všem vybraným záznamům.

  Přidat obsah prvku popisu
    Přidá hodnotu opakovatelného prvku ke všem vybraným záznamům.

  Nahradit hodnotu za jinou
    U označených hodnot a záznamů nahradí hodnotu za jinou dle výběru.

  Nahradit specifikaci za jinou
    U označených hodnot a záznamů nahradí zvolenou specifikaci za jinou dle výběru.

  Odstranit celý prvek popisu
    Ze všech záznamů odstraní příslušný prvek popisu.



|tz-ru-nahradit|

.. note::
  Při :ref:`úpravách <ug_arr_table_view_edit>` hodnot opakovatelných prvků popisu
  používajících **specifikace** je v některých případech vhodné omezit danou operaci pouze na vybrané specifikace
  a přesněji určit rozsah hromadné úpravy v dotčených jednotkách popisu.


.. warning::
  Při :ref:`úpravách <ug_arr_table_view_edit>` v tabulkovém zobrazení nejsou aktivně vyhodnocována
  :ref:`Základní pravidla pro zpracování archiválií <ZP2015>`. Provedené změny, které jsou v rozporu s :ref:`pravidly archivního popisu <ZP2015_PRAVIDLA>`,
  jsou zobrazeny jako :ref:`nesrovnalosti <nesrovnalosti>` v pravém panelu :ref:`Pořádání <ug_arr_poradani>`.


.. _ug_arr_table_columns:

Nastavení sloupců
-----------------

Výchozí nastavení tabulkového zobrazení je možné měnit a přímo vybrat prvky popisu,
které se zobrazí v samostatném sloupci.

Tučně jsou zvýrazněny **prvky použité v daném archivním souboru**.
Pomocí šipek je možné prvky jednotlivě nebo hromadně přidat do tabulky.
V závorce je uveden počet jednotek popisu s hodnotou prvku
nebo přiděleným příznakem :ref:`výjimka <prvky_popisu_vyjimka>`.

Pořadí zobrazených sloupců lze upravit označením prvku v pravé části okna
a následným přetažením pomocí myši do cílové pozice.

|tz-sloupce|


.. _ug_arr_table_view_export:

Export tabulkového zobrazení
----------------------------

Záznamy zobrazené v tabulkovém zobrazení lze **stáhnout do souboru CSV** ve dvou variantách:

 1. Tabulka
 2. Data

Oba soubory uvádějí číslo záznamu a číslo jednotky popisu z tabulkového zobrazení, a dále UUID příslušné jednotky popisu.

V souboru Tabulka (table) jsou na samostatných řádcích uváděny jednotky popisu s příslušnými hodnotami prvků popisu.
Jednotlivé řádky souboru Data (data) naopak tvoří hodnoty prvků popisu.

.. warning::

  Soubory CSV exportované z tabulkového zobrazení **nejsou** určeny pro zpětný :ref:`import <ug_arr_table_view_import>` do aplikace.


.. _ug_arr_table_view_import:

Import prvků popisu
---------------------

Pomocí tabulkového zobrazení je možné hromadně **přidat hodnoty prvků popisu** ke stávajícím jednotkám popisu.

Podporované datové typy:

 - DECIMAL
 - ENUM
 - INT
 - RECORD_REF
 - STRING
 - TEXT
 - URI_REF

Pro přidání prvků popisu je třeba vložit **soubor CSV**, kde každý řádek odpovídá jedné jednotce popisu ve tvaru:

 1. UUID jednotky popisu
 2. prvek / prvky popisu

Prvky popisu lze přidat opakovaně v pořadí hodnot:

 1. kód prvku
 2. kód specifikace (pokud pro daný prvek existuje)
 3. hodnota prvku (hodnotou může být i kód specifikace)


**Příklady přidání prvků:**

:ref:`ZP2015_FORMAL_TITLE`: Babička

  *6f8aea87-7580-4622-8e7d-033377c6b56b,ZP2015_FORMAL_TITLE,Babička*

:ref:`ZP2015_OTHER_ID`: číslo jednací: 1234/75

  *069f2e12-b808-4b3f-af48-35c372ae0818,ZP2015_OTHER_ID,ZP2015_OTHERID_CJ,1234/75*

:ref:`ZP2015_UNIT_TYPE`: rukopis

  *161778f7-3a10-4f65-8cc6-019345238207,ZP2015_UNIT_TYPE,ZP2015_UNIT_TYPE_RKP*

Kombinace: :ref:`ZP2015_FORMAL_TITLE`: Divá Bára, :ref:`ZP2015_OTHER_ID`: signatura: 1234/75, :ref:`ZP2015_UNIT_TYPE`: rukopis

  *069f2e12-b808-4b3f-af48-35c372ae0818,ZP2015_FORMAL_TITLE,Divá Bára,ZP2015_OTHER_ID,ZP2015_OTHERID_SIG,1234/75,ZP2015_UNIT_TYPE,ZP2015_UNIT_TYPE_RKP*

.. note::
  Hodnotou u prvků popisu typu **RECORD_REF** (např. :ref:`ZP2015_ENTITY_ROLE`) je ID záznamu archivní entity (číslo z instance ELZA).
  Hodnotu u prvků typu **URI_REF** (např. :ref:`ZP2015_RELATED_UNITS_LINK` ) je třeba vyjádřit ve tvaru [odkaz URI],[textový popisek].

.. warning::
  - Jediné přípustné **kódování CSV souboru** importovaného do tabulkového zobrazení je **UTF-8**.
    Použití jiného kódování může způsobit problémy s diakritikou a písmeny z různých abeced.
  - Pokud hodnota sloupce obsahuje **čárky**, které jsou současně oddělovačem, je nutné
    je během přípravy dat **vložit do uvozovek**: ``"[hodnota sloupce]"``. Např. ``"Svoboda Karel, učitel"``. 