Med XML-katalogoppføringer kan du tilordne eksterne entitetsreferanser til lokalt definerte ressurser. Du kan oppgi regler for hvordan disse entitetene skal behandles.
Du finner nærmere opplysninger om standarden for XML-kataloger på http://www.oasis-open.org/committees/download.php/14809/xml-catalogs.html.
Anta for eksempel at du arbeider med en XML-fil på datamaskinen og peker dens
schemaLocation mot et skjema kalt c:\MySchema.xsd. Hvis du ikke bruker en
XML-katalog, må du redigere schemaLocation når du er ferdig med XML-filen og klar til
å publisere den på nettet, slik at schemaLocation peker på en ressurs som er tilgjengelig på nettet.
Hvis du
vil unngå stadige endringer av XML-dokumentet, kan du bruke
XML-katalogen. Du kan oppgi en regel som omdirigerer en referanse til en Internett-ressurs
(for eksempel "http://www.ibm.com/published-schemas/MySchema.xsd"),
slik at den peker på en ressurs på den lokale maskinen
(for eksempel "file:///C:/MySchema.xsd"). I stedet for å redigere XML-dokumenter ofte og oppdatere
URIene eller plasseringene (særlig når det er mange dokumenter i prosjektet)
trenger du bare å oppdatere en enkelt regel i XML-katalogen.
Instruksjonene nedenfor er skrevet for Ressurs-perspektivet, men virker også for mange andre perspektiver.
Slik legger du til en
oppføring i XML-katalogen:
- Åpne XML-filen som du vil knytte til en DTD eller et XML-skjema.
- Klikk på og velg . Delen XML-katalogoppføringer inneholder en liste over brukerdefinerte og plugin-definerte
katalogoppføringer. Du kan velge en hvilken som helst oppføring for å få informasjon om den i delen Detaljer.
- Klikk på Legg til for å opprette en ny katalogoppføring.
- I kolonnen til venstre klikker du på den typen katalogoppføring
du vil legge til:
| Alternativ |
Beskrivelse |
| Katalogoppføring
|
Brukes av en XML-behandler ved behandling av entitetsreferanser.
Du kan gi katalogen regler for å oppgi hvordan entiteter skal behandles.En XML-katalogoppføring
består av to deler:
- En nøkkel (som representerer et DTD- eller XML-skjema)
- En plassering
(likner på en URI, som inneholder informasjon om et DTD- eller XML-skjemas plassering).
Du kan
legge nøkkelen i en XML-fil. Når XML-prosessoren finner den, vil den bruke XML-katalogoppføringen til å finne plasseringen til DTDen eller
XML-skjemaet som er knyttet til nøkkelen.
|
| Omskrivingsoppføring |
Brukes til å omdirigere
et sett med entiteter. |
| Suffiksoppføring |
Brukes til å sammenlikne
suffikset for en URI eller systemID. |
| Neste katalog
|
Brukes til å referere
til en annen katalog uten å importere den til arbeidsbenken. |
| Delegatkatalog |
Brukes til å knytte en
alternativ katalog til en identifikator. |
- Fyll ut feltene for katalogoppføringen du valgte:
Tabell 1. Katalogoppføringstyper og tilknyttede felt
| Katalogtype |
Felt |
| Katalogoppføring |
- I feltet Plassering oppgir du eller du bruker Se gjennom til å finne plasseringen av eller URIen for
DTD- eller XML-skjemafilen. Dette bruker datamaskinens banestil til å beskrive plasseringen av filen.
- Velg en nøkkeltype:
- Hvis du har oppgitt en DTD: Velg Felles-ID, System-ID eller URI fra feltet Nøkkeltype. Hvis du velger Felles-ID, må verdien du oppgir i feltet
Nøkkel, være den samme som felles-IDen i XML-filens
DOCTYPE-deklarasjon. Hvis du velger System-ID, må verdien du oppgir, tilsvare system-IDen i en XML-fils
DOCTYPE-deklarasjon. Hvis du velger URI,
må verdien du oppgir, være en fullt kvalifisert URI.
- Hvis du har oppgitt et XML-skjema: Velg enten Navn på navneområde eller
Skjemaplassering fra feltet Nøkkeltype. Hvis skjemaet definerer et målnavneområde, vil det automatisk bli vist i feltet
Nøkkel.
Ellers kan du oppgi skjemaplassering i feltet
Nøkkel.
- Merk av for Oppgi alternative web-adresse hvis du ønsker å kunne oppgi
en alternativ web-adresse for ressursen.
Denne web-adressen brukes når en XML-forekomst genereres ut fra denne katalogoppføringen. Merk:
Dette alternativet er tilgjengelig vare hvis du velger Felles-ID (for en DTD) eller Navn på navneområde (for
et skjema) i feltet Nøkkeltype.
|
| Omskrivingsoppføring |
- Velg en Nøkkeltype det skal sammenliknes med, enten URI eller systemID.
- Samsvarende startstreng: Det samsvarende prefikset
som skal fjernes fra den oppgitte identifikatoren.
- Prefiks for omskriving: Prefikset som skal brukes i stedet
for prefikset som fjernes.
|
| Suffiksoppføring |
- I feltet Plassering oppgir du eller du bruker Se gjennom til å finne plasseringen av eller URIen for
DTD- eller XML-skjemafilen. Dette bruker datamaskinens banestil til å beskrive plasseringen av filen.
- Velg en Nøkkeltype (URI eller systemID) som skal
sammenliknes.
- Oppgi Suffikset for identifikatoren som skal sammenliknes.
|
| Neste katalog |
I feltet Plassering av en annen XML-katalogfil
oppgir eller blar du etter XML-katalogen du vil referere til.
|
| Delegatkatalog |
- Velg en Nøkkeltype det skal sammenliknes med, enten URI eller systemID.
- Samsvarende startstreng: Prefikset
for den oppgitte identifikatoren som skal sammenliknes.
- Delegat til denne XML-filen: Den alternative katalogen
som skal tilknyttes.
|
- Når du er ferdig med å opprette katalogoppføringer, klikker du på
OK for å lukke dialogboksen Legg til en XML-katalogoppføring.
Klikk på OK igjen for å lagre innstillingene.
- Pass på at XML-filen er i fokus, og klikk på verktøylinjeknappen Last inn avhengigheter på nytt.
XML-filen er nå knyttet til den siste versjonen av XML-skjemaet eller DTDen.
Du kan også eksportere og importere informasjon om XML-katalogen:
Du eksporterer ved å klikke på og velge . Du vil bli bedt om å velge et prosjekt og oppgi filnavn for lagring av katalogoppføringer i en
.xmlcatalog-fil, som kan åpnes fra Navigator-visningen. Siden katalogoppføringene lagres i en .xmlcatalog-fil, kan du sjekke dem inn og ut og dele dem akkurat som med andre
prosjektressurser.
Du importerer ved å klikke på og velge . Oppgi deretter filen som skal brukes til å laste inn
XML-kataloginnstillingene. Når du importerer en .xmlcatalog-fil, blir alle oppføringer i den lastet inn i XML-katalogen (og
alle eksisterende oppføringer blir overskrevet).