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

Nový planner 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ý planner 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 „Planner“, 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 planneru na předem vybrané místo nahlížecí stránky.
• Nedojde-li před vložením nového planneru k určení požadované pozice, bude nový planner 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ů 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
• 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 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.
  • 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ě. Provede-li se navigace naplánovaná tímto skriptem (například funkcí „SCHEDULEVIEWPAGE“), nový záznam se nezaloží. 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 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í 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 „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 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.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é 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.7. Záložka „Administrace“

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

2.7.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.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. Ikona „Tisk...“ se nabízí jen na počítači, ne na mobilním zařízení.
• 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.