Kari Perttula

XML - skeemat

Tietotekniikan LuK-tutkielma

14.6.2003

Jyväskylän yliopisto

Tietotekniikan laitos

Tekijä: Kari Perttula

Yhteystiedot: pekaky@cc.jyu.fi

Työn nimi: XML-skeemat

Title in English: XML Schemas

Työ: LuK-tutkielma

Linja: Ohjelmistotekniikka.

Teettäjä: Jyväskylän yliopisto, tietotekniikan laitos

Avainsanat: XML-skeema, XML, DTD, SGML, leksikaalinen esitysmuoto, nimiavaruus, arvojoukko, perintä, sanastot, Busines2Busines.

Tiivistelmä: Käytetystä laitteistosta ja käyttöjärjestelmästä riippumattomaan tiedonesitykseen on kehitetty XML-kieli. Se ei kuitenkaan ota kantaa varsinaisen tietosisällön arvojoukkoihin, eikä tallennettavien tietoalkioiden keskinäiseen järjestykseen. Tutkielmassa käsiteltävä XML-skeema kehitettiin, jotta XML-dokumentin rakenne ja siihen tallennettavien tietoalkioiden sallitut arvojoukot voitaisiin paremmin määritellä. XML-skeemoja ymmärtävällä XML-parserilla voi tarkistaa käsiteltävän XML-dokumentin oikeamuotoisuuden ja sen, kuuluvatko annettujen tietoalkioiden arvot sallittuun arvojoukkoon.

Esipuhe

Ensimmäiseksi haluan kiittää kaikkia niitä henkilöitä, jotka ovat edesauttaneet tämän tutkielman valmistumista. Aivan erityinen kiitos kuuluu Jukka-Pekka Santaselle ja Tommi Lahtoselle runsaasta ja asiallisesta opastuksesta. Kiitos myös KS-Elektroniikka Oy:lle heidän tilauslomakkeestaan, josta sain muokattua tutkielmassa käytetyn esimerkkitapauksen.

Tämän tutkielman kirjoittaminen oli antoisa kokemus, sillä en tuntenut XML-teknologiaa ennestään kovin tarkasti. Myös tutkielman muoto on alkanut vähän kerrallaan selvitä ohjaajien avustuksella.

Termiluettelo

CSS (engl. Cascading Style Sheets) eli tyylitiedostot on tarkoitettu HTML- ja XML-dokumenttien ulkoasun määrittämiseen.

DTD (engl. Document Type Definition) on joukko sääntöjä, jotka määräävät, mitkä elementtityypit ovat sallittuja XML-dokumentin sisällä. Ne siis määrittävät kunkin elementtityypin sallitun sisällön ja attribuutit. DTD kuvaa myös kaikki ulkoiset elementit, joihin on viitattu dokumentin sisällä sekä käytettävissä olevat notaatiot [1].

HTML (engl. Hypertext Markup Language) on merkkauskieli, jolla määritellään hypertekstiä sisältäviä sivuja World Wide Webissä. Eräät HTML:n versiot ovat SGML:n sovellutuksia [1].

Nimiavaruus (engl. namespace) on tapa määrittää XML-dokumenteissa käytetyt nimet liittämällä ne URI:lla määriteltyyn kontekstiin [1].

SGML (engl. Standard Generalized Markup Language) on kansainvälinen standardi (ISO 8879:1986), joka määrittää yleisluontoisen merkkaustavan dokumenttien loogisen rakenteen esittämiseen järjestelmä- ja alustariippumattomalla tavalla. SGML on metakieli, eli kieli, jolla kuvataan merkkauskieliä [1].

XML (engl. Extensible Markup Language) on rakenteisten dokumenttien merkkauskieli. Se on laajennettavissa ja HTML:ää joustavampi.

XSL (engl. Extensible Stylesheet Language) on XML:n tyylikieli. Kyseinen koodausmenetelmä kertoo XML-dokumentin esittävälle sovellukselle, kuinka dokumentin elementit on esitettävä.

Sisältö

1 Johdanto

2 XML-skeemat

2.1 Mitä ovat XML-skeemat?

2.2 Mitä käytettiin ennen skeemoja?

2.3 Mihin skeemoja tarvitaan?

2.4 Muut skeemat

3 XML-skeeman muoto

3.1 Mistä XML-skeema rakentuu

3.2 Juurielementti

3.3 Elementin määrittely

3.4 Esimerkkiongelma

3.5 Tavoitteeksi asetettu XML-dokumentti

4 Halutun dokumentin validoiva skeema

4.1 XML-skeeman tunnisteet

4.2 XML-skeemalla validoitavan dokumentin muodon määrittelystä

4.3 Perintä

4.4 Ennalta määrätty arvojoukko

4.5 Elementin esiintymien määrääminen

4.6 Leksikaalisen esitysmuodon määrittäminen

4.7 XML-skeeman käytöstä esimerkkitapauksessa

4.8 Skeeman määrittelystä yleisemmin

5 Muutamia toteutettuja skeemoja ja sovelluksia

5.1 Instrument Markup Language

5.2 TranXML-kieli

5.3 XML-skeemaohjelmistoja

6 Yhteenveto

Lähteet

Liitteet

Liite 1. Malli tilauslomakkeesta

Liite 2. Tilausesimerkin XML-koodi

Liite 3. Esimerkki tilausdokumentin validoivasta XML-skeemasta

1 Johdanto

Liiketoimintojen lisääntyminen Internetissä on, muiden syiden ohessa, luonut tarpeen riippumattomaan tiedon esitysmuotoon. Tämän esitysmuodon ei tulisi olla riippuvainen laitteistosta, käyttöjärjestelmästä tai ohjelmistosta, joissa tieto luodaan tai missä se tulisi tulkita. Tähän tarpeeseen luotiin XML-standardi. Jotta XML-standardi olisi riittävän monikäyttöinen, kehitettiin siitä suhteellisen väljä. XML-dokumentin luoja voi lähes täysin vapaasti valita käyttämiensä elementtien nimeämiskäytännön ja elementtien esiintymisjärjestyksen.

Jotta XML-dokumenttien automaattinen käsittely olisi mahdollista, tarvitaan mekanismi, jolla tarkistetaan XML-dokumentin oikeamuotoisuus, toisin sanoen sopivuus kyseiseen tietojärjestelmään. DTD mahdollistaa kyllä dokumentin oikeamuotoisuuden tarkistuksen, mutta dokumentin tietojen arvojoukkoja ei DTD:llä voi rajoittaa riittävän tarkasti. Lisäksi DTD:n kielioppi poikkeaa XML:sta, joten dokumentin määrityksen luojan on osattava sekä XML:n että DTD:n melko erilaiset kieliopit.

Tutkielmassa käsitellään XML-skeemaa. Kyseinen standardi on suunniteltu mahdollistamaan XML-dokumentille samanlaisen oikeamuotoisuuden tarkistamisen, minkä DTD mahdollistaa. XML-skeema kuitenkin käyttää XML:n kielioppia, ja mahdollistaa lisäksi arvojoukkojen tarkemman määrittelyn.

Luvussa 2 tarkastellaan, millaisia välineitä on käytetty ennen kuin XML-skeema on kehitetty ja miksi skeemaa tarvitaan. Lisäksi kuvataan, mitä XML-skeemat ovat ja mitä muita skeemaratkaisuja on olemassa.

Luvussa 3 tutustutaan XML-skeemadokumentin muotoon. Luvussa esitellään elementti, joka on XML-dokumentin perusrakenneosa. Lisäksi esitellään yksinkertainen esimerkkiongelma. Luvussa tuodaan esille myös joitakin ajatuksia XML-skeeman suunnittelusta.

Luvussa 4 esitellään joitakin tekniikoita, joita voi käyttää XML-skeemassa. Käsittely tapahtuu edellisessä luvussa esitetyn XML-dokumentin validoivan XML-skeeman avulla

Luvussa 5 esitellään joitakin XML-skeemaan perustuvia sovelluksia.

2 XML-skeemat

Kysymys "Mikä ihmeen XML-skeema?" saattaa nousta esiin, jos joku mainitsee kyseisen termin. Tämä luku pyrkii vastaamaan tähän kysymykseen, samoin kuin siihen, mitä XML-skeemalla on korvattu ja sitä, mihin XML-skeemaa oikein tarvitaan. Näitä vastauksia on haettu lähteiden [1], [2] ja [3] pohjalta.

2.1 Mitä ovat XML-skeemat?

XML-skeema on XML-dokumentti, kokoelma XML-dokumentteja, tai osa toista XML-dokumenttia. Skeema muodostuu joukosta sääntöjä, jotka määrittävät halutunlaisen XML-dokumentin rakenteen, elementit, attribuutit, attribuuttien tietotyypit ja tarvittaessa myös attribuuttien arvoille sallitut arvojoukot.

Kaikki XML-dokumentit, jotka täyttävät tietyn XML-skeeman validisuusehdot, kuuluvat kyseisen XML-skeeman määrittämään dokumenttiluokkaan. XML-skeemaa voi käyttää validoimaan olemassaoleva XML-dokumentti (katso kuva 1). XML-dokumentti voidaan myös muodostaa dynaamisesti XML-skeeman perusteella (katso kuva 1).

Kuva 1. XML-dokumentin validointi tai luonti XML-skeemasta.

2.2 Mitä käytettiin ennen skeemoja?

Jo ennen XML-kielen syntyä oli syntynyt tarve luoda määrämuotoisia, alustariippumattomia dokumentteja, ja tarkistaa, onko jokin dokumentti määrämuotoinen. ASCII-merkistö (American Standard Code for Information Interchange) mahdollisti alustariippumattomat dokumentit. HTML (Hyper Text Markup Language) mahdollisti dokumentin esitysmuodon välittämisen, dokumentin käsittelyalustasta riippumatta.

HTML:ää laajempi merkkauskieli, SGML (Standard Generalized Markup Language) täyttää samat tarpeet kuin XML (Extensible Markup Language). Mahdollistaahan SGML myös tiedon merkityksen kertovien tagien käytön. Tosin SGML kykenee paljon muuhunkin.

SGML:ssa tietyn kielen määrittelyyn käytetään DTD:ia (Document Type Definition). Myös XML:lle ja XML-skeemalle on määritelty DTD. Kullekin XML-dokumentille (tai dokumenttiluokalle) voidaan määrittää DTD. On olemassa työkaluja, joilla verrataan dokumenttia sen määrittävään DTD:iin. Kyseiset työkalut kertovat, vastaako dokumentin rakenne DTD:ssa määriteltyä rakennetta.

Edellä esitetty toiminnallisuus riittää varsin pitkälle, mutta DTD ei pysty todentamaan dokumentissa esiintyvien arvojen kuulumista sallitulle alueelle. DTD:sta ei voi viitata toisen DTD:n osaan, eli kaikki validoitavassa dokumentissa esiintyvät rakenteet on määriteltävä kokonaan yhdessä DTD:ssa, tai sisällytettävä toinen (toiset) DTD kokonaisuutena validoivaan DTD:hen. Tästä seuraa, että DTD:sta voi tulla iso ja monimutkainen ja siten vaikeasti hallittava. Lisäksi sisällytettävässä DTD:ssa ei saa olla ristiriitoja isäntä-DTD:n kanssa.

DTD:ssa myös käytetään eri kielioppia kuin XML:ssa, mikä lisää sovellussuunnittelijalta vaadittavia taitoja sekä erityisesti mahdollisuutta tehdä virheitä. XML-skeemassa sen sijaan noudatetaan XML:n kielioppia.

2.3 Mihin skeemoja tarvitaan?

Erityisesti "business to business" -tyyppinen, eli yritysten välinen, kaupankäynti on yleistymässä Internetissä. Koska HTML ei mahdollista siirrettävien tietoalkioiden yksilöimistä, ei se anna kovin hyviä työkaluja kaupankäyntiin liittyvien asiakirjojen automaattiseen käsittelyyn. Tämä on ollut yksi tärkeimmistä syistä kehittää XML, jossa kunkin tietoalkion tyyppi voidaan nimetä.

XML-skeema antaa mahdollisuuden tarkistaa, että saapuva XML-dokumentti noudattaa vaadittua rakennetta, ja on siten yhteensopiva oman tietojärjestelmän kanssa. Lisäksi XML-skeemassa on mekanismi, jolla arvojoukkoja kyetään rajaamaan.

XML-skeema mahdollistaa myös sen, että esimerkiksi kauppajärjestelmän rakentaja voi, nimiavaruuksia käyttäen, valita kulloinkin validointiin käytettävän skeeman. Nimiavaruuksia käyttämällä voidaan samassa dokumentissa käyttää eri skeemoissa määriteltyjä tietotyyppejä. Koska eri skeemoista lainatuilla rakenteilla (tai tietotyypeillä) on nimiavaruuden tunnisteina eri etuliite, ovat ne isäntäskeemalle eri yksilöitä, vaikka niillä olisikin muuten sama nimi. Kustakin skeemasta isäntäskeema käyttää vain niitä elementtejä, joihin se viittaa suoraan, ja niitä, jotka määrittelevät edellä mainitut elementit.

Skeemoja voidaan myös käyttää määrittelemään johonkin erityistarkoitukseen tarvittava sanasto. Esimerkkinä tästä on NASA:n instrumenttien ohjauskieli, jota käsitellään tarkemmin luvussa 5.1 .

2.4 Muut skeemat

On myös monia muita XML:ään pohjautuvia skeemoja, kuten XML Data Reduced ja Microsoft Biztalk. Useimmat näistä vaihtoehtoisista skeemoista on kehitetty, koska XML-skeeman hyväksyminen standardiksi viivästyi. Toisaalta XML-skeema on koettu liian laajaksi, ja siten liian monimutkaiseksi. Tästä johtuen on kehitetty kevyempiä, johonkin tarkemmin määritettyyn, erityiskäyttöön tarkoitettuja skeemoja.

3 XML-skeeman muoto

Luvussa esitetään XML-skeeman perusrakenne ja tutkielmassa käsiteltävässä esimerkissä tarvittavia elementtejä. Esimerkkitapauksena käydään läpi XML-muotoinen tilauslomake ja sen validoiva XML-skeema esitetään luvussa 4. Vastaavanlaisia esimerkkejä on esitetty ainakin lähteissä [2] ja [3]. Ne eivät kuitenkaan aivan suoraan sopineet Suomen oloihin. Luku perustuu pääosin lähteisiin [2], [3], [13] ja [14].

3.1 Mistä XML-skeema rakentuu

Lähteen [13] mukaan XML-skeeman rakentamiseen käytettäviä komponentteja on kaikkiaan 13 erilaista, jotka voidaan jakaa 3 ryhmään. Ensisijaiset komponentit ovat seuraavat:
- simpleType-tietorakenteen määrittely,
- complexType-tietorakenteen määrittely,
- attribuutin esittely käytettäväksi kyseisessä kohdassa sekä
- elementin esittely käytettäväksi kyseisessä kohdassa validoitavaa XML-dokumenttia.
Näistä simple type ja complex type vaativat nimen määrittelyn (katso luku 3.3, toinen esimerkki), kun attribuutin ja elementin esittelyssä sitä voi tarvittaessa käyttää. Edellisten lisäksi on ryhmä toissijaisia ja avustavia komponentteja.

SimpleType -tietorakenne voi sisältää vain yhden elementin, jonka sisältönä on luku, merkkijono tai merkki (katso luku 4.5, toinen esimerkki). SimpleType voi perustua muualla määriteltyyn SimpleType -tietorakenteeseen tai johonkin perustietotyyppiin, johon on lisätty rajoitteita.

ComplexType on useista tietueista koostuva monimutkaisempi tietorakenne, vastaten C-kielen struct-rakennetta (katso luku 4.5, ensimmäinen esimerkki). ComlexTypen määrittelyyn voi käyttää tietotyyppejä jotka perustuvat SimpleTypeen, ComplexTypeen tai perustietotyyppeihin.

3.2 Juurielementti

XML-skeema on XML-dokumentti, jonka juurielementtinä on skeematietorakenne, joka muodostuu muista elementeistä ja attribuuteista. Kaikissa XML-skeemoissa juurielementti on muotoa

<xsd:schema xmlns:xsd="http://www.w3.org/2000/10/XMLSchema" elementFormDefault= "qualified">
...
</xsd:schema>

Juurielementissä on aluksi elementin nimi xsd:schema, joka koostuu etuliitteestä ja varsinaisesta nimestä. Etuliite viittaa nimiavaruuteen, joka määritellään seuraavaksi komennolla xmlns:xsd="http://www.w3.org/2000/10/XMLSchema". Yleisimmät XML-skeeman koostamiseen tarvittavat XML-skeeman elementit on määritelty ko. nimiavaruudessa.

Seuraavaksi annettava ohje (engl. directive) elementFormDefault= "qualified" on suunnattu kaikille niille dokumenteille, jotka perustuvat tähän XML-skeemaan. Sen mukaan kaikkien tähän XML-skeemaan perustuvissa dokumenteissa käytettävien elementtien tulee täyttää tässä XML-skeemassa määritellyissä nimiavaruuksissa asetetut vaatimukset. Toisin sanoen kyseisissä dokumenteissa ei saa olla elementtejä, joita ei ole määritelty tässä XML-skeemassa, tai tämän XML-skeeman käyttämissä nimiavaruuksissa.

3.3 Elementin määrittely

Kukin XML-dokumentissa käytettävä elementti on määriteltävä. Elementille on määritettävä vähintään sen muoto. Sille voidaan määrittää myös nimi seuraavasti:

<xsd:element name="tilaus"> ... </xsd:element>

Elementin nimi annetaan siis attribuuttina. Elementin muoto voidaan määritellä samantien, kuten on tehty esimerkin tilaus-elementille (katso liite 3). Elementin muotona voidaan käyttää viittausta myös samassa dokumentissa muualla, tai toisessa nimiavaruudessa, määriteltyyn tietotyyppiin. Tätä havainnollistaa seuraava esimerkki.

<xsd:element name="päiväys" type="päiväysTyyppi"/>

...

<xsd:complexType name="päiväysTyyppi">

<xsd:simpleContent>

<xsd:restriction base="xsd:string">

<xsd:pattern value= "[0-9]{2}.[0-9]{2}.[0-9]{2}([0-9]{2})?"/>

</xsd:restriction>

</xsd:simpleContent>

</xsd:complexType>

3.4 Esimerkkiongelma

Oy XYZ Ab toimittaa asiakkaillensa hilavitkuttimia ja niihin varaosia. Tilaukset on tähän asti toimitettu paperilla (tai faksilla, tai puhelimitse) ja syötetty konttorissa tilausjärjestelmään. Nyt Oy XYZ Ab on kuitenkin luomassa Internettiin sivustojaan ja samalla haluttaisiin luoda asiakkaille mahdollisuus tehdä tilaus Internetissä.

Toteutuksen kannalta yksinkertaisinta olisi luoda sivuille lomake, jonka asiakas täyttää ja lähettää Oy XYZ Ab:lle (esimerkiksi XML-dokumenttina). Konttorissa kyseinen lomake syötetään tilausjärjestelmään. Tilausten käsittelyn kannalta tämä ei tuo Oy XYZ Ab:lle mitään merkittävää hyötyä, sillä jonkun on edelleenkin tarkastettava tilauksen järkevyys. Lisäksi tilaus on käsin syötettävä tilausjärjestelmään.

Oy XYZ Ab:n kannalta olisi suotavaa, että palautuva dokumentti kelpaisi automaattisesti tilausjärjestelmälle syötteeksi. Riittääkö siis luoda tilausjärjestelmään XML-suodin, ja kaikki on hyvin? Ei aivan. Kelvottomien dokumenttien hylkääminen on nimittäin tarpeettoman työläs toteuttaa. Lisäksi osa vakioasiakkaista on jo jonkin aikaa toivonut mekanismia, jolla he saisivat tilaukset lähtemään suoraan omista tietojärjestelmistään.

3.5 Tavoitteeksi asetettu XML-dokumentti

Yrityksen tilausjärjestelmä osaa kaivaa tarvitsemansa tiedot esiin seuraavan muotoisesta XML-dokumentista:

<?xml version="1.0"?>

<!-- edited with XML Spy v3.5 (http://www.xmlspy.com) by Kari Perttula (private) -->

<!-- Kaikki tässä dokumentissa esiintyvät tiedot on hankittu ns. hiha-metodilla.-->

<tilaus>

<päiväys>17.6.2001</päiväys>

<numero>32047</numero>

<tilaaja>

<yritys>Tmi Villen vekottimet</yritys>

<nimi>Ville Kurppa</nimi>

<puhelinnumero>+358 14 555 9800</puhelinnumero>

<faksinumero>+358 14 555 9811</faksinumero>

<tilauksen-hyväksynyt>Ville Kurppa</tilauksen-hyväksynyt>

<osoite>

<postiosoite>

<osoite>PL 999</osoite>

<postinumero>40101</postinumero>

<postitoimipaikka>Jyväskylä</postitoimipaikka>

</postiosoite>

<käyntiosoite>

<osoite>Volmarinkatu 47</osoite>

<postinumero>40720</postinumero>

<postitoimipaikka>Jyväskylä</postitoimipaikka>

</käyntiosoite>

</osoite>

<rekisteri-tiedot>

<kaupparekisteri_numero>999.111</kaupparekisteri_numero>

<kotipaikka>Jyväskylä</kotipaikka>

</rekisteri-tiedot>

</tilaaja>

<toimittaja>

<yritys>ab XYZ oy</yritys>

<nimi/>

<puhelinnumero>+358 14 831 0009</puhelinnumero>

<faksinumero>+358 14 831 0001</faksinumero>

<osoite>

<postiosoite>

<osoite>Vuojärventie 130</osoite>

<postinumero>41340</postinumero>

<postitoimipaikka>Laukaa</postitoimipaikka>

</postiosoite>

<käyntiosoite>

<osoite>Vuojärventie 130</osoite>

<postinumero>41340</postinumero>

<postitoimipaikka>Laukaa</postitoimipaikka>

</käyntiosoite>

</osoite>

<rekisteri-tiedot>

<kaupparekisteri_numero>888.222</kaupparekisteri_numero>

<kotipaikka>Laukaa</kotipaikka>

</rekisteri-tiedot>

</toimittaja>

<toimitusehdot>

<toimitusaika>1 vk</toimitusaika>

<toimitustapa>matkahuolto</toimitustapa>

<toimituskulut>lähettäjä</toimituskulut>

<ALV-kanta>0 %</ALV-kanta>

</toimitusehdot>

<rivit>

<tilausrivi>

<koodi>06-99-196</koodi>

<nimeke>Hilavitkutin nro 3</nimeke>

<määrä>8</määrä>

<hinta>1399</hinta>

<alennus_prosentti>20</alennus_prosentti>

<toimitusviikko/>

</tilausrivi>

<tilausrivi>

<koodi>12-00-124</koodi>

<nimeke>Hilavitkutin nro 12</nimeke>

<määrä>12</määrä>

<hinta>1248</hinta>

<alennus_prosentti>12</alennus_prosentti>

<toimitusviikko/>

</tilausrivi>

<tilausrivi>

<koodi>07-99-005</koodi>

<nimeke>Hilavitkuttimen nro3 pehmustettu kantolaukku</nimeke>

<määrä>5</määrä>

<hinta>285</hinta>

<alennus_prosentti>10</alennus_prosentti>

<toimitusviikko/>

</tilausrivi>

<tilausrivi>

<koodi>01-88-007</koodi>

<nimeke>Hilavitkuttimen nro1 pääakseli</nimeke>

<määrä>1</määrä>

<hinta>580</hinta>

<alennus_prosentti>10</alennus_prosentti>

<toimitusviikko/>

</tilausrivi>

</rivit>

</tilaus>

4 Halutun dokumentin validoiva skeema

Luvussa 3.5 esitetyn XML-dokumentin runko voitaisiin asettaa yrityksen WWW-sivulle täytettäväksi. Ongelmaksi jää edelleenkin tilauksen järkevyyden tarkistus. Jos sen lisäksi sivulle laitetaan edellä esitetyn dokumentin validoiva XML-skeema, tällöin syötettävien arvojen oikeellisuuden tarkistus sisältyy validointiprosessiin.

Luvussa käsitellään yksi mahdollinen XML-skeema, joka validoi halutun XML-dokumentin. Samalla esitetään se, kuinka XML-skeema määritellään, ja mikä on sen tyypillinen muoto. Luvun tiedot pohjautuvat pitkälti lähteisiin [2], [3], [13] ja [14].

4.1 XML-skeeman tunnisteet

XML-skeemadokumentin alkuun tulee joitakin tunnistetietoja, jotka voivat olla esimerkiksi seuraavat:

<?xml version="1.0" encoding="UTF-8"?>

<!-- edited with XML Spy v3.5 (http://www.xmlspy.com) by Kari Perttula (private) -->

<xsd:schema xmlns:xsd="http://www.w3.org/2000/10 /XMLSchema" elementFormDefault="qualified">

Tunnistetiedot kertovat dokumenttia käsittelevälle ohjelmalle, kuinka kyseinen dokumentti on tulkittava. Toteutettavan XML-skeeman ensimmäinen rivi kertoo dokumentin noudattavan XML:n version 1.0 mukaista rakennetta.

Kommenttirivin jälkeen alkaa varsinainen XML-skeema, joka on itse asiassa tavallinen XML-dokumentin elementti (xsd:schema). Samalla on määritelty nimiavaruus (xmlns:xsd="http://www.w3.org/2000/10/XMLSchema"), ja sille kahva xsd (engl. handle, tag). Kyseisellä rivillä määritelty nimiavaruus on voimassa siinä elementissä (ja alielementeissä), jossa se on määritelty. Tässä tapauksessa siis koko skeemassa.

Skeeman alussa määrätty nimiavaruus osoittaa W3-konsortiumin määrittelemiin, valmiisiin tietotyyppeihin. Niinpä merkintä xsd:string viittaa valmiiseen merkkijonotietotyyppiin, joka on määritelty W3-konsortiumin julkistamassa skeemassa. Merkkijonon xsd tilalle olisi voitu valita myös joku muu merkkijono. Ilman etuliitettä (engl. prefix) merkityt elementin tai tietotyypin nimet viittaavat oletusnimiavaruuteen, joka tässä skeemassa tarkoittaa skeemaa itseään. Oletusnimiavaruudeksi voidaan määrätä myös jokin ulkopuolinen skeema (tai DTD).

Varsinainen XML-skeema sijaitsee elementtien

<xsd:schema xmlns:xsd="http://www.w3.org/2000/10/XMLSchema" elementFormDefault="qualified">

ja

</xsd:schema>

välissä.

4.2 XML-skeemalla validoitavan dokumentin muodon määrittelystä

XML-skeemassa määritellään validoitavan dokumentin muoto määrittelemällä dokumentissa sallittujen elementtien järjestys ja muoto seuraavasti:

<xsd:element name="tilaus">

<xsd:annotation>

<xsd:documentation>Tilauslomake</xsd: documentation>

</xsd:annotation>

<xsd:complexType>

<xsd:sequence>

<xsd:element name="päiväys" type="päiväysTyyppi"/>

<xsd:element name="numero" type="xsd:short"/>

<xsd:element name="tilaaja" type="tilaajaTyyppi"/>

<xsd:element name="toimittaja" type="toimittajaTyyppi"/>

<xsd:element name="Toimitusehdot" type="ehdotTyyppi"/>

<xsd:element name="kommentti" type="xsd:string" minOccurs="0" maxOccurs="1"/>

<xsd:element name="rivit" type="rivitTyyppi"/>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

Tässä juurielementille on määrätty nimeksi tilaus, sitä on kommentoitu elementillä <xsd:annotation> ja sen muoto on määritelty complexType-elementissä.

Edellisessä esimerkissä on määrätty myös tilaus-elementin alielementit. Näiden rakenne määritellään paikassa, johon kunkin elementin type-attribuutti viittaa. Lisäksi kommentti-elementti voi esiintyä validoitavassa dokumentissa korkeintaan yhden kerran, mutta sitä ei välttämättä tarvitse dokumentista löytyä (minOccurs="0" maxOccurs="1"). Oletusarvoisesti skeemassa mainittu elementti on löydyttävä dokumentista tasan yhden kerran, ellei muuta ole merkitty. XML-skeemassa määritettyjen elementtien on oltava validoitavassa dokumentissa siinä järjestyksessä, minkä XML-skeema määrittelee.

4.3 Perintä

Seuraavassa määriteltäviä tietotyyppejä tilaajaTyyppi ja toimittajaTyyppi käytetään elementtien tilaaja ja toimittaja rakenteen määräämiseen (katso luku 4.2). Kyseinen tietotyyppien määrittely on esimerkkinä perinnästä XML-skeemassa.

<xsd:complexType name="tilaajaTyyppi">

<xsd:simpleContent>

<xsd:restriction base="yleisYhteystietoTyyppi"/>

</xsd:simpleContent>

</xsd:complexType>

<xsd:complexType name="toimittajaTyyppi">

<xsd:simpleContent>

<xsd:restriction base="yleisYhteystietoTyyppi">

<xsd:sequence>

<xsd:element name="yritys" type="xsd:string" minOccurs="0"/>

<xsd:element name="nimi" type="xsd:string"/>

<xsd:element name="puhelinnumero" type="puhNroTyyppi" minOccurs="0"/>

<xsd:element name="faksinumero" type="puhNroTyyppi" minOccurs="0"/>

<xsd:element name="tilauksen-hyväksynyt" type="xsd:string" minOccurs="0" maxOccurs="0"/>

<xsd:element name="osoite" type="osoiteTyyppi"/>

<xsd:element name="rekisteri-tiedot" type="rekisteriTyyppi"/>

</xsd:sequence>

</xsd:restriction>

<xsd:simpleContent>

</xsd:complexType>

XML-skeema tuntee perinnän. Esimerkissä edellä tilaajaTyyppi ja toimittajaTyyppi perivät yleisYhteystietoTyyppi-elementin. Lisäksi on määritetty toimittajaTyyppiin lisärajoitukseksi, ettei tilauksen-hyväksynyt-elementtiä suvaita, asettamalla toimittajaTyyppin tilauksen-hyväksynyt-elementin maxOccurs-attribuutin arvoksi nolla.

Esimerkissä alla on attribuutin maxOccurs arvoksi asetettu unbounded, jolloin kyseessä olevan elementin esiintymien lukumäärän ylärajaa ei ole mitenkään rajoitettu.

<xsd:complexType name="rivitTyyppi">

<xsd:sequence>

<xsd:element name="tilausrivi" type="riviTyyppi" maxOccurs="unbounded"/>

</xsd:sequence>

</xsd:complexType>

4.4 Ennalta määrätty arvojoukko

Tietotyypille voidaan määrätä hyväksyttävien arvojen joukko luettelemalla, kuten seuraavassa esimerkissä:

<xsd:complexType name="toimituskulutTyyppi">

<xsd:simpleContent>

<xsd:restriction base="xsd:string">

<xsd:enumeration value="lähettäjä"/>

<xsd:enumeration value="vastaanottaja"/>

</xsd:restriction>

</xsd:simpleContent>

</xsd:complexType>

Hyväksyttävä arvojoukko voidaan määritellä myös antamalla sille ala- ja/tai yläraja, joka tapahtuu määrittelemällä tietotyypin attribuuttien minInclusive ja maxInclusive arvo.

4.5 Elementin esiintymien määrääminen

Seuraavassa esimerkissä elementit yritys, puhelinnumero ja faksinumero eivät ole pakollisia yhteystiedoissa. Tämä määritellään antamalla kyseisen elementin attribuutille minOccurs arvoksi nolla.

<xsd:complexType name="yleisYhteystietoTyyppi">

<xsd:simpleContent>

<xsd:restriction>

<xsd:sequence>

<xsd:element name="yritys" type="xsd:string" minOccurs="0"/>

<xsd:element name="nimi" type="xsd:string"/>

<xsd:element name="puhelinnumero" type="puhNroTyyppi" minOccurs="0"/>

<xsd:element name="faksinumero" type="puhNroTyyppi" minOccurs="0"/>

<xsd:element name="tilauksen-hyväksynyt" type="xsd:string"/>

<xsd:element name="osoite" type="osoiteTyyppi"/>

<xsd:element name="rekisteri-tiedot" type="rekisteriTyyppi"/>

</xsd:sequence>

</xsd:restriction>

</xsd:simpleContent>

</xsd:complexType>

Attribuutilla maxOccurs voidaan määrittää elementin esiintymien lukumäärälle yläraja, tai sallia rajoittamaton määrä elementtejä antamalla attribuutille maxOccurs arvoksi unbound. Mikäli attribuuttille maxOccurs ei ole määritetty arvoa, käytetään oletusarvoa 1. Attribuutin maxOccurs arvon tulee olla suurempi tai yhtäsuuri kuin attribuutin minOccurs arvon.

sequence-elementtien välissä olevien elementtien tulee esiintyä XML-dokumentissa samassa järjestyksessä, kuin ne on esitetty XML-skeemassa. choice-elementtien välissä esitellyistä elementeistä valitaan dokumenttiin yksi, ellei attribuutein muuta osoiteta. Alla on esitetty esimerkki sekä sequence- että choice-elementin käytöstä.

<xsd:simpleType name="puhNroTyyppi">

<xsd:restriction base="xsd:string"/>

</xsd:simpleType>

<xsd:complexType name="osoiteTyyppi" mixed="true">

<xsd:simpleContent>

<xsd:restriction>

<xsd:sequence>

<xsd:element name="postiosoite" type="postiosoiteTyyppi"/>

<xsd:element name="käyntiosoite" type="käyntiosoiteTyyppi"/>

</xsd:sequence>

</xsd:restriction>

</xsd:simpleContent>

</xsd:complexType>

<xsd:complexType name="postiosoiteTyyppi" mixed="true">

<xsd:sequence>

<xsd:choice minOccurs="1" maxOccurs="2">

<xsd:element name="osoite" type="plOsoiteTyyppi" minOccurs="0"/>

<xsd:element name="osoite" type="katuOsoiteTyyppi" minOccurs="0"/>

</xsd:choice>

<xsd:element ref="postinumero"/>

<xsd:element name="postitoimipaikka" type="xsd:string"/>

</xsd:sequence>

</xsd:complexType>

4.6 Leksikaalisen esitysmuodon määrittäminen

Koska XML perustuu merkkijonoihin, on XML:ssa käytettäville numeerisille ja muille merkkijonosta poikkeaville tietotyypeille määriteltävä leksikaalinen esitysmuoto. Perustietotyypeissä tämä määrittely on löydettävissä W3C:n määrityksistä. Esimerkissä alla määritetään leksikaalinen esitysmuoto tietotyypille plOsoiteTyyppi.

<xsd:complexType name="käyntiosoiteTyyppi">

<xsd:sequence>

<xsd:element name="osoite" type="katuOsoiteTyyppi" minOccurs="1" maxOccurs="2"/>

<xsd:element ref="postinumero"/>

<xsd:element name="postitoimipaikka" type="xsd:string"/>

</xsd:sequence>

</xsd:complexType>

<xsd:simpleType name="katuOsoiteTyyppi">

<xsd:restriction base="xsd:string"/>

</xsd:simpleType>

<xsd:simpleType name="plOsoiteTyyppi">

<xsd:restriction base="katuOsoiteTyyppi">

<xsd:pattern value="pl[0-9]{3}"/>

<xsd:pattern value="PL[0-9]{3}"/>

<xsd:pattern value="pl [0-9]{3}"/>

<xsd:pattern value="PL [0-9]{3}"/>

</xsd:restriction>

</xsd:simpleType>

Tässä plOsoiteTyyppi perustuu katuOsoiteTyyppi-elementin kautta perustietotyyppiin string siten, että plOsoiteTyyppiä oleva elementti voi saada arvokseen minkä tahansa merkkijonon. Kyseisen merkkijonon tulee kuitenkin alkaa merkeillä pl tai PL, joita seuraa välilyönti ja kolme numeroa tai kolme numeroa ilman välilyöntiä.

Leksikaalisen esitysmuodon määrittelyssä luetellaan ne merkit, jotka kyseisessä paikassa merkkijonoa ovat sallittuja. Mikäli sallittuja merkkejä kyseiseen paikkaan on useampia, esitetään ne joko hakasulkeissa pilkulla erotettuina [a,b,e,k] tai merkkijakson alku ja loppu hakasulkeissa [f-o]. Myös edellisten tapojen yhdistelmä on mahdollinen [a-c,f,h,v-z]. Luku aaltosuluissa, merkkimäärityksen jäljessä, kertoo sen, kuinka monta kyseistä merkkiä tulee olla. Mikäli merkkimääritys annetaan kaarisulkujen sisässä, voi kyseisen merkin jättää pois. Seuraavassa esimerkissä on määritelty päiväyksen esitysmuoto.

<xsd:complexType name="päiväysTyyppi">

<xsd:simpleContent>

<xsd:restriction base="xsd:string">

<xsd:pattern value="[0-9]{1}([0-9]{1}).[0-9]{1} ([0-9]{1}).[0-9]{2}([0-9]{2})?"/>

</xsd:restriction>

</xsd:simpleContent>

</xsd:complexType>

Tässä olisi voinut käyttää valmista perustietotyyppiä date, mutta se on määritelty ISO-standardin 8601 mukaiseksi. Tällöin päiväys on muotoa 2001-08-16 (vvvv-kk-pp). Kun halutaan käyttää suomalaisittain tutumpaa muotoa 16.8.2001, joudutaan määrittelemään uusi tietotyyppi. päiväysTyyppi-elementissä on siis yksi tai kaksi numeroa, piste, yksi tai kaksi numeroa, piste ja kaksi tai neljä numeroa.

Postinumeron leksikaaliseksi esitysmuodoksi Suomessa riittänee viisi numeroa, kuten esimerkissä alla.

<xsd:element name="postinumero">

<xsd:simpleType>

<xsd:restriction base="xsd:string">

<xsd:pattern value="\d{5}"/>

</xsd:restriction>

</xsd:simpleType>

</xsd:element>

Seuraavassa esimerkissä määritellään arvoalueeltaan rajattu desimaalilukutyyppi ja sen esitysmuoto:

<xsd:complexType name="prosenttiTyyppi">

<xsd:simpleContent>

<xsd:restriction base="xsd:desimal">

<xsd:totalDigits value="5"/>

<xsd:fractionDigits value="2"/>

<xsd:minInclusive value="0.00"/>

<xsd:maxInclusive value="100.00"/>

</xsd:restriction>

</xsd:simpleContent>

</xsd:complexType>

prosenttiTyyppi-elementti voi saada arvokseen desimaaliluvun, jossa on korkeintaan viisi numeroa (totalDigits). Numeroista kaksi on varattu desimaaliosalle (fractionDigits). Pienin sallittu arvo on 0.00 (minInclusive) ja suurin 100.00 (maxInclusive).

Seuraavassa esimerkissä hinta ilmoitetaan kahden desimaalin tarkkuudella. Kokonaisosaan jää kuusi numeroa, joten suurin mahdollinen hinta on siis 99999.99. Pienin sallittu arvo on 0.00, joten palautukset eivät ole mahdollisia tilauslomaketta käyttäen.

<xsd:complexType name="hintaTyyppi">

<xsd:simpleContent>

<xsd:restriction base="xsd:desimal">

<xsd:totalDigits value="8"/>

<xsd:fractionDigits value="2"/>

<xsd:minInclusive value="0.00"/>

</xsd:restriction>

</xsd:simpleContent>

</xsd:complexType>

Seuraavassa esimerkissä tuotekoodit ovat muotoa kaksi numeroa, viiva, kaksi numeroa, viiva ja kolme numeroa.

<xsd:complexType name="koodiTyyppi">

<xsd:simpleContent>

<xsd:restriction base="xsd:string">

<xsd:pattern value="\d{2}-\d{2}-\d{3}"/>

</xsd:restriction>

</xsd:simpleContent>

</xsd:complexType>

4.7 XML-skeeman käytöstä esimerkkitapauksessa

Esimerkissä tilauksia vastaanottavassa tietojärjestelmänosassa on parseri, joka lukee XML-tilauslomakkeesta tilauksen tiedot sekä vertaa XML-dokumenttia edellä määriteltyyn skeemaan. Mikäli dokumentti ei ole ristiriidassa skeeman kanssa, tilauksen tiedot tallennetaan tietojärjestelmään. Mikäli XML-tilauksen sisällössä on jotain skeemassa kiellettyä, parseri hylkää dokumentin ja palauttaa virheilmoituksen tilauksen lähettäjälle.

4.8 Skeeman määrittelystä yleisemmin

Edellä esitetty, suhteellisen yksinkertainen, esimerkki oli kirjoittajan mielestä helpointa määritellä valmiista XML-dokumentista liikkeelle lähtien. Laajoissa skeemoissa on syytä lähteä liikkeelle järjestelmällisempiä suunnittelumetodeja käyttäen.

Osoitteessa http://XMLModeling.com löytyy tietoa XML-dokumenttien mallintamisesta UML:ää käyttäen. Erityisesti Dave Carsonin kirjoittamaa esitystä "Modeling the UDDI Schema with UML" voi suositella.

Kaikki XML-työkalut eivät välttämättä hyväksy yllä esitettyä skeemaa, vaikka skeeman pitäisikin olla standardin mukainen. Esimerkiksi XML-editori XML -Spyn versio 3.5 ei hyväksynyt skandinaavisia merkkejä (åäö), vaikka ne standardissa on määritelty hyväksytyiksi merkeiksi. Lisäksi XML-Spy ei tue perintää sen kaikissa standardin määrittelemissä muodoissa. XML-Spyn uudemmissa versioissa perintä pitäisi olla paremmin tuettuna.

5 Muutamia toteutettuja skeemoja ja sovelluksia

Luvussa esitellään lyhyesti joitakin toteutettuja XML-skeemoja ja ohjelmistoja, jotka käyttävät tai kykenevät muokkaamaan XML-skeemoja.

5.1 Instrument Markup Language

NASA on kehittänyt tähtitietellisten instrumenttien kauko-ohjausjärjestelmää. Osana tätä järjestelmää käytetään instrumenttien merkkauskieltä, jonka määrittely on tehty XML-skeemoilla. Näitä skeemoja voi sitten käyttää instrumentille tulevien kauko-ohjauskomentojen (syntaktisen) oikeellisuuden tarkistamiseen.

Nasan WWW-sivuilta löytyy tarkempia tietoja instrumenttien kauko-ohjauksesta [5] ja Instrument Markup Language -kielestä [6].

5.2 TranXML-kieli

Transentric on kehittänyt TranXML-kielen [7] kuljetusliikkeiden tiedonsiirron tarpeisiin. Transentric toivoo, että TranXML nousisi avoimeksi teollisuusstandardiksi.

Kieli on vapaasti käytettävissä TranXML Open Source Licence Agreementin mukaisesti. Kyseinen lisenssi on lähes saman sisältöinen kuin GPL [4]. Lisenssistä [8] on linkki TranXML:n määritteleviin skeemoihin.

5.3 XML-skeemaohjelmistoja

XML Spy on kaupallinen XML-editori Windows-ympäristöön ja se tukee myös XML-skeemoja. XML Spy mm. luo automaattisesti skeeman laadittavasta XML-dokumentista. Tutustumisversion voi ladata maksutta yhtiön WWW-sivuilta [9].

EditML on toinen kaupallinen Windows-ympäristössä toimiva XML-editori. Se tuntee myös DTD:t ja XML-skeemat. Tutustumisversion voi ladata maksutta Netbryx Technologiesin WWW-sivuilta [10].

Ilmoituksessaan XMLFormsin julkaisusta [11], Schemantix kertoo XMLFormsin olleen aiemmin vapaan lähdekoodin kehitysprojekti, nimeltään SxDP (Schemantix Development Platform).

Schemantixin mukaan XMLForms luo dynaamisesti graafisen käyttöliittymän mistä tahansa oikeellisesta XML-dokumentista tai -skeemasta. Niinpä tämä teknologia luo hetkessä dynaamisen ja interaktiivisen edustan mille tahansa sovellukselle, jonka ytimenä on XML.

Sittemmin Schemantix on kehittänyt Schemantix Busines Service Platformin, ja sitä käyttäen Schemantix Business Service Suiten. Samalla maininnat XMLFormsista ovat kadonneet yhtiön kotisivuilta [12].

6 Yhteenveto

Tietyllä XML-skeemalla voidaan tarkastaa jonkin tietyn dokumentin oikeamuotoisuus. Lisäksi samaa XML-skeemaa voidaan käyttää kaavana XML-dokumenttia tilanteen mukaan ohjelmallisesti luotaessa. Myös sanastoja ja erikoiskieliä voidaan määritellä XML-skeemalla.

XML-skeema kehitettiin nimenomaan XML-dokumenttien validointiin, joten sen muodoksi tuli luontevasti XML:n muoto. Toisin sanoen XML-skeema sinällään on XML-dokumentti. Vastaavasti kuin DTD:ssa, myös XML-skeemassa määritellään validoitavan dokumenttiluokan ilmentymien sisältämät elementit ja niiden järjestys kyseisessä dokumentissa. Lisäksi XML-skeemaan on luotu mekanismi, jolla elementin sisältämälle tiedolle sallittu arvojoukko voidaan rajata hyvin tarkasti.

XML-skeemasta on yritetty tehdä standardia, jossa olisi jokaiselle jotakin. Niinpä XML-skeema on paikoitellen ehkäpä turhan monimutkainen.

Eri tahot ovat luoneet skeemavarastoja (engl. schema repositorys), joihin on tallennettuna valmiita skeemoja kenen tahansa käytettäväksi. Lisäksi jotkin tahot ovat alkaneet kehittää sanastoja eri aloille. Näiden hankkeiden tarkoituksena on luoda yhtenäinen termistö kullekin kaupan ja teollisuuden alalle. Kuitenkin, kun kehittäjiä on useita, tekevät he päällekkäistä työtä sekä luovat toisistaan poikkeavia ja siten yhteensopimattomia termistöjä.

Lähteet

[1] North Simon ja Hermans Paul, (suomentanut Santala-Köykkä Riitta), "XML", Edita, IT-Press Helsinki, 2001.

[2] Fallside David C, "XML Schema Part 0: Primer ", saatavilla HTML-muodossa
<URL: http://www.w3.org/tr/xmlschema-0/ >, W3C, 2001.

[3] Walsh Norman, "Understanding XML Schemas", saatavilla HTML-muodossa,
<URL: http://www.xml.com/pub/a/1999/07/schemas/index.html>, O'Reilly & Assosiated, inc. 1999.

[4] Dumbill Edd, "Schemas for the Transportation Industry", saatavilla HTML-muodossa, <URL: http://www.xmlhack.com/read.php?item=1209>,
XMLhack, 2001.

[5] NASA, "Instrument Remote Control", saatavilla HTML-muodossa, <URL: http://pioneer.gsfc.nasa.gov/public/irc/>, NASA, luettu 7.11.2002.

[6] NASA, "Instrument Markup Language", saatavilla HTML-muodossa, <URL: http://pioneer.gsfc.nasa.gov/public/iml/>, NASA, luettu 7.11.2002.

[7] Transentric, "TranXML®", saatavilla HTML-muodossa, <URL: http://www.transentric.com/products/commerce/tranxml.asp>, Transentric in. luettu 7.11.2002.

[8] Transentric, "TranXML® Open Source License Agreement", saatavilla HTML-muodossa, <URL: http://www.transentric.com /products /commerce/license.asp>, Transentric inc, 2001.

[9] Altova, "xmlspy ", saatavilla HTML-muodossa,
<URL: http://www.xmlspy.com>, Altova, 2001.

[10] Netbryx Technologies, kotisivu, saatavilla HTML-muodossa,
<URL: http://www.editml.com> Netbryx Techonologies, 2000.

[11] Gertner Matthew,"ANN: XMLForms 1.0", saatavilla HTML-muodossa, <URL: http://lists.xml.org/archives/xml-dev/200103 /msg01190.html>, XML.org, 2001.

[12] Schemantix, kotisivu, saatavilla HTML-muodossa,
<URL: http://www.schemantix.com>, Schemantix 2001.

[13] Thompson Henry S. , et als, "XML Schema Part 1: Structures ", saatavilla HTML-muodossa, <URL: http://www.w3.org/TR/2001/PR-xmlschema-1-20010330/>, W3C, 2001.

[14] Biron Paul V, Malhotra Ashok, "XML-Schema Part 2: Datatypes ", saatavilla
HTML-muodossa, <URL: http://www.w3.org/TR/2001/PR-xmlschema-2-20010330/>, W3C, 2001.

Liitteet

Liite 1. Malli tilauslomakkeesta

Tilaaja
Yritys:______________________________
Nimi:_______________________________
Tilauksen hyväksynyt:__________________
Postiosoite:__________________________
Postinro ja toimipaikka:________________
___________________________________
Käyntiosoite:________________________
Postinro ja toimipaikka:________________
___________________________________
Kaupparekisterinumero:________________
Kotipaikka:__________________________

XYZ oy
puh: +358 14 831 0009
fax: +358 14 831 0001
________________________
Vuojärventie 130
41340 Laukaa

Kaupparekisterinumero 888.222
Kotipaikka Laukaa

Tilaus N:o_______________________

_____/_____ 20____

Toimitusaika_____________________

Toimitustapa_____________________

Toimituskulut: Vast.ottaja/Lähettäjä

________________________________

Hinnat: ALV0% / ALV22%

Koodi	Nimeke	Määrä	Hinta	Ale-%	Toim.vko

Allekirjoitus__________________________________

Liite 2. Tilausesimerkin XML-koodi

<?xml version="1.0"?>

<!-- edited with XML Spy v3.5 (http://www.xmlspy.com) by Kari Perttula (private) -->

<!-- Kaikki tässä dokumentissa esiintyvät tiedot on hankittu ns hiha-metodilla.-->

<tilaus>

<päiväys>17.6.2001</päiväys>

<numero>32047</numero>

<tilaaja>

<yritys>Tmi Villen vekottimet</yritys>

<nimi>Ville Kurppa</nimi>

<puhelinnumero>+358 14 555 9800</puhelinnumero>

<faksinumero>+358 14 555 9811</faksinumero>

<tilauksen-hyväksynyt>Ville Kurppa </tilauksen-hyväksynyt>

<osoite>

<postiosoite>

<osoite>PL 999</osoite>

<postinumero>40101</postinumero>

<postitoimipaikka>Jyväskylä</postitoimipaikka>

</postiosoite>

<käyntiosoite>

<osoite>Volmarinkatu 47</osoite>

<postinumero>40720</postinumero>

<postitoimipaikka>Jyväskylä</postitoimipaikka>

</käyntiosoite>

</osoite>

<rekisteri-tiedot>

<kaupparekisteri_numero>999.111 </kaupparekisteri_numero>

<kotipaikka>Jyväskylä</kotipaikka>

</rekisteri-tiedot>

</tilaaja>

<toimittaja>

<yritys>ab XYZ oy</yritys>

<nimi/>

<puhelinnumero>+358 14 831 0009</puhelinnumero>

<faksinumero>+358 14 831 0001</faksinumero>

<osoite>

<postiosoite>

<osoite>Vuojärventie 130</osoite>

<postinumero>41340</postinumero>

<postitoimipaikka>Laukaa</postitoimipaikka>

</postiosoite>

<käyntiosoite>

<osoite>Vuojärventie 130</osoite>

<postinumero>41340</postinumero>

<postitoimipaikka>Laukaa</postitoimipaikka>

</käyntiosoite>

</osoite>

<rekisteri-tiedot>

<kaupparekisteri_numero>888.222 </kaupparekisteri_numero>

<kotipaikka>Laukaa</kotipaikka>

</rekisteri-tiedot>

</toimittaja>

<toimitusehdot>

<toimitusaika>1 vk</toimitusaika>

<toimitustapa>matkahuolto</toimitustapa>

<toimituskulut>lähettäjä</toimituskulut>

<ALV-kanta>0 %</ALV-kanta>

</toimitusehdot>

<rivit>

<tilausrivi>

<koodi>06-99-196</koodi>

<nimeke>Hilavitkutin nro 3</nimeke>

<määrä>8</määrä>

<hinta>1399.00</hinta>

<alennus_prosentti>20</alennus_prosentti>

<toimitusviikko/>

</tilausrivi>

<tilausrivi>

<koodi>12-00-124</koodi>

<nimeke>Hilavitkutin nro 12</nimeke>

<määrä>12</määrä>

<hinta>1248.00</hinta>

<alennus_prosentti>12</alennus_prosentti>

<toimitusviikko/>

</tilausrivi>

<tilausrivi>

<koodi>07-99-005</koodi>

<nimeke>Hilavitkuttimen nro3 pehmustettu kantolaukku </nimeke>

<määrä>5</määrä>

<hinta>285.80</hinta>

<alennus_prosentti>10</alennus_prosentti>

<toimitusviikko/>

</tilausrivi>

<tilausrivi>

<koodi>01-88-007</koodi>

<nimeke>Hilavitkuttimen nro1 pääakseli</nimeke>

<määrä>1</määrä>

<hinta>580.00</hinta>

<alennus_prosentti>10</alennus_prosentti>

<toimitusviikko/>

</tilausrivi>

</rivit>

</tilaus>

Liite 3. Esimerkki tilausdokumentin validoivasta XML-skeemasta

<?xml version="1.0" encoding="UTF-8"?>

<!-- edited with XML Spy v3.5 (http://www.xmlspy.com) by Kari Perttula (private) -->

<xsd:schema xmlns:xsd= "http://www.w3.org/2000/10/XMLSchema" elementFormDefault="qualified">

<xsd:element name="tilaus">

<xsd:annotation>

<xsd:documentation>Tilauslomake</xsd:documentation>

</xsd:annotation>

<xsd:complexType>

<xsd:sequence>

<xsd:element name="päiväys" type= "päiväysTyyppi"/>

<xsd:element name="numero" type="xsd:short"/>

<xsd:element name="tilaaja" type= "tilaajaTyyppi"/>

<xsd:element name="toimittaja" type= "toimittajaTyyppi"/>

<xsd:element name="Toimitusehdot" type= "ehdotTyyppi"/>

<xsd:element name="kommentti" type="xsd:string" minOccurs="0" maxOccurs="1"/>

<xsd:element name="rivit" type="rivitTyyppi"/>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:complexType name="tilaajaTyyppi">

<xsd:simpleContent>

<xsd:restriction base="yleisYhteystietoTyyppi"/>

</xsd:simpleContent>

</xsd:complexType>

<xsd:complexType name="toimittajaTyyppii">

<xsd:simpleContent>

<xsd:restriction base="yleisYhteystietoTyyppi">

<xsd:sequence>

<xsd:element name="yritys" type="xsd:string" minOccurs="0"/>

<xsd:element name="nimi" type="xsd:string"/>

<xsd:element name="puhelinnumero" type="puhNroTyyppi" minOccurs="0"/>

<xsd:element name="faksinumero" type="puhNroTyyppi" minOccurs="0"/>

<xsd:element name="tilauksen-hyväksynyt" type="xsd:string" minOccurs="0" maxOccurs="0"/>

<xsd:element name="osoite" type="osoiteTyyppi"/>

<xsd:element name="rekisteri-tiedot" type="rekisteriTyyppi"/>

</xsd:sequence>

</xsd:restriction>

<xsd:simpleContent>

</xsd:complexType>

<xsd:complexType name="rivitTyyppi">

<xsd:sequence>

<xsd:element name="tilausrivi" type="riviTyyppi" maxOccurs="unbounded"/>

</xsd:sequence>

</xsd:complexType>

<xsd:complexType name="ehdotTyyppi">

<xsd:sequence>

<xsd:element name="toimitusaika" type="xsd:string"/>

<xsd:element name="toimitustapa" type="xsd:string"/>

<xsd:element name="toimituskulut" type="toimituskulutTyyppi"/>

<xsd:element name="ALV-kanta" type="xsd:string"/>

</xsd:sequence>

</xsd:complexType>

<xsd:complexType name="toimituskulutTyyppi">

<xsd:simpleContent>

<xsd:restriction base="xsd:string">

<xsd:enumeration value="lähettäjä"/>

<xsd:enumeration value="vastaanottaja"/>

</xsd:restriction>

</xsd:simpleContent>

</xsd:complexType>

<xsd:complexType name="yleisYhteystietoTyyppi">

<xsd:simpleContent>

<xsd:restriction>

<xsd:sequence>

<xsd:element name="yritys" type="xsd:string" minOccurs="0"/>

<xsd:element name="nimi" type="xsd:string"/>

<xsd:element name="puhelinnumero" type="puhNroTyyppi" minOccurs="0"/>

<xsd:element name="faksinumero" type="puhNroTyyppi" minOccurs="0"/>

<xsd:element name="tilauksen-hyväksynyt" type="xsd:string"/>

<xsd:element name="osoite" type="osoiteTyyppi"/>

<xsd:element name="rekisteri-tiedot" type="rekisteriTyyppi"/>

</xsd:sequence>

</xsd:restriction>

</xsd:simpleContent>

</xsd:complexType>

<xsd:simpleType name="puhNroTyyppi">

<xsd:restriction base="xsd:string"/>

</xsd:simpleType>

<xsd:complexType name="osoiteTyyppi" mixed="true">

<xsd:simpleContent>

<xsd:restriction>

<xsd:sequence>

<xsd:element name="postiosoite" type="postiosoiteTyyppi"/>

<xsd:element name="käyntiosoite" type="käyntiosoiteTyyppi"/>

</xsd:sequence>

</xsd:restriction>

</xsd:simpleContent>

</xsd:complexType>

<xsd:complexType name="postiosoiteTyyppi" mixed="true">

<xsd:sequence>

<xsd:choice minOccurs="1" maxOccurs="2">

<xsd:element name="osoite" type="plOsoiteTyyppi" minOccurs="0"/>

<xsd:element name="osoite" type="katuOsoiteTyyppi" minOccurs="0"/>

</xsd:choice>

<xsd:element ref="postinumero"/>

<xsd:element name="postitoimipaikka" type="xsd:string"/>

</xsd:sequence>

</xsd:complexType>

<xsd:complexType name="käyntiosoiteTyyppi">

<xsd:sequence>

<xsd:element name="osoite" type="katuOsoiteTyyppi" minOccurs="1" maxOccurs="2"/>

<xsd:element ref="postinumero"/>

<xsd:element name="postitoimipaikka" type="xsd:string"/>

</xsd:sequence>

</xsd:complexType>

<xsd:simpleType name="katuOsoiteTyyppi">

<xsd:restriction base="xsd:string"/>

</xsd:simpleType>

<xsd:simpleType name="plOsoiteTyyppi">

<xsd:restriction base="katuOsoiteTyyppi">

<xsd:pattern value="pl[0-9]{3}"/>

<xsd:pattern value="PL[0-9]{3}"/>

<xsd:pattern value="pl [0-9]{3}"/>

<xsd:pattern value="PL [0-9]{3}"/>

</xsd:restriction>

</xsd:simpleType>

<xsd:complexType name="rekisteriTyyppi">

<xsd:sequence>

<xsd:element name="kaupparekisteri_numero" type="xsd:string"/>

<xsd:element name="kotipaikka" type="xsd:string"/>

</xsd:sequence>

</xsd:complexType>

<xsd:element name="postinumero">

<xsd:simpleType>

<xsd:restriction base="xsd:string">

<xsd:pattern value="\d{5}"/>

</xsd:restriction>

</xsd:simpleType>

</xsd:element>

<xsd:complexType name="päiväysTyyppi">

<xsd:simpleContent>

<xsd:restriction base="xsd:string">

<xsd:pattern value="[0-9] {1} ( [0-9] {1} ) . [0-9] {1} ( [0-9] {1} ) . [0-9] {2} ( [0-9] {2} ) ?"/>

</xsd:restriction>

</xsd:simpleContent>

</xsd:complexType>

<xsd:complexType name="riviTyyppi">

<xsd:sequence>

<xsd:element name="koodi" type="koodiTyyppi"/>

<xsd:element name="nimeke" type="xsd:string"/>

<xsd:element name="määrä" type="einegatiivinenDesimaaliTyyppi"/>

<xsd:element name="hinta" type="hintaTyyppi"/>

<xsd:element name="alennus_prosentti" type="prosenttiTyyppi"/>

</xsd:sequence>

</xsd:complexType>

<xsd:complexType name="prosenttiTyyppi">

<xsd:simpleContent>

<xsd:restriction base="xsd:desimal">

<xsd:totalDigits value="5"/>

<xsd:fractionDigits value="2"/>

<xsd:minInclusive value="0.00"/>

<xsd:maxInclusive value="100.00"/>

</xsd:restriction>

</xsd:simpleContent>

</xsd:complexType>

<xsd:complexType name="hintaTyyppi">

<xsd:simpleContent>

<xsd:restriction base="xsd:desimal">

<xsd:totalDigits value="8"/>

<xsd:fractionDigits value="2"/>

<xsd:minInclusive value="0.00"/>

</xsd:restriction>

</xsd:simpleContent>

</xsd:complexType>

<xsd:complexType name="einegatiivinenDesimaaliTyyppi">

<xsd:simpleContent>

<xsd:restriction base="xsd:desimal">

<xsd:minInclusive value="0.0"/>

</xsd:restriction>

</xsd:simpleContent>

</xsd:complexType>

<xsd:complexType name="koodiTyyppi">

<xsd:simpleContent>

<xsd:restriction base="xsd:string">

<xsd:pattern value="\d{2}-\d{2}-\d{3}"/>

</xsd:restriction>

</xsd:simpleContent>

</xsd:complexType>

</xsd:schema>