Legge til oppføringer i XML-katalogen

En XML-katalogoppføring består av to deler, en nøkkel (som representerer et DTD- eller XML-skjema) og en URI (som inneholder informasjon om plasseringen av et DTD- eller XML-skjema). 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.

XML-katalogoppføringer kan brukes i forskjellige situasjoner. Anta for eksempel at du arbeider med en XML-fil på hovedmaskinen din og peker den schemaLocation mot et skjema kalt c:\MySchema.xsd. Så lagrer du den på hovedmaskinen, slik at du kan arbeide med den senere. Når du åpner ilen på den bærbare maskinen, får du imidlertid et problem: XML-redigeringsprogrammet kan ikke finne skjemaet MySchema.xsd, for det er faktisk installert på D-stasjonen. Du må redigere schemaLocation til å peke på d:\MySchema.xsd. Når du er ferdig med å redigere XML-filen og klar til å publisere den på nettet, må du redigere URIen på nytt, slik at den peker på en ressurs som er tilgjengelig på nettet. Nå er problemet åpenbart. En URI som brukes i XML-filen, er ikke så flyttbar som du skulle ønske. For å unngå å måtte endre XML-dokumentet ofte kan du bruke XML-katalogen.

En XML-katalogoppføring brukes av en XML-prosessor ved behandling av entitetsreferanser. Du kan gi katalogen regler for å oppgi hvordan entiteter skal behandles. Hvis du vurderer eksempelet over, kan du prøve å 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å utviklerens lokale maskin (for eksempel "file:///C:/MySchema.xsd"). I stedet for å redigere XML-dokumenter ofte og oppdatere URIene (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:

  1. Åpne XML-filen som du vil knytte til en DTD eller et XML-skjema.
  2. Klikk på Vindu > Preferanser > Web og XML > XML-katalog.
  3. Feltet XML-katalogoppføringer inneholder en liste over brukerdefinerte og plugin-definerte katalogoppføringer.
    1. Velg en oppføring, og du får frem opplysninger i feltet Detaljer.
    2. Klikk på Legg til for å opprette en ny katalogoppføring.
  4. I feltet URI oppgir du plassering for DTDen eller XML-skjemaet, eller du blar for å finne den/det.
  5. Hvis du har oppgitt en DTD i feltet URI, kan du velge enten Felles-ID eller System-ID i 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.
  6. Hvis du har oppgitt et XML-skjema i feltet URI, kan du velge enten Navn på navneområde eller Skjemaplassering i 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.
  7. 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.
  8. Hvis du vil slå opp i en annen katalog uten å importere den til arbeidsbenken, klikker du på Neste katalog. Oppgi eller bla etter XML-katalogen du vil referere til.
  9. Når du er ferdig med å opprette katalogoppføringer, klikker du på OK for å lukke dialogboksen Legg til en XML-katalogoppføring.
  10. Klikk på Avansert hvis du vil importere eller eksportere XML-kataloginnstillinger.
  11. Klikk på Eksporter hvis du vil fortsette med XML-kataloginformasjonen. Bare de brukerspesifiserte oppføringene blir eksportert.
    1. 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.
    2. Klikk på OK.
  12. Klikk på Importer hvis du vil importere en .xmlcatalog-fil. Du blir bedt om å velge filen du vil importere.
    1. 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).
    2. Klikk på OK.
  13. Klikk på OK for å lukke dialogboksen Avanserte XML-katalogpreferanser.
  14. 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.
Beslektede begreper
XML-filtilknytninger med DTDer og XML-skjemaer
Beslektede oppgaver
Redigere med DTD- eller XML-skjemabegrensninger
Redigere DOCTYPE-deklarasjoner
Oppdatere XML-filer med endringer gjort i DTDer og skjemaer
Redigere navneområdeinformasjon