WebToDate/XML export - import/Reference - Historie editací

Jardac: /* Plánovaná úloha pro nahrazení obsahu souboru */

2013-10-23T08:10:31Z

Plánovaná úloha pro nahrazení obsahu souboru

← Starší verze		Verze z 23. 10. 2013, 10:10
Řádek 1 196:		Řádek 1 196:

	=== Plánovaná úloha pro nahrazení obsahu souboru ===		=== Plánovaná úloha pro nahrazení obsahu souboru ===
			Úloha je obecně využitelná pro nahrazování řetězců v textových souborech (nemusí jít jen o XML). Úloha prochází všechny soubory ve složce definované jako parametr a provádí v nich nahrazování textových řetězců. Jako první parametr se zadává regulární výraz, kterým se identifikují nahrazované řetězce, jako druhý řetězec, kterým se nahrazuje.

	[[Image:scheduler-tasks-replacecontent.png\|center]]		[[Image:scheduler-tasks-replacecontent.png\|center]]

Jardac: /* Plánovaná úloha pro nahrazení obsahu souboru */

2013-10-23T07:57:46Z

Plánovaná úloha pro nahrazení obsahu souboru

← Starší verze		Verze z 23. 10. 2013, 09:57
Řádek 1 194:		Řádek 1 194:

	Pro úspěšné využití této funkce pro načítání RSS do databáze zpráv je třeba použít XSLT transformaci, která transformuje RSS formát na formát používaný ve WebToDate; transformace se pak vybere v rámci úlohy pro import.		Pro úspěšné využití této funkce pro načítání RSS do databáze zpráv je třeba použít XSLT transformaci, která transformuje RSS formát na formát používaný ve WebToDate; transformace se pak vybere v rámci úlohy pro import.

			=== Plánovaná úloha pro nahrazení obsahu souboru ===

			[[Image:scheduler-tasks-replacecontent.png\|center]]

	== Adresářová struktura ==		== Adresářová struktura ==

Jardac: /* Elementy pro zprávy */

2012-05-17T12:58:45Z

Elementy pro zprávy

← Starší verze		Verze z 17. 5. 2012, 14:58
Řádek 165:		Řádek 165:
	Speciální hodnotou atributu ''name'' pro import je hodnota ''self''. Tato hodnota vyznačuje, že data byla exportována ze stejné instalace WebToDate, jako budou importována. Pokud totiž data byla pořízena přímo ve WebToDate, nemají v tabulce pro sledování importů záznam, a tudíž není možná jejich aktualizace přes import běžným způsobem. Hodnotou ''self'' se vyznačí, že jde o tento případ a import pak aktualizuje zprávy dle ID zpráv tak jak se v importovaném souboru vyskytují.		Speciální hodnotou atributu ''name'' pro import je hodnota ''self''. Tato hodnota vyznačuje, že data byla exportována ze stejné instalace WebToDate, jako budou importována. Pokud totiž data byla pořízena přímo ve WebToDate, nemají v tabulce pro sledování importů záznam, a tudíž není možná jejich aktualizace přes import běžným způsobem. Hodnotou ''self'' se vyznačí, že jde o tento případ a import pak aktualizuje zprávy dle ID zpráv tak jak se v importovaném souboru vyskytují.

			Atribut ''ids'' určuje "skupinu" revizí a jazykových verzí. Stejný identifikátor ''ids'' u různých zpráv znamená, že jde buď o revize, nebo jazykové verze. Pokud je jazyk zpráv stejný, jedná se o revize ve stejném jazyce, pokud je různý, jedná se o jazykové verze.

			Atribut ''vid'' určuje pořadové číslo revize; více o revizích viz [[../../Referenční/Workflow obsahu#Revize zpráv\|Revize zpráv]].

			Atributy ''ids'' a ''vid'' se exportují, funkce XML importu s nimi nijak nepracuje.
	\|-		\|-
	\| ''status''		\| ''status''

Jardac: /* Rozhraní pro napojení jiných aplikací */

2011-06-15T13:45:40Z

Rozhraní pro napojení jiných aplikací

← Starší verze		Verze z 15. 6. 2011, 15:45
Řádek 1 227:		Řádek 1 227:
	Možnosti tohoto rozhraní jsou takové, že buď ukládá přijatou XML dávku jako soubor do určeného adresáře k následnému importu (např. plánovanou úlohou modulu) nebo rovnou spouští import. Rozhraní nepodporuje nějaké další nastavení jako je volba kategorie či publikace pro importované zprávy, příslušná data musí být v XML obsažena. Jedinou podporovanou možností je spuštění XSLT transformace před importem.		Možnosti tohoto rozhraní jsou takové, že buď ukládá přijatou XML dávku jako soubor do určeného adresáře k následnému importu (např. plánovanou úlohou modulu) nebo rovnou spouští import. Rozhraní nepodporuje nějaké další nastavení jako je volba kategorie či publikace pro importované zprávy, příslušná data musí být v XML obsažena. Jedinou podporovanou možností je spuštění XSLT transformace před importem.

	Konfigurační pole rozhraní se pro jeho funkčnost umístí do souboru ''~~config~~/global.php'' a má následující strukturu:		Konfigurační pole rozhraní se pro jeho funkčnost umístí do souboru ''[[../../Referenční/Konfigurace WebToDate#Globální konfigurace WebToDate\|global.php]]'' a má následující strukturu:

	<code>		<code>

Jardac: /* Nastavení v globálních předvolbách */

2011-06-15T13:45:16Z

Nastavení v globálních předvolbách

← Starší verze		Verze z 15. 6. 2011, 15:45
Řádek 1 140:		Řádek 1 140:
	=== Nastavení v globálních předvolbách ===		=== Nastavení v globálních předvolbách ===

	V konfiguračním souboru ''~~config~~/global.php'' na serveru je jedna volba týkající se XML importu, která je ve tvaru		V konfiguračním souboru ''[[../../Referenční/Konfigurace WebToDate#Globální konfigurace WebToDate\|global.php]]'' na serveru je jedna volba týkající se XML importu, která je ve tvaru

	<code>		<code>
Řádek 1 152:		Řádek 1 152:
	Pro hlavičku ''importsettings'' existuje element <nowiki><wtd:addnewkeywords></nowiki>, který specifikuje v datech, zda nová klíčová slova přidávat či nikoliv. Platí následující pravidla:		Pro hlavičku ''importsettings'' existuje element <nowiki><wtd:addnewkeywords></nowiki>, který specifikuje v datech, zda nová klíčová slova přidávat či nikoliv. Platí následující pravidla:

	* Pokud je tato volba v global.php nastavena na hodnotu ''false'', je uvedení nastavení v XML souboru irelevantní a nová klíčová slova se nikdy automaticky nepřidávají.		* Pokud je tato volba v ''global.php'' nastavena na hodnotu ''false'', je uvedení nastavení v XML souboru irelevantní a nová klíčová slova se nikdy automaticky nepřidávají.
	* Pokud je tato volba v global.php nastavena na hodnotu ''true'', bere se v potaz nastavení v XML souboru, pokud toto nastavení není v importovaném souboru přítomno, nová klíčová slova se přidávají.		* Pokud je tato volba v ''global.php'' nastavena na hodnotu ''true'', bere se v potaz nastavení v XML souboru, pokud toto nastavení není v importovaném souboru přítomno, nová klíčová slova se přidávají.

	== Plánované úlohy ==		== Plánované úlohy ==

Jardac: /* Plánovaná úloha pro stahování XML přes http */

2011-06-02T10:20:40Z

Plánovaná úloha pro stahování XML přes http

← Starší verze		Verze z 2. 6. 2011, 12:20
Řádek 1 179:		Řádek 1 179:

	=== Plánovaná úloha pro stahování XML přes http ===		=== Plánovaná úloha pro stahování XML přes http ===

			Pomocí této úlohy lze stahovat periodicky ze zadaného URL XML data a ukládat je jako soubor do zvoleného adresáře. Úloha je zejména vhodná na načítání RSS kanálů do databáze zpráv WebToDate.

	[[Image:xmlexport-import-reference-hmlhttptask.png\|center]]		[[Image:xmlexport-import-reference-hmlhttptask.png\|center]]

			V parametrech úlohy se nastavuje plné URL stahovaného XML kódu a cesta k adresáři, do kterého se kód ukládá jako soubor; jméno souboru se vygeneruje náhodně a má koncovku ''*.xml''.

			Na běh této úlohy v sekvenci v plánovači úloh typicky navazuje úloha pro XML import, která se pro načtení importovaných dat nasměruje na stejný adresář na serveru jako tato úloha.

			Pro úspěšné využití této funkce pro načítání RSS do databáze zpráv je třeba použít XSLT transformaci, která transformuje RSS formát na formát používaný ve WebToDate; transformace se pak vybere v rámci úlohy pro import.

	== Adresářová struktura ==		== Adresářová struktura ==

Jardac: /* Plánovaná úloha pro stahování XML přes http */

2011-06-02T10:10:50Z

Plánovaná úloha pro stahování XML přes http

← Starší verze		Verze z 2. 6. 2011, 12:10
Řádek 1 179:		Řádek 1 179:

	=== Plánovaná úloha pro stahování XML přes http ===		=== Plánovaná úloha pro stahování XML přes http ===

			[[Image:xmlexport-import-reference-hmlhttptask.png\|center]]

	== Adresářová struktura ==		== Adresářová struktura ==

Jardac: /* Plánovaná úloha pro stahování XML přes http */

2011-06-02T10:09:12Z

Plánovaná úloha pro stahování XML přes http

← Starší verze		Verze z 2. 6. 2011, 12:09
Řádek 1 177:		Řádek 1 177:
	* Je k dispozici volba '''Mazat importované soubory''' - pokud je zvoleno a soubor je úspěšně importován, automaticky se smaže.		* Je k dispozici volba '''Mazat importované soubory''' - pokud je zvoleno a soubor je úspěšně importován, automaticky se smaže.
	* Pokud je zvoleno '''Mazat importované soubory''' a při importu dojde k chybě, místo smazání souboru dojde k jeho přesunu do adresáře nastaveném v poli '''Chybový adresář'''.		* Pokud je zvoleno '''Mazat importované soubory''' a při importu dojde k chybě, místo smazání souboru dojde k jeho přesunu do adresáře nastaveném v poli '''Chybový adresář'''.

			=== Plánovaná úloha pro stahování XML přes http ===

	== Adresářová struktura ==		== Adresářová struktura ==

Jardac: /* Rozhraní pro napojení jiných aplikací */

2011-06-01T12:03:32Z

Rozhraní pro napojení jiných aplikací

← Starší verze		Verze z 1. 6. 2011, 14:03
Řádek 1 207:		Řádek 1 207:

	Protokoly exportu a importu se ukládají do adresáře ''/offlinedata/logs/xml/'' na serveru. Jedná se o běžné textové soubory, které lze následně zpracovat v aplikacích typu MS Excel apod.		Protokoly exportu a importu se ukládají do adresáře ''/offlinedata/logs/xml/'' na serveru. Jedná se o běžné textové soubory, které lze následně zpracovat v aplikacích typu MS Excel apod.

			== Rozhraní pro napojení jiných aplikací ==
			Modul obsahuje rozhraní pro napojení jiných aplikací, které umožňuje těmto aplikacím odesílat data k aktualizaci databáze zpráv či zdrojů v XML přes protokol http.

			Na adrese /''gate/xmlhttp/default.php'' je skript pro příjem XML dávky. Tento skript může spouštět buď přímo XML import přijatých dat, nebo pouze uložit přijatou XML dávku do určeného adresáře. Skript přijímá data přes http PUT a dále se řídí konfiguračním polem skriptu. Adresář ''gate'' je virtuální adresář www serveru fyzicky umístěný na stejné úrovni jako např. adresář wwwroot. Z bezpečnostních důvodů je velmi vhodné přístup na tento virtuální adresář omezit pouze na IP adresy, na kterých běží aplikace, které mají data odesílat.

			Možnosti tohoto rozhraní jsou takové, že buď ukládá přijatou XML dávku jako soubor do určeného adresáře k následnému importu (např. plánovanou úlohou modulu) nebo rovnou spouští import. Rozhraní nepodporuje nějaké další nastavení jako je volba kategorie či publikace pro importované zprávy, příslušná data musí být v XML obsažena. Jedinou podporovanou možností je spuštění XSLT transformace před importem.

			Konfigurační pole rozhraní se pro jeho funkčnost umístí do souboru ''config/global.php'' a má následující strukturu:

			<code>
			<nowiki>$xmlhttp_import_settings = array(</nowiki>
			<nowiki>'192.168.55.77' => array( 'start' => 'planned', 'folder' => '/xml/import/' ),</nowiki>
			<nowiki>'192.168.53.21' => array( 'start' => 'immediate', 'xslt' => 7 )</nowiki>
			</nowiki>);</nowiki>
			</code>

			Jako klíče prvního pole jsou použity IP adresy, ze kterých může skript přijímat data. Pokud není IP adresa zdroje v klíči pole, skript vrátí pouze http chybu 403 Forbidden. V opačném případě se skript pokusí data zpracovat.

			Povinný klíč v konfiguraci je ''start'', možné hodnoty jsou:

			* ''planned'' – skript uloží XML do adresáře v klíči ''folder'' pod náhodným názvem souboru
			* ''immediate'' – okamžitě spouští XML import přes stejné funkce jako používají např. plánované úlohy pro XML import. Jediným zde podporovaným nepovinným parametrem je ''xslt'', kde se uvede ID transformace z [[../../Referenční/Navigace a transformace#Vytvoření a úprava transformace\|databáze transformací]] WebToDate, která se má před importem aplikovat.

			Pokud se podaří dokončit skriptu požadovanou akci, vrací http status 200 OK, v opačném případě (soubor se nepodaří uložit, transformace s daným ID neexistuje apod.) 500 Internal Server Error. Skript zapisuje do protokolu WebToDate úspěšné i neúspěšné zpracování příchozí XML dávky podobně jako např. plánované úlohy.

Jardac: /* Import */

2011-06-01T06:59:32Z

Import

← Starší verze		Verze z 1. 6. 2011, 08:59
Řádek 1 166:		Řádek 1 166:
	[[Image:xmlexport-import-reference-img006.png\|center]]		[[Image:xmlexport-import-reference-img006.png\|center]]

	=== ~~Import~~ ===		=== Plánovaná úloha pro import ===

	Úlohu použijeme v případě, že chceme periodicky importovat z daného XML souboru (který je např. v čase měněn jinou aplikací) s použitím stejných nastavení.		Úlohu použijeme v případě, že chceme periodicky importovat z daného XML souboru (který je např. v čase měněn jinou aplikací) s použitím stejných nastavení.