Editační formulář - Kanban

1. Základní informace

1.1. Popis ovládacího prvku

Kanban je nástěnka o více sloupcích (zdrojích), která zobrazuje události vizualizované ve formě karet.

1.2. Vytvoření nového ovládacího prvku

• Detailní popis vytváření nových ovládacích prvků v editačním formuláři je uveden v samostatné příručce Vytváření ovládacích prvků editačního formuláře.

1.3. Editace nebo smazání ovládacího prvku

• U každého existujícího ovládacího prvku se po jeho levé straně v editačním formuláři zobrazuje ikona tužky, která slouží pro změnu nastavení ovládacího prvku nebo jeho smazání.
• Jednotlivé ovládací prvky mohou být v editačním formuláři vertikálně přesouvány metodou Drag&Drop. Přesunutí spočívá v chycení ovládacího prvku nejlépe za jeho název umístěný v levém sloupci editačního formuláře, a následném tažení až na požadované místo v editačním formuláři.
• Ovládací prvky je možné přesouvat jen se zaškrtnutým polem „Drag&Drop“ umístěným nad toolbarem s ovládacími prvky. Z bezpečnostních důvodů je toto pole po každém přihlášení do aplikace nezaškrtnuté, aby nedošlo k nechtěnému přesunutí ovládacího prvku.

2. Seznam záložek v dialogu nastavení ovládacího prvku

• Obecné – Nastavení obecných vlastností
• Zdroje – Nastavení zdrojů nástěnky
• Text – Nastavení sloupců zobrazovaných na jednotlivých kartách
• Tooltip – Nastavení sloupců zobrazovaných v detailech
• Nápověda – Nastavení textu nápovědy
• Práva – Nastavení práv

2.1. Záložka „Obecné“

2.1.1. Název

• Název ovládacího prvku.

2.1.2. Slovník

• Slovník zobrazuje seznam názvů ostatních ovládacích prvků, formulářů, nahlížecích stránek, kategorií, aplikací a aplikačních skupin, použitých napříč celou aplikací.
• Vyhledávání ve slovníku slouží k navržení správného názvu ovládacího prvku a k udržení konzistence názvosloví v celé aplikaci tak, aby se ovládací prvky se stejným významem umístěné na různých místech v aplikaci nazývaly stejným způsobem.

2.1.3. Šířka

• Šířka ovládacího prvku uvedená v pixelech.
• Při nevyplnění tohoto zadávacího pole se nástěnka roztáhne na celou dostupnou šířku.

2.1.4. Zdroj dat

• Zdroj dat definuje zdrojové databázové záznamy zobrazované na nástěnce.
• Nastavení zdroje dat se provádí v grafickém návrháři databázových dotazů. Detailní popis návrháře databázových dotazů je uveden v samostatné příručce Návrhář databázových dotazů.

• Má-li zdroj dat vyplněné pole „Časový úsek podle“, zobrazí se nad nástěnkou filtr „od-do“. Nejsou-li v dotazu vyplněné výchozí hodnoty „Od“ a „Do“, předvyplní se „Od“ prvním dnem aktuálního měsíce a „Do“ posledním dnem aktuálního roku.
• Obsahuje-li zdroj dat sloupce pro filtrování, zobrazí se nad nástěnkou také filtry. Jsou-li zdroje definované dotazem, zúží filtr nastavený na sloupec formuláře, ze kterého dotaz zdrojů čte, i seznam sloupců nástěnky.

2.1.5. Nadpis

• Výběr sloupce, který určuje nadpis události na nástěnce.

2.1.6. Zdroj

• Výběr sloupce, který určuje zdroj události na nástěnce.
• Zdroje se zobrazují jako jednotlivé sloupce nástěnky.

2.1.7. Možnosti

• Zakázat otevírání záznamů
  • Zaškrtnutí tohoto pole určuje, zda má být všem uživatelům zakázána možnost vstupu do editačního formuláře za účelem otevření zobrazovaného databázového záznamu kliknutím na nadpis karty na nástěnce.
  • Kliknutí na nadpis karty nejdřív uloží záznam editačního formuláře, ve kterém je nástěnka umístěna, a teprve potom otevře záznam karty. Nezměnil-li se záznam formuláře, vynechá se jen samotný zápis do databáze – skripty „OnBeforeSave“ a „OnAfterSave“ se spustí i tak. Nesmí-li uživatel záznam formuláře měnit, záznam se neuloží a skripty se nespustí.
• Povolit hromadné změny
  • Zaškrtnutí tohoto pole určuje, zda má být na nástěnce namísto samotné hodnoty ovládacího prvku zobrazeno textové pole nebo rozbalovací seznam s vybranou hodnotou, s možností změny hodnoty bez nutnosti otevření a editace záznamu v editačním formuláři.
    • Změnit hodnotu přímo na kartě lze jen ve sloupcích zobrazených v textu karty (záložka „Text“), jejichž ovládací prvek má na záložce „Obecné“ zaškrtnuté pole „Povolit hromadné změny“ a na záložce „Nápověda“ v poli „Poznámky“ uvedenou funkci CONTROLINDETAILS().
    • Změněná hodnota se uloží rovnou. Ukládací skripty editačního formuláře „OnBeforeSave“ a „OnAfterSave“ se přitom spustí jen u ovládacího prvku se zaškrtnutým polem „Spustit OnBeforeSave/OnAfterSave před uložením záznamu do databáze“.
    • Zaškrtávací tlačítko lze na kartě přepnout i u ovládacího prvku nastaveného jen ke čtení a u záznamu jiného uživatele, stejně jako v nahlížecí tabulce. Detailní popis zaškrtávacího tlačítka je uveden v samostatné příručce Editační formulář – CheckBox.
    • Anonymní uživatel může hodnoty měnit za stejných podmínek jako přihlášený uživatel, tedy podle práv na editaci záznamu. Všichni anonymní návštěvníci ale vystupují pod jedním uživatelským účtem, a jsou proto vlastníky všech záznamů, které některý z nich založil. Smí-li záznam měnit jeho vlastník, může tak každý anonymní návštěvník měnit i záznamy založené jiným návštěvníkem.

2.2. Záložka „Zdroje“

2.2.1. Zdroje

• Definice zdrojů, které se zobrazují jako jednotlivé sloupce nástěnky.
• Je-li ručně zadaný seznam zdrojů prázdný, vytvoří se sloupce z hodnot sloupce „Zdroj“ v zobrazených záznamech.
• Záznam, jehož hodnota ve sloupci „Zdroj“ neodpovídá žádnému zdroji, se na nástěnce nezobrazí. Nejsou-li definované žádné zdroje, zobrazí se všechny záznamy v jediném sloupci s názvem ovládacího prvku; jsou-li zdroje definované, ale sloupec „Zdroj“ není vybraný, zůstanou sloupce prázdné. Skončí-li dotaz zdrojů chybou, zobrazí se nástěnka stejně jako bez definovaných zdrojů a chyba se zapíše do logu „Errors“.
• V záhlaví každého sloupce je za jeho názvem v závorce uveden počet karet.
• V ručně zadaném seznamu zdrojů lze používat proměnné. Názvy zdrojů zadané vícejazyčně se zobrazují v jazyce uživatele.
• Radio button zdroje obsahuje následující dva typy definice zdroje:
  • Oddělené enterem – seznam hodnot zdrojů je nastaven ručně, do textového pole pomocí hodnot oddělených enterem
  • Z dotazu – seznam zdrojů definuje databázový dotaz, který je vyhodnocen při otevření nebo aktualizaci editačního formuláře

2.2.2. Do databáze uložit ID zdroje

• Zaškrtnutí tohoto pole určuje, zda mají databázové záznamy událostí v hodnotě zdroje uloženou hodnotu cizího klíče, který se odkazuje na primární klíč zdroje.
• Pole se v dialogu nabízí jen při definici zdrojů „Z dotazu“. Záznam se pak do sloupce nástěnky zařadí podle ID záznamu z dotazu zdrojů a názvem sloupce je hodnota prvního sloupce dotazu zdrojů.

2.3. Záložka „Text“

2.3.1. Sloupce

• Definice sloupců zobrazovaných v textovém poli události na kartě nástěnky.

2.4. Záložka „Tooltip“

2.4.1. Sloupce

• Definice sloupců detailů zobrazovaných při najetí myší nad událost nástěnky.
• Tooltip se zobrazí při najetí myší na text karty, a jen u karty, která má neprázdný text ze sloupců záložky „Text“. Na mobilních zařízeních se tooltip nezobrazuje.

2.5. Záložka „Nápověda“

2.5.1. Nápověda

• Nápověda se v editačním formuláři zobrazuje jako ikona nápovědy v záhlaví prvního sloupce nástěnky; text nápovědy se zobrazí po najetí myší na ikonu.
• Text – text nápovědy je definován ručně zadaným textovým řetězcem ve víceřádkovém textovém poli pod radio buttonem
• Volba Z dotazu není u tohoto ovládacího prvku dostupná.
• Detailní popis nápovědy je uveden v samostatné příručce Nastavení vzhledu.

2.6. Záložka „Práva“

2.6.1. Práva

• Práva definují seznam uživatelských skupin a uživatelů, kteří mají oprávnění na zobrazení ovládacího prvku v editačním formuláři.

2.6.2. Nahradit práva ostatním ovládacím prvkům

• Funkce „Nahradit práva ostatním ovládacím prvkům“ slouží pro sjednocení práv v rámci celého editačního formuláře u ovládacích prvků, které spolu z pohledu práv souvisí.
• Díky odkazu „Zobrazit...“ je možné zobrazit seznam všech ovládacích prvků v editačním formuláři včetně nastavení práv těchto ovládacích prvků. U každého ovládacího prvku je zobrazeno zaškrtávací tlačítko, kterým je možné ovládací prvek vybrat. Při uložení ovládacího prvku se následně nastaví stejná práva i těmto vybraným ovládacím prvkům.
• Alternativou pro sjednocení práv v rámci celého editačního formuláře je zobrazení reportu dostupného ze záložky „Práva podřízených objektů“ v nastavení editačního formuláře.

2.7. Tlačítka „Uložit“, „Smazat“ a „Zavřít“

• Tlačítko „Uložit“ – Uložení změn v nastavení ovládacího prvku.
• Tlačítko „Smazat“ – Trvalé odstranění ovládacího prvku.
• Tlačítko „Zavřít“ – Zavření dialogu s nastavením ovládacího prvku bez uložení změn.