Nahlížecí stránka - 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

Nový kanban je možné vytvořit následujícím způsobem z nahlížecí stránky pomocí toolbaru s ovládacími prvky:

• Nejdříve se kliknutím myši na nahlížecí stránce určí pozice, na kterou má být nový kanban umístěn. Tím dojde ke zvýraznění vybrané pozice šedou horizontální linií. Následně stačí v toolbaru nahlížecí stránky kliknout na položku „Kanban“, v nově otevřeném dialogu vyplnit atributy nového ovládacího prvku, a následně uložit. Tím dojde k vložení nového kanbanu na předem vybrané místo nahlížecí stránky.
• Nedojde-li před vložením nového kanbanu k určení požadované pozice, bude nový kanban vložen na konec nahlížecí stránky.

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 nahlížecí stránce 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 na nahlížecí stránce vertikálně přesouvány metodou Drag&Drop. Přesunutí spočívá v chycení ovládacího prvku nejlépe za jeho název, a následném tažení až na požadované místo na nahlížecí stránce.
• 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
• Práva – Nastavení práv
• Administrace – Nastavení ostatních vlastností

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.
• 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 nahlížecí stránky

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 „Práva“

2.5.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 na nahlížecí stránce.
• U nového ovládacího prvku se práva předvyplní podle ovládacího prvku na pozici určené před jeho vložením; není-li pozice určena, podle práv nahlížecí stránky.

2.5.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é nahlížecí stránky 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ů na nahlížecí stránce 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é nahlížecí stránky je přehled nastavení práv všech ovládacích prvků, který se zobrazí odkazem „Zobrazit přehled...“ na záložce „Práva“ v nastavení nahlížecí stránky.

2.6. Záložka „Administrace“

• Záložka „Administrace“ se zobrazuje pouze u existujících ovládacích prvků.

2.6.1. Umístění

• Výběr nahlížecí stránky, na které je ovládací prvek umístěn.
• Rozbalovací seznam obsahuje nahlížecí stránky umístěné ve stejné aplikaci a ve stejné kategorii jako nahlížecí stránka, na které ovládací prvek stojí. U nahlížecí stránky bez kategorie nabízí jen nahlížecí stránky bez kategorie. U nového ovládacího prvku obsahuje jen aktuální nahlížecí stránku.

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.