Nahlížecí stránka - TimeTable

1. Základní informace

1.1. Popis ovládacího prvku

TimeTable je rozvrh hodin nebo ganttův diagram.

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

Novou timetable 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á timetable umístěna. 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 „TimeTable“, 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é timetable na předem vybrané místo nahlížecí stránky.
• Nedojde-li před vložením nové timetable k určení požadované pozice, bude nová timetable vložena 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ů ganttova diagramu
• Text – Nastavení sloupců zobrazovaných v rozvrhu hodin nebo ganttově diagramu
• 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í rozvrhu hodin nebo ganttova diagramu.

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. Zdroj dat

• Zdroj dat definuje zdrojové databázové záznamy zobrazované v rozvrhu hodin nebo ganttově diagramu.
• 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.4. Typ

• Ganttův diagram
• Rozvrh hodin A – rozvrh hodin s buňkami po 15 minutách
• Rozvrh hodin B – rozvrh hodin s buňkami po hodinách
• Pole „Výchozí“ a „Nadpis“ se v dialogu nabízejí jen u typu „Ganttův diagram“.

• Rozvrh hodin zobrazuje jeden týden – týden prvního zobrazeného záznamu, a nejsou-li zobrazené žádné záznamy, aktuální týden. Řádky tvoří dny od pondělí do pátku; sobota a neděle se doplní, začíná-li v některé z nich událost. Sloupce tvoří hodiny od 6 do 22, rozšířené tak, aby se vešly události, které začínají dříve nebo končí později.
• Končí-li název ovládacího prvku znaky „++“, zobrazí se v rozvrhu hodin sobota a neděle vždy; znaky „++“ se v názvu prvku nezobrazují.
• Počet v titulku prvku ve tvaru „x / y“ udává, kolik událostí je zobrazených (x) z celkového počtu načtených záznamů (y).

2.1.5. Výchozí

• Výchozí zobrazení ganttova diagramu určuje způsob seskupování událostí podle datumu. Uživatel si zobrazení mění v záhlaví ganttova diagramu a zvolené zobrazení se mu pamatuje (anonymnímu uživateli ne); změna tohoto pole a uložení ovládacího prvku přenastaví zobrazení všem uživatelům.
• Má-li zdroj dat vyplněné pole „Časový úsek podle“, zobrazí se nad ganttovým diagramem 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“ podle zobrazení: u dnů posledním dnem třetího a u týdnů posledním dnem šestého měsíce počítáno od aktuálního měsíce, u měsíců posledním dnem roku o dva roky pozdějšího a u roků posledním dnem roku o devět let pozdějšího.
• Zobrazené období se u dnů zkrátí nejvýše na jeden rok, u týdnů na sedm let a u měsíců na dvacet let. Je-li ve filtru „od-do“ zadané „Do“ dřívější než „Od“, nastaví se „Do“ na hodnotu „Od“; je-li zadané období kratší než jeden měsíc, prodlouží se „Do“ na datum o měsíc pozdější než „Od“. Upravená hodnota „Do“ se zapíše i do filtru. Bez pole „Časový úsek podle“ zobrazí ganttův diagram období od nejstaršího po nejnovější zobrazený záznam se stejnými omezeními.
• Rozbalovací seznam nabízí následující způsoby seskupování:
  • Dny – seskupování událostí podle dne
  • Týdny – seskupování událostí podle týdne
  • Měsíce – seskupování událostí podle měsíce
  • Roky – seskupování událostí podle roku

2.1.6. 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 předvyplní jeho výchozí hodnota, má-li nová 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 rozvrhu hodin ani v ganttově diagramu se podle tohoto sloupce neřídí.

2.1.7. Od

• Výběr sloupce, který určuje počáteční datum události v rozvrhu hodin nebo ganttově diagramu.

2.1.8. Do

• Výběr sloupce, který určuje koncové datum události v rozvrhu hodin nebo ganttově diagramu.
• Konec bez času (o půlnoci) znamená, že událost trvá do konce daného dne.

2.1.9. Nadpis

• Výběr sloupce, který určuje nadpis (zdroj) události v rozvrhu hodin nebo ganttově diagramu.
• Nadpisy (zdroje) se zobrazují jako jednotlivé řádky ganttova diagramu.
• Vedle sloupce nadpisu lze vybrat druhý sloupec. Nejsou-li zdroje zadané ručně ani dotazem, tvoří řádky ganttova diagramu kombinace obou hodnot oddělené lomítkem („ / “); prázdná druhá hodnota se nepřipojuje. Se zdroji zadanými ručně nebo dotazem se události přiřazují k řádkům jen podle hodnoty prvního sloupce.

2.1.10. Barva

• Výchozí barva všech událostí v rozvrhu hodin nebo ganttově diagramu.
• 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 rozvrhu hodin nebo ganttova diagramu.
  • Kliknutí na volné místo jen předvyplní termín a zdroj jako výchozí hodnoty a otevře editační formulář; nový záznam vznikne až jeho uložením. Skript z pole „Spustit skript“ se spouští jen tehdy, když je toto pole zaškrtnuté.
• Spustit skript
  • Zaškrtnutí tohoto pole určuje, zda bude 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é.
    • #timetablefrom#
    • #timetableto#
    • #timetableresource#
• Zakázat otevírání záznamů
  • Zaškrtnutí tohoto pole určuje, zda bude 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 rozvrhu hodin nebo ganttově diagramu.

2.2. Záložka „Zdroje“

• Definice zdrojů, které se zobrazují jako jednotlivé řádky ganttova diagramu.
• 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
    • Skončí-li dotaz zdrojů chybou, zobrazí se ganttův diagram bez řádků a chyba se zapíše do logu „Errors“.

2.2.1. 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 „Text“

2.3.1. Sloupce

• Definice sloupců zobrazovaných v textovém poli události rozvrhu hodin nebo ganttova diagramu.

2.4. Záložka „Tooltip“

2.4.1. Sloupce

• Definice sloupců detailů zobrazovaných při najetí myší nad událost rozvrhu hodin nebo ganttova diagramu.

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.