WebToDate/Formuláře a katalogy/Začínáme - Historie editací

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

2009-10-13T12:42:19Z

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

← Starší verze		Verze z 13. 10. 2009, 14:42
Řádek 1:		Řádek 1:
	[[Category:WebToDate ~~4.1~~ Formuláře a katalogy]]		[[Category:WebToDate Formuláře a katalogy]]
	[[Category:Formuláře a katalogy]]		[[Category:Formuláře a katalogy]]
	== Základní funkce a principy ==		== Základní funkce a principy ==

Jardac: Stránka WebToDate 4.1/Formuláře a katalogy/Začínáme přemístěna na stránku WebToDate/Formuláře a katalogy/Začínáme

2009-10-13T12:39:01Z

Stránka WebToDate 4.1/Formuláře a katalogy/Začínáme přemístěna na stránku WebToDate/Formuláře a katalogy/Začínáme

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

Bajkvl: /* Jednoduchý formulář pro vkládání dat */

2009-08-14T12:34:11Z

Jednoduchý formulář pro vkládání dat

← Starší verze		Verze z 14. 8. 2009, 14:34
Řádek 61:		Řádek 61:

	Pak pomocí tlačítka '''Upravit soubor''' vložte následující HTML kód stránky:		Pak pomocí tlačítka '''Upravit soubor''' vložte následující HTML kód stránky:

			<div class="note">Tento kód (bez kódu pro začátek a konce stránky) rovněž vygeneruje na základě definice existujícího katalogu do těla nového fragmentu pomocný nástroj '''Nástroje / Vstupní formulář)'''.</div>

	<code>		<code>
	<nowiki><html></nowiki>		<nowiki><html></nowiki>

Bajkvl v 5. 8. 2009, 12:02

2009-08-05T12:02:33Z

← Starší verze		Verze z 5. 8. 2009, 14:02
Řádek 4:		Řádek 4:
	Základní části a funkce modulu jsou zobrazeny na následujícím diagramu.		Základní části a funkce modulu jsou zobrazeny na následujícím diagramu.

	[[Image:~~image001~~.jpg\|center]]		[[Image:formulare_a_katalogy01-diagram-znazorneni-zakladni-funkce.jpg\|center]]

	Prvním krokem při zakládání každého katalogu je vždy vytvoření datové tabulky a její případné naplnění daty. Pro tyto účely jsou k dispozici funkce pro založení tabulky v SQL databázi serveru a definici její struktury (tj. názvy sloupců tabulky a jejich datové typy jako číslo, řetězec apod.). Dále lze data do tabulky importovat, podporované formáty pro import a export jsou DBF, XML a CSV.		Prvním krokem při zakládání každého katalogu je vždy vytvoření datové tabulky a její případné naplnění daty. Pro tyto účely jsou k dispozici funkce pro založení tabulky v SQL databázi serveru a definici její struktury (tj. názvy sloupců tabulky a jejich datové typy jako číslo, řetězec apod.). Dále lze data do tabulky importovat, podporované formáty pro import a export jsou DBF, XML a CSV.
Řádek 28:		Řádek 28:
	V prvním kroku založíme příslušnou datovou tabulku. V nabídce modulu použijte položku '''Data''' / '''Seznam tabulek''', v pravé části nahoře použijte odkaz '''Přidat'''. Do pole Název tabulky zadejte "INFOZADOST" (bez uvozovek), celý název tabulky bude KATDINFOZADOST (názvy všech datových tabulek začínají na písmena KATD). Pak se přepněte na záložku '''Sloupce''' a vytvořte (pomocí tlačítek '''Přidat sloupec''') strukturu se čtyřmi sloupci tabulky tak, jak je uvedeno na následujícím otisku obrazovky (délky polí se zadávají jen u polí JMENO a EMAIL, u ostatních se doplní automaticky).		V prvním kroku založíme příslušnou datovou tabulku. V nabídce modulu použijte položku '''Data''' / '''Seznam tabulek''', v pravé části nahoře použijte odkaz '''Přidat'''. Do pole Název tabulky zadejte "INFOZADOST" (bez uvozovek), celý název tabulky bude KATDINFOZADOST (názvy všech datových tabulek začínají na písmena KATD). Pak se přepněte na záložku '''Sloupce''' a vytvořte (pomocí tlačítek '''Přidat sloupec''') strukturu se čtyřmi sloupci tabulky tak, jak je uvedeno na následujícím otisku obrazovky (délky polí se zadávají jen u polí JMENO a EMAIL, u ostatních se doplní automaticky).

	[[Image:~~image002~~.jpg\|center]]		[[Image:formulare_a_katalogy02-editace-tabulky.jpg\|center]]

	Ve druhém kroku vytvoříme nový katalog (s názvem "Žádost o informace") a nastavíme jeho vlastnosti. Použijte položku nabídky '''Administrace''' / '''Nový katalog''', formulář vyplňte podle následujícího otisku obrazovky a použijte tlačítko '''Přidat'''.		Ve druhém kroku vytvoříme nový katalog (s názvem "Žádost o informace") a nastavíme jeho vlastnosti. Použijte položku nabídky '''Administrace''' / '''Nový katalog''', formulář vyplňte podle následujícího otisku obrazovky a použijte tlačítko '''Přidat'''.

	[[Image:~~image003~~.jpg\|center]]		[[Image:formulare_a_katalogy03-pridani-noveho-katalogu.jpg\|center]]

	Nyní musíme nadefinovat pole katalogu. Po přidání katalogu se tento katalog zobrazil ve skupině '''Administrace''' nabídky modulu. Použijte znak '''+''' u názvu katalogu, u katalogu se zobrazí nabídka '''Pole''' a třídění. Klepněte na '''Pole''' a pomocí odkazu '''Přidat''' vpravo nahoře přidejte postupně čtyři pole. Příslušná nastavení jsou na následujících otiscích obrazovky. Vlastnost '''Pořadové číslo''' je třeba vždy zadávat ručně.		Nyní musíme nadefinovat pole katalogu. Po přidání katalogu se tento katalog zobrazil ve skupině '''Administrace''' nabídky modulu. Použijte znak '''+''' u názvu katalogu, u katalogu se zobrazí nabídka '''Pole''' a třídění. Klepněte na '''Pole''' a pomocí odkazu '''Přidat''' vpravo nahoře přidejte postupně čtyři pole. Příslušná nastavení jsou na následujících otiscích obrazovky. Vlastnost '''Pořadové číslo''' je třeba vždy zadávat ručně.
Řádek 38:		Řádek 38:


	[[Image:~~image004~~.jpg\|center]]		[[Image:formulare_a_katalogy04-administrace-pole-katalogu.jpg\|center]]

	Pole ID budeme používat jako pomocné číslování, které jednoznačně identifikuje záznamy. Jsou-li vlastnosti polí nastaveny tak jak je na otisku obrazovky znázorněno, hodnotu pole nebude zadávat uživatel, ale pole se bude automaticky vyplňovat číselnou řadou.		Pole ID budeme používat jako pomocné číslování, které jednoznačně identifikuje záznamy. Jsou-li vlastnosti polí nastaveny tak jak je na otisku obrazovky znázorněno, hodnotu pole nebude zadávat uživatel, ale pole se bude automaticky vyplňovat číselnou řadou.
Řádek 44:		Řádek 44:


	[[Image:~~image005~~.jpg\|center]]		[[Image:formulare_a_katalogy05-nastaveni-pole-katalogu.jpg\|center]]

	Vlastnost '''Zobrazovat v seznamu při úpravách''' znamená, že pokud budeme prohlížet (a případně editovat záznamy v administračním rozhraní modulu, budou takto označená pole přítomná v seznamu položek. Vlastnost '''Odkaz na detail''' musíme zaškrtnout proto, aby modul věděl, na které pole má umístit odkaz na otevření celého záznamu v redakčním rozhraní.		Vlastnost '''Zobrazovat v seznamu při úpravách''' znamená, že pokud budeme prohlížet (a případně editovat záznamy v administračním rozhraní modulu, budou takto označená pole přítomná v seznamu položek. Vlastnost '''Odkaz na detail''' musíme zaškrtnout proto, aby modul věděl, na které pole má umístit odkaz na otevření celého záznamu v redakčním rozhraní.

	[[Image:~~image006~~.jpg\|center]]		[[Image:formulare_a_katalogy06-rucni-nastaveni-pole-katalogu.jpg\|center]]



	[[Image:~~image007~~.jpg\|center]]		[[Image:formulare_a_katalogy07-nastaveni-katalogu-seznam-poli.jpg\|center]]

	Celý katalog je tedy definován tak, že uživatel musí povinně zadat jméno a e-mail (ID se doplní automaticky), nepovinně zadává text do pole "Další požadavky a komentáře".		Celý katalog je tedy definován tak, že uživatel musí povinně zadat jméno a e-mail (ID se doplní automaticky), nepovinně zadává text do pole "Další požadavky a komentáře".
Řádek 58:		Řádek 58:
	Nyní založíme předlohu pro skript zpracovávající vstupní formulář. Ve stromu stránek WebToDate založte novou stránku podle následujícího otisku obrazovky (URL stránky je možné zvolit podle potřeby).		Nyní založíme předlohu pro skript zpracovávající vstupní formulář. Ve stromu stránek WebToDate založte novou stránku podle následujícího otisku obrazovky (URL stránky je možné zvolit podle potřeby).

	[[Image:~~image008~~.jpg\|center]]		[[Image:formulare_a_katalogy08-zalozeni-nove-stranky.jpg\|center]]

	Pak pomocí tlačítka '''Upravit soubor''' vložte následující HTML kód stránky:		Pak pomocí tlačítka '''Upravit soubor''' vložte následující HTML kód stránky:
Řádek 95:		Řádek 95:
	Nově založený předpis se zobrazí v nabídce v části '''Nastavení''' / '''Předpisy'''. Použijte položku nabídky '''Nastavení''' / '''Předpisy''' / '''Žádost o informace''' / '''Vkládání''' a v tomto formuláři v poli '''Předloha pro vstupní stránku''' vyberte stránku založenou v prvním kroku (viz následující otisk obrazovky).		Nově založený předpis se zobrazí v nabídce v části '''Nastavení''' / '''Předpisy'''. Použijte položku nabídky '''Nastavení''' / '''Předpisy''' / '''Žádost o informace''' / '''Vkládání''' a v tomto formuláři v poli '''Předloha pro vstupní stránku''' vyberte stránku založenou v prvním kroku (viz následující otisk obrazovky).

	[[Image:~~image009~~.jpg\|center]]		[[Image:formulare_a_katalogy09-nastaveni-parametru-predpisu.jpg\|center]]

	Nyní už stačí pouze definovat, že katalog používá právě vytvořený předpis. V nabídce modulu použijte položku '''Administrace''' / '''Žádost o informace''' a v poli '''Předpis''' vyberte právě založený předpis (viz následující otisk obrazovky).		Nyní už stačí pouze definovat, že katalog používá právě vytvořený předpis. V nabídce modulu použijte položku '''Administrace''' / '''Žádost o informace''' a v poli '''Předpis''' vyberte právě založený předpis (viz následující otisk obrazovky).

	[[Image:~~image010~~.jpg\|center]]		[[Image:formulare_a_katalogy10-uprava-katalogu-predpis.jpg\|center]]

	Nyní již můžete funkčnost formuláře vyzkoušet na veřejné části. Zadejte do prohlížeče URL		Nyní již můžete funkčnost formuláře vyzkoušet na veřejné části. Zadejte do prohlížeče URL
Řádek 113:		Řádek 113:
	Jestliže všechny předchozí kroky proběhly v pořádku, zobrazí se formulář jako na následujícím otisku obrazovky.		Jestliže všechny předchozí kroky proběhly v pořádku, zobrazí se formulář jako na následujícím otisku obrazovky.

	[[Image:~~image011~~.jpg\|center]]		[[Image:formulare_a_katalogy11-zobrazeni-formulare.jpg\|center]]

	Pokud nevyplníte všechna povinná pole, zobrazí se po použití tlačítka Odeslat stejný formulář s chybovým hlášením, jestliže vyplníte správně všechna pole, po odeslání se data uloží do datové tabulky a zobrazí se úvodní stránka serveru.		Pokud nevyplníte všechna povinná pole, zobrazí se po použití tlačítka Odeslat stejný formulář s chybovým hlášením, jestliže vyplníte správně všechna pole, po odeslání se data uloží do datové tabulky a zobrazí se úvodní stránka serveru.
Řádek 119:		Řádek 119:
	Vložení dat si můžete zkontrolovat v administrační části modulu pomocí nabídky '''Data''' / '''Katalogy''' / '''Žádost o informace''', zobrazení by mělo vypadat zhruba jako na následujícím otisku obrazovky.		Vložení dat si můžete zkontrolovat v administrační části modulu pomocí nabídky '''Data''' / '''Katalogy''' / '''Žádost o informace''', zobrazení by mělo vypadat zhruba jako na následujícím otisku obrazovky.

	[[Image:~~image012~~.jpg\|center]]		[[Image:formulare_a_katalogy12-administracni-cast-modulu.jpg\|center]]

Bajkvl: /* Jednoduchý formulář pro vkládání dat */

2009-07-30T13:39:08Z

Jednoduchý formulář pro vkládání dat

← Starší verze		Verze z 30. 7. 2009, 15:39
Řádek 64:		Řádek 64:
	<nowiki><html></nowiki>		<nowiki><html></nowiki>
	<nowiki><head></nowiki>		<nowiki><head></nowiki>
	<nowiki><title>Žádost o informace</title></nowiki>		<nowiki><title>Žádost o informace</title></nowiki>
	<nowiki></head></nowiki>		<nowiki></head></nowiki>
	<nowiki><body></nowiki>		<nowiki><body></nowiki>

Bajkvl: /* Jednoduchý formulář pro vkládání dat */

2009-07-24T12:31:31Z

Jednoduchý formulář pro vkládání dat

← Starší verze		Verze z 24. 7. 2009, 14:31
Řádek 63:		Řádek 63:
	<code>		<code>
	<nowiki><html></nowiki>		<nowiki><html></nowiki>
	<nowiki><head></nowiki>		<nowiki><head></nowiki>
	<nowiki><title>Žádost o informace</title></nowiki>		<nowiki><title>Žádost o informace</title></nowiki>
	<nowiki></head></nowiki>		<nowiki></head></nowiki>
	<nowiki><body></nowiki>		<nowiki><body></nowiki>
	<nowiki><form action="/scripts/modules/catalogue/iform.php?catalogueid=<!--WTD_CATALOGUE(ID)-->" method="post"></nowiki>		<nowiki><form action="/scripts/modules/catalogue/iform.php?catalogueid=<!--WTD_CATALOGUE(ID)-->" method="post"></nowiki>

Bajkvl: /* Jednoduchý formulář pro vkládání dat */

2009-07-24T12:22:13Z

Jednoduchý formulář pro vkládání dat

← Starší verze		Verze z 24. 7. 2009, 14:22
Řádek 62:		Řádek 62:
	Pak pomocí tlačítka '''Upravit soubor''' vložte následující HTML kód stránky:		Pak pomocí tlačítka '''Upravit soubor''' vložte následující HTML kód stránky:
	<code>		<code>
	<nowiki><html></nowiki>		<nowiki><html></nowiki>
			<nowiki><head></nowiki>
	<nowiki><head></nowiki>		<nowiki><title>Žádost o informace</title></nowiki>
			<nowiki></head></nowiki>
	<nowiki><title>Žádost o informace</title></nowiki>

	<nowiki></head></nowiki>

	<nowiki><body></nowiki>		<nowiki><body></nowiki>

	<nowiki><form action="/scripts/modules/catalogue/iform.php?catalogueid=<!--WTD_CATALOGUE(ID)-->" method="post"></nowiki>		<nowiki><form action="/scripts/modules/catalogue/iform.php?catalogueid=<!--WTD_CATALOGUE(ID)-->" method="post"></nowiki>

	<nowiki><input type="hidden" name="returnurl" value="/"/></nowiki>		<nowiki><input type="hidden" name="returnurl" value="/"/></nowiki>

	<nowiki><!--WTD_IF(DATATYPEERROR,"Datový typ některého pole není možné zpracovat.")--></nowiki>		<nowiki><!--WTD_IF(DATATYPEERROR,"Datový typ některého pole není možné zpracovat.")--></nowiki>

	<nowiki><!--WTD_IF(MANDATORYERROR,"Některé povinné pole není vyplněno.")--></nowiki>		<nowiki><!--WTD_IF(MANDATORYERROR,"Některé povinné pole není vyplněno.")--></nowiki>

	<nowiki><!--WTD_IF(FIELDSCONFLICT,"Obsah formuláře nelze zapsat")--></nowiki>		<nowiki><!--WTD_IF(FIELDSCONFLICT,"Obsah formuláře nelze zapsat")--></nowiki>

	<nowiki><!--WTD_IF(FIELDSNOACCESS,"Obsah formuláře nelze zapsat")--></nowiki>		<nowiki><!--WTD_IF(FIELDSNOACCESS,"Obsah formuláře nelze zapsat")--></nowiki>

	<nowiki><!--WTD_IF(GENERALERROR,"Obsah formuláře nelze zapsat")--></nowiki>		<nowiki><!--WTD_IF(GENERALERROR,"Obsah formuláře nelze zapsat")--></nowiki>

	<nowiki><label for="JMENO">Jméno a příjmení</label><br/></nowiki>		<nowiki><label for="JMENO">Jméno a příjmení</label><br/></nowiki>

	<nowiki><input type="text" id="JMENO" name="JMENO" value="<!--WTD_FCI(JMENO)-->"/></nowiki> *		<nowiki><input type="text" id="JMENO" name="JMENO" value="<!--WTD_FCI(JMENO)-->"/></nowiki> *

	<nowiki><br/></nowiki>		<nowiki><br/></nowiki>

	<nowiki><label for="EMAIL">E-mailová adresa</label><br/></nowiki>		<nowiki><label for="EMAIL">E-mailová adresa</label><br/></nowiki>

	<nowiki><input type="text" id="EMAIL" name="EMAIL" value="<!--WTD_FCI(EMAIL)-->"/></nowiki> *		<nowiki><input type="text" id="EMAIL" name="EMAIL" value="<!--WTD_FCI(EMAIL)-->"/></nowiki> *

	<nowiki><br/></nowiki>		<nowiki><br/></nowiki>

	<nowiki><label for="VZKAZ">Další požadavky a komentáře</label><br/></nowiki>		<nowiki><label for="VZKAZ">Další požadavky a komentáře</label><br/></nowiki>

	<nowiki><textarea rows="10" rows="" name="VZKAZ" id="VZKAZ"><!--WTD_FCI(VZKAZ)--></textarea></nowiki>		<nowiki><textarea rows="10" rows="" name="VZKAZ" id="VZKAZ"><!--WTD_FCI(VZKAZ)--></textarea></nowiki>

	<nowiki><br/></nowiki>		<nowiki><br/></nowiki>

	<nowiki><input type="submit" name="catalogue_insert_button" value="Odeslat" /></nowiki>		<nowiki><input type="submit" name="catalogue_insert_button" value="Odeslat" /></nowiki>

	<nowiki><p> Pole označená * jsou povinná. </p></nowiki>		<nowiki><p> Pole označená * jsou povinná. </p></nowiki>

	<nowiki></form></nowiki>		<nowiki></form></nowiki>

	<nowiki></body></nowiki>		<nowiki></body></nowiki>

	<nowiki></html></nowiki>		<nowiki></html></nowiki>
	</code>		</code>

Bajkvl: /* Jednoduchý formulář pro vkládání dat */

2009-07-24T12:20:26Z

Jednoduchý formulář pro vkládání dat

← Starší verze		Verze z 24. 7. 2009, 14:20
Řádek 61:		Řádek 61:

	Pak pomocí tlačítka '''Upravit soubor''' vložte následující HTML kód stránky:		Pak pomocí tlačítka '''Upravit soubor''' vložte následující HTML kód stránky:
			<code>
			<nowiki><html></nowiki>

			<nowiki><head></nowiki>

			<nowiki><title>Žádost o informace</title></nowiki>

			<nowiki></head></nowiki>

			<nowiki><body></nowiki>

	<nowiki><~~html~~></nowiki>		<nowiki><form action="/scripts/modules/catalogue/iform.php?catalogueid=<!--WTD_CATALOGUE(ID)-->" method="post"></nowiki>

	<nowiki><~~head~~></nowiki>		<nowiki><input type="hidden" name="returnurl" value="/"/></nowiki>

	<nowiki><~~title~~>~~Žádost o informace~~</~~title~~></nowiki>		<nowiki><!--WTD_IF(DATATYPEERROR,"Datový typ některého pole není možné zpracovat.")--></nowiki>

			<nowiki><!--WTD_IF(MANDATORYERROR,"Některé povinné pole není vyplněno.")--></nowiki>

			<nowiki><!--WTD_IF(FIELDSCONFLICT,"Obsah formuláře nelze zapsat")--></nowiki>

	<nowiki><~~/head~~></nowiki>		<nowiki><!--WTD_IF(FIELDSNOACCESS,"Obsah formuláře nelze zapsat")--></nowiki>

	<nowiki><~~body~~></nowiki>		<nowiki><!--WTD_IF(GENERALERROR,"Obsah formuláře nelze zapsat")--></nowiki>

	<nowiki><~~form action~~="/~~scripts/modules/catalogue~~/~~iform.php?catalogueid=<!--WTD_CATALOGUE(ID)-->" method="post"~~></nowiki>		<nowiki><label for="JMENO">Jméno a příjmení</label><br/></nowiki>

	<nowiki><input type="~~hidden~~" name="~~returnurl~~" value="/"/></nowiki>		<nowiki><input type="text" id="JMENO" name="JMENO" value="<!--WTD_FCI(JMENO)-->"/></nowiki> *

	<nowiki><~~!--WTD_IF(DATATYPEERROR,"Datový typ některého pole není možné zpracovat.")--~~></nowiki>		<nowiki><br/></nowiki>

	<nowiki><~~!--WTD_IF(MANDATORYERROR,~~"~~Některé povinné pole není vyplněno.~~")--></nowiki>		<nowiki><label for="EMAIL">E-mailová adresa</label><br/></nowiki>

	<nowiki><!--~~WTD_IF~~(~~FIELDSCONFLICT,"Obsah formuláře nelze zapsat"~~)--></nowiki>		<nowiki><input type="text" id="EMAIL" name="EMAIL" value="<!--WTD_FCI(EMAIL)-->"/></nowiki> *

	<nowiki><~~!--WTD_IF(FIELDSNOACCESS,"Obsah formuláře nelze zapsat")--~~></nowiki>		<nowiki><br/></nowiki>

	<nowiki><~~!--WTD_IF(GENERALERROR,~~"~~Obsah formuláře nelze zapsat~~"~~)--~~></nowiki>		<nowiki><label for="VZKAZ">Další požadavky a komentáře</label><br/></nowiki>

			<nowiki><textarea rows="10" rows="" name="VZKAZ" id="VZKAZ"><!--WTD_FCI(VZKAZ)--></textarea></nowiki>

	<nowiki~~><label for="JMENO">Jméno a příjmení</label~~><br/></nowiki>		<nowiki><br/></nowiki>

	<nowiki><input type="~~text" id="JMENO~~" name="~~JMENO~~" value="~~<!--WTD_FCI(JMENO)-->~~"/></nowiki> *		<nowiki><input type="submit" name="catalogue_insert_button" value="Odeslat" /></nowiki>

	<nowiki><br/></nowiki>		<nowiki><p> Pole označená * jsou povinná. </p></nowiki>

	<nowiki><~~label for="EMAIL">E-mailová adresa</label><br~~/></nowiki>		<nowiki></form></nowiki>

	<nowiki><input type="text" id="EMAIL" name="EMAIL" value="<!--WTD_FCI(EMAIL)-->"/></nowiki> *		<nowiki></body></nowiki>

	~~<nowiki><br/></nowiki>~~

	~~<nowiki><label for="VZKAZ">Další požadavky a komentáře</label><br/></nowiki>~~

	~~<nowiki><textarea rows="10" rows="" name="VZKAZ" id="VZKAZ"><!--WTD_FCI(VZKAZ)--></textarea></nowiki>~~

	~~<nowiki><br/></nowiki>~~

	~~<nowiki><input type="submit" name="catalogue_insert_button" value="Odeslat" /></nowiki>~~

	~~<nowiki><p> Pole označená * jsou povinná. </p></nowiki>~~

	~~<nowiki></form></nowiki>~~

	<nowiki></body~~></nowiki>~~

	~~<nowiki></html~~></nowiki>

			<nowiki></html></nowiki>
			</code>

Bajkvl: Založena nová stránka: Category:WebToDate 4.1 Formuláře a katalogy Category:Formuláře a katalogy == Základní funkce a principy == Základní části a funkce modulu jsou zobrazeny n…

2009-07-23T14:12:13Z

Založena nová stránka: Category:WebToDate 4.1 Formuláře a katalogy Category:Formuláře a katalogy == Základní funkce a principy == Základní části a funkce modulu jsou zobrazeny n…

Nová stránka

[[Category:WebToDate 4.1 Formuláře a katalogy]]
[[Category:Formuláře a katalogy]]
== Základní funkce a principy ==
Základní části a funkce modulu jsou zobrazeny na následujícím diagramu.

[[Image:image001.jpg|center]]

Prvním krokem při zakládání každého katalogu je vždy vytvoření datové tabulky a její případné naplnění daty. Pro tyto účely jsou k dispozici funkce pro založení tabulky v SQL databázi serveru a definici její struktury (tj. názvy sloupců tabulky a jejich datové typy jako číslo, řetězec apod.). Dále lze data do tabulky importovat, podporované formáty pro import a export jsou DBF, XML a CSV.

Je-li správně nadefinovaná datová tabulka, lze nad touto tabulkou vytvořit '''katalog'''. Katalog definuje:

* Pole datové tabulky sloužící jako jednoznačný identifikátor záznamů
* Kdo může z veřejné části data číst (všichni / pouze registrovaní / nikdo)
* Kdo může z veřejné části pomocí příslušného formuláře data do tohoto katalogu zapisovat (všichni / pouze registrovaní / nikdo)
* Některé další pomocné vlastnosti

Kromě nastavení základních vlastností katalogu se definují vlastnosti polí. Každému sloupci datové tabulky může odpovídat maximálně jedna definice pole, která určuje, v jakém pohledu se toto pole zobrazuje, zda se do něj vkládá, jaká je jeho výchozí hodnota, zda je pole nutné při vkládání nového záznamu vyplnit apod. Rovněž lze definovat, podle kterých polí se při zobrazování katalogu na veřejné části třídí.

Třetím krokem při vytvoření katalogu je zpravidla definice předpisu, neboli sady grafických nastavení, které určují, která stránka používá jako předloha, jakým stylem se vypisuje seznam položek apod. Součástí vlastností katalogu je přiřazení ''předpisu'', vhodný způsob je ale ten, že se nejdříve nadefinují vlastnosti katalogu, pak se vytvoří předpis a na závěr se vybere ve vlastnostech katalogu tento předpis – k dispozici je totiž sada nástrojů, které tvorbu předpisu usnadňují a mohou vygenerovat generické podoby elementů jako jsou formuláře, styly pro zobrazení katalogu apod.

Data uložená v datové tabulce katalogu lze rovněž přes administrační www rozhraní modulu editovat. Tento editor ovšem používá definice katalogu, pokud tedy chcete tuto funkcí využít, je třeba kromě datové tabulky mít vhodným způsobem definovaný i katalog nad touto tabulkou. Dokud není takový katalog definován, lze data do datové tabulky vkládat pouze importem.

== Jednoduchý formulář pro vkládání dat ==
První kroky s modulem Formuláře a katalogy jsou demonstrovány na příkladu vytvoření vstupního formuláře, pomocí kterého uživatel předává svůj kontakt a žádá o další informace. Chceme tedy vytvořit veřejně přístupný formulář, do kterého uživatel vyplní své jméno, e-mailovou adresu a případně text specifikující, o které informace má zájem. Tato tři pole se uloží do databáze modulu a jsou k dispozici obsluze modulu pro prohlížení či export.

V prvním kroku založíme příslušnou datovou tabulku. V nabídce modulu použijte položku '''Data''' / '''Seznam tabulek''', v pravé části nahoře použijte odkaz '''Přidat'''. Do pole Název tabulky zadejte "INFOZADOST" (bez uvozovek), celý název tabulky bude KATDINFOZADOST (názvy všech datových tabulek začínají na písmena KATD). Pak se přepněte na záložku '''Sloupce''' a vytvořte (pomocí tlačítek '''Přidat sloupec''') strukturu se čtyřmi sloupci tabulky tak, jak je uvedeno na následujícím otisku obrazovky (délky polí se zadávají jen u polí JMENO a EMAIL, u ostatních se doplní automaticky).

[[Image:image002.jpg|center]]

Ve druhém kroku vytvoříme nový katalog (s názvem "Žádost o informace") a nastavíme jeho vlastnosti. Použijte položku nabídky '''Administrace''' / '''Nový katalog''', formulář vyplňte podle následujícího otisku obrazovky a použijte tlačítko '''Přidat'''.

[[Image:image003.jpg|center]]

Nyní musíme nadefinovat pole katalogu. Po přidání katalogu se tento katalog zobrazil ve skupině '''Administrace''' nabídky modulu. Použijte znak '''+''' u názvu katalogu, u katalogu se zobrazí nabídka '''Pole''' a třídění. Klepněte na '''Pole''' a pomocí odkazu '''Přidat''' vpravo nahoře přidejte postupně čtyři pole. Příslušná nastavení jsou na následujících otiscích obrazovky. Vlastnost '''Pořadové číslo''' je třeba vždy zadávat ručně.

[[Image:image004.jpg|center]]

Pole ID budeme používat jako pomocné číslování, které jednoznačně identifikuje záznamy. Jsou-li vlastnosti polí nastaveny tak jak je na otisku obrazovky znázorněno, hodnotu pole nebude zadávat uživatel, ale pole se bude automaticky vyplňovat číselnou řadou.

[[Image:image005.jpg|center]]

Vlastnost '''Zobrazovat v seznamu při úpravách''' znamená, že pokud budeme prohlížet (a případně editovat záznamy v administračním rozhraní modulu, budou takto označená pole přítomná v seznamu položek. Vlastnost '''Odkaz na detail''' musíme zaškrtnout proto, aby modul věděl, na které pole má umístit odkaz na otevření celého záznamu v redakčním rozhraní.

[[Image:image006.jpg|center]]

[[Image:image007.jpg|center]]

Celý katalog je tedy definován tak, že uživatel musí povinně zadat jméno a e-mail (ID se doplní automaticky), nepovinně zadává text do pole "Další požadavky a komentáře".

Nyní založíme předlohu pro skript zpracovávající vstupní formulář. Ve stromu stránek WebToDate založte novou stránku podle následujícího otisku obrazovky (URL stránky je možné zvolit podle potřeby).

[[Image:image008.jpg|center]]

Pak pomocí tlačítka '''Upravit soubor''' vložte následující HTML kód stránky:

<nowiki><html></nowiki>

<nowiki><head></nowiki>

<nowiki><title>Žádost o informace</title></nowiki>

<nowiki></head></nowiki>

<nowiki><body></nowiki>

<nowiki><form action="/scripts/modules/catalogue/iform.php?catalogueid=" method="post"></nowiki>

<nowiki><input type="hidden" name="returnurl" value="/"/></nowiki>

<nowiki></nowiki>

<nowiki></nowiki>

<nowiki></nowiki>

<nowiki></nowiki>

<nowiki></nowiki>

<nowiki><label for="JMENO">Jméno a příjmení</label><br/></nowiki>

<nowiki><input type="text" id="JMENO" name="JMENO" value=""/></nowiki> *

<nowiki><br/></nowiki>

<nowiki><label for="EMAIL">E-mailová adresa</label><br/></nowiki>

<nowiki><input type="text" id="EMAIL" name="EMAIL" value=""/></nowiki> *

<nowiki><br/></nowiki>

<nowiki><label for="VZKAZ">Další požadavky a komentáře</label><br/></nowiki>

<nowiki><textarea rows="10" rows="" name="VZKAZ" id="VZKAZ"></textarea></nowiki>

<nowiki><br/></nowiki>

<nowiki><input type="submit" name="catalogue_insert_button" value="Odeslat" /></nowiki>

<nowiki><p> Pole označená * jsou povinná. </p></nowiki>

<nowiki></form></nowiki>

<nowiki></body></nowiki>

<nowiki></html></nowiki>

V posledním kroku využijeme takto definovanou předlohu v grafických nastaveních modulu tak, aby skript pro vkládání dat použil tuto stránku jako šablonu. Nejprve založíme nový předpis. Použijte nabídku '''Nastavení''' / '''Seznam předpisů''', v pravé horní části klepněte na '''Přidat''' a založte nový předpis nazvaný "Žádost o informace" (bez uvozovek, zadává se jen název).

Nově založený předpis se zobrazí v nabídce v části '''Nastavení''' / '''Předpisy'''. Použijte položku nabídky '''Nastavení''' / '''Předpisy''' / '''Žádost o informace''' / '''Vkládání''' a v tomto formuláři v poli '''Předloha pro vstupní stránku''' vyberte stránku založenou v prvním kroku (viz následující otisk obrazovky).

[[Image:image009.jpg|center]]

Nyní už stačí pouze definovat, že katalog používá právě vytvořený předpis. V nabídce modulu použijte položku '''Administrace''' / '''Žádost o informace''' a v poli '''Předpis''' vyberte právě založený předpis (viz následující otisk obrazovky).

[[Image:image010.jpg|center]]

Nyní již můžete funkčnost formuláře vyzkoušet na veřejné části. Zadejte do prohlížeče URL

http://název_serveru/scripts/modules/catalogue/iform.php?catalogueid=id_katalogu

tedy např.

http://www.mujserver.cz/scripts/modules/catalogue/iform.php?catalogueid=1

(ID katalogu zjistíte tak jak je naznačeno na předchozím otisku obrazovky, pokud jste předchozím postupem založili první katalog, má ID = 1).

Jestliže všechny předchozí kroky proběhly v pořádku, zobrazí se formulář jako na následujícím otisku obrazovky.

[[Image:image011.jpg|center]]

Pokud nevyplníte všechna povinná pole, zobrazí se po použití tlačítka Odeslat stejný formulář s chybovým hlášením, jestliže vyplníte správně všechna pole, po odeslání se data uloží do datové tabulky a zobrazí se úvodní stránka serveru.

Vložení dat si můžete zkontrolovat v administrační části modulu pomocí nabídky '''Data''' / '''Katalogy''' / '''Žádost o informace''', zobrazení by mělo vypadat zhruba jako na následujícím otisku obrazovky.

[[Image:image012.jpg|center]]