Editační formulář - Planner

1. Základní informace

1.1. Popis ovládacího prvku

Planner je vícezdrojový plánovací kalendář.

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ů plánovacího kalendáře
• Dostupnosti – Nastavení dostupností
• Text – Nastavení sloupců zobrazovaných v plánovacím kalendáři
• 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 zobrazovaný v záhlaví plánovacího kalendáře.

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 bude šířka plánovacího kalendáře nastavena na maximální šířku obrazovky.

2.1.4. Zdroj dat

• Zdroj dat definuje zdrojové databázové záznamy zobrazované v plánovacím kalendáři.
• 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ů.

2.1.5. Od-Do

• Výběr textového sloupce, do kterého se při založení nového záznamu kliknutím na volné místo a při přesunutí události nebo změně jejího začátku či konce dosadí jeho výchozí hodnota, má-li událost rozdílný začátek a konec. Má-li začátek a konec shodný, zůstane tento sloupec i sloupec „Do“ prázdný.
• Zobrazení událostí v plánovacím kalendáři se podle tohoto sloupce neřídí.

2.1.6. Od

• Výběr sloupce, který určuje počáteční datum události v plánovacím kalendáři.

2.1.7. Do

• Výběr sloupce, který určuje koncové datum události v plánovacím kalendáři.

2.1.8. Nadpis

• Výběr sloupce, který určuje nadpis události v plánovacím kalendáři.
  • Čas – Zaškrtnutí tohoto pole určuje, zda se před nadpisem události zobrazí čas jejího začátku a konce ve formátu „HH:mm - HH:mm“. U události, která začíná i končí o půlnoci, se čas nezobrazí.

2.1.9. Zdroj

• Výběr sloupce, který určuje zdroj události v plánovacím kalendáři.
• Zdroje se zobrazují jako jednotlivé sloupce plánovacího kalendáře.
• Událost se zobrazí ve sloupci zdroje, kterému odpovídá její hodnota ve sloupci „Zdroj“ (se zaškrtnutým polem „Do databáze uložit ID zdroje“ ID záznamu zdroje). Událost, které neodpovídá žádný zdroj, se nezobrazí – to platí i tehdy, když sloupec „Zdroj“ není vybraný. Výjimkou je jediný zdroj, nemá-li dotaz zdrojů na záložce „Filtry“ definované žádné filtry: v jeho sloupci se zobrazí všechny události, a to i ve sloupci „Výchozí zdroj“.

2.1.10. Barva

• Výchozí barva všech událostí v plánovacím kalendáři.
• Každá událost může mít nastavenou svojí vlastní barvu. V nastavení zdroje dat musí být nastaven sloupec „Barva podle“, podle kterého se následně určuje barva události.

2.1.11. Možnosti

• Povolit zadávání nových záznamů
  • Zaškrtnutí tohoto pole určuje, zda má být umožněno přesměrování uživatele do konkrétního editačního formuláře za účelem založení nového záznamu v databázi kliknutím na volné místo v buňce plánovacího kalendáře.
• Spustit skript
  • Zaškrtnutí tohoto pole určuje, zda má být před vstupem do editačního formuláře za účelem založení nového záznamu v databázi spuštěn skript, který typicky plánuje vyplnění dalších hodnot pomocí serverové funkce „SCHEDULEDEFAULTVALUE“ nebo „SCHEDULEDEFAULTVALUES“. Detailní popis serverových funkcí je uveden v samostatné příručce Serverové funkce.
  • Ve skriptu je možné používat následující proměnné. Detailní popis proměnných je uveden v samostatné příručce Proměnné.
    • #plannerid#
    • #plannerfrom#
    • #plannerto#
    • #plannerresource#
  • Proměnná #plannerid# má v tomto skriptu vždy hodnotu „0“. Proměnné #plannerresourcefrom# a #plannerresourceto# jsou v tomto skriptu prázdné, plní je jen přesunutí události na jiný zdroj.
• 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 událost v plánovacím kalendáři.
  • Kliknutí na událost nejdřív uloží záznam editačního formuláře, ve kterém je plánovací kalendář umístěn, a teprve potom otevře záznam události. 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í.
  • Zákaz se týká kliknutí na událost. Přesunutí události nebo změna jejího začátku či konce metodou Drag&Drop otevře editační formulář i se zaškrtnutým polem (není-li zaškrtnuté pole „Povolit hromadné změny“); přesunutí zamezí až zaškrtnutí pole „Zakázat Drag&Drop“.
• Zakázat Drag&Drop
  • Zaškrtnutí tohoto pole určuje, zda má být zakázáno přesouvání událostí plánovacího kalendáře metodou Drag&Drop.
  • Přesunutí události nebo změna jejího začátku či konce tažením otevře editační formulář záznamu s předvyplněným novým termínem a zdrojem; změna se uloží až uložením editačního formuláře.
  • Je-li zaškrtnuté pole „Povolit hromadné změny“, uloží se nový termín a zdroj rovnou, bez otevření editačního formuláře a bez spuštění jeho skriptů, a to jen u záznamu, který smí uživatel měnit. Stejně tak kliknutí na volné místo rovnou založí nový záznam.
• Zobrazovat zkrácený název dne
  • Zaškrtnutí tohoto pole určuje, zda má být v řádkách plánovacího kalendáře spolu s datumem daného dne zobrazen také zkrácený název dne.
• Povolit hromadné změny
  • Zaškrtnutí tohoto pole určuje, zda se přesunutí události, změna jejího začátku či konce a kliknutí na volné místo uloží rovnou, bez otevření editačního formuláře (viz „Zakázat Drag&Drop“).
    • Takto uložený záznam neprochází validací editačního formuláře ani jeho skripty.
    • Nově založený záznam dostane jen termín, zdroj a hodnoty naplánované skriptem z pole „Spustit skript“, který se před založením záznamu spustí i v tomto případě. Výchozí hodnoty ovládacích prvků editačního formuláře se nepoužijí, s výjimkou sloupce „Od-Do“.
    • Platí to i pro anonymního uživatele. Přesunout smí uživatel jen událost, kterou smí podle práv měnit; nový záznam se založí vždy. 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 plánovacího kalendáře.
• 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í a uplatní jen při definici zdrojů „Z dotazu“.

2.3. Záložka „Dostupnosti“

• Definice dostupností, které určují, kdy je zdroj volný pro naplánování nové události.
• V zobrazení „Dny“ se části dostupnosti, které nepokrývají události daného zdroje začínající v témže dni, vykreslí ve sloupci zdroje jako bloky volného úseku. Dostupnosti se v tomto zobrazení uplatní jen tehdy, je-li vybraný sloupec „Zdroj“ na záložce „Obecné“.
• V zobrazení „Hodiny“ se dostupnosti nevykreslují jako bloky. Časové úseky zobrazeného dne, které spadají do dostupnosti zdroje, mají bílé pozadí, ostatní časové úseky šedé.

• Kliknutí na blok volného úseku se chová stejně jako označení dnů, které blok zabírá, ve sloupci jeho zdroje; bez zaškrtnutého pole „Povolit zadávání nových záznamů“ se nestane nic. Blok volného úseku nelze přesouvat metodou Drag&Drop.

2.3.1. Zdroj dat

• Zdroj dat definuje zdrojové databázové záznamy dostupností v plánovacím kalendáři.
• 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ů.

2.3.2. Od

• Výběr sloupce, který určuje počáteční datum dostupnosti v plánovacím kalendáři.

2.3.3. Do

• Výběr sloupce, který určuje koncové datum dostupnosti v plánovacím kalendáři.

2.3.4. Nadpis

• Výběr sloupce, který určuje nadpis dostupnosti. V zobrazení „Dny“ se blok volného úseku zobrazí s textem „Volno - nadpis dostupnosti“, je-li vybraný sloupec „Nadpis“ na záložce „Obecné“.

2.3.5. Zdroj

• Výběr sloupce, který určuje zdroj dostupnosti v plánovacím kalendáři – zdroj, pro který je dostupnost určena.

2.4. Záložka „Text“

2.4.1. Sloupce

• Definice sloupců zobrazovaných v textovém poli události plánovacího kalendáře.

2.5. Záložka „Tooltip“

2.5.1. Sloupce

• Definice sloupců detailů zobrazovaných při najetí myší nad událost plánovacího kalendáře.

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

2.6.1. Nápověda

• Nápověda se v editačním formuláři zobrazí po kliknutí na tlačítko „Nápověda...“ v liště ikon, která se objeví po najetí myší na záhlaví plánovacího kalendáře; na existenci nápovědy upozorňuje ikona v záhlaví.
• 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.7. Záložka „Práva“

2.7.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.7.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.8. 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.

3. Práce s plánovacím kalendářem

• Plánovací kalendář nabízí zobrazení Dny a Hodiny.
• V zobrazení „Dny“ přepne kliknutí na datum v levém sloupci plánovací kalendář do zobrazení „Hodiny“ na tomto dni.
• Je-li zobrazených zdrojů více, zobrazí kliknutí na název zdroje v záhlaví jen tento zdroj a k jeho názvu se doplní „(Aktivní)“; další kliknutí zobrazí znovu všechny vybrané zdroje.
• Ikona „Zobrazit zdroje“ v titulku plánovacího kalendáře zobrazí seznam zdrojů, ve kterém se vybírají zobrazené zdroje; ikona „Skrýt zdroje“ ho opět skryje.
• Rozbalovací seznamy v zápatí určují šířku plánovacího kalendáře (100 až 1000 %), v zobrazení „Dny“ počet týdnů zobrazených před vybraným datem (0 až 13, 26 nebo 52) a od něj (1 až 13, 26 nebo 52) a v zobrazení „Hodiny“ první zobrazenou hodinu (0:00 až 10:30) a poslední zobrazenou hodinu (16:00 až 24:00).
• Zvolené zobrazení, vybraný zdroj, výběr zobrazených zdrojů, šířku, počet zobrazených dnů a rozsah zobrazených hodin si plánovací kalendář pamatuje pro každého uživatele zvlášť. Zobrazené datum se obnoví při tisku, po návratu z editačního formuláře otevřeného z plánovacího kalendáře a tehdy, pracoval-li uživatel s plánovacím kalendářem během posledních 10 minut; jinak se plánovací kalendář otevře na dnešním dni.
• Anonymnímu uživateli se nastavení plánovacího kalendáře neukládá.
• Nejsou-li definované žádné zdroje, zobrazí se jediný sloupec „Výchozí zdroj“. Skončí-li dotaz zdrojů chybou, zobrazí se rovněž jediný sloupec „Výchozí zdroj“ a chyba se zapíše do logu „Errors“.
• 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.