WebToDate/Referenční/Struktura obsahu - Historie editací

Jardac: /* Číselníky - autocomplete */

2013-10-23T07:48:41Z

Číselníky - autocomplete

← Starší verze		Verze z 23. 10. 2013, 09:48
Řádek 64:		Řádek 64:
	V nabídce '''Administrace''' – '''Číselníky''' lze definovat číselníky pro přizpůsobitelnou strukturu. Číselníkem se rozumí seznam položek, které se pro nějaké pole nabízejí jako výběrová hodnota (rozevírací nabídka).		V nabídce '''Administrace''' – '''Číselníky''' lze definovat číselníky pro přizpůsobitelnou strukturu. Číselníkem se rozumí seznam položek, které se pro nějaké pole nabízejí jako výběrová hodnota (rozevírací nabídka).

	Nový číselník se přidává odkazem ''Přidat'', ~~nejprve~~ se ~~vyplňuje~~ název číselníku. V horním seznamu položek se pak zobrazuje seznam číselníků. Klikem na název číselníku se zobrazí formulář pro změnu názvu číselníku, klikem na ikonu vedle názvu se zobrazí seznam hodnot číselníku s možností jejich přidávání, odstraňování a změn.		Nový číselník se přidává odkazem ''Přidat'', vyplňuje se název číselníku a způsob zobrazení. Možné způsoby zobrazení jsou:

			* ''Rozevírací nabídka'' - ve formuláři pro úpravu zprávy se pak zobrazuje jednoduchá rozevírací nabídka s možností výběru jedné z hodnot.
			* ''Text s automatickým doplňováním'' - ve formuláři pro úpravu zprávy se pak zobrazuje textové pole,s funkcí ''autocomplete'', neboli vypsání začátku názvu položky číselníku způsobí její automatické doplnění. Tato volba je vhodná v případě, že položek v číselníku je mnoho desítek a více. Při zadávání hodnot číselníku se navíc zobrazuje obsah pole ''Pomocný text'', které je součástí položky číselníku, což zde může být využito jako nápověda apod.

			V horním seznamu položek se pak zobrazuje seznam číselníků. Klikem na název číselníku se zobrazí formulář pro změnu názvu číselníku, klikem na ikonu vedle názvu se zobrazí seznam hodnot číselníku s možností jejich přidávání, odstraňování a změn.

	[[Image:referencniprirucka-strukturaobsahu-img103.png\|center]]		[[Image:referencniprirucka-strukturaobsahu-img103.png\|center]]
Řádek 72:		Řádek 77:
	* '''Hodnota''' - hodnota ukládaná do databáze		* '''Hodnota''' - hodnota ukládaná do databáze
	* '''Systémový název''' - název položky zobrazovaný v rozevírací nabídce ve formuláři pro úpravu zprávy		* '''Systémový název''' - název položky zobrazovaný v rozevírací nabídce ve formuláři pro úpravu zprávy
			* '''Pomocný text''' - další text, který nemá vliv na funkci číselníku, ale zobrazuje se ve formuláři pro zprávu v případě, že je číselník nastaven jako ''Text s automatickým doplňováním''
	* '''Lokalizovaný název pro každý jazyk''' - název položky, který se zobrazuje v prezentační části		* '''Lokalizovaný název pro každý jazyk''' - název položky, který se zobrazuje v prezentační části

Jardac: /* Principy přizpůsobitelné struktury databáze zpráv */

2011-06-16T13:34:13Z

Principy přizpůsobitelné struktury databáze zpráv

← Starší verze		Verze z 16. 6. 2011, 15:34
Řádek 26:		Řádek 26:
	Pro práci s touto strukturou a daty v ní platí následující pravidla:		Pro práci s touto strukturou a daty v ní platí následující pravidla:

	* Podle jednotlivých polí v přizpůsobitelné struktuře nelze standardními prostředky aplikace prohledávat ani třídit. Je-li nastaveno ''VARDOCXML=false'', je možné založit pro dané pole databázový nebo fulltextový index. Tyto indexy ale nejsou využívány aplikací ani standardními moduly (např. ~~'''~~Fulltext~~'''~~), tuto funkcionalitu lze využít pouze v zákaznicky vytvořených skriptech např. generovaných z WebToDate.		* Podle jednotlivých polí v přizpůsobitelné struktuře nelze standardními prostředky aplikace prohledávat ani třídit. Je-li nastaveno ''VARDOCXML=false'', je možné založit pro dané pole databázový nebo fulltextový index. Tyto indexy ale nejsou využívány aplikací ani standardními moduly (např. [[../../Fulltext\|Fulltext]]), tuto funkcionalitu lze využít pouze v zákaznicky vytvořených skriptech např. generovaných z WebToDate.
	* Jednou definovanému poli, které již bylo použito u nějaké zprávy nelze změnit systémový název ani datový typ.		* Jednou definovanému poli, které již bylo použito u nějaké zprávy nelze změnit systémový název ani datový typ.
	* Nová pole do přizpůsobitelné struktury lze přidávat bez omezení		* Nová pole do přizpůsobitelné struktury lze přidávat bez omezení

Jardac: /* Úpravy zpráv s přizpůsobitelnou strukturou */

2011-06-15T13:56:57Z

Úpravy zpráv s přizpůsobitelnou strukturou

← Starší verze		Verze z 15. 6. 2011, 15:56
Řádek 90:		Řádek 90:
	Je ovšem možné definovat pohledy používající některá nebo všechna pole z této přizpůsobitelné struktury, více naleznete v kapitole [[../Zprávy#Pohledy\|Pohledy]].		Je ovšem možné definovat pohledy používající některá nebo všechna pole z této přizpůsobitelné struktury, více naleznete v kapitole [[../Zprávy#Pohledy\|Pohledy]].

	<div class="note">Jak se zobrazují pole všech datových typů kromě ''víceřádkový text'' je pevně dáno, pro víceřádkový text lze v konfiguračním souboru ''global.php '' specifikovat počet řádků v konstantě INPUT_FIELDS_ROWS. Výchozí hodnota je 3 řádky.</div>		<div class="note">Jak se zobrazují pole všech datových typů kromě ''víceřádkový text'' je pevně dáno, pro víceřádkový text lze v konfiguračním souboru ''[[../Konfigurace WebToDate#Globální konfigurace WebToDate\|global.php]]'' specifikovat počet řádků v konstantě INPUT_FIELDS_ROWS. Výchozí hodnota je 3 řádky.</div>

Jardac: Nahrazení textu „[[Category:WebToDate 4.1“ textem „[[Category:WebToDate“

2009-10-13T12:44:38Z

Nahrazení textu „[[Category:WebToDate 4.1“ textem „[[Category:WebToDate“

← Starší verze		Verze z 13. 10. 2009, 14:44
Řádek 1:		Řádek 1:
	[[Category:WebToDate ~~4.1~~ Referenční]]		[[Category:WebToDate Referenční]]
	[[Category:Referenční]]		[[Category:Referenční]]
	== Principy přizpůsobitelné struktury databáze zpráv ==		== Principy přizpůsobitelné struktury databáze zpráv ==

Jardac: Stránka WebToDate 4.1/Referenční/Struktura obsahu přemístěna na stránku WebToDate/Referenční/Struktura obsahu

2009-10-13T12:39:04Z

Stránka WebToDate 4.1/Referenční/Struktura obsahu přemístěna na stránku WebToDate/Referenční/Struktura obsahu

← Starší verze	Verze z 13. 10. 2009, 14:39
(Žádný rozdíl)

Bajkvl: /* Úpravy zpráv s přizpůsobitelnou strukturou */

2009-09-07T14:19:50Z

Úpravy zpráv s přizpůsobitelnou strukturou

← Starší verze		Verze z 7. 9. 2009, 16:19
Řádek 88:		Řádek 88:
	[[Image:referencniprirucka-strukturaobsahu-img105.png\|center]]		[[Image:referencniprirucka-strukturaobsahu-img105.png\|center]]

	Je ovšem možné definovat pohledy používající některá nebo všechna pole z této přizpůsobitelné struktury, více naleznete v kapitole [ Pohledy].		Je ovšem možné definovat pohledy používající některá nebo všechna pole z této přizpůsobitelné struktury, více naleznete v kapitole [[../Zprávy#Pohledy\|Pohledy]].

	<div class="note">Jak se zobrazují pole všech datových typů kromě ''víceřádkový text'' je pevně dáno, pro víceřádkový text lze v konfiguračním souboru ''global.php '' specifikovat počet řádků v konstantě INPUT_FIELDS_ROWS. Výchozí hodnota je 3 řádky.</div>		<div class="note">Jak se zobrazují pole všech datových typů kromě ''víceřádkový text'' je pevně dáno, pro víceřádkový text lze v konfiguračním souboru ''global.php '' specifikovat počet řádků v konstantě INPUT_FIELDS_ROWS. Výchozí hodnota je 3 řádky.</div>

Bajkvl: Založena nová stránka: Category:WebToDate 4.1 Referenční Category:Referenční == Principy přizpůsobitelné struktury databáze zpráv == Cílem této funkce ve WebToDate je mít mož…

2009-08-17T07:34:41Z

Založena nová stránka: Category:WebToDate 4.1 Referenční Category:Referenční == Principy přizpůsobitelné struktury databáze zpráv == Cílem této funkce ve WebToDate je mít mož…

Nová stránka

[[Category:WebToDate 4.1 Referenční]]
[[Category:Referenční]]
== Principy přizpůsobitelné struktury databáze zpráv ==
Cílem této funkce ve WebToDate je mít možnost:

* přidat k pevně definované struktuře zpráv libovolný počet dalších vstupních editačních polí a definovat jejich základní chování (datový typ, omezení maximální délky textu apod.)
* Umožnit úpravy tohoto obsahu uživatelům (v běžném formuláři pro zprávy i v pohledech)
* Zajistit, aby v prezentační vrstvě (stylech a předlohách) byl obsah takto definovaných polí použitelný stejným způsobem jako u polí, která jsou daná pevnou databázovou strukturou.

Obecný způsob zacházení s přizpůsobitelnou strukturou je následující.

[[Image:referencniprirucka-strukturaobsahu-img100.png|center]]

Administrátor nadefinuje seznam polí, která vůbec lze použít ve zprávách (tj. v jejich přizpůsobitelné struktuře). Každé pole v tomto seznamu je pak používáno v databázi zpráv v daném kontextu vždy se stejným významem. Definice pole zahrnuje jeho systémový název (z něj se pak tvoří klíčová slova pro šablony a styly), uživatelský název, datový typ a případné další vlastnosti (maximální délka textu apod.).

Definice polí jsou pak sdruženy do jedné sady, která je nazvána ''Rozšířené zprávy''.

Způsob interního uložení této přizpůsobitelné struktury definuje konfigurační konstanta VARDOCXML. Je-li tato konstanta nastavena na hodnotu ''true'', platí, že pro obsah vstupních polí přizpůsobitelné struktury existuje jedno databázové pole typu TEXT neomezené délky, data se zde ukládají v XML struktuře, aby bylo možné jednoduše oddělit obsah jednotlivých vstupních polí apod. Pokud je tato hodnota nastavena na ''false'', ukládají se pole rozšířené struktury do speciální databázové tabulky, co pole to jeden sloupec této tabulky.

U každé zprávy je navíc interně poznamenáno, zda používá vstupní pole definovaná ve struktuře ''Rozšířené zprávy'' nebo ne. Jakmile je jednou struktura nadefinována, při úpravě zprávy se automaticky tato pole zobrazí v editačním formuláři, pokud jsou zprávy upravovány pomocí pohledů, je v definici pohledu vyznačeno, zda používá tuto přizpůsobitelnou strukturu či nikoli.

Pro práci s touto strukturou a daty v ní platí následující pravidla:

* Podle jednotlivých polí v přizpůsobitelné struktuře nelze standardními prostředky aplikace prohledávat ani třídit. Je-li nastaveno ''VARDOCXML=false'', je možné založit pro dané pole databázový nebo fulltextový index. Tyto indexy ale nejsou využívány aplikací ani standardními moduly (např. '''Fulltext'''), tuto funkcionalitu lze využít pouze v zákaznicky vytvořených skriptech např. generovaných z WebToDate.
* Jednou definovanému poli, které již bylo použito u nějaké zprávy nelze změnit systémový název ani datový typ.
* Nová pole do přizpůsobitelné struktury lze přidávat bez omezení
* Existující pole lze ve struktuře odstraňovat. Znamená to ale, že obsah pole, které bylo u zprávy vyplněno a pak v definici struktury odstraněno již nelze upravovat, při uložení takové zprávy je pak tento obsah definitivně smazán.

== Správa struktury ==
Správu přizpůsobitelné struktury provádí administrátor v nabídce '''Administrace''' – '''Struktura zpráv'''. Interface pro tuto správu je na následujícím otisku obrazovky.

[[Image:referencniprirucka-strukturaobsahu-img101.png|center]]

V horním seznamu se zobrazuje seznam polí patřících do přizpůsobitelné struktury (systémový název a uživatelský název), ve spodní části formulář pro nastavení vlastností pole. Význam položek v tomto formuláři je následující:

* '''Systémový název''' – název, pod kterým se data interně ukládají. Název pak navíc figuruje v klíčových slovech (značkách) WebToDate, která zastupují obsah pole v šablonách či stylech. Syntaxe těchto značek je <nowiki></nowiki>. Systémový název tvořte pomocí velkých písmen, číslic a znaku podtržítko.
* '''Uživatelský název''' – popisek, který se zobrazuje ve formuláři pro zprávy. Tento popisek se zobrazuje vždy v běžném formuláři pro zprávu, v pohledech funguje jako systémový název, který lze buď převzít nebo předefinovat.
* '''Datový typ''' – vybírá se jeden z datových typů Možné hodnoty jsou ''jednořádkový text'', ''víceřádkový text'', ''URL'', ''datum'', ''celé nezáporné číslo, reálné číslo, položka databáze zdrojů''. Význam této volby je především v tom, jak se pole ve formuláři pro úpravy zpráv zobrazuje a jaké jsou kontroly při ukládání dat.
* '''Povolit HTML''' – Udává, zda lze do pole vkládat HTML kód nebo jen prostý text. U těchto polí se ve formuláři zobrazí ikona pro úpravy pomocí WYSIWYG editoru.
* '''Formátování''' – zde se volí, zda se pro pole používá Automatické formátování, jedná se v zásadě o stejnou funkci, která je k dispozici pro Tělo zprávy.
* '''Maximální délka''' – maximální možná délka textu pro textová pole. Pokud není vyplněno, délka textu není omezena.
* '''Povinně vyplnit''' – udává, zda musí uživatel obsah daného pole povinně vyplnit.

Je-li nastavena konfigurační konstanta ''VARDOCXML=false'', lze navíc definovat:

* '''Indexování - běžný index''' - je-li zaškrtnuto, vytvoří se pro toto pole databázový index
* '''Indexování''' - fulltextový index - je-li zaškrtnuto, vytvoří se pro toto pole fulltextový index

[[Image:referencniprirucka-strukturaobsahu-img102.png|center]]

Pro nastavení ''VARDOCXML=false'' není k dispozici možnost '''Formátování: ponechat možnost volby na uživateli'''.

Pokud je definován alespoň jeden číselník, nabízí se v poli '''Použít číselník''' výběr ze seznamu číselníků. Číselníky lze zvolit pouze pro pole typu ''Jednořádkový text''.

Při práci s touto strukturou je vhodné si uvědomit zejména to, že obsahy polí se interně identifikují podle systémového názvu. Pokud je systémový název změněný nebo je pole dokonce odstraněno, jsou obsahy tohoto pole ve zprávách ztraceny a např. pro definici formulářů pomocí pohledů se pak jedná o jiné pole, které je v pohledu nutno znovu nadefinovat.

Poměrně speciálním typem pole je ''položka databáze zdrojů''. Jedná se o pole, do kterého lze vložit pouze klíčové slovo pro instanci položky z databáze zdrojů. Používá se v případě, že je třeba do struktury zprávy vkládat např. více ilustračních obrázků v různých variantách, kde každá varianta se používá v jiném kontextu (jeden ilustrační obrázek pro zprávu umístěnou na úvodní stránce, jiný ilustrační obrázek pro zprávu umístěnou na stránce sekce apod.).

== Číselníky ==
V nabídce '''Administrace''' – '''Číselníky''' lze definovat číselníky pro přizpůsobitelnou strukturu. Číselníkem se rozumí seznam položek, které se pro nějaké pole nabízejí jako výběrová hodnota (rozevírací nabídka).

Nový číselník se přidává odkazem ''Přidat'', nejprve se vyplňuje název číselníku. V horním seznamu položek se pak zobrazuje seznam číselníků. Klikem na název číselníku se zobrazí formulář pro změnu názvu číselníku, klikem na ikonu vedle názvu se zobrazí seznam hodnot číselníku s možností jejich přidávání, odstraňování a změn.

[[Image:referencniprirucka-strukturaobsahu-img103.png|center]]

Ve formuláři pro úpravu hodnoty číselníku se nacházejí následující položky:

* '''Hodnota''' - hodnota ukládaná do databáze
* '''Systémový název''' - název položky zobrazovaný v rozevírací nabídce ve formuláři pro úpravu zprávy
* '''Lokalizovaný název pro každý jazyk''' - název položky, který se zobrazuje v prezentační části

Pokud se tedy např. nadefinuje položka číselníku Hodnota = 2, Systémový název = "na skladě", Lokalizovaný název = "Položka je na skladě", při výběru této hodnoty u dané zprávy uživatel vybere položku "na skladě", do databáze se interně uloží hodnota 2, pokud je klíčové slovo pro toto pole např. v předloze pro zprávy, ve stránce se zprávou v prezentační vrstvě se zobrazí "Položka je na skladě".

[[Image:referencniprirucka-strukturaobsahu-img104.png|center]]

Z toho vyplývá:

* Měnit systémové a lokalizované názvy položek v číselníku lze bez omezení
* Změna hodnoty u položky, která již byla někde použita (nebo dokonce smazání položky číselníku) znamená, že v databázi u dané zprávy může být uložena hodnota číselníku, pro kterou nejsou k dispozici názvy, takže se pak aplikace chová v podstatě tak, jako by pro danou zprávu hodnota číselníku vůbec nebyla nastavena.

== Úpravy zpráv s přizpůsobitelnou strukturou ==
Pokud je nadefinováno aspoň jedno pole přizpůsobitelné struktury, zobrazuje se ve formuláři pro zprávy záložka '''Další''', ve které se tato pole nacházejí. Obsah této záložky je řízen pouze touto strukturou a nelze jej dále ovlivnit.

[[Image:referencniprirucka-strukturaobsahu-img105.png|center]]

Je ovšem možné definovat pohledy používající některá nebo všechna pole z této přizpůsobitelné struktury, více naleznete v kapitole [ Pohledy].

<div class="note">Jak se zobrazují pole všech datových typů kromě ''víceřádkový text'' je pevně dáno, pro víceřádkový text lze v konfiguračním souboru ''global.php '' specifikovat počet řádků v konstantě INPUT_FIELDS_ROWS. Výchozí hodnota je 3 řádky.</div>