.. _ZP2015_PP_NazevJP:

======================
Název jednotky popisu
======================

Prvek :ref:`Název jednotky popisu <ZP2015_NAME>` slouží k pojmenování jednotky popisu.

Prvek byl postupně zaveden na přelomu let 2025–2026 dle `harmonogramu <https://docs.google.com/document/d/1kyiJ3Cv7oD_K7dN4GMzp1Q9gsmzJJVXSeeMkk6Iu5c0/edit?usp=sharing>`_,
který byl diskutován a přijat na jednáních `komunity ELZA <https://github.com/elzasw/elza/wiki/Z%C3%A1pisy-z-jedn%C3%A1n%C3%AD>`_
v letech 2024–2025 na základě uplatnění potřeb archivů při vývoji aplikace.

Předmětem změny je zpřesnění archivního popisu a vzájemného vztahu mezi původními prvky :ref:`ZP2015_TITLE`,
:ref:`ZP2015_UNIT_CONTENT` a :ref:`ZP2015_FORMAL_TITLE` s ohledem na publikaci.

Předpokladem implementace prvku byla **součinnost na straně archivů** v oblasti kontroly
a případné úpravy původních hodnot prvku :ref:`ZP2015_TITLE` před :ref:`migrací dat <ZP2015_PP_NazevJP-migrace>`.

Viz :ref:`základní pravidla kontroly prvku Obsah <ZP2015_PRAVIDLA_KONTROLY_ZAKLADNI_OBSAH>`.

Viz :ref:`rozšířená pravidla kontroly prvku Obsah <ZP2015_PRAVIDLA_KONTROLY_ROZSIRENA>`.

Viz :ref:`vyhledávání chyb v archivních souborech <ug_arr_intro_search>`.

Viz :ref:`nastavení zobrazení pravidel kontroly JP <kontrola>`.

.. note::
   Podoba hodnot prvku :ref:`ZP2015_TITLE` měla dopad na způsob budoucí :ref:`migrace <ZP2015_PP_NazevJP-migrace>` (viz níže).
   Předchozí ověření dat s využitím :ref:`pravidel kontroly popisu <ZP2015_PRAVIDLA_KONTROLY>`
   a funkcionality :ref:`Vyhledávání v archivních souborech <ug_arr_intro_search>`
   záměrně rozlišovalo mezi :ref:`základní <ZP2015_PRAVIDLA_KONTROLY_ZAKLADNI_OBSAH>`
   a :ref:`rozšířenou kontrolou prvku Obsah <ZP2015_PRAVIDLA_KONTROLY_ROZSIRENA>`.
   Cílem bylo dosažení optimálního způsobu migrace do prvku :ref:`Název jednotky popisu <ZP2015_NAME>`.
   Případné předchozí **úpravy** archivního popisu byly **doporučené**
   zejména u jednotek popisu označených :ref:`základní kontrolou <ZP2015_PRAVIDLA_KONTROLY_ZAKLADNI_OBSAH>`,
   **nikoli povinné**, a to zvláště u :ref:`starších archivních pomůcek <ZP2015_PP_ZpusobPoradani>`.
   Výsledná podoba dat po zavedení prvku :ref:`Název jednotky popisu <ZP2015_NAME>`
   vyplývá z konkrétních potřeb a cílů daného archivu v oblasti archivního popisu a jeho publikace.


.. _ZP2015_PP_NazevJP-migrace:

Migrace dat
============

Základní migrace dat probíhá **automaticky při instalaci verze 3.4.0**,
kdy v databázi dochází k přejmenování prvku :ref:`ZP2015_TITLE`
na :ref:`ZP2015_CONTENT`.

.. list-table::

 * - Elza 3.3
   - kód prvku
   - Elza 3.4
   - kód prvku
 * - :ref:`Název jednotky popisu <ZP2015_NAME>`
   - :code:`ZP2015_NAME`
   - :ref:`Název jednotky popisu <ZP2015_NAME>`
   - :code:`ZP2015_NAME`
 * - :ref:`Název s omezením přístupnosti <ZP2015_NAME_PUBLIC>`
   - :code:`ZP2015_NAME_PUBLIC`
   - :ref:`Název s omezením přístupnosti <ZP2015_NAME_PUBLIC>`
   - :code:`ZP2015_NAME_PUBLIC`
 * - :ref:`ZP2015_TITLE`
   - :code:`ZP2015_TITLE`
   - :ref:`ZP2015_CONTENT`
   - :code:`ZP2015_CONTENT`
 * - :ref:`ZP2015_TITLE_PUBLIC`
   - :code:`ZP2015_TITLE_PUBLIC`
   - :ref:`ZP2015_CONTENT_PUBLIC`
   - :code:`ZP2015_CONTENT_PUBLIC`
 * - :ref:`ZP2015_FORMAL_TITLE`
   - :code:`ZP2015_FORMAL_TITLE`
   - :ref:`ZP2015_FORMAL_TITLE`
   - :code:`ZP2015_FORMAL_TITLE`
 * - :ref:`ZP2015_UNIT_CONTENT`
   - :code:`ZP2015_UNIT_CONTENT`
   - :ref:`ZP2015_UNIT_CONTENT`
   - :code:`ZP2015_UNIT_CONTENT`


Finální migrace dat do prvků :ref:`Název jednotky popisu <ZP2015_NAME>` (popřípadě :ref:`Název s omezením přístupnosti <ZP2015_NAME_PUBLIC>`)
a :ref:`ZP2015_CONTENT` proběhne řízeně ze strany uživatele
pomocí :ref:`funkce <ug_arr_functions>` :ref:`Migrace na Název / Obsah, tematický popis <ZP2015_Migrace_Nazev_Obsah>`,
kterou je možné spouštět nad více archivními soubory nebo dle potřeby opakovat.

Po spuštění akce dojde k případnému **přesunu hodnot prvků popisu** v závislosti na jejich kvalitě.
Nevyhovující hodnoty zůstávají v prvcích :ref:`ZP2015_CONTENT`, popřípadě :ref:`ZP2015_CONTENT_PUBLIC` či :ref:`ZP2015_UNIT_CONTENT`:

:ref:`ZP2015_CONTENT` (původně :ref:`ZP2015_TITLE`)

  → :ref:`Název jednotky popisu <ZP2015_NAME>` (hodnoty < 250 znaků jednořádkové)

  → :ref:`ZP2015_CONTENT` (hodnoty > 250 znaků + víceřádkové)

:ref:`ZP2015_CONTENT_PUBLIC` (původně :ref:`ZP2015_TITLE_PUBLIC`)

  → :ref:`Název s omezením přístupnosti <ZP2015_NAME_PUBLIC>` (hodnoty < 250 znaků jednořádkové)

  → :ref:`ZP2015_CONTENT_PUBLIC` (hodnoty > 250 znaků + víceřádkové)

:ref:`ZP2015_UNIT_CONTENT`

  → :ref:`ZP2015_CONTENT` (pokud je :ref:`ZP2015_CONTENT` **prázdný**, respektive jeho hodnota byla převedena do :ref:`Název jednotky popisu <ZP2015_NAME>`)
  
  → :ref:`ZP2015_UNIT_CONTENT` (pokud :ref:`ZP2015_CONTENT` **není prázdný**, respektive jeho hodnota nebyla převedena do :ref:`Název jednotky popisu <ZP2015_NAME>`)

.. note::
   - Prvek :ref:`ZP2015_TITLE` je během aktualizace na Elza 3.4.0 **nahrazen** prvkem :ref:`ZP2015_CONTENT`.
   - Prvek :ref:`ZP2015_TITLE_PUBLIC` je během aktualizace na Elza 3.4.0 **nahrazen** prvkem :ref:`ZP2015_CONTENT_PUBLIC`.
   - Hodnoty více prvků nebudou slučovány do jednoho pole, proto je nutné (dočasné) **ponechání** prvku :ref:`ZP2015_UNIT_CONTENT`, který by však již neměl být používán.
   - Archivy mohou dle kvality vlastních dat, konkrétních potřeb a možností aplikovat **skripty pro převod** (nebo využít jiné dostupné nástroje) díky případné existenci oddělovačů v prvku :ref:`ZP2015_TITLE`
     či jiným možnostem rozlišení hodnot prvků :ref:`Název jednotky popisu <ZP2015_NAME>` a :ref:`ZP2015_CONTENT`.
     Vhodným případem pro použití skriptů mohou být víceřádkové hodnoty prvku :ref:`ZP2015_TITLE`, které již nyní fakticky obsahují název jednotky popisu,
     a to zpravidla na 1. řádku odděleném dvojtečkou, středníkem, čárkou či pouhým odřádkováním (ENTER).
     Export původních a import upravených hodnot prvků popisu je možné realizovat pomocí :ref:`Tabulkového zobrazení <ug_arr_table_view>`.