Merkintöjen lisäys XML-luetteloon

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:

  1. Avaa XML-tiedosto, jonka haluat liittää DTD- tai XML-skeemaan.
  2. Valitse ensin vaihtoehdot Ikkuna > Oletusasetukset ja sitten XML > XML-luettelo. 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.
  3. Luo uusi luettelomerkintä napsauttamalla Lisää-vaihtoehtoa.
  4. 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.
  5. 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.
  6. Kun olet luonut luettelomerkinnät, sulje Lisää XML-luettelomerkintä -valintaruutu napsauttamalla OK-painiketta. Tallenna asetukset napsauttamalla OK-painiketta uudelleen.
  7. 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 Tiedosto > Vie ja sitten XML > XML-luettelo. 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 Tiedosto > Tuo ja sitten XML > XML-luettelo . 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).

Aiheeseen liittyviä käsitteitä
XML-tiedostojen DTD-tiedosto- ja XML-skeemaliitokset
Aiheeseen liittyviä tehtäviä
Muokkaus DTD-tiedoston tai XML-skeeman rajoitteiden avulla
DOCTYPE-esittelyn muokkaus
DTD-tiedostoihin ja skeemoihin tehtyjen muutosten päivitys XML-tiedostoihin
Nimitilatietojen muokkaus