Operace - záložka Detail

Zobrazí detailní informace k aktuální definici operace ze záložky Seznam. Položky zadávané ke každé definici operace jsou standardně rozděleny do subzáložek dle svého významu:

Obsažené subzáložky: Hlavní údaje Formuláře

Pokud je v detailu agendy nebo číselníku pouze jedna aktivní subzáložka k výběru, lišta s výběrem subsáložek se nezobrazuje.

V horní části záložky Detail může být variantně zobrazen některý z Panelů definovatelných údajů detailu pro tuto agendu. Zobrazení panelu definovatelných údajů detailu závisí na aktuálním nastavení v menu Nastavení pro danou agendu a přihlášeného uživatele.

Subzáložka Hlavní údaje

Subzáložka slouží pro zadání základních údajů o daném záznamu. Obsahuje:

Hlavičkové údaje

V horní části subzáložky je ke každé operaci možné zadávat položky:

Název Popis
Název

Název definované operace. Jak bylo řečeno v kap. Věcný obsah - Definování operací, jedná se o jméno, pod kterým se tato operace zobrazuje v prohlížeči a zároveň je to jméno, kterým se tato operace volá. Název musí být unikátní v rámci služby, ke které je operace přiřazena. Měl by být co nejvýstižnější, aby usnadňoval pozdější orientaci v seznamu operací. Povinná položka.

Nesmí obsahovat diakritiku, některé ASCII znaky jako např. mezery. Povoleny jsou písmena A-Z a číslice. Při změně názvu probíhá kontrola, zda již neexistuje operace se stejným názvem v rámci služby, ke které je operace připojena. Název je case sensitiveClosed Je-li nějaká položka case insensitive, znamená to, že není citlivá na velká a malá písmena, neboli nerozlišuje velká a malá písmena. Tzn., že není rozdíl, je-li napsáno např. "Abc" nebo "abc". Opak je case sensitive., tj. rozlišuje velká/malá písmena.
Procedura/ Funkce

Specifikace, zda se jedná o proceduru nebo funkci.

Po zvolení hodnoty Funkce je automaticky přidán parametr jména Result, pokud takový dosud mezi parametry uveden není.
Skript

Jak bylo řečeno v kap. Věcný obsah - Definování operací, požadovaná funkcionalita (to, co má daná operace vlastně vykonat) je realizována pomocí skriptování, tj. ke každé operaci musí být definována odpovídající metoda v nějakém balíčku v agendě Balíčky skriptů. Tudíž zde je třeba zadat odkazy pro volání obsluhy do skriptování. Pokud daná metoda dosud neexistuje, je možné si hlavičku pro ni rovnou z této agendy nechat založit pomocí funkce Vytvořit hlavičku. Údaje, které je potřeba zadat:

Další související položky:
Jméno balíčku Identifikace balíčku skriptů, který obsahuje požadovanou proceduru/funkci. Balíček musí obsahovat skript druhu Knihovna. Povinná položka.
Jméno knihovny Jméno skriptovací knihovny z daného balíčku obsahující potřebnou proceduru/funkci. Bez vyplnění této položky nemá definice operace význam.
Jméno metody Název skriptovací procedury/funkce obsažené v dané knihovně, která implementuje požadovanou funkcionalitu. Bez vyplnění této položky nemá definice operace význam.

Pozor! Názvy balíčku, knihovny a metody nesmí obsahovat diakritiku, mezery a některé další speciální ASCII znaky. Povoleny jsou písmena A-Z a číslice. Jména ve skriptování totiž nesmí obsahovat mezery ani jiné speciální znaky.

Zde se jména balíčků, jméno knihovny a jména funkcí z dané knihovny z odkazovaného balíčku nenabízí (jako je tomu např. v agendě Funkce pro zajištění), jelikož zde se spíše předpokládá opačný postup: nejdříve zadat záznam operace a teprve poté k němu dodefinovat nový odpovídající skript.

Položky jsou k dispozici i tehdy, pokud není k dispozici agenda Balíčky skriptů, tj. pokud není nainstalováno skriptování. V takovém případě je ale nelze použít (systém ABRA Gen nahlásí chybu), ovšem v takovém případě nemá ani význam definovat operace.

Parametry operace

Jedná se o prvek editovatelný seznam pro zadání vstupně/výstupních parametrů celé operace. Jak bylo řečeno v kap. Věcný obsah - Definování operací, jde-li o funkci, musí obsahovat parametr Result.

Pozor, každá metoda obsluhující ve skriptování určitou webovou operaci přebírá jako první parametr hodnotu Self. Tento parametr se ale nikde v definici operace neuvádí. Dále viz Parametr Self.

Zadávané položky:

Název Popis
Jméno parametru Zadáte jméno parametru. Jméno Result je vyhraženo pro operace typu Funkce a parametr tohoto jména je přidán automaticky (a naopak automaticky odebrán, je-li definice operace změněna na typ Procedura). Dále viz Definování operací.
Typ parametru Položka typu skrytý seznam, kde vyberete typ parametru (číslo, řetězec, BusinessObject, …).
Příznaky parametru

Položka typu skrytý seznam, kde vyberete jednu z hodnot:

  • Bez příznaků - v tom případě se jedná pouze o vstupní parametr.
  • Var - tzn., že se jedná o vstupně/výstupní parametr, jehož hodnotu může operace modifikovat a upravená hodnota bude přenesena zpět.

Lišta navigátoru

Pod editovatelným seznamem v dolní části subzáložky je k dispozici lišta navigátoru:

VložitPřidatVymazat

Navigátor v záložce Detail této agendy

Navigátor v této záložce obsahuje tlačítka:

  • Pro pohyb kurzoru po řádcích (na začátek, předchozí řádek, další řádek, na konec) editovatelného seznamu, změně jejich pořadí a dále hledání hodnoty v seznamu. Pořadí parametrů má význam při volání operace.
  • Vložit - Pro vložení nového řádku před aktuální řádek (na němž stojí kurzor).
  • Přidat - Pro přidání nového řádku na konec.
  • Vymazat - Pro vymazání aktuálního řádku.

Subzáložka Formuláře

Subzáložka je k dispozici pouze, je-li v menu Nastavení aktuálně zatržena volba pro zobrazení uživatelských formulářů. Umožňuje vybírat si z nadefinovaných uživatelských vstupních formulářů a zobrazovat a zadávat si skrz ně potom jednotlivé údaje.

Pravidla pro použití této záložky jsou pro všechny agendy, ve kterých se může vyskytnout, společná a byla podrobně popsána v kap. Záložka Formuláře - obecně.

Zobrazení seznamu v Detailu

V některé části této záložky může být zobrazen Seznam (Panel pro zobrazení seznamu na jiných záložkách), tedy záznamy ze záložky seznam (podrobněji viz Společné prvky v číselnících - záložka Detail).

Zobrazení seznamu závisí na aktuálním nastavení v menu Nastavení pro danou agendu a přihlášeného uživatele.

Funkce k záložce Detail v této agendě:

Podmnožina funkcí obsažených v záložce Seznam.

Název Kl. Doplňující popis:
Předvyplnit parametry... - Vyvolá funkci "Parametry pro obsluhu volání HTTP protokolu", která předvyplní parametry operace parametry pro standardní volání

V editačním režimu jsou navíc k dispozici standardní funkce pro režim editace v číselnících. Obecné zásady pro editaci v číselnících viz kap. Editace záznamů v číselnících.