XML-luettelon merkintöjä käytetään määrittämään ulkoisten olioiden viittauksia
vastaavat paikallisesti määritetyt resurssit. Voit määrittää säännöt sille, miten näiden olioiden
selvitys tehdään.
Lisätietoja XML-luetteloiden standardista on osoitteessa http://www.oasis-open.org/committees/download.php/14809/xml-catalogs.html.
Oletetaan esimerkiksi:
että työstät XML-tiedostoa tietokoneellasi ja määrität tiedoston schemaLocation-määritteen
arvoksi skeeman c:\MySchema.xsd. Jos et käytä XML-luetteloa ja XML-tiedoston muokkaus
on valmis ja haluat julkaista sen Web-sivustossa, schemaLocation on muutettava
niin, että se viittaa Web-resurssiin.
Jos et halua tehdä jatkuvasti muutoksia XML-asiakirjaan, voit käyttää
XML-luetteloa: voisit esimerkiksi määrittää
säännön, joka määrittää Internet-resurssiviitettä (esimerkiksi "http://www.ibm.com/published-schemas/MySchema.xsd")
vastaavan resurssin sovelluskehittäjän paikallisessa koneessa (esimerkiksi "file:///C:/MySchema.xsd"). Tällöin URI-osoitteita tai sijainteja ei tarvitse päivittää muokkaamalla XML-asiakirjoja
jatkuvasti (mikä helpottaa tilannetta varsinkin, jos projektissa on useita
asiakirjoja), vaan voit tehdä päivityksen muokkaamalla yhtä XML-luettelon sääntöä.
Seuraavat ohjeet on kirjoitettu resurssiperspektiiviä varten, mutta ne pätevät useissa muissakin perspektiiveissä.
Voit lisätä merkinnän XML-luetteloon
seuraavasti:
- Avaa XML-tiedosto, jonka haluat liittää DTD- tai XML-skeemaan.
- Valitse ensin vaihtoehdot ja sitten . Kaikki käyttäjän ja lisäosien määrittämät luettelomerkinnät ovat
XML-luettelomerkinnät-osassa. Kun valitset merkinnän, sen tiedot tulevat näkyviin Tiedot-osaan.
- Luo uusi luettelomerkintä napsauttamalla Lisää-vaihtoehtoa.
- Napsauta vasemmanpuoleisessa sarakkeessa lisättävän luettelomerkinnän lajia:
| Vaihtoehto |
Kuvaus |
| Luettelomerkintä |
XML-prosessori selvittää olioviittaukset luettelomerkintöjen
avulla. Voit määrittää luettelosäännöt, joiden mukaan merkinnät
selvitetään.XML-luettelomerkintä
sisältää kaksi osaa:
- Avain (joka vastaa DTD- tai XML-skeemaa)
- Sijainti (URI-osoitteen kaltainen sijainti, joka sisältää DTD- tai
XML-skeeman sijaintitiedot).
Avain voi olla XML-tiedostossa. Kun XML-prosessori havaitsee avaimen, se selvittää avaimeen liittyvän DTD- tai
XML-skeeman sijainnin XML-luettelomerkinnän avulla.
|
| Uudelleenkirjoitusmerkintä |
Käytetään uudelleenohjaamaan
merkintäryhmiä. |
| Loppuliitteen merkintä |
Käytetään vastaamaan
URI-osoitteen tai järjestelmätunnuksen loppuliitettä. |
| Seuraava luettelo |
Käytetään viittaamaan toiseen luetteloon tuomatta sitä työympäristöön. |
| Delegaattiluettelo |
Käytetään yhdistämään
vaihtoehtoinen luettelo tunnisteeseen. |
- Täytä valitun luettelokohdan kentät:
Taulukko 1. Luettelokohdan tyypit ja yhdistetyt kentät
| Luettelotyyppi |
Kentät |
| Luettelomerkintä |
- Kirjoita tai hae selaamalla DTD- tai XML-skeematiedoston sijainti tai URI-osoite Sijainti-kenttään. Kentässä kuvataan tiedoston sijainti tietokoneen polkutyylin mukaisesti.
- Valitse Avainlaji:
- Jos olet määrittänyt DTD-skeeman, voit valita Avainlaji-kentästä vaihtoehdon Julkinen tunnus, Järjestelmän tunnus tai URI-osoite. Jos valitset Julkinen tunnus -vaihtoehdon, Avain-kentän
arvon on oltava sama kuin XML-tiedoston DOCTYPE-esittelyssä määritetty julkinen tunnus. Jos valitset Järjestelmän tunnus -vaihtoehdon, arvon on oltava
sama kuin XML-tiedoston DOCTYPE-esittelyssä määritetty järjestelmän tunnus.
Jos valitset URI-osoite-vaihtoehdon, arvon on oltava tarkennettu URI-osoite.
- Jos olet määrittänyt XML-skeeman, voit valita Avainlaji-kentästä joko
Nimitilan nimi- tai Skeeman sijainti -vaihtoehdon. Jos skeema on kohteen nimitilamääritys, se tulee automaattisesti näkyviin
Avain-kenttään.
Muussa tapauksessa voit määrittää skeeman
sijainnin Avain-kenttään.
- Valitse Määritä vaihtoehtoinen Web-osoite -valintaruutu,
jos haluat, että resurssille voidaan määrittää vaihtoehtoinen Web-osoite.
Järjestelmä käyttää tätä Web-osoitetta, kun tämän luettelomerkinnän perusteella
luodaan XML-ilmentymä. Huomautus: Tämä vaihtoehto on käytettävissä vain, jos olet valinnut Avainlaji-kentästä Julkinen tunnus- (kun kyseessä on DTD-skeema) tai Nimitilan nimi -vaihtoehdon (kun kyseessä on skeema).
|
| Uudelleenkirjoitusmerkintä |
- Valitse Vastaava avainlaji, joko URI
tai järjestelmätunnus.
- Vastaava alkumerkkijono: Vastaava etuliite, joka poistetaan
annetusta tunnisteesta.
- Uudelleenkirjoituksen etuliite: Etuliite, jota käytetään
poistettavan etuliitteen sijasta.
|
| Loppuliitteen merkintä |
- Kirjoita tai hae selaamalla DTD- tai XML-skeematiedoston sijainti tai URI-osoite Sijainti-kenttään. Kentässä kuvataan tiedoston sijainti tietokoneen polkutyylin mukaisesti.
- Valitse Avainlaji (URI tai järjestelmätunnus), johon verrataan.
- Kirjoita verrattavan tunnisteen Jälkiliite.
|
| Seuraava luettelo |
Kirjoita tai hae Muun XML-hakemistotiedoston sijainti -kenttään XML-hakemisto, johon haluat viitata. |
| Delegaattiluettelo |
- Valitse Vastaava avainlaji, joko URI
tai järjestelmätunnus.
- Vastaava alkumerkkijono: Annetun tunnisteen etuliite, johon verrataan.
- Delegoi tälle XML-tiedostolle: Vaihtoehtoinen liitettävä luettelo.
|
- Kun olet luonut luettelomerkinnät, sulje Lisää XML-luettelomerkintä -valintaruutu
napsauttamalla OK-painiketta. Tallenna asetukset napsauttamalla OK-painiketta uudelleen.
- Varmista, että XML-tiedosto on valittuna, ja napsauta työkalurivin Lataa
riippuvuudet uudelleen -painiketta.
XML-tiedosto on nyt liitetty XML- tai DTD-skeeman uusimpaan versioon.
Voit myös viedä ja tuoda XML-luettelon tiedot:
Voit viedä tiedot valitsemalla ensin vaihtoehdot ja sitten . Järjestelmä pyytää valitsemaan projektin ja määrittämän sen tiedoston nimen,
johon haluat luettelomerkinnät (tiedoston tunniste on .xmlcatalog). Voit avata
tämän tiedoston navigaattorinäkymässä. Koska luettelomerkinnät tallentuvat
.xmlcatalog-tiedostoihin, voit sisään- ja uloskuitata niitä aivan kuten muitakin
projektiresursseja.
Voit tuoda tiedot valitsemalla ensin vaihtoehdot ja sitten . Määritä sitten tiedosto, johon XML-luettelon asetukset ladataan. Kun tuot .xmlcatalog-tiedoston, sen merkinnät latautuvat XML-luetteloon
(kaikki aiemmin määritetyt merkinnät korvautuvat).