WebIS – manuál | ||
---|---|---|
Předcházející | Kapitola 2. Obecné kapitoly | Další |
Šablonou se v tomto případě rozumí předvyplněný objekt vázaný na zvolený kontejner. Pokud v něm vytvoříte nový objekt, automaticky se do něj zkopírují vyplněná pole ze šablony, která je nastavena jako první v seznamu šablon (aktivní šablona). Každý kalendář může obsahovat více než jednu šablonu.
Při vytváření nové šablony můžete využít jinou šablonu ze stejného nebo nadřazeného kontejneru výběrem v menu Šablony v ....
Při vytváření nového objektu se do něj automaticky vyplní údaje z aktivní šablony kontejneru. V menu Šablona můžete zvolit jinou šablonu nebo zadat hodnotu = bez šablony =. Při vytváření nových objektů nelze využívat šablony z jiných kontejnerů. Globální šablony nenavázané na žádný kontejner prozatím nejsou k dispozici. V případě, že v objektu upravíte některá pole ručně, při přepnutí na nějakou šablonu se z ní nahrají jen ta pole, která upravena nebyla. Toto pravidlo se netýká polí, která jsou prázdná.
V libovolném poli objektu lze používat různé proměnné WebISu. Ty lze s výhodou využívat především při zadávání nových objektů do skupinových nebo sdílených kontejnerů.
Proměnné se zadávají ve tvaru ${promenna:parametr}, kde parametr někdy nemusí být přítomen. Následuje výpis nejběžnějších proměnných:
t – aktuální čas. Bez parametru vypíše jednoznačné časové razítko (počet sekund od data 1. 1. 1970). Následující parametry lze použít pro výpis různých odvoditelných údajů:
a – zkrácený název dne (A vypíše úplný název dne),
b – zkrácený název měsíce (B vypíše úplný název měsíce),
c – čas a datum,
d – číslo dne v měsíci v rozsahu 01 až 31 (m vypíše číslo měsíce v roce v rozsahu 01 až 12),
H – hodina dne v rozsahu 00 až 23 (I vypíše hodinu dne v rozsahu 01 až 12),
M – číslo minuty v rozsahu 00 až 59 (S vypíše číslo sekundy v rozsahu 00 až 60),
j – pořadové číslo dnu v roce v rozsahu 001 až 366 (W vypíše pořadové číslo týdne v roce v rozsahu 00 až 53),
x – pouze datum (X vypíše pouze čas),
y – poslední dvojčíslí čísla roku (Y vypíše celé číslo roku),
login – vyplní úplné přihlašovací jméno uživatele, který objekt vytváří. Pro totéž lze rovněž využít proměnnou user.
local – vyplní lokální část přihlašovacího jména autora objektu (domain vyplní doménovou část přihlašovacího jména autora objektu).
increment – tento příkaz zvýší hodnotu proměnné v parametru o 1. Pokud není zadán korektní název proměnné nebo pokud uživatel nemá do zadané proměnné právo zápisu, nestane se při vytváření události nic. V opačném případě se proměnná buď vytvoří nebo se její hodnota zvýší o jedničku a předvyplní se na přednastavené místo v nové události. Tyto proměnné se používají na číslování událostí podle určité šablony ve sdílených kalendářích. Vzorový zápis v šabloně může vypadat např. takto:
${increment:uzivatel@domena/slozka/pocitadlo}
format – tento příkaz umožňuje formátovat řetězce předané jako další parametry. Tyto parametry mohou obsahovat proměnné. Formální zápis vypadá takto: ${format: formátovací řetězec, argument1, argument2, ...}. Zápis formátovacího řetězce se řídí pravidly standardní funkce printf, jejíž úplný popis najdete v angličtině například v dokumentaci. Další parametry jsou buď přímo řetězce nebo výrazy obsahující proměnné, které se vyhodnocují od nejzanořenější po tu nejméně zanořenou. Nakonec se vyhodnotí samotný příkaz format, jehož výsledkem je text, který se vloží do nové události.
Příklad 2-3. Příklad proměnné
Pokud do šablony zadáme ${t:A}, ${t:W}.týden, pak se pro událost vytvořenou dne 21. 3. 2006 vyplní text Úterý, 12. týden.
Příklad 2-4. Příklad použití příkazů format a increment
Tento příklad popisuje nastavení šablony v případě, že potřebujeme číslovat události nebo úkoly periodicky od jedničky v zápisu s předřazenými nulami nebo bez nich.
Mějme datum 22. ledna a následující výraz v šabloně:
${format:%4d-%05d,0${t:W},${increment:demo@priklad.cz/i${t:m}}}
Máme tedy dva řetězce, které se budou formátovat:0${t:W} – proměnná se vyhodnotí jako číslo týdne v roce, výsledný řetězec tedy bude v našem případě 003. Při formátování se odstraní počáteční nuly a číslo se pomocí mezer odsadí na čtyři znaky.
${increment:demo@priklad.cz/promenne/i${t:m}} – zanořená proměnná se vyhodnotí jako číslo měsíce, následně se v našem případě vytvoří proměnná i1 a její hodnota se zvýší o jedničku. Tímto způsobem dosáhneme toho, že příští měsíc se vytvoří nová proměnná pro nové číslování. Při formátování se výsledný řetězec roztáhne na pět znaků a doplní se zleva nulami.
Při vytvoření první události s tímto výrazem v šabloně se tedy vyplní hodnota " 3-00001".
Kromě výše zmíněných proměnných a příkazů lze také definovat složitější volání jednotlivých backendů aplikačního serveru, nad kterým WebIS běží. Pokud máte na svém serveru WebIS v provozu a potřebujete do svých šablon předvyplňovat údaje, který nelze nastavit popsanými prostředky, kontaktujte svého integrátora WebISu.
Předcházející | Domů | Další |
Rychlý výběr kontaktu | Nahoru | Přehled |