XML-katalogindgange bruges til at mappe eksterne entitetsreferencer til
lokale definerede ressourcer. Du kan angive regler for, hvordan disse entiteter opløses.
Du kan finde oplysninger om XML-standardkataloger under http://www.oasis-open.org/committees/download.php/14809/xml-catalogs.html.
Eksempel: Du arbejder med en XML-fil på en computer, og dens schemaLocation peger på et skema med navnet c:\MySchema.xsd. Hvis du ikke bruger et XML-katalog, skal du, når du er færdig med at redigere XML-filen og er klar til at publicere den på internettet, redigere schemaLocation, så den peger på en ressource, der er tilgængelig på internettet.
For at undgå, at du ofte skal ændre XML-dokumentet,
kan du bruge XML-kataloget: Angiv en regel, som omdirigerer en internetressource-reference (f.eks. "http://www.ibm.com/published-schemas/MySchema.xsd"), så den peger på en ressource på den lokale maskine (f.eks. "file:///C:/MySchema.xsd"). Nu behøver du kun opdatere en enkelt regel i XML-kataloget i stedet for hele tiden (især når der er mange dokumenter i projektet) at redigere XML-dokumenter for at opdatere URI'erne eller placeringerne.
Følgende instruktioner er skrevet til perspektivet Ressource, men gælder også i mange andre perspektiver.
Sådan tilføjer du en indgang til XML-kataloget:
- Åbn den XML-fil, du vil tilknytte til en DTD eller et XML-skema.
- Klik på , og vælg . Afsnittet XML-katalogindgange indeholder en liste med katalogindgange, der er defineret af brugeren eller af plugins. Vælg en indgang for at se oplysninger om den i afsnittet Oplysninger.
- Klik på Tilføj for at oprette den nye katalogindgang.
- Klik i den venstre kolonne på den type katalogindgang, du vil tilføje:
| Indstilling |
Beskrivelse |
| Katalogindgang
|
Bruges af en XML-processor til fortolkning af entitetsreferencer. Du kan angive regler over for kataloget, som specificerer, hvordan entiteter skal fortolkes.En XML-katalogindgang består af to dele:
- En nøgle, som repræsenterer en DTD eller et XML-skema
- En placering, som ligner en URI og indeholder oplysninger om placeringen af en DTD eller et XML-skema.
Du kan placere nøglen i en XML-fil. Når XML-processoren møder den, bruger den XML-katalogindgangen til at finde placeringen på den DTD eller det XML-skema, der er tilknyttet til nøglen.
|
| Omskrivningsindgang |
Bruges til at omdirigere et sæt entiteter. |
| Suffiksindgang |
Bruges til at matche suffikset for en URI eller en system-id. |
| Næste katalog
|
Bruges til at referere til et andet katalog uden at importere det til arbejdsbænken. |
| Delegeringskatalog |
Bruges til at tilknytte et alternativt katalog med en id. |
- Udfyld felterne for den valgte katalogindgang:
Tabel 1. Katalogindgangstyper og tilknyttede felter
| Katalogtype |
Felter |
| Katalogindgang |
- Indtast eller vælg placering eller URI for DTD'en eller XML-skemafilen i feltet Placering. Herved bruges computerens format til stier til at beskrive filens placering.
- Vælg en Nøgletype:
- Hvis du har angivet en DTD: Vælg Offentlig id, System-id eller URI i feltet Nøgletype. Hvis du vælger Offentlig id, skal den værdi, du angiver i feltet Nøgle, være den samme som den offentlige id i DOCTYPE-erklæringen til XML-filen. Hvis du vælger System-id, skal den værdi, du angiver, svare til system-id'en i en XML-fils DOCTYPE-erklæring.
Hvis du vælger URI, skal det være en fuldstændigt kvalificeret URI.
- Hvis du angav et XML-skema: Vælg enten Navn på navneområde eller Skemaplacering i feltet Nøgletype. Hvis skemaet definerer et målnavneområde, vises det automatisk i feltet Nøgle.
Ellers du angive skemaplacering i feltet Nøgle.
- Markér afkrydsningsfeltet Angiv alternativ webadresse, hvis du vil have mulighed for at angive en anden webadresse på ressourcen.
Denne webadresse bruges, når der genereres en XML-forekomst fra denne katalogindgang. Bemærk: Denne indstilling er kun tilgængelig, hvis du vælger Offentlig id (for en DTD) eller Navn på navneområde (for et skema) i feltet Nøgletype.
|
| Omskrivningsindgang |
- Vælg en Nøgletype, der skal matche, enten URI
eller systemID.
- Matchende startstreng: Det matchende præfiks, der skal fjernes fra den leverede id.
- Omskrivningspræfiks: Det præfiks, der skal bruges i stedet for det præfiks, der fjernes.
|
| Suffiksindgang |
- Indtast eller vælg placering eller URI for DTD'en eller XML-skemafilen i feltet Placering. Herved bruges computerens format til stier til at beskrive filens placering.
- Vælg en Nøgletype (URI eller systemID), der skal matches.
- Angiv Suffiks for den id, der skal matches.
|
| Næste katalog |
Skriv eller gennemse listen for at finde det XML-katalog, du vil referere til, i feltet Placering af en anden XML-katalogfil. |
| Delegeringskatalog |
- Vælg en Nøgletype, der skal matche, enten URI
eller systemID.
- Matchende startstreng: Præfikset for den leverede id, der skal matches.
- Delegér til denne XML-katalogfil: Alternativt katalog, der skal tilknyttes.
|
- Når du er færdig med at oprette katalogindgange, skal du klikke påOK for at lukke dialogboksen Tilføj XML-katalogindgang. Klik på OK igen for at gemme indstillingerne.
- Sørg for, at der er fokus på XML-filen, og klik herefter på værktøjslinjeknappen Genindlæs afhængigheder.
XML-filen er nu tilknyttet den nyeste version af XML-skemaet eller DTD'en.
Du kan også eksportere og importere oplysninger i XML-kataloget:
Du eksporterer ved at klikke på og vælge . Du bliver bedt om at vælge et projekt og angive et filnavn til lagring af katalogindgangene i en .xmlcatalog-fil, som kan åbnes i oversigten Navigator. Eftersom katalogindgangene er lagret i en
.xmlcatalog-fil, kan du tjekke dem ind og ud og dele dem på samme måde som andre projektressourcer.
Du importerer ved at klikke på og vælge . Angiv derefter den fil, der skal bruges til at indlæse XML-katalogindstillingerne. Når du importerer en .xmlcatalog-fil, bliver dens indgange indlæst i XML-kataloget (og eventuelle eksisterende indgange bliver overskrevet).