Legge til oppføringer i XML-katalogen

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:

  1. Åpne XML-filen som du vil knytte til en DTD eller et XML-skjema.
  2. Klikk på Vindu > Preferanser og velg XML > XML-katalog. 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.
  3. Klikk på Legg til for å opprette en ny katalogoppføring.
  4. 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.
  5. 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.
  6. 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.
  7. 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å Fil > Eksporter og velge XML > XML-katalog. 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å Fil > Importer og velge XML > XML-katalog. 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).

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