Knihovna XmlLibEx TXV 003 78.01 třetí vydání říjen 2014 změny vyhrazeny 1 TXV 003 78.01
Historie změn Datum Vydání Popis změn Říjen 2012 1 První vydání, popis odpovídá XmlLibEx_v11 Prosinec 2013 Říjen 2014 2 3 Doplněn popis bloků fbxmlparser, fbxmlfileparser a fbxmlpageparser, popis odpovídá XmlLibEx_v13 Přidání funkce parsování od určitého tagu popis odpovídá XmlLibEx_v15 OBSAH 1 Úvod...3 2 Datové typy...5 3 Konstanty...8 4 Globální proměnné...8 5 Funkce...9 5.1 Funkce SetAttrValue...10 5.2 Funkce GetAttrValue...11 6 Funkční bloky...12 6.1 Funkční blok fbxmltagparser...13 6.2 Funkční blok fbxmltagcomposer...15 6.3 Funkční blok fbxmlparser...17 6.4 Funkční blok fbxmlfileparser...19 6.5 Funkční blok fbxmlfileparserfindtag...21 6.6 Funkční blok fbxmlpageparser...24 6.7 Funkční blok fbxmlpageparserfindtag...27 7 Příklady použití...30 7.1 Použití fbxmltagparser a fbxmltagcomposer...30 7.2 Použití fbxmlfileparser...32 7.3 Použití fbxmlfileparserfindtag...38 7.4 Použití fbxmlpageparser...43 7.5 Použití fbxmlpageparserfindtag...49 2 TXV 003 78.01
1 ÚVOD Knihovna XmlLibEx je standardně dodávaná jako součást programovacího prostředí Mosaic. Knihovna obsahuje funkční bloky umožňující práci s daty ve formátu Extensible Markup Language (XML). 1 2 3 4 5 <tag attribute= value >Text</tag> Obecná struktura XML 1 tag 2 atribut 3 hodnota atributu 4 text 5 ukončení tagu XmlLibEx ve verzi 1.5 nepokrývá kompletně všechny možnosti zápisu XML dat. Omezení knihovny jsou následující: - Komentáře jsou ignorovány - Maximální délka názvu tagu je 80 znaků - Maximální délka názvu atributu je 64 znaků - Maximální délka hodnoty atributu je 192 znaků - Maximální délka textu je 254 znaků - Maximální počet atributů pro jeden tag je deset - Není podporována sekce CDATA - Nejsou podporovány zástupné xml entity Následují obrázek ukazuje strukturu knihovny XmlLibEx v prostředí Mosaic Pokud chceme funkce z knihovny XmlLibEx použít v aplikačním programu PLC, je třeba nejprve přidat tuto knihovnu do projektu. Knihovna je dodávaná jako součást instalace prostředí Mosaic od verze v2012.3. 3 TXV 003 78.01
Knihovna XmlLibEx využívá podporu ve firmware centrální jednotky PLC. Knihovnu lze použít na všech centrálních jednotkách řady Foxtrot od firmware v7.4. V systémech TC700 lze knihovnu použít na procesorech CP-7004 a CP-7007 od v7.4. Knihovnu XmlLibEx lze použít jako náhradu starší knihovny XmlLib. Kód XmlLibEx je kratší a běží rychleji než tomu bylo u původní knihovny XmlLib. Od XmlLibEx_v13 jsou navíc v knihovně k dispozici funkční bloky zjednodušující zpracování XML dokumentů. Ve verzi XmlLibEx_v15 jsou přidány další dva funkční bloky pro parsování dat ze souboru a XML stránky od určitého tagu. Objednací číslo dokumentace ke knihovně XmlLibEx je TXV 003 78.01. 4 TXV 003 78.01
2 DATOVÉ TYPY V knihovně XmlLibEx jsou definovány následující datové typy: Datový typ TXmlItem je struktura obsahující informace o aktuálně načteném elementu XML dokumentu. Význam jednotlivých položek je následující: Identifikátor Typ Význam TXmlItem STRUCT Popis elementu XML.tag STRING[80] Jméno tagu včetně klíčových znaků?, /, atd..istxt BOOL Příznak přítomnosti textu.indextxt UDINT Index začátku textu v xml bufferu.txt STRING[254] Text před vlastním tagem (prvních 254 znaků).starttag BOOL TRUE znamená začátek párového tagu (např. <ROOT>).endTAG BOOL TRUE znamená konec párového tagu (např. </ROOT>).numAtr UINT Počet atributů v tagu.atr.val ARRAY [1..10] OF STRING[64] ARRAY [1..10] OF STRING[192] Názvy prvních deseti atributů Hodnoty prvních deseti atributů 5 TXV 003 78.01
Datový typ TXmlStack je struktura obsahující informace o historii pársování XML dokumentu. Název každého vypársovaného tagu v XML dokumentu je uložen do XML stacku. Vnořené tagy zvyšují úroveň stacku. Význam jednotlivých položek je následující: Identifikátor Typ Význam TXmlStack STRUCT Historie parsování XML (vnoření tagů).done BOOL Příznak vypársování položky.eod BOOL Konec XML dokumentu.error USINT Kód chyby.errtxt STRING[32] Popis chyby.level SINT Úroveň stacku.layer ARRAY [0..9] OF TXmlStackItem Názvy až deseti vnořených tagů Datový typ TXmlInfo je struktura obsahující typy TxmlItem a TxmlStack. Chování struktury TxmlStack během pársování XML dokumentu Pokud bude pársován výše uvedený XML soubor, pak bude jako první získán tag <?xml>. Do položky TxmlStack.layer[0] se tedy uloží název?xml a položka TxmlStack.level bude mít hodnotu 0. Atributy tohoto tagu budou uloženy do struktury TXmlItem. Při dalším volání funkčního bloku pro pársování (fbxmlparser, fbxmlfileparser, fbxmlpageparser) bude ze XML souboru zís- 6 TXV 003 78.01
kán tag <výlet>. Ten je také na úrovni 0 jako předchozí tag <?xml>, takže dojde k přepsání položky TxmlStack.layer[0] názvem tagu výlet. Úroveň stacku TxmlStack.level se nezmění (zůstane 0). A opět se odpovídajícím způsobem nastaví struktura TxmlItem. Dalším získaným tagem bude tag <účastníci>. To je tag vnořený v tagu <výlet>, úroveň vnoření je 1, takže se zvýší hodnota TxmlStack.level na 1 název tagu bude zapsán do položky TxmlStack.layer[1]. Dalším tagem v pořadí je tag <osoba>. Ten má úroveň vnoření 2 a jeho název bude tedy zapsán do položky TxmlStack.layer[2], přičemž úroveň stacku TxmlStack.level se zvýší na hodnotu 2. Do struktury TXmlItem bude uložen atribut s názvem jméno, hodnota tohoto atributu bude Pepa. Následuje další tag <osoba>. Úroveň tohoto tagu je rovněž 2, takže úroveň stacku TxmlStack.level se nezmění (zůstane 2). Název tohoto tagu je shodný s předchozím tagem, takže hodnota položky TxmlStack.layer[2] zůstane osoba. Do struktury TXmlItem bude nyní uložen atribut s názvem jméno, hodnota tohoto atributu bude Franta. Dalším tagem je koncový tag </účastníci>. Tento tag je na úrovni 1, takže dojde ke snížení úrovně stacku TxmlStack.level na hodnotu 1. Položka TxmlStack.layer[2] se smaže (nahradí se prázdným řetězcem) a jméno tagu /účastníci je uloženo do položky TxmlStack.layer[1]. A tak dále stále dokola. Takže struktura TxmlStack slouží k jednoznačnému určení aktuálně vypársovaného tagu. Například v okamžiku získání tagu <start> bude mít úroveň stacku TxmlStack.level hodnotu 2 a položky TxmlStack.layer budou naplněny následovně: TxmlStack.layer[0] výlet TxmlStack.layer[1] trasa TxmlStack.layer[2] start TxmlStack.layer[3] žádný text 7 TXV 003 78.01
3 KONSTANTY V knihovně XmlLibEx jsou definovány následující konstanty: Konstanty definují velikost položek v datovém typu TxmlItem (počet znaků). Význam konstant je následující: Identifikátor Typ Hodnota Význam XML_MAX_ATR_LEN USINT 64 Max. délka názvu atributu XML_MAX_ATR_NUM USINT 10 Max. počet atributů v tagu XML_MAX_STACK_LEVEL SINT 9 Max. index položky TxmlStack.layer[] XML_MAX_TAG_LEN USINT 80 Max. délka názvu tagu XML_MAX_TXT_LEN USINT 254 Max. délka textu v tagu XML_MAX_VAL_LEN USINT 192 Max. délka hodnoty atributu XML_BUFFER_SIZE UINT 768 Velikost pracovního bufferu pro XML XML_BUMPER UINT 256 Nárazník 4 GLOBÁLNÍ PROMĚNNÉ V knihovně XmlLibEx nejsou definovány žádné globální proměnné. 8 TXV 003 78.01
5 FUNKCE V knihovně XmlLibEx jsou definovány následující funkce. Funkční blok GetAttrValue SetAttrValue Popis Přečte hodnotu atributu daného jména Zapíše hodnotu do atributu daného jména 9 TXV 003 78.01
5.1 Funkce SetAttrValue Knihovna : XmlLibEx Funkce SetAttrValue pracuje nad strukturou TXmlItem popisující element XML dokumentu, která se předává na vstupu itemxml. V této struktuře nalezne podle zadaného jména na vstupu name příslušný atribut a nastaví mu hodnotu předávanou na vstupu value. Pokud atribut daného jména ve struktuře neexistuje, pak jej založí (zkopíruje jméno atributu na volné místo do struktury itemxml.atr[i]), nastaví jeho hodnotu (zkopíruje hodnotu atributun do itemxml.val[i]) a zvýší počet atributů ve struktuře (položka itemxml.numatr). Pokud funkce zapíše požadovaný atribut a jeho hodnotu vrací TRUE. V případě, že se atribut nepodařilo zapsat, funce vrací FALSE. Popis proměnných : Proměnná Typ Význam VAR_INPUT Name STRING Název atributu Value STRING Hodnota atributu VAR_IN_OUT itemxml TXmlItem Popis XML elementu SetAttrValue Návratová hodnota BOOL TRUE pokud se atribut podařilo zapsat, jinak FALSE 10 TXV 003 78.01
5.2 Funkce GetAttrValue Knihovna : XmlLibEx Funkce GetAttrValue pracuje nad strukturou popisující element XML dokumentu TXmlItem, která se předává na vstupu itemxml. V této struktuře nalezne podle zadaného jména na vstupu name příslušný atribut a vrátí jeho hodnotu. Pokud atribut není nalezen, funkce vrátí prázdný string. Popis proměnných : Proměnná Typ Význam VAR_INPUT Name STRING Název atributu VAR_IN_OUT itemxml TXmlItem Popis zpracovaného XML elementu GetAttrValue Návratová hodnota STRING Hodnota atributu 11 TXV 003 78.01
6 FUNKČNÍ BLOKY V knihovně XmlLibEx jsou definovány následující funkční bloky: Funkční blok fbxmltagparser fbxmltagcomposer fbxmlparser fbxmlfileparser fbxmlfileparserfindtag fbxmlpageparser fbxmlpageparser Popis Zpracovává elementy XML dokumentu Zapisuje elementy XML dokumentu Zpracovává jednu položku XML dokumentu Tento blok je použit ve fbxmlfileparser(), fbxmlfileparserfind- Tag(), fbxmlpageparser() a fbxmlpageparserfindtag() Pársování XML dokumentu ze souboru Pársování XML dokumentu ze souboru od zadaného tagu. Pársování XML dokumentu z web stránky Pársování XML dokumentu z web stránky od zadaného tagu 12 TXV 003 78.01
6.1 Funkční blok fbxmltagparser Knihovna : XmlLibEx Funkční blok fbxmltagparser slouží k rozebírání XML dokumentu po jednotlivých elementech. Na začátku rozebírání je nutné nastavit proměnnou start na hodnotu TRUE a proměnnou size na velikost proměnné, ve které je uložen XML dokument. Vlastní proměnná s XML dokumentem se předává na vstupu sourcexml. Výsledek zpracování se vrací ve struktuře TXmlItem na vstupu itemxml. Následující volání s proměnnou start nastavenou na hodnotu FALSE vrací další elementy XML v pořadí, jak za sebou v dokumentu následují. Výstup eod je nastaven v případě, že byly přečteny všechny elementy XML dokumentu. Popis proměnných : Proměnná Typ Význam VAR_INPUT start BOOL TRUE začne procházet od začátku XML dat, FALSE pokračuje tam, kde se minule skončilo size UDINT Velikost XML dokumentu v bytech VAR_IN_OUT sourcexml USINT Proměnná obsahující XML dokument itemxml TXmlItem Popis zpracovaného XML elementu VAR_OUTPUT eod BOOL Konec dat, dokument byl přečten až do velikosti udané proměnnou size 13 TXV 003 78.01
Ve struktuře TXmlItem položka numatr udává počet atributů načteného tagu (0 až 10). Příznaky starttag a endtag v sobě nesou informaci o tom jestli se jedná o počáteční nebo koncový tag. Pokud mají oba příznaky hodnotu TRUE jedná se o nepárový tag. Příznak istxt je nastaven v případě, že zpracovávaný tag obsahuje pole text. Délku textu pak obsahuje položka lentxt a položka indextxt obsahuje index od začátku sourcexml, na kterém text začíná. To má význam v případě, že je text delší než konstanta XML_MAX_TXT_LEN (254 znaků) a celý text se tím pádem nevejde do položky txt. Kompletní text je pak dostupný pouze v bufferu sourcexml, položka indextxt říká ja daleko od začátku sourcexml text leží a položka lentxt říká, jak je dlouhý. Příklad použití (komentář... je potřeba nahradit zpracováním XML tagů) : VAR_GLOBAL xmltemp : ARRAY [0..3] OF STRING := ['<data>', '<date></date>', '<value valid=""></value>', '</data>']; PROGRAM prgxmlexample VAR ParserLineXML : fbxmltagparser; itemxml : TXmlItem; ParserLineXML(start := 1, size := SIZEOF(xmlTemp), sourcexml := void(xmltemp), itemxml := itemxml); IF itemxml.tag = 'data' THEN WHILE NOT ParserLineXML.eod AND itemxml.tag <> '/data' DO ParserLineXML(start := 0, sourcexml := void(xmltemp), itemxml := itemxml); (*... *) END_WHILE; END_PROGRAM 14 TXV 003 78.01
6.2 Funkční blok fbxmltagcomposer Knihovna : XmlLibEx Funkční blok fbxmltagcomposer slouží k zápisu XML dokumentu do proměnné. Na začátku zápisu je nutné nastavit proměnnou start na hodnotu TRUE a proměnnou size na velikost proměnné, ve které je bude výsledný XML dokument. Cílová proměnná se předává na vstupu destxml. Následující volání s proměnnou start nastavenou na hodnotu FALSE zapisuje další elementy XML za poslední zapsaný. Výsledný zápis je ovlivněn příznaky starttag, endtag a numatr, které musí být před voláním bloku fbxmltagcomposer nastaveny ve struktuře itemxml. Položka numatr udává počet atributů zapisovaného tagu (0 až 10). Pokud jsou příznaky starttag a endtag oba TRUE, pak bude tag zapsán jako nepárový (např. <tag atrib= value /> ). Popis proměnných : Proměnná Typ Význam VAR_INPUT start BOOL TRUE začne ukládat od začátku XML dat, FALSE pokračuje tam, kde se minule skončilo size UDINT Velikost proměnné, do které se ukládá XML dokument (počet bytů) VAR_IN_OUT destxml USINT Proměnná, obsahující vytvářený XML dokument itemxml TXmlItem Popis elementu, který bude zapsán do XML VAR_OUTPUT sizexml UDINT Aktuální velikost XML dokumentu 15 TXV 003 78.01
Proměnná Typ Význam sizeerr BOOL Nedostatek místa pro zápis elementu Příklad programu s funkčním blokem fbxmltagcomposer: VAR_GLOBAL xmlresult : ARRAY [0..511] OF USINT; PROGRAM prgexamplecompose VAR ComposerLineXML : fbxmltagcomposer; linexml : TXmlItem; VAR_TEMP i : UINT; FOR i := 0 TO 5 DO CASE i OF 0 : linexml.tag := 'data'; linexml.starttag := true; linexml.endtag := false; linexml.numatr := 0; 1 : linexml.tag := 'date'; 2 : linexml.tag := '/date'; linexml.txt := DT_TO_STRINGF(GetDateTime(), '%TYYYY/MM/DD-hh:mm:ss'); 3 : linexml.tag := 'value'; linexml.atr[1] := 'valid'; linexml.val[1] := BOOL_TO_STRING( NOT(r0_p3_AI0.STAT.UNR OR r0_p3_ai0.stat.ovr)); linexml.numatr := 1; linexml.txt := ''; 4 : linexml.starttag := false; linexml.endtag := true; linexml.tag := '/value'; linexml.txt := REAL_TO_STRINGF(r0_p3_AI0.ENG, '%5.2f'); linexml.numatr := 0; 5 : linexml.tag := '/data'; linexml.txt := ''; END_CASE; ComposerLineXML(start := i = 0, size := SIZEOF(xmlResult)-1, destxml := void(xmlresult), itemxml := linexml); END_FOR; xmlresult[udint_to_uint(composerlinexml.sizexml)] := 0; END_PROGRAM Výsledkem programu je následující XML dokument, který může vypadat například takto: <data><date>2012/10/01-10:39:25</date><value valid= 1 >12.5</value></data> 16 TXV 003 78.01
6.3 Funkční blok fbxmlparser Knihovna : XmlLibEx Funkční blok fbxmlparser slouží k rozebírání XML dokumentu po jednotlivých elementech. Tento blok je rozšířením funkčního bloku fbxmltagparser. Na začátku rozebírání je nutné nastavit proměnnou start na hodnotu TRUE a proměnnou size na velikost bufferu, ve kterém je uložen XML dokument (nebo jeho část). Odkaz na buffer s XML dokumentem se předává na vstupu sourcexml. Výsledek zpracování se vrací ve strukturách TXmlItem a TXmlStack. Následující volání bloku s proměnnou start nastavenou na hodnotu FALSE vrací další elementy XML v pořadí, jak za sebou v dokumentu následují. Vstupní proměnná shrink umožňuje odmazat z bufferu tu část dokumentu, která již byla zpracovaná. V bufferu může být načtena pouze část dokumentu, po zpracování této části lze přes vstup shrink zpracovanou část z bufferu odstranit, čímž se v bufferu uvolní místo pro načtení další části XML dokumentu. Z uvedeného vyplývá, že funkční blok fbxmlparser umožňuje zpracování XML dokumentu po částech. To je výhodné zejména v případech, kdy není dopředu známá velikost XML dokumentu. Výstup done udává, že byl vypársován jeden element XML dokumentu. Pokud má výstup error hodnotu různou od nuly, pak při pársování došlo k chybě. Výstup restlen udává počet znaků, které zbývají zpracovat do konce dokumentu (bufferu). Výstup eod je nastaven v případě, že byly přečteny všechny elementy XML dokumentu. Struktura TxmlItem obsahuje informace o aktuálně zpracovaném XML elementu. Položka numatr v této struktuře udává počet atributů načteného tagu (0 až 10). Příznaky starttag a end- TAG v sobě nesou informaci o tom jestli se jedná o počáteční nebo koncový tag. Pokud mají oba příznaky hodnotu TRUE jedná se o nepárový tag. Příznak istxt je nastaven v případě, že zpracovávaný tag obsahuje pole text. Délku textu pak obsahuje položka lentxt a položka indextxt obsahuje index od začátku sourcexml, na kterém text začíná. To má význam v případě, že je text delší než konstanta XML_MAX_TXT_LEN (254 znaků) a celý text se tím pádem nevejde do položky txt. Kompletní text je pak dostupný pouze v bufferu sourcexml, položka indextxt říká ja daleko od začátku sourcexml text leží a položka lentxt říká, jak je dlouhý. Struktura TXmlStack je zásobník sloužící k analýze dokumentu. Položka done udává, že byla vypársovaná další položka. Položka eod signalizuje konec XML dokumentu. Nenulová hodnota položky error signalizuje, že při rozebírání dokumentu došlo k chybě. V takovém případě je popis chyby dostupný v položce errtxt. Položka level udává úroveň zaplnění zásobníku. Vlastní zá- 17 TXV 003 78.01
sobník je v poli layer[]. První položka pole layer[0] obsahuje název vrcholového tagu, další položky pole pak obsahují názvy vnořených tagů. Maximální podporovaná úroveň vnoření XML tagů je 10. Popis proměnných : Proměnná Typ Význam VAR_INPUT start BOOL TRUE začne procházet od začátku XML dat, FALSE pokračuje tam, kde se minule skončilo shrink BOOL TRUE odstraní z bufferu již zpracovanou část XML dokumentu a nezpracovanou část přesune na začátek bufferu size UDINT Velikost XML dokumentu v bytech VAR_IN_OUT sourcexml USINT Proměnná obsahující XML dokument xmlitem TXmlItem Popis zpracovaného XML elementu xmlstack TXmlStack Zásobník pro analýzu dokumentu VAR_OUTPUT done BOOL Byla vypársována další položka eod BOOL Konec dat, dokument byl celý zpracován error USINT Obsahuje kód chyby pokud při rozebírání dokumentu dojde k chybě restlen UINT Počet znaků v bufferu, které zbývá zpracovat line UDINT Číslo řádku v XML dokumentu Funkční blok fbxmlparser je používán funkčními bloky fbxmlfileparser, fbxmlfileparser- FindTag, fbxmlpageparser a fbxmlpageparserfindtag (viz následující podkapitoly). 18 TXV 003 78.01
6.4 Funkční blok fbxmlfileparser Knihovna : XmlLibEx Funkční blok fbxmlfileparser slouží k rozebírání XML dokumentu, který je uložen v souboru. Na začátku rozebírání je nutné nastavit proměnnou exec na hodnotu TRUE a do proměnné filename uvést název souboru, ve kterém je uložen XML dokument. Na náběžnou hranu proměnné exec se otevře uvedený soubor, do výstupu filesize se nastaví velikost souboru a načte se první část XML dokumentu. Poté se v dokumentu najde první XML element. Od nastavení proměnné exec na hodnotu TRUE do nalezení prvního XML tagu uběhne typicky několik cyklů programu (tj. několik volání instance funkčního bloku fbxmlfileparser). Po celou dobu zpracování je nastaven výstup busy na TRUE. V okamžiku nalezení XML tagu je nastaven výstup done na TRUE a výsledky zpracování jsou uloženy ve struktuře TXmlInfo, která obsahuje jak informace o nalezeném XML elementu (název tagu, počet atributů, jejich názvy a hodnoty, atd. v položce TXmlInfo.item) tak informace o historii pársování dokumentu (úroveň vnoření XML tagů a jejich názvy, informace o případných chybách při pársování, atd. v položce TXmlInfo.stack). Aplikační program se pak rozhodne, jestli použije některou z informací ze struktury TXmlInfo. Poté je možné cyklicky volat blok fbxmlfileparser až do chvíle, kdy je výstup bloku break nastaven na TRUE. Po každém volání je ve struktuře TXmlInfo informace o dalším nalezeném XML elementu. Nastavením výstupu break na TRUE blok signalizuje, že je zpracovaná aktuálně načtená část souboru. Při dalším volání bloku se načte další část XML dokumentu ze souboru a pársování souboru pokračuje stejně jako po načtení první části dokumentu. Při dosažení konce souboru je nastaven výstup eof na TRUE. Výstup processed udává průběžně počet zpracovaných znaků, výstup line obsahuje číslo aktuálně zpracované řádky v XML souboru. Struktura TXmlItem obsahuje informace o aktuálně zpracovaném XML elementu. Položka numatr v této struktuře udává počet atributů načteného tagu (0 až 10). Příznaky starttag a end- TAG v sobě nesou informaci o tom jestli se jedná o počáteční nebo koncový tag. Pokud mají oba příznaky hodnotu TRUE jedná se o nepárový tag. Příznak istxt je nastaven v případě, že zpracovávaný tag obsahuje pole text. Délku textu pak obsahuje položka lentxt a položka indextxt obsahuje index od začátku sourcexml, na kterém text začíná. To má význam v případě, že je text delší než konstanta XML_MAX_TXT_LEN (254 znaků) a celý text se tím pádem nevejde do položky 19 TXV 003 78.01
txt. Kompletní text je pak dostupný pouze v bufferu sourcexml, položka indextxt říká,jak daleko od začátku sourcexml text leží a položka lentxt říká, jak je dlouhý. Struktura TXmlStack je zásobník sloužící k analýze dokumentu. Položka done udává, že byla vypársovaná další položka. Položka eod signalizuje konec XML dokumentu. Nenulová hodnota položky error signalizuje, že při rozebírání dokumentu došlo k chybě. V takovém případě je popis chyby dostupný v položce errtxt. Položka level udává úroveň zaplnění zásobníku. Vlastní zásobník je v poli layer[]. První položka pole layer[0] obsahuje název vrcholového tagu, další položky pole pak obsahují názvy vnořených tagů. Maximální podporovaná úroveň vnoření XML tagů je 10. Proměnná Typ Význam VAR_INPUT exec BOOL TRUE znamená pársovat XML soubor, na náběžnou hranu se otevře soubor a zahájí se jeho pársování. Tato proměnná musí být TRUE po celou dobu rozebírání (pársování) dokumentu. VAR_IN_OUT filename STRING Jméno souboru s XML dokumentem xmlinfo TXmlInfo Popis zpracovaného XML elementu (obsahuje TXmlItem a TXmlStack) VAR_OUTPUT start BOOL Má hodnotu TRUE v okamžiku inicializace bloku fbxmlfileparser Dá se použít pro inicializaci proměnných, do kterých se budou ukládat výsledky pársování XML dokumentu done BOOL Byl vypársován jeden element XML dokumentu, výsledek pársování je k dispozici v TXmlInfo busy BOOL Blok je zaneprázdněn (pracuje na získání dalšího XML elementu ze souboru) eof BOOL Příznak dosažení konce souboru (byl vypársován celý XML soubor) break BOOL Aktuálně načtená část XML souboru byla zpracovaná, činnost bloku bude pokračovat v dalším cyklu načtením další části souboru err BOOL TRUE znamená, že při práci bloku došlo k chybě. Popis chyby viz errtxt errtxt STRING Popis chyby (pokud žádná chyba nenastala, pak string je prázdný) filesize UDINT Velikost zpracovávaného souboru (počet znaků) processed UDINT Kolik již bylo ze souboru zpracováno (počet znaků) line UDINT Číslo řádku v XML dokumentu, který byl právě zpracován Příklad použití viz kap.7.2 Použití fbxmlfileparser 20 TXV 003 78.01
6.5 Funkční blok fbxmlfileparserfindtag Knihovna : XmlLibEx Funkční blok fbxmlfileparserfindtag slouží k rozebírání XML dokumentu, který je uložen v souboru. Na začátku rozebírání je nutné nastavit proměnnou exec na hodnotu TRUE a do proměnné filename uvést název souboru, ve kterém je uložen XML dokument. Na náběžnou hranu proměnné exec se otevře uvedený soubor, do výstupu filesize se nastaví velikost souboru a načte se první část XML dokumentu. Poté se v dokumentu hledá první tag odpovídají findtag řetězci (ve tvaru <tag> nebo <tag za předpokladu, že hodnota orderfindtag nebyla nastavena). Nastavením orderfindtag na hodnotu větší než jedna, dojde k hledání tagu findtag v pořadí určeném hodnotou orderfindtag od začátku souboru. Jinak řečeno hodnota orderfindtag určuje od kolikáteho tagu findtag od začátku souboru se má začít parsovat. Pokud se v dokumentu hledaný tag nenachází, vyvolá tento stav chybu v podobě err = 1 a příslušnou chybovým hlášením v errtxt.od nastavení proměnné exec na hodnotu TRUE do nalezení findtag uběhne typicky několik cyklů programu (tj. několik volání instance funkčního bloku fbxmlfileparserfindtag). Po celou dobu zpracování je nastaven výstup busy na TRUE. V okamžiku nalezení XML tagu je nastaven výstup done na TRUE a výsledky zpracování jsou uloženy ve struktuře TXmlInfo, která obsahuje jak informace o nalezeném XML elementu (název tagu, počet atributů, jejich názvy a hodnoty, atd. v položce TXmlInfo.item) tak informace o historii pársování dokumentu (úroveň vnoření XML tagů a jejich názvy, informace o případných chybách při pársování, atd. v položce TXmlInfo.stack). Aplikační program se pak rozhodne, jestli použije některou z informací ze struktury TXmlInfo. Poté je možné cyklicky volat blok fbxmlfileparser až do chvíle, kdy je výstup bloku break nastaven na TRUE. Po každém volání je ve struktuře TXmlInfo informace o dalším nalezeném XML elementu. Nastavením výstupu break na TRUE blok signalizuje, že je zpracovaná aktuálně načtená část souboru. Při dalším volání bloku se načte další část XML dokumentu ze souboru a pársování souboru pokračuje stejně jako po načtení první části dokumentu. Při dosažení konce souboru je nastaven výstup 21 TXV 003 78.01
eof na TRUE. Výstup processed udává průběžně počet zpracovaných znaků, výstup line obsahuje číslo aktuálně zpracované řádky v XML souboru (počítáno od hledaného tagu findtag). Popis proměnných : Proměnná Typ Význam VAR_INPUT exec BOOL parsovat XML soubor findtag STRING tag, od kterého se začne parsovat XML soubor orderfindtag UINT udává pořadí hledaného tagu findtag v souboru VAR_OUTPUT start BOOL příznak inicializace bloku done BOOL výsledek parsování je připraven v xmlinfo busy BOOL blok je zaneprázdněn eof BOOL konec souboru break BOOL buffer zpracován, pokračovat příští cyklus err BOOL příznak chyby errtxt STRING popis chyby filesize UDINT velikost souboru processed UDINT zpracováno (počet znaků) line UDINT číslo řádku v XML dokumentu od hledaného tagu FindTag VAR_IN_OUT filename STRING jméno souboru s XML dokumentem xmlinfo TXmlInfo výsledek parsování Struktura TXmlItem obsahuje informace o aktuálně zpracovaném XML elementu. Položka numatr v této struktuře udává počet atributů načteného tagu (0 až 10). Příznaky starttag a end- TAG v sobě nesou informaci o tom jestli se jedná o počáteční nebo koncový tag. Pokud mají oba příznaky hodnotu TRUE jedná se o nepárový tag. Příznak istxt je nastaven v případě, že zpracovávaný tag obsahuje pole text. Délku textu pak obsahuje položka lentxt a položka indextxt ob- 22 TXV 003 78.01
sahuje index od začátku sourcexml, na kterém text začíná. To má význam v případě, že je text delší než konstanta XML_MAX_TXT_LEN (254 znaků) a celý text se tím pádem nevejde do položky txt. Kompletní text je pak dostupný pouze v bufferu sourcexml, položka indextxt říká ja daleko od začátku sourcexml text leží a položka lentxt říká, jak je dlouhý. Struktura TXmlStack je zásobník sloužící k analýze dokumentu. Položka done udává, že byla vypársovaná další položka. Položka eod signalizuje konec XML dokumentu. Nenulová hodnota položky error signalizuje, že při rozebírání dokumentu došlo k chybě. V takovém případě je popis chyby dostupný v položce errtxt. Položka level udává úroveň zaplnění zásobníku. Vlastní zásobník je v poli layer[]. První položka pole layer[0] obsahuje název vrcholového tagu, další položky pole pak obsahují názvy vnořených tagů. Maximální podporovaná úroveň vnoření XML tagů je 10. Příklad použití viz kap.7.3 Použití fbxmlfileparserfindtag 23 TXV 003 78.01
6.6 Funkční blok fbxmlpageparser Knihovna : XmlLibEx Funkční blok fbxmlpageparser slouží k rozebírání XML dokumentu, který je načten z web serveru HTTP protokolem metodou GET. Na začátku rozebírání je nutné nastavit proměnnou exec na hodnotu TRUE a do proměnné pagename uvést název odkazu na soubor obsahující XML dokument. V proměnné chancode musí být uveden kód kanálu, který bude použit pro komunikaci s web serverem. Na náběžnou hranu proměnné exec se naváže spojení s web severem, ze kterého bude načten uvedený soubor, načte se první část XML dokumentu a do výstupu filesize se nastaví velikost aktuálně načtené části souboru. Poté se v dokumentu najde první XML element. Od nastavení proměnné exec na hodnotu TRUE do nalezení prvního XML tagu uběhne typicky několik cyklů programu (tj. několik volání instance funkčního bloku fbxmlpageparser). Po celou dobu zpracování je nastaven výstup busy na TRUE. V okamžiku nalezení XML tagu je nastaven výstup done na TRUE a výsledky zpracování jsou uloženy ve struktuře TXmlInfo, která obsahuje jak informace o nalezeném XML elementu (název tagu, počet atributů, jejich názvy a hodnoty, atd. v položce TXmlInfo.item) tak informace o historii pársování dokumentu (úroveň vnoření XML tagů a jejich názvy, informace o případných chybách při pársování, atd. v položce TXmlInfo.stack). Aplikační program se pak rozhodne, jestli použije některou z informací ze struktury TXmlInfo. Poté je možné cyklicky volat blok fbxmlpageparser až do chvíle, kdy je výstup bloku break nastaven na TRUE. Po každém volání je ve struktuře TXmlInfo informace o dalším nalezeném XML elementu. Nastavením výstupu break na TRUE blok signalizuje, že je zpracovaná aktuálně načtená část souboru. Při dalším volání bloku se načte další část XML dokumentu z web serveru a pársování souboru pokračuje stejně jako po načtení první části dokumentu. Při dosažení konce souboru je nastaven výstup eof na TRUE. Výstup processed udává průběžně počet zpracovaných znaků, výstup line obsahuje číslo aktuálně zpracované řádky v XML souboru. Pro komunikaci je nutné použít rozhraní ETH1 v režimu uni TCP master, velikost přijímací zóny 512 bytů, velikost vysílací zóny 512 bytů, vzdálená IP adresa 0.0.0.0, vzdálený port 80, místní port 0. Komunikace může probíhat jak v lokální síti tak přes internet. 24 TXV 003 78.01
Popis proměnných : Proměnná Typ Význam VAR_INPUT exec BOOL TRUE znamená pársovat XML soubor, na náběžnou hranu se naváže spojení s web serverem, načte se první část souboru a zahájí se jeho pársování. Tato proměnná musí být TRUE po celou dobu rozebírání (pársování) dokumentu. chancode UINT Kód komunikačního kanálu ETH1_uni0 ETH1_uni7 VAR_IN_OUT pagename STRING Odkaz na soubor s XML dokumentem (jméno web stránky) xmlinfo VAR_OUTPUT TXmlInfo Popis zpracovaného XML elementu (obsahuje TXmlItem a TXmlStack) start BOOL Má hodnotu TRUE v okamžiku inicializace bloku fbxmlpageparser Dá se použít pro inicializaci proměnných, do kterých se budou ukládat výsledky pársování XML dokumentu done BOOL Byl vypársován jeden element XML dokumentu, výsledek pársování je k dispozici v TXmlInfo busy BOOL Blok je zaneprázdněn (pracuje na získání dalšího XML elementu ze souboru) eof BOOL Příznak dosažení konce souboru (byl vypársován celý XML soubor) break BOOL Aktuálně načtená část XML souboru byla zpracovaná, činnost bloku bude pokračovat v dalším cyklu načtením další části souboru err BOOL TRUE znamená, že při práci bloku došlo k chybě. Popis chyby viz errtxt errtxt STRING Popis chyby (pokud žádná chyba nenastala, pak string je prázdný) filesize UDINT Aktuální velikost souboru načteného z web serveru (počet znaků) processed UDINT Kolik již bylo ze souboru zpracováno (počet znaků) line UDINT Číslo řádku v XML dokumentu, který byl právě zpracován Příklad použití viz kap. 7.4 Použití fbxmlpageparser Ve struktuře TXmlItem položka numatr udává počet atributů načteného tagu (0 až 10). Příznaky starttag a endtag v sobě nesou informaci o tom jestli se jedná o počáteční nebo koncový tag. Pokud mají oba příznaky hodnotu TRUE jedná se o nepárový tag. Příznak istxt je nastaven v případě, že zpracovávaný tag obsahuje pole text. Délku textu pak obsahuje položka lentxt a 25 TXV 003 78.01
položka indextxt obsahuje index od začátku sourcexml, na kterém text začíná. To má význam v případě, že je text delší než konstanta XML_MAX_TXT_LEN (254 znaků) a celý text se tím pádem nevejde do položky txt. Kompletní text je pak dostupný pouze v bufferu sourcexml, položka indextxt říká ja daleko od začátku sourcexml text leží a položka lentxt říká, jak je dlouhý. Struktura TXmlStack je zásobník sloužící k analýze dokumentu. Položka done udává, že byla vypársovaná další položka. Položka eod signalizuje konec XML dokumentu. Nenulová hodnota položky error signalizuje, že při rozebírání dokumentu došlo k chybě. V takovém případě je popis chyby dostupný v položce errtxt. Položka level udává úroveň zaplnění zásobníku. Vlastní zásobník je v poli layer[]. První položka pole layer[0] obsahuje název vrcholového tagu, další položky pole pak obsahují názvy vnořených tagů. Maximální podporovaná úroveň vnoření XML tagů je 10. 26 TXV 003 78.01
6.7 Funkční blok fbxmlpageparserfindtag Knihovna : XmlLibEx Funkční blok fbxmlpageparserfindtag slouží k rozebírání XML dokumentu, který je načten z web serveru metodou GET. Na začátku rozebírání je nutné nastavit proměnnou exec na hodnotu TRUE a do proměnné pagename uvést název odkazu na soubor obsahující XML dokument. V proměnné chancode musí být uveden kód kanálu, který bude použit pro komunikaci s web serverem. Na náběžnou hranu proměnné exec se naváže spojení s web severem, ze kterého bude načten uvedený soubor, načte se první část XML dokumentu a do výstupu filesize se nastaví velikost aktuálně načtené části souboru. Poté se v dokumentu začne hledat první řetězec findtag ve tvaru <tag> nebo <tag (jestliže je hodnota orderfindtag nenastavena). Nastavením orderfindtag na hodnotu větší než jedna se určuje pořadí řetězce findtag od začátku souboru. Jinak řečeno hodnota orderfindtag určuje od kolikátého tagu findtag od začátku souboru se má začít parsovat. Po nalezení findtag v odpovídajícím pořadí se tedy stává prvním tagem v dokumentu od kterého se začne parsovat. Pokud se v dokumentu hledaný tag nenachází, vyvolá tento stav chybu v podobě err = 1 a příslušnou chybovým hlášením v errtxt. Od nastavení proměnné exec na hodnotu TRUE do nalezení findtag XML tagu uběhne typicky několik cyklů programu (tj. několik volání instance funkčního bloku fbxmlpageparserfindtag). Po celou dobu zpracování je nastaven výstup busy na TRUE. V okamžiku nalezení XML tagu je nastaven výstup done na TRUE a výsledky zpracování jsou uloženy ve struktuře TXmlInfo, která obsahuje jak informace o nalezeném XML elementu (název tagu, počet atributů, jejich názvy a hodnoty, atd. v položce TXmlInfo.item) tak informace o historii pársování dokumentu (úroveň vnoření XML tagů a jejich názvy, informace o případných chybách při pársování, atd. v položce TXmlInfo.stack). Aplikační program se pak rozhodne, jestli pou- 27 TXV 003 78.01
žije některou z informací ze struktury TXmlInfo. Poté je možné cyklicky volat blok fbxmlpageparserfindtag až do chvíle, kdy je výstup bloku break nastaven na TRUE. Po každém volání je ve struktuře TXmlInfo informace o dalším nalezeném XML elementu. Nastavením výstupu break na TRUE blok signalizuje, že je zpracovaná aktuálně načtená část souboru. Při dalším volání bloku se načte další část XML dokumentu z web serveru a pársování souboru pokračuje stejně jako po načtení první části dokumentu. Při dosažení konce souboru je nastaven výstup eof na TRUE. Výstup processed udává průběžně počet zpracovaných znaků, výstup line obsahuje číslo aktuálně zpracované řádky v XML souboru od hledaného tagu findtag. Pro komunikaci je nutné použít rozhraní ETH1 v režimu uni TCP master, velikost přijímací zóny 512 bytů, velikost vysílací zóny 512 bytů, vzdálená IP adresa 0.0.0.0, vzdálený port 80, místní port 0. Komunikace může probíhat jak v lokální síti tak přes internet. Ve struktuře TXmlItem položka numatr udává počet atributů načteného tagu (0 až 10). Příznaky starttag a endtag v sobě nesou informaci o tom jestli se jedná o počáteční nebo koncový tag. Pokud mají oba příznaky hodnotu TRUE jedná se o nepárový tag. Příznak istxt je nastaven v případě, že zpracovávaný tag obsahuje pole text. Délku textu pak obsahuje položka lentxt a položka indextxt obsahuje index od začátku sourcexml, na kterém text začíná. To má význam v případě, že je text delší než konstanta XML_MAX_TXT_LEN (254 znaků) a celý text se tím pádem nevejde do položky txt. Kompletní text je pak dostupný pouze v bufferu sourcexml, položka indextxt říká ja daleko od začátku sourcexml text leží a položka lentxt říká, jak je dlouhý. Struktura TXmlStack je zásobník sloužící k analýze dokumentu. Položka done udává, že byla vypársovaná další položka. Položka eod signalizuje konec XML dokumentu. Nenulová hodnota položky error signalizuje, že při rozebírání dokumentu došlo k chybě. V takovém případě je popis chyby dostupný v položce errtxt. Položka level udává úroveň zaplnění zásobníku. Vlastní zásobník je v poli layer[]. První položka pole layer[0] obsahuje název vrcholového tagu, další položky pole pak obsahují názvy vnořených tagů. Maximální podporovaná úroveň vnoření XML tagů je 10. Příklad použití viz kap.7.5 Použití fbxmlpageparserfindtag 28 TXV 003 78.01
Popis proměnných : Proměnná Typ Význam VAR_INPUT exec BOOL parsovat XML soubor chancode UINT komunikační kanál (ETH1_uni0, ETH1_uni1,...) findtag STRING tag, od kterého se začne parsovat XML soubor orderfindtag UINT udává pořadí hledaného tagu v souboru VAR_OUTPUT start BOOL příznak inicializace bloku done BOOL výsledek parsování je připraven v xmlinfo busy BOOL blok je zaneprázdněn eof BOOL konec souboru break BOOL buffer zpracován, pokračovat příštím cyklu err BOOL příznak chyby errtxt STRING popis chyby filesize UDINT velikost souboru processed UDINT zpracováno (počet znaku) line UDINT Udává číslo řádku v XML dokumentu od nalezeného tagu VAR_IN_OUT pagename STRING[255] název web stránky s XML dokumentem xmlinfo TXmlInfo výsledek parsování 29 TXV 003 78.01
7 PŘÍKLADY POUŽITÍ 7.1 Použití fbxmltagparser a fbxmltagcomposer Následující příklad ukazuje možnosti použití funkčních bloků fbxmltagparser a fbxmltag- Composer. Pomocí bloku fbxmltagparser je vyčtena struktura XML dokumentu z proměnné templatexml. Načtená struktura je doplňována programem a opět převáděna na XML dokument, blokem fbxmltagcomposer. VAR_GLOBAL templatexml : ARRAY [0..3] OF STRING := ['<data>', '<date></date>', '<value valid=""></value>', '</data>']; resultxml : ARRAY [0..511] OF USINT; resulttxt AT resultxml : STRING[255]; PROGRAM prgxmlexample VAR ParserLineXML : fbxmltagparser; ComposerLineXML : fbxmltagcomposer; linexml : TXmlItem; VAR_TEMP i : UINT; ParserLineXML( start := 1, size := SIZEOF(templateXml), sourcexml := void(templatexml), itemxml := linexml); IF linexml.tag = 'data' THEN ComposerLineXML( start := 1, size := SIZEOF(resultXml)-1, destxml := void(resultxml), itemxml := linexml); WHILE NOT ParserLineXML.EOD DO ParserLineXML( start := 0, sourcexml := void(templatexml), itemxml := linexml); IF linexml.tag = '/date' THEN linexml.txt := DT_TO_STRINGF(GetDateTime(), '%TYYYY/MM/DD-hh:mm:ss'); IF linexml.tag = 'value' THEN FOR i := 1 TO linexml.numatr DO IF linexml.atr[i] = 'valid' THEN linexml.val[i] := BOOL_TO_STRING( NOT(r0_p3_AI0.STAT.UNR OR r0_p3_ai0.stat.ovr)); EXIT; END_FOR; IF linexml.tag = '/value' THEN linexml.txt := REAL_TO_STRINGF(r0_p3_AI0.ENG, '%5.2f'); ComposerLineXML( start := 0, destxml := void(resultxml), itemxml := linexml); END_WHILE; 30 TXV 003 78.01
resultxml[udint_to_uint(composerlinexml.sizexml)] := 0; END_PROGRAM Program nejprve zkontroluje, zda-li je počáteční tag <data>. Pokud ano, hledá koncový tag </date> před, který přidá datum zformátovaný funkcí z knihovny ToStringLib. Když narazí na tag <value> zkusí vyhledat atribut valid, do kterého doplní stav z analogového vstupu. Při nalezení koncového tagu </value> je před něj doplněn text z hodnotou analogového vstupu. Po sestavení celého dokumentu je přidán na konec znak 0. Výsledek může vypadat například takto: <data><date>2012/10/01-09:14:28</date><value valid = 1 >12.5</value></data> 31 TXV 003 78.01
7.2 Použití fbxmlfileparser Funkční blok fbxmlfileparser umožňuje získat informace ze XML dokumentu, který je uložen na SD kartě v PLC. Předpokládejme, že se XML soubor bude jmenovat vylet.xml a jeho obsah bude následující: <?xml version="1.0" encoding="utf-8"?> <výlet> <účastníci> <osoba jméno="pepa" /> <osoba jméno="franta" /> </účastníci> <trasa> <start jméno="kuřim" /> <cíl jméno="tišnov" /> </trasa> <svačina> <věc kolik="1">chleba</věc> <věc kolik="2"> <poznámka> dobře zabalit! </poznámka> řízek </věc> </svačina> </výlet> Prvním krokem bude návrh struktury dat, do které budeme ukládat informace získané rozebíráním (pársováním) xml souboru. V tomto případě bude vhodné, aby navržená datová struktura kopírovala strukturu tagů v xml souboru. Strukturu nazveme T_VYLET a její položky nazveme ucastnici, trasa a svacina. Tyto položky pak obsahují informace uložené uvnitř odpovídajících tagů. Například tag <účastníci> obsahuje vnořené tagy <osoba jméno="pepa" /> kde jméno účastníka je atributem tagu <osoba>. V naší struktuře tedy připravíme pole jmen pro 10 účastníků výletu ucastnici : ARRAY[1..10] OF STRING[16];. Podobný postup je použit i pro tagy <trasa> a <svačina>. Jen je třeba poznamenat, že názvy položek v datové struktuře nemohou obsahovat háčky a čárky (je možno použít pouze písmena anglické abecedy). Definice struktury bude vypadat následovně: TYPE T_TRASA : STRUCT start : STRING[16]; cil : STRING[16]; END_STRUCT; T_VEC : STRUCT kolik : INT; nazev : STRING[16]; poznamka : STRING[16]; END_STRUCT; T_VYLET : STRUCT ucastnici : ARRAY[1..10] OF STRING[16]; trasa : T_TRASA; svacina : ARRAY[1..5] OF T_VEC; END_STRUCT; END_TYPE 32 TXV 003 78.01
Graficky vyjádřeno bude struktura dat vypadat následovně: Pro další postup je dobré si uvědomit, že každý tag v xml dokumentu je jednoznačně identifikován názvem tagu a úrovní, na které je v xml struktuře uložen. V našem případě jsou na úrovni 0 tagy <?xml> a <výlet>, na úrovni 1 jsou tagy <účastníci>, <trasa> a <svačina>, na úrovni 2 jsou tagy <osoba>, <start>, <cíl> a <věc> a na úrovni 3 je tag <poznámka>. Takže například pro nalezení tagu <start> platí následující podmínka: pokud je na úrovni 0 nalezen tag <výlet> a na úrovni 1 je tag <trasa> a úrovni 2 najdeme tag <start> pak je tag nalezen a můžeme použít jeho atribut jméno. K jednoduchému vyhodnocení uvedené podmínky v programu slouží struktura TXmlStack, kterou nastavuje funkční blok fbxmlfileparser. Jméno každého nalezeného tagu je uloženo do položky layer[i], kde index položky i odpovídá úrovni, na které byl tag nalezen. Ukázkový příklad používá pro pársování xml souboru instanci funkčního blok fbxmlfileparser, která je nazvaná XmlDocParser. Zpracování je zahájeno na náběžnou hranu proměnné rqdoc. Proměnná docname obsahuje jméno xml souboru. Instance XmlDocParser je volaná v cyklu REPEAT. Cyklus je vykonáván až do okamžiku, kdy se nastaví výstup XmlDocParser.break na hodnotu TRUE. To znamená, že blok potřebuje načíst další část souboru a zpracování bude 33 TXV 003 78.01
pokračovat v následujícím cyklu programu. Pokud je nastaven výstup XmlDocParser.start tak program provede inicializaci pomocných proměnných potřebných k rozebírání dokumentu. Když je nastaven výstup XmlDocParser.done tak to znamená, že byl vypársován jeden element XML dokumentu a informace o tomto elementu jsou uloženy v proměnné xml (ta obsahuje položky typu TXmlItem a TXmlStack) Následuje zpracování těchto informací a výsledky se uloží do proměnné vylet. REPEAT // cist XML ze souboru XmlDocParser( exec := rqdoc, filename := docname, xmlinfo := xml); IF XmlDocParser.start THEN // // blok XmlDocParser zahajil parsovani -> zahajime ho taky // IF XmlDocParser.done THEN // // vyparsovan jeden radek dokumentu -> zpracujeme ho // UNTIL XmlDocParser.break END_REPEAT; Celý program pro zpracování xml souboru vylet.xml pak vypadá následovně: TYPE T_TRASA : STRUCT start : STRING[16]; cil : STRING[16]; END_STRUCT; T_VEC : STRUCT kolik : INT; nazev : STRING[16]; poznamka : STRING[16]; END_STRUCT; T_VYLET : STRUCT ucastnici : ARRAY[1..10] OF STRING[16]; trasa : T_TRASA; svacina : ARRAY[1..5] OF T_VEC; END_STRUCT; T_PARSE_LEVEL_0 : (PARSE_0_NONE, PARSE_0_VYLET); T_PARSE_LEVEL_1 : (PARSE_1_NONE, PARSE_1_UCAST, PARSE_1_TRASA, PARSE_1_SVACINA); END_TYPE VAR_GLOBAL vylet : T_VYLET; // data získaná z xml dokumentu PROGRAM prgexamplefileparse VAR rqdoc : BOOL := 1; // žádost o načtení a vypársovaní xml 34 TXV 003 78.01
docname : STRING := 'vylet.xml'; // jméno souboru s XML dokumentem XmlDocParser : fbxmlfileparser; // FB pro pársování souboru xml : TXmlInfo; // struktura pro výsledky pársování lasterr : STRING; // popis případné chyby inducastnici : INT; indsvacina : INT; parselevel0 : T_PARSE_LEVEL_0; parselevel1 : T_PARSE_LEVEL_1; VAR_TEMP tmpstr : STRING; REPEAT // cist XML ze souboru XmlDocParser( exec := rqdoc, filename := docname, xmlinfo := xml); IF XmlDocParser.start THEN // blok XmlDocParser zahajil parsovani -> zahajime ho taky inducastnici := 1; // nastavit indexy poli na zacatek indsvacina := 1; parselevel0 := PARSE_0_NONE; // nastavit uvodni stavy pro parsovani parselevel1 := PARSE_1_NONE; IF XmlDocParser.done THEN // vyparsovan jeden radek dokumentu IF xml.stack.level = 0 THEN IF xml.stack.layer[0].tag = 'výlet' THEN parselevel0 := PARSE_0_VYLET; ELSE parselevel0 := PARSE_0_NONE; IF xml.stack.level = 1 AND parselevel0 = PARSE_0_VYLET THEN IF xml.stack.layer[1].tag = 'účastníci' THEN parselevel1 := PARSE_1_UCAST; ELSIF xml.stack.layer[1].tag = 'trasa' THEN parselevel1 := PARSE_1_TRASA; ELSIF xml.stack.layer[1].tag = 'svačina' THEN parselevel1 := PARSE_1_SVACINA; ELSE parselevel1 := PARSE_1_NONE; IF xml.stack.level = 2 AND parselevel0 = PARSE_0_VYLET THEN CASE parselevel1 OF PARSE_1_UCAST : IF xml.stack.layer[2].tag = 'osoba' THEN IF inducastnici <= 10 THEN vylet.ucastnici[inducastnici] := GetAttrValue(name := 'jméno', itemxml := xml.item); inducastnici := inducastnici + 1; PARSE_1_TRASA : IF xml.stack.layer[2].tag = 'start' THEN vylet.trasa.start := GetAttrValue(name := 'jméno', itemxml := xml.item); ELSIF xml.stack.layer[2].tag = 'cíl' THEN vylet.trasa.cil := GetAttrValue(name := 'jméno', itemxml := xml.item); PARSE_1_SVACINA : 35 TXV 003 78.01
IF indsvacina <= 5 THEN IF xml.stack.layer[2].tag = 'věc' THEN tmpstr := GetAttrValue(name := 'kolik', itemxml := xml.item); vylet.svacina[indsvacina].kolik := STRING_TO_INT( tmpstr); ELSIF xml.stack.layer[2].tag = '/věc' THEN vylet.svacina[indsvacina].nazev := xml.item.txt; indsvacina := indsvacina + 1; END_CASE; IF xml.stack.level = 3 AND parselevel0 = PARSE_0_VYLET THEN IF parselevel1 = PARSE_1_SVACINA THEN IF xml.stack.layer[3].tag = '/poznámka' THEN IF indsvacina <= 5 THEN vylet.svacina[indsvacina].poznamka := xml.item.txt; UNTIL XmlDocParser.break END_REPEAT; IF XmlDocParser.exec THEN IF XmlDocParser.eof OR XmlDocParser.err THEN // parsovani ukonceno rqdoc := 0; IF XmlDocParser.err THEN END_PROGRAM lasterr := XmlDocParser.errTxt; // zachytit chybu Celý postup zůstane beze změny i v případě, že bude xml dokument doplněn o další informace. Podmínkou je, aby struktura původních tagů zůstala zachována. <?xml version="1.0" encoding="utf-8"?> <výlet> <účastníci> <osoba jméno="pepa" /> <osoba jméno="franta" /> </účastníci> <trasa> <start jméno="kuřim" /> <přes jméno="čebín" /> <cíl jméno="tišnov" /> </trasa> <sraz> <místo>kuřim nádraží</místo> <kdy datum="2013-05-11" čas="08:25:00" /> <GPS N="49 18'3,507" E="16 32'4,673" /> </sraz> <svačina> <věc kolik="1">chleba</věc> <věc kolik="2"> <poznámka> dobře zabalit! </poznámka> řízek </věc> </svačina> </výlet> 36 TXV 003 78.01
Pársování výše uvedeného souboru bude mít stejný výsledek jako v předchozím případě. POZNÁMKA Pokud chceme ladit uvedený příklad se simulátorem PLC v prostředí Mosaic (kde je možnost využít krokování programu), pak je třeba v adresáři projektu založit adresář ROOT (pokud již neexistuje). V tomto adresáři vytvoříme textový soubor vylet.xml a nakopírujeme do něho výše uvedený xml text. Adresář ROOT v simulátoru nahrazuje SD kartu PLC. 37 TXV 003 78.01
7.3 Použití fbxmlfileparserfindtag Funkční blok fbxmlfileparserfindtag umožňuje získat informace ze XML dokumentu od určitého tagu. Soubor je uložen na SD kartě v PLC. Předpokládejme, že se XML soubor bude jmenovat OTE.xml a obsahuje hledaný tag <tbody> s jehož pomocí si můžeme vyparsovat ze souboru vhodná data. V našem případě tabulku denního trhu ČR níže je uvedená jen malá část souboru s hledaným tagem a pár hodnotami z tabulky:... <tbody> <tr> <td> 1 </td> <td> 10,70 </td> <td> 2 073,2 </td> <td> 0,0 </td> <td> 98,5 </td> </tr> <tr> <td> 2 </td> <td> 8,50 </td> <td>2 156,8 </td> <td> 0,0 </td> <td> 64,6 </td>... Prvním krokem bude návrh struktury dat, do které budeme ukládat informace získané rozebíráním (pársováním) xml souboru. Strukturu nazveme T_TABULKA_OTE a její položky nazveme Hodina,Cena,Mnozstvi,CR_SR,SR_CR. Tyto položky pak obsahují informace uložené uvnitř tabulky. TYPE T_TABULKA_OTE : STRUCT Hodina : INT; Cena : REAL; Mnozstvi : REAL; CR_SR : REAL; SR_CR : REAL; END_STRUCT; END_TYPE VAR_GLOBAL tabulka_ote : array[1..25] of T_TABULKA_OTE; V našem případě se na úrovni 0 nalézá tag <tbody>. Na úrovni 2 (když se objeví tag </td>) jsou hodnoty tabulky v xml.item.txt v textovém řetězci, jenž je potřeba posléze převést na odpovídající datové typy. Jméno každého nalezeného tagu je uloženo do položky layer[i], kde index položky i odpovídá úrovni, na které byl tag nalezen. Ukázkový příklad používá pro pársování xml souboru instanci funkčního blok fbxmlfileparserfindtag, která je nazvaná XmlDocParser. Zpracování je zahájeno na náběžnou hranu proměnné rqdoc. Proměnná docname obsahuje jméno xml souboru. Instance XmlDocParser je volaná v cyklu REPEAT. Cyklus je vykonáván až do okamžiku, kdy se nastaví výstup XmlDocPars- 38 TXV 003 78.01
er.break na hodnotu TRUE. To znamená, že blok potřebuje načíst další část souboru a zpracování bude pokračovat v následujícím cyklu programu. Pokud je nastaven výstup XmlDocParser.start tak program provede inicializaci pomocných proměnných potřebných k rozebírání dokumentu. Když je nastaven výstup XmlDocParser.done tak to znamená, že byl vypársován jeden element XML dokumentu a informace o tomto elementu jsou uloženy v proměnné xml (ta obsahuje položky typu TXmlItem a TxmlStack). Následuje zpracování těchto informací, výsledky se uloží do pole struktur tabulka_ote. PROGRAM ParserXmlOTE VAR rqdoc : BOOL := 1; // žádost o načtení a vypársovaní xml docname : STRING := 'OTE.xml'; // jméno souboru s XML dokumentem XmlDocParser : fbxmlfileparserfindtag;// FB pro pársování souboru xml : TxmlInfo; // struktura pro výsledky pársování lasterr : STRING; // popis případné chyby numbercolumn : INT; // pořadí sloupce index : INT:=1; // hodiny v tabulce OTE REPEAT // cist XML ze souboru XmlDocParser( exec := rqdoc, filename := docname, xmlinfo := xml,findtag := '<tbody>'); IF XmlDocParser.start THEN // blok XmlDocParser zahajil parsovani -> zahajime ho taky numbercolumn := 1; index := 1;// nastavit uvodni stavy pro parsovani IF XmlDocParser.done THEN // vyparsovan jeden radek dokumentu IF xml.stack.level = 2 THEN IF xml.stack.layer[2].tag = '/td' THEN CASE numbercolumn OF 1 : index :=STRING_TO_INT_EX( xml.item.txt); IF (index = 0) OR (index > 24)THEN index := 25; // uz mam vse 25 radek lezi v tabulce ELSE tabulka_ote[index].hodina := index; 2 : tabulka_ote[index].cena := STRING_TO_REAL_EX( xml.item.txt ); 3 : tabulka_ote[index].mnozstvi := STRING_TO_REAL_EX( xml.item.txt ); 4 : tabulka_ote[index].cr_sr := STRING_TO_REAL_EX( xml.item.txt ); 5 : tabulka_ote[index].sr_cr := STRING_TO_REAL_EX( xml.item.txt ); END_CASE; numbercolumn := numbercolumn + 1; ELSIF xml.stack.level = 1 THEN IF xml.stack.layer[1].tag = 'tr' THEN numbercolumn := 1; UNTIL XmlDocParser.break END_REPEAT; IF XmlDocParser.exec THEN IF XmlDocParser.eof OR XmlDocParser.err THEN // parsovani ukonceno rqdoc := 0; IF XmlDocParser.err THEN END_PROGRAM lasterr := XmlDocParser.errTxt; // zachytit chybu 39 TXV 003 78.01
V dalším příkladu získáme pomocí funkčního bloku fbxmlfileparserfindtag kurzy nejznámějších měn dle kurzu České národní banky ze XML dokumentu, který je uložen na SD kartě v PLC. Předpokládejme, že se XML soubor bude jmenovat CNB.xml a jeho ukázkový obsah vypadá následovně:... <table id="stationselector_table"> </table> <table class="kurzy_tisk"> <tbody> <tr class="odd"> <th> země <th> měna <th> množství <th> kód <th> kurz </tr> <tr class="even"> <td> Austrálie <td> dolar <td align="right"> 1 <td>aud</td> <tdalign="right">19,213 </tr> </th> </th> </th> </th> </th> </td> </td> </td> </td>... <tr class="odd"> <td> Brazílie <td> real <td align="right"> 1 <td> BRL <td align="right"> 8,754 </tr> </td> </td> </td> </td> </td> Nejprve je nutné navrhnout vhodnou strukturu pro ukládání dat, kam se budou ukládat informace získané rozebíráním (pársováním) xml souboru. Strukturu nazveme T_TABULKA_CNB a její položky nazveme Zeme, mena, Mnozstvi, Kod, kurz. Tyto položky budou obsahovat informace uložené uvnitř tabulky. TYPE T_TABULKA_CNB : STRUCT Zeme : STRING[15]; mena : STRING[10]; Mnozstvi : INT; Kod : STRING[5]; kurz : REAL; END_STRUCT; END_TYPE VAR_GLOBAL tabulka_cnb : array[1..33] of T_TABULKA_CNB; 40 TXV 003 78.01
V souboru CNB.xml se klíčový hledaný tag <tbody> objevuje vícekrát. My potřebujeme, aby parsování začalo až z druhým nalezeným tagem a proto je nutné nastavit orderfindtag na hodnotu 2, aby došlo k zahájení parsování až s druhým nalezením hledaného tagu. Po zahájení pársování se na úrovni 0 nalézá tag <table. Na úrovni 3, když se objeví tag </td>, jsou hodnoty tabulky v textovém řetězci xml.item.txt. Některé položky je pak třeba ještě převést z řetězce na odpovídající formát proměnné (viz funkce STRING_TO_REAL_EX). Jméno každého nalezeného tagu je uloženo do položky layer[i], kde index položky i odpovídá úrovni, na které byl tag nalezen. PROGRAM XmlFileParserCNB VAR_INPUT VAR_OUTPUT VAR rqdoc : BOOL := 1; // žádost o načtení a vypársovaní xml docname : STRING := 'CNB.xml';// jméno souboru s XML dokumentem XmlDocParser: fbxmlfileparserfindtag; xml : TXmlInfo; // struktura pro výsledky pársování lasterr : STRING; // popis případné chyby numbercolumn : INT := 0; // pořadí sloupce v tabulce numberline : INT := -1; // pořadí řádky tabulky VAR_TEMP REPEAT // cist XML ze souboru XmlDocParser( exec := rqdoc, filename := docname, xmlinfo := xml, findtag := '<table',orderfindtag := 2); IF XmlDocParser.start THEN // blok XmlDocParser zahajil parsovani -> zahajime ho taky numbercolumn := 1; numberline := 0;// uvodni stavy pro parsovani IF XmlDocParser.done THEN // vyparsovan jeden radek dokumentu IF xml.stack.level = 2 AND xml.stack.layer[2].tag = '/tr' THEN numberline:=numberline+1; numbercolumn := 1; IF xml.stack.layer[3].tag = '/td' AND numberline>0 THEN CASE numbercolumn OF 1 : tabulka_cnb[numberline].zeme := xml.item.txt; 2 : tabulka_cnb[numberline].mena := xml.item.txt ; 3:tabulka_CN[numberLin].Mnozstvi :=STRING_TO_INT_EX(xml.item.txt ); 4 : tabulka_cnb[numberline].kod := xml.item.txt ; 5 : tabulka_cnb[numberline].kurz := STRING_TO_REAL_EX( xml.item.txt ); END_CASE; numbercolumn := numbercolumn + 1; UNTIL XmlDocParser.break END_REPEAT; IF XmlDocParser.exec THEN IF XmlDocParser.eof OR XmlDocParser.err THEN // parsovani ukonceno rqdoc := 0; IF XmlDocParser.err THEN END_PROGRAM lasterr := XmlDocParser.errTxt; // zachytit chybu 41 TXV 003 78.01
Stejně, jako minulém příkladu se používá pro pársování xml souboru instanci funkčního blok fbxmlfileparserfindtag, která je nazvaná XmlDocParser. Zpracování je zahájeno na náběžnou hranu proměnné rqdoc. Proměnná docname obsahuje jméno xml souboru. Instance XmlDocParser je volaná v cyklu REPEAT. Cyklus je vykonáván až do okamžiku, kdy se nastaví výstup XmlDoc- Parser.break na hodnotu TRUE. To znamená, že blok potřebuje načíst další část souboru a zpracování bude pokračovat v následujícím cyklu programu. Pokud je nastaven výstup XmlDocParser.start tak program provede inicializaci pomocných proměnných potřebných k rozebírání dokumentu. Když je nastaven výstup XmlDocParser.done tak to znamená, že byl vypársován jeden element XML dokumentu a informace o tomto elementu jsou uloženy v proměnné xml (ta obsahuje položky typu TXmlItem a TXmlStack) Následuje zpracování těchto informací a výsledky se uloží do pole struktur tabulka_cnb. POZNÁMKA Pokud chceme ladit uvedený příklad se simulátorem PLC v prostředí Mosaic (kde je možnost využít krokování programu), pak je třeba v adresáři projektu založit adresář ROOT (pokud již neexistuje). V tomto adresáři vytvoříme textový soubor OTE.xml a nakopírujeme do něho výše uvedený xml text. Adresář ROOT v simulátoru nahrazuje SD kartu PLC. 42 TXV 003 78.01
7.4 Použití fbxmlpageparser Funkční blok fbxmlpageparser umožňuje získat informace ze XML dokumentu, který je poskytován web serverem. Princip práce bloku je shodný s blokem fbxmlfileparser, rozdíl je pouze v tom, jakým způsobem se získává obsah xml souboru. V případě bloku fbxmlpageparser se data získávají komunikací s web serverem (HTTP protokol, port 80, metoda GET). Nejprve je tedy třeba nastavit komunikační kanál. Pro spojení s web serverem je třeba nejprve zapnout podporu režimu uni na rozhraní ethernet. Toto se v prostředí Mosaic provede pomocí Manažeru projektu. Po spuštění Manažera projektu (např. CTRL+ALT+F11) vybereme myší uzel HW konfigurace. Dále je třeba vyvolat dialog pro nastavení komunikačních kanálů centrální jednotky PLC, což se provede kliknutím na ikonu v řádku CPU. Poté klikneme na řádek s nastavením režimu uni pro rozhraní Ethernet (viz řádek ETH uni-off) a ten se zbarví modře. V novém projektu je uni režim pro rozhraní ethernet vypnutý (viz pole Režim kanálu = OFF). 43 TXV 003 78.01
Poté je třeba zvolit režim kanálu uni, což se provede pomocí rozbalovacího menu jak ukazuje následující obrázek. Následující obrázek ukazuje jak bude vypadat dialog po nastavení režimu uni pro kanál ethernet. Kliknutím na ikonu v řádku ETH-uni a vyvoláme dialog pro nastavení parametrů komunikace v režimu uni. 44 TXV 003 78.01
Objeví se dialog s názvem Nastavení univerzálního režimu kanálu. V něm nastavíme následující parametry pro první ethernet spojení (ETH1_uni0): zvolíme délku přijímací zóny 512 bytů, délku vysílací zóny 512 bytů, typ protokolu TCP master, vzdálená IP adresa 0.0.0.0, vzdálený port 80, místní port 0. Po stisku tlačítka OK je ethernet rozhraní PLC nastaveno pro komunikaci s web serverem. Tím je nastavení komunikačního kanálu hotové. Pro příklad použijeme službu serveru freegeoip.net, který vrací geografické informace podle IP adresy, ze které přišel dotaz. Tyto informace je server schopen zasílat v XML formátu. Službu 45 TXV 003 78.01
lze snadno vyzkoušet, stačí zadat do adresního řádku webového prohlížeče odkaz http://freegeoip.net/xml/. Server vrátí xml soubor, který může vypadat např. následovně: <?xml version="1.0" encoding="utf-8"?> <Response> <Ip>188.75.132.14</Ip> <CountryCode>CZ</CountryCode> <CountryName>Czech Republic</CountryName> <RegionCode>88</RegionCode> <RegionName>Stredocesky kraj</regionname> <City>Kolin</City> <ZipCode></ZipCode> <Latitude>50.0269</Latitude> <Longitude>15.2023</Longitude> <MetroCode></MetroCode> <AreaCode></AreaCode> </Response> Odpověď serveru zpracujeme programem v PLC. Získáme tím informaci o aktuálním umístění PLC systému. Program může vypadat například následovně: TYPE T_GEO_INFO : STRUCT IP : TIPadr; country : STRING[32]; region : STRING[32]; city : STRING[32]; latitude : LREAL; longitude : LREAL; END_STRUCT; END_TYPE VAR_GLOBAL geoinfo : T_GEO_INFO; // data získaná z xml dokumentu PROGRAM prgexamplepageparse VAR rqdoc : BOOL := 1; // žádost o načtení a vypársovaní xml xmlpage : STRING := 'freegeoip.net/xml/'; // jméno web stránky XmlDocParser : fbxmlpageparser; // FB pro pársování souboru xml : TXmlInfo; // struktura pro výsledky pársování lasterr : STRING; // popis případné chyby parseenable : BOOL; // pomocná pro pársování REPEAT // cist XML ze souboru XmlDocParser( exec := rqdoc, chancode := ETH1_uni0, pagename := xmlpage, xmlinfo := xml); IF XmlDocParser.start THEN // blok XmlDocParser zahajil parsovani -> zahajime ho taky parseenable := 0; // nastavit uvodni stav pro parsovani IF XmlDocParser.done THEN // vyparsovan jeden radek dokumentu IF xml.stack.level = 0 THEN IF xml.stack.layer[0].tag = 'Response' THEN parseenable := 1; 46 TXV 003 78.01
ELSE parseenable := 0; IF xml.stack.level = 1 AND parseenable THEN IF xml.stack.layer[1].tag = '/Ip' THEN geoinfo.ip := STRING_TO_IPADR( xml.item.txt ); ELSIF xml.stack.layer[1].tag = '/CountryName' THEN geoinfo.country := xml.item.txt; ELSIF xml.stack.layer[1].tag = '/RegionName' THEN geoinfo.region := xml.item.txt; ELSIF xml.stack.layer[1].tag = '/City' THEN geoinfo.city := xml.item.txt; ELSIF xml.stack.layer[1].tag = '/Latitude' THEN geoinfo.latitude := STRING_TO_LREAL( xml.item.txt); ELSIF xml.stack.layer[1].tag = '/Longitude' THEN geoinfo.longitude := STRING_TO_LREAL( xml.item.txt); UNTIL XmlDocParser.break END_REPEAT; IF XmlDocParser.exec THEN IF XmlDocParser.eof OR XmlDocParser.err THEN // parsovani ukonceno rqdoc := 0; IF XmlDocParser.err THEN END_PROGRAM lasterr := XmlDocParser.errTxt; // zachytit chybu Ukázkový příklad používá pro pársování xml souboru instanci funkčního blok fbxmlpageparser, která je nazvaná XmlDocParser. Zpracování je zahájeno na náběžnou hranu proměnné rqdoc. Proměnná xmlpage obsahuje název web stránky se xml souborem. Instance Xml- DocParser je volaná v cyklu REPEAT. Cyklus je vykonáván až do okamžiku, kdy se nastaví výstup XmlDocParser.break na hodnotu TRUE. To znamená, že blok potřebuje načíst další část souboru a zpracování bude pokračovat v následujícím cyklu programu. Pokud je nastaven výstup XmlDoc- Parser.start tak program provede inicializaci pomocných proměnných potřebných k rozebírání dokumentu. Když je nastaven výstup XmlDocParser.done tak to znamená, že byl vypársován jeden element XML dokumentu a informace o tomto elementu jsou uloženy v proměnné xml (ta obsahuje položky typu TXmlItem a TxmlStack). Následuje zpracování těchto informací a výsledky se uloží do proměnné geoinfo. POZNÁMKA Je pravděpodobné, že většina serverů, ze kterých bude PLC systém stahovat XML soubory, je umístěna na internetu. V takovém případě je potřeba, aby měl PLC správně nastavenou nejen IP adresu a masku sítě, ale také adresu brány (gateway). A pokud router, přes který je PLC k internetu připojen, obsahuje také DNS server, pak je užitečné nastavit i adresu DNS serveru. Není-li IP adresa DNS serveru nastavena, PLC systém použije DNS server s IP adresou 8.8.8.8. Nastavení uvedených adres lze provést například programem SetPlcIp, který je součástí instalace prostředí Mosaic nebo ho lze stáhnout z ftp://fw.tecomat.com/app/setplcip.zip. 47 TXV 003 78.01
48 TXV 003 78.01
7.5 Použití fbxmlpageparserfindtag Funkční blok fbxmlpageparserfindtag umožňuje získat informace ze XML dokumentu poskytovaného web serverem s tím, že pársování začne až od určitého tagu. Princip práce bloku je shodný s blokem fbxmlfileparserfindtag, rozdíl je pouze v tom, jakým způsobem se získává obsah xml souboru. V případě bloku fbxmlpageparserfindtag se data získávají komunikací s web serverem (HTTP protokol, port 80, metoda GET). Nejprve je tedy třeba nastavit komunikační kanál nastavuje se stejně, jako v případě popsaném v kapitole 7.4 Použití fbxmlpageparser. Typickým příkladem pro použití bloku bxmlpageparserfindtag je získávání hodnot z tabulky uvedené na webové stránce. Například na stránkách OTE denního trhu elektřiny (http://www.ote-cr.cz/kratkodobe-trhy/elektrina/denni-trh/) je možné najít tabulku s aktuálními cenami elektrické energie pro následující den. Obsah této stránky načteme do PLC pomocí funkčního bloku fbxmlpageparserfindtag. Odpověď serveru zpracujeme programem v PLC. Získáme tím informaci o aktuální ceně elektřiny od společnosti OTE, kterou můžeme dál zpracovávat v PLC programu. Program může vypadat například následovně: 49 TXV 003 78.01
TYPE T_TABULKA_OTE1 : STRUCT Hodina : INT; Cena : REAL; Mnozstvi : REAL; CR_SR : REAL; SR_CR : REAL; END_STRUCT; END_TYPE VAR_GLOBAL tabulka_ote_hodnoty : array[1..25] of T_TABULKA_OTE1; PROGRAM PageOTE VAR_INPUT VAR_OUTPUT VAR rqdoc : BOOL := 1;// žádost o nactení a vypársovaní xml xmlpage : STRING := 'http://www.ote-cr.cz/kratkodobe-trhy/elekt rina/denni-trh'; // jméno web stránky XmlDocParser : fbxmlpageparserfindtag; // FB pro pársování souboru xml : TXmlInfo; // struktura pro výsledky pársování lasterr : STRING; // popis prípadné chyby parseenable : BOOL; // pomocná pro pársování numbercolumn : INT; index : INT:=1; VAR_TEMP REPEAT // cist XML ze souboru XmlDocParser( exec := rqdoc, chancode := ETH1_uni0, pagename := xmlpage, xmlinfo := xml,findtag := '<tbody>'); IF XmlDocParser.start THEN // blok XmlDocParser zahajil parsovani -> zahajime ho taky numbercolumn := 1; index := 1; // nastavit uvodni stav pro parsovani IF XmlDocParser.done THEN // vyparsovan jeden radek dokumentu IF xml.stack.level = 2 THEN IF xml.stack.layer[2].tag = '/td' THEN CASE numbercolumn OF 1 : index :=STRING_TO_INT_EX( xml.item.txt); IF (index = 0) OR (index > 24)THEN index := 25;// uz mam vse 25 radek lezi v tabulce ELSE //soucet jednotlivých sloupcu; tabulka_ote_hodnoty[index].hodina := index; 2 : tabulka_ote_hodnoty[index].cena := STRING_TO_REAL_EX( xml.item.txt ); 3 : tabulka_ote_hodnoty[index].mnozstvi := STRING_TO_REAL_EX( xml.item.txt ); 4 : tabulka_ote_hodnoty[index].cr_sr := STRING_TO_REAL_EX( xml.item.txt ); 5 : tabulka_ote_hodnoty[index].sr_cr := STRING_TO_REAL_EX( xml.item.txt ); END_CASE; numbercolumn := numbercolumn + 1; ELSIF xml.stack.level = 1 THEN 50 TXV 003 78.01
IF xml.stack.layer[1].tag = 'tr' THEN numbercolumn := 1; UNTIL XmlDocParser.break END_REPEAT; IF XmlDocParser.exec THEN IF XmlDocParser.eof OR XmlDocParser.err THEN // parsovani ukonceno rqdoc := 0; IF XmlDocParser.err THEN END_PROGRAM lasterr := XmlDocParser.errTxt; // zachytit chybu V tomto příkladu se používá pro pársování xml souboru instance funkčního bloku fbxmlpageparserfindtag, která je nazvaná XmlDocParser. Zpracování je zahájeno na náběžnou hranu proměnné rqdoc. Proměnná xmlpage obsahuje název web stránky. Instance XmlDocParser je volaná v cyklu REPEAT. Cyklus je vykonáván až do okamžiku, kdy se nastaví výstup XmlDoc- Parser.break na hodnotu TRUE. To znamená, že blok potřebuje načíst další část souboru a zpracování bude pokračovat v následujícím cyklu programu. Pokud je nastaven výstup XmlDocParser.start tak program provede inicializaci pomocných proměnných potřebných k rozebírání dokumentu. Když je nastaven výstup XmlDocParser.done tak to znamená, že byl vypársován jeden element XML dokumentu a informace o tomto elementu jsou uloženy v proměnné xml (ta obsahuje položky typu TXmlItem a TxmlStack). Následuje zpracování těchto informací a výsledky se uloží do proměnné tabulka_ote_hodnoty. V dalším ukázkovém příkladu chceme vyparsovat ze stránek České národní banky (viz http://www.cnb.cz/cs/financni_trhy/devizovy_trh/kurzy_devizoveho_trhu/denni_kurz.jsp) kurzy nejznámějších měn světa. 51 TXV 003 78.01