.. _ug_arr_publication:

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

=========
Publikace
=========

Sekce *Publikace* slouží pro řízené **zpřístupňování archivního popisu** prostřednictvím publikačních systémů.

Uživatel má v závislosti na přiděleném :ref:`oprávnění <ug_admin_perms_fund>`
možnost připravit export dat do příslušného systému,
sledovat stav exportu včetně případných chyb
a získat kontinuální přehled o publikaci archivního popisu v rámci daného archivního souboru.

.. _ug_arr_publication_admin:

Horní panel
===========

Kontextová část horního panelu obsahuje tyto ovládací prvky:

|newspaper| :ref:`Správa publikačních systémů <ug_arr_publication_admin>`

  Umožňuje spravovat nastavení komunikace s publikačními systémy.


Správa publikačních systémů
---------------------------

Pro **nastavení komunikace s publikačními systémy** jsou k dispozici ovládací prvky:

``Přidat``
   Založí nový záznam publikačního systému.

``Uložit``
   Uloží změnu nastavení publikačního systému.

``Obnovit``
   Zruší provedené změny nastavení.

``Deaktivovat``
   Zneaktivní záznam vybraného publikačního systému, který se následně nenabízí pro spuštění exportu dat.

``Aktivovat``
   Aktivuje záznam publikačního systému.

|deleteRegular| :sm:`Smazat`
   Odstraní záznam publikačního systému.


Pro **popis vlasností publikačního systému** jsou dostupné atributy:

    Název
        Název publikačního systému.
    
    Kód
        Kód publikačního systému.
    
    Typ připojení
        Volba typu připojení dle povahy systému (produkční, testovací nebo vývojové prostředí).

    Počet uložených exportů
        Určí počet záznamů, které se zobrazují v přehledu exportů ve :ref:`spodním panelu <ug_arr_publication_sp>`.
        Hodnota „0“ zobrazí neomezený počet záznamů.

    Filtr
        Umožňuje nastavit příslušný :ref:`filtr omezení přístupnosti <meths_filtry>`, který je uplatněn při publikaci.
    
    Požadované oprávnění
        Určí konkrétní :ref:`oprávnění <ug_admin_perms_fund>`, které je nutné pro spuštění exportu dat do vybraného publikačního systému.


.. note::
  Volba požadovaného :ref:`oprávnění <ug_admin_perms_fund>` pro publikaci do externího systému
  umožňuje přizpůsobit nastavení publikace konkrétnímu **rozdělení kompetencí a rolí v daném archivu**.
  Například pro publikaci do testovacího prostředí může být požadováno pouze oprávnění *Export*,
  které umožňuje běžný export archivního popisu do souboru na disku.
  Oprávnění *Publikování* může být v administraci přidělováno pouze uživatelům,
  kteří jsou oprávněni spustit export archivního popisu do publikačního systému v produkčním prostředí.


.. _ug_arr_publication_sp:

Spodní panel
============

Ve spodním panelu je k dispozici **přehled exportů archivního popisu** do publikačního systému v čase,
včetně případných chybových stavů.
U každého exportu dat je možné sledovat jeho stav
v závislosti na kvalitě dat a komunikaci s publikačním systémem.

K dispozici jsou ovládací prvky:

``Publikovat: [název]``
  Spustí export dat do publikačního systému uvedeného v názvu.

``Sloupce``
  Umožňuje nastavit zobrazení jednotlivých atributů:

    Systém
        Název publikačního systému

    Stav
        :ref:`Stav exportu <ug_arr_publication_state>` do publikačního systému.
  
    Uživatel
       Identifikace uživatele, který spustil export do publikačního systému.

    Vytvořeno
       Datum spuštění exportu.

    Připraveno
       Datum dokončení exportu.
    
    Publikováno
       Datum zpřístupnění exportu v publikačním systému.
 
    Naposledy staženo
       [?] Datum posledního stažení exportu.

    Zneplatněno
       Datum zneplatnění exportu.

    Čas chyby
       Datum vzniku chybového stavu.

    Chybová zpráva
       Popis chybového stavu.


Volbou z menu (ikona |dots|) lze s exportem provádět následující **akce**:

|arrowDownloadRegular| :sm:`Stáhnout`
  Uloží export do XML.

|copyRegular| :sm:`Kopírovat do ...`
  Umožňuje zkopírovat stejný export do jiného publikačního systému [?] se shodným nastavením :ref:`filtru omezení přístupnosti <meths_filtry>`.

|deleteRegular| :sm:`Odstranit`
  Odstraní export v jakémkoli stavu. 


.. note::
  - Možnost **kopírování exportu** lze využít při standardním postupu, kdy je export nejprve odeslán do testovacího prostředí.
    Daný export ke stejnému datu (se stejným obsahem dat) lze následně odeslat také do produkčního prostředí.
  - Pro **odstranění exportu** je vyžadováno :ref:`oprávnění <ug_admin_perms_other>` *Superuživatel*. 

.. warning::
  Export lze připravit vždy jen z :ref:`aktuální verze archivního souboru <ug_arr_version>`.


.. _ug_arr_publication_state:

Stavy exportu do publikačního systému
-------------------------------------

  Nový
    Spuštění exportu.

  Připravený
    Dokončení exportu.
  
  Převzatý
    Převzetí exportu ze strany publikačního systému.
  
  Publikováno
    Zpřístupnění exportu v publikačním systému.
  
  Chyba při přípravě
    Chyba na straně přípravy ve zdrojovém systému.
  
  Chyba při publikaci
    Chyba na straně publikačního systému.
  
  Zneplatněný
    Zneplatnění exportu, který již není možné stáhnout.

.. note::
  *Chyba při přípravě* je konečným stavem a může být **vyřešena** pouze opravou dat dle chybové zprávy a novým exportem.
  Stav *Chyba při publikaci* se změní do stavu *Publikováno*, pokud dojde na straně publikačního systému k odstranění chyby.