PAS formuláře
=============

Definice formulářů.

Třídy
------

.. py:class:: ProjectModelChoiceField

   Třída pro správně zobrazení label.

   **Metody:**

   .. py:method:: label_from_instance()

      Provádí operaci label from instance.

      :param obj: Parametr ``obj`` pracuje se s atributy ``ident_cely``, ``vedouci_projektu``, vstupuje do návratové hodnoty.

      :return: Vrací hodnotu podle větve zpracování.


.. py:class:: PotvrditNalezForm

   Hlavní formulář pro potvrzení nálezu lokality.

   **Metody:**

   .. py:method:: __init__()

      Inicializuje instanci třídy.

      :param args: Parametr ``args`` se předává do volání ``__init__()``.
      :param readonly: Parametr ``readonly`` slouží jako vstup pro logiku funkce ``__init__``.
      :param predano_required: Parametr ``predano_required`` slouží jako vstup pro logiku funkce ``__init__``.
      :param predano_hidden: Parametr ``predano_hidden`` ovlivňuje větvení podmínek; pokud je ``True``, pole ``predano_organizace`` se nezahrne do layoutu formuláře.
      :param kwargs: Parametr ``kwargs`` se předává do volání ``__init__()``.


.. py:class:: CreateSamostatnyNalezForm

   Hlavní formulář pro vytvoření, editaci a zobrazení samostatnýho nálezu.

   **Metody:**

   .. py:method:: __init__()

      Inicializuje instanci třídy.

      :param args: Parametr ``args`` se předává do volání ``__init__()``.
      :param readonly: Parametr ``readonly`` ovlivňuje větvení podmínek.
      :param user: Parametr ``user`` se předává do volání ``ProjectModelChoiceField()``, ``filter()``, pracuje se s atributy ``moje_spolupracujici_organizace``, ``moje_stavy_pruzkumnych_projektu``.
      :param required: Parametr ``required`` ovlivňuje větvení podmínek.
      :param required_next: Parametr ``required_next`` slouží jako vstup pro logiku funkce ``__init__``.
      :param project_ident: Identifikátor ``project_ident`` používaný pro dohledání cílového záznamu.
      :param kwargs: Parametr ``kwargs`` se předává do volání ``__init__()``, pracuje se s atributy ``pop``.


.. py:class:: CreateZadostForm

   Hlavní formulář pro vytvoření, editaci a zobrazení žádosti o spoluprácu.

   **Metody:**

   .. py:method:: __init__()

      Inicializuje instanci třídy.

      :param args: Parametr ``args`` se předává do volání ``__init__()``.
      :param kwargs: Parametr ``kwargs`` se předává do volání ``__init__()``.


.. py:class:: PasFilterForm

   Implementuje komponentu ``PasFilterForm`` v rámci aplikace.


.. py:class:: DeaktivovatSpolupraciForm

   Formulář pro deaktivaci záznamu. Obsahuje jen text pole pro zdůvodnění deaktivace.

   **Metody:**

   .. py:method:: __init__()

      Inicializuje instanci třídy.

      :param args: Parametr ``args`` se předává do volání ``__init__()``.
      :param kwargs: Parametr ``kwargs`` se předává do volání ``__init__()``.


.. py:class:: EditSpolupraceProjektyForm

   Formulář pro editaci přiřazených projektů ke spolupráci.

   **Metody:**

   .. py:method:: __init__()

      Inicializuje instanci třídy.

      :param args: Parametr ``args`` se předává do volání ``__init__()``.
      :param vedouci_organizace: Organizace vedoucího spolupráce pro filtrování dostupných projektů.
      :param kwargs: Parametr ``kwargs`` se předává do volání ``__init__()``.


Funkce
------

.. py:function:: validate_uzivatel_email(email)

   Funkce pro validaci zadaného emailu uživatele.

   :param email: Uživatel nebo osoba ``email``, v jejímž kontextu se operace provádí.

   :raises ValidationError: Vyvolá se při splnění podmínky ``not user.exists()``; nebo při splnění podmínky ``user[0].hlavni_role not in Group.objects.filter(id__in=(ROLE_ARCHEOLOG_ID, ROLE_ADMIN_ID, ROLE_ARCHIVAR_ID))``.