WebToDate/Import Newton/Reference
Newton XML formát a jeho import v modulu
Importovaný formát má zhruba následující tvar (v zápisu je jeden článek, který se bude importovat jako jedna zpráva):
<?xml version="1.0" encoding="UTF-8"?>
<nitexp xmlns="http://www.nitml.org/nitexp/1.0">
<item type="press">
<nitoid>ZY49A04F</nitoid>
<source>
<name>Blesk pro ženy</name>
<issue>
<publicdate>20051205</publicdate>
<issuenumber>49</issuenumber>
<page>4</page>
<rank>6</rank>
<column>Zaujalo nás</column>
</issue>
</source>
<title>PRO & PROTI</title>
<author>(mif)</author>
<content>
<nitcml xmlns="http://www.nitml.org/nitcml/1.0">
<body>
<p>
<l>V dnešní době mobilů je takřka přežitkem posílat vánoční gratulace na pohlednicích. Spousta lidí už se nechala zlákat
moderní technikou a gratulují si prostřednictvím SMS nebo e-mailů. Držíte se stále starého zvyku a posíláte
pohlednice? </l>
</p>
<p>
<l>Marie Koutná (64), důchodkyně, Praha </l>
<l>
<tt/>Vánoční gratulace už několik let posílám zásadně na krásných vánočních pohlednicích. I když je pravda, že dříve
jsem jich posílala víc. V posledních letech jsem to omezila jen na ty nejbližší příbuzné a přátele, se kterými
se o svátcích neuvidím. Posílání vánočních SMS gratulací mi přijde neosobní a asi by mě to víc zdržovalo, nejsem totiž technický typ. </l>
</p>
<p>
<l>Pavel Marek (28), podnikatel, Praha </l>
<l>
<tt/>Nedokážu si představit, že bych všem svým známým rozesílal pohlednice s přáním krásného prožití vánočních
svátků. To bych několik dní před Vánocemi nedělal nic jiného a navíc by mě to přišlo dráž. Ani si nejsem jistý, že
bych pohlednice odeslal včas. SMSky posílám v klidu a teple domova až na Štědrý den a mám jistotu, že je moji nejbližší dostanou hned. </l>
</p>
<p/>
</body>
</nitcml>
</content>
</item>
</nitexp>
Při importu se obsah XML elementů využívá následujícím způsobem:
| Element | Jak se zpracovává |
| title | Importuje se jako Nadpis zprávy |
| column | Využívá se k zařazení zprávy do kategorie WebToDate a případně k naplnění pole Rubrika ve zprávě |
| page | Importuje se do pole Strana ve zprávě |
| author | Importuje se jako Autor zprávy |
| body, annotation | Při vytváření obsahu polí Popis a Tělo ve zprávě se postupuje následovně:
|
Obsah elementů neuvedených v této tabulce (např. photo či nmms apod.) se při importu ignoruje. Další vlastnosti zpráv vytvořených importem jsou následující:
- Zpráva je ve stavu Vloženo
- V poli Tělo nejsou žádné HTML značky, všechny elementy v importovaném elementu body se odstraňují. Tělo má nastaveno Automatické řádkování.
- Datum zprávy se přebírá z data vydání, nikoliv z XML formátu
- Čas zprávy se nastavuje podle nastavení ve formuláři Předvolby modulu
- Zpráva je zařazena do zvoleného vydání (pole Číslo vydání), Publikace je nastavena shodně s vydáním, do kterého se importuje
Způsob nastavování kategorie a rubriky je popsán v kapitole Konverze.
Administrační rozhraní
Přístupová práva
Ve formuláři Administrace / Práva lze nastavit, které týmy mají přístup k funkcím sekce Data tohoto modulu. Členové týmu Administrátoři mají přístup k těmto funkcím vždy. Nastavení se provádí stejně jako u všech ostatních modulů WebToDate.
Předvolby
Před prvním importem je třeba povinně nastavit tyto předvolby.
Nastavuje se:
- Čas importovaných zpráv – všechny importované zprávy budou mít datum dle vydání, do kterého se importuje a čas dle nastavení v tomto formuláři.
- Výchozí kategorie – kategorie, do které se zprávy zařadí, pokud není dle pravidel pro řazení do kategorií nalezena jiná kategorie (viz následující kapitola). Tlačítkem Změnit se vybírá kategorie ze stromu kategorií WebToDate.
- Výchozí pohled – zde lze vybrat, zda importované zprávy budou mít přiřazený nějaký pohled (tj. jiný než standardní vstupní formulář) nebo budou bez pohledu.
- Uzamčení zpráv – pokud je zaškrtnuto, importované zprávy budou uzamčeny pro uživatele, který spustil import. V opačném případě budou zprávy po importu odemčeny.
Konverze
Pomocí této funkce lze nastavit, do jakých kategorií se zprávy importují a zda a jak je ve zprávách vyplněno pole Rubrika. Jako výchozí údaj se přitom bere název rubriky z importovaného XML souboru.
Pro konfiguraci se definují čtveřice hodnot publikace - původní název rubriky – kategorie WebToDate – název rubriky WebToDate. Do databáze modulu se tedy ukládají jakási pravidla, která říkají, že pokud je původní název rubriky v importovaném souboru nějaký a importuje se do publikace xy, zprávy patří do zvolené kategorie a (volitelně) bude mít vyplněn název rubriky zadaným textovým řetězcem. Pokud při importu dané zprávy není název rubriky v těchto pravidlech nalezen, použije se výchozí pravidlo pro danou publikaci nebo nakonec výchozí kategorie z předvoleb modulu.
Nové pravidlo se přidává do databáze modulu pomocí odkazu Přidat v pravém horním rohu prohlížeče. V pravém spodním rámci se zobrazí formulář. Zde lze zadat:
- Název rubriky – původní název tak, jak je uváděn v importovaných datech. Možná hodnota je i znak * (hvězdička)
- Publikace – vybírá se jedna z publikací WebToDate
- Kategorie – Pomocí tlačítka Změnit se vybere kategorie, do které patří zprávy z uvedené rubriky
- Rubrika – název rubriky tak, jak bude uveden v poli Rubrika ve zprávě. Pro uložení pravidla je požadováno vyplnění předchozích dvou polí, toto pole je nepovinné; pokud není vyplněno, bude pro tuto rubriku pole Rubrika ve zprávách prázdné. Možná hodnota je i znak * (hvězdička).
V horní části prohlížeče se pak zobrazuje seznam existujících pravidel, klepnutím na název rubriky v prvním sloupci tohoto seznamu se otevírá ve spodním rámci formulář pro úpravy pravidla.
Pravidla lze přidávat či mazat bez omezení. V prvním poli formuláře Název rubriky nelze zadat vícekrát (pro různá pravidla) stejný název, naopak více rubrik do stejné kategorie směřovat lze.
Pravidla se při importu aplikují následujícím způsobem:
- Vždy se importuje do nějakého konkrétního vydání konkrétní publikace. V úvahu se tedy berou pravidla spojená s touto publikací, ostatní pravidla se v tu chvíli ignorují.
- U importované položky se načte název rubriky z XML dat a tento název se hledá v poli Rubrika Newton pravidel pro danou publikaci. Pokud je takové pravidlo nalezeno, zpráva se vloží do kategorie nastavené v tomto pravidle.
- Pokud není rubrika nalezena podle názvu, hledá se pravidlo pro danou publikaci, které obsahuje v poli Rubrika Newton znak * (hvězdička). Je-li takové pravidlo nalezeno, zpráva se vloží do kategorie zadané v tomto pravidle.
- Pokud není nalezen ani konkrétní název rubriky, ani pravidlo se znakem hvězdička, zpráva se vloží do výchozí kategorie zadané v předvolbách.
Pro naplnění obsahu pole Rubrika v importovaných zprávách platí:
- Pokud se do pole Rubrika ve formuláři pro editaci pravidla konverze vloží znak hvězdička, znamená to, že zpráva naimportovaná podle tohoto pravidla převezme do pole Rubrika ve zprávě původní název rubriky z importovaného XML souboru.
- Pokud je obsah pole Rubrika ve formuláři pro editaci pravidla konverze jiný než znak hvězdička, nepřebírá se pro zprávy importované podle daného pravidla původní název rubriky, ale použije se název zadaný v tomto poli pravidla. To platí i pro prázdnou hodnotu – pokud se toto pole tedy nechá v pravidle prázdné, zprávy naimportované podle tohoto pravidla budou mít pole Rubrika prázdné.
Práce se soubory
Funkce Data / Soubory otevírá nové okno prohlížeče, ve kterém lze spravovat importované a exportované soubory. Po výchozí instalaci existuje složka data/nwtimport, se kterou tato funkce pracuje.
Funkce je velmi podobná funkci Obrázky z hlavní nabídky WebToDate. K dispozici jsou následující tlačítka:
- Přidat soubor – zobrazí ve spodním rámci formulář pro upload souboru na server
- Zobrazit soubor – zobrazí XML kód vybraného souboru v pravém spodním rámci okna prohlížeče
- Smazat – maže vybraný soubor z adresáře serveru
- Kopírovat URL – kopíruje URL vybraného souboru do schránky
Importovaný soubor je třeba nejprve pomocí této funkce nakopírovat na server. Po importu se soubor automaticky nemaže, je tedy vhodné jej pomocí této funkce po importu odstranit.
Import
V pravé horní části okna se zobrazuje seznam souborů v importním adresáři. Klepnutím na název souboru se otevírá ve spodní části okna formulář pro import.
V poli Do vydání tohoto formuláře zadejte ID vydání, do kterého chcete importovat a použijte tlačítko Zkontrolovat. Pokud se zobrazí ve formuláři název publikace a vydání dle vzoru na následujícím otisku obrazovky, je vydání správně identifikováno a je možné spustit import tlačítkem Importovat. Do jednoho vydání lze importovat i více XML souborů.
Při importu se zobrazuje průběh importu v procentech, po skončení importu se formou informačního hlášení zobrazí výsledek importu a počet naimportovaných zpráv.
Protokoly
Všechno důležité ohledně importu se protokoluje. Funkce Data / Protokoly zobrazí výpis průběhu importu tak, jak je znázorněno na následujícím obrázku.
Ovládání tohoto okna je stejné jako u hlavních protokolů WebToDate. Lze zde nalézt především informace o zakládání zpráv a dále popisy chyb (pokud při importu nastanou).
Adresářová struktura
Import dat
Po výchozí instalaci existuje na serveru složka /data/nwtimport/. Do této složky se ukládají soubory k importu, import z jiných složek není podporován.
Protokoly modulu
Protokoly importu se ukládají do adresáře /offlinedata/logs/nwtimport/ na serveru. Jedná se o běžné textové soubory, které lze následně zpracovat v aplikacích typu MS Excel apod.
