Lägga till poster i XML-katalogen

XML-katalogposter används till avbildning av externa entitetsreferenser till lokalt definierade resurser. Du kan ange regler för hur dessa entiteter ska lösas

Mer information om standarden för XML-kataloger finns i: http://www.oasis-open.org/committees/download.php/14809/xml-catalogs.html.

Exempel: Du arbetar med en XML-fil i datorn och pekar schemaLocation på ett schema med namnet c:\MySchema.xsd. Om du inte använder någon XML-katalog och har redigerat färdigt en XML-fil som du vill publicera på webben måste du redigera schemaLocation så att den pekar på en resurs som är tillgänglig på webben.

Du kan använda XML-katalogen för att undvika att ofta göra ändringar i XML-dokumentet: definiera en regel som dirigerar om en referens till en Internetresurs (exempel: "http://www.ibm.com/published-schemas/MySchema.xsd") så att den pekar på en resurs på den lokala datorn (exempel: "file:///C:/MySchema.xsd"). I stället för att behöva redigera XML-dokument gång på gång för att uppdatera URI-adresserna eller platserna (särskilt när det finns många dokument i projektet) behöver du nu bara uppdatera en enda regel i XML-katalogen.

Följande instruktioner är skrivna för resursperspektivet, men de fungerar även i många andra fall.

Så här lägger du till en post i XML-katalogen:

  1. Öppna den XML-fil du vill associera med en DTD-fil eller ett XML-schema.
  2. Klicka på Fönster > Inställningar och välj XML > XML-katalog. Avsnittet XML-katalogposter innehåller en lista med eventuella användardefinierade och insticksprogramsdefinierade katalogposter. Välj en post om du vill visa information om den i avsnittet Detaljer.
  3. Klicka på Lägg till så skapas en ny katalogpost.
  4. I den vänstra kolumnen klickar du på den typ av katalogpost som du vill lägga till:
    Alternativ Beskrivning
    Katalogpost Används av en XML-processor vid tolkning av entitetsreferenser. Du kan tillhandahålla regler för katalogen för hur enheter ska tolkas.
    En XML-katalogpost innehåller två delar:
    • En nyckel (som representerar ett DTD- eller XML-schema)
    • En plats (liknar en URI, som innehåller information om DTD- eller XML-schemats plats).
    Du kan placera nyckeln i en XML-fil. När den påträffas i XML-bearbetningsfunktionen används XML-katalogposten till att söka efter sökvägen till den DTD-fil eller det XML-schema som är associerat med nyckeln
    Omskrivningspost Dirigerar om en uppsättning entiteter.
    Suffixpost Matchar suffixet för en URI eller ett system-ID.
    Nästa katalog Hänvisar till en annan katalog utan att importera den till arbetsmiljön.
    Delegatkatalog Associerar en alternativ katalog till en identifierare.
  5. Fyll i fälten för den katalogpost som du valde:
    Tabell 1. Katalogposttyper och motsvarande fält
    Katalogtyp Fält
    Katalogpost
    • >Ange i fältet Plats, eller bläddra till, platsen eller URI-adressen för DTDn eller XML-schemafilen. Den använder datorns sökvägsformat för att beskriva filens plats.
    • Välj en Nyckeltyp:
      • Om du angav en DTD: välj Publikt ID, System-ID eller URI från fältet Nyckeltyp. Om du väljer Publikt ID bör det värde du anger i fältet Nyckel vara detsamma som värdet i Publikt ID i DOCTYPE-deklarationen för XML-filen. Om du väljer System-ID bör det värde du anger överensstämma med system-IDt i DOCTYPE-deklarationen för XML-filen. Om du väljer URI måste det värde du anger vara en fullständig URI-adress.
      • Om du angav ett XML-schema: väljer du antingen Namnrymdsnamn eller Schemaplats i fältet Nyckeltyp. Om schemat definierar en målnamnrymd visas det automatiskt i fältet Nyckel. I annat fall kan du ange sökvägen för schemat i fältet Nyckel.
    • Markera kryssrutan Ange alternativ webbadress om du vill kunna ange en alternativ webbadress för resursen.
      Den här webbadressen används när en XML-förekomst genereras från den här katalogposten.
      Anm. Det här alternativet är endast tillgängligt om du väljer Publikt ID (för en DTD) eller Namnrymdsnamn (för ett schema) i fältet Nyckeltyp.
    Omskrivningspost
    • Välj en Nyckeltyp som ska matcha: URI eller system-ID.
    • Matchningsstartsträng: Det matchningsprefix som ska tas bort från den angivna identifieraren.
    • Omskrivningsprefix: Prefixet som ska användas i stället för det prefix som tas bort.
    Suffixpost
    • >Ange i fältet Plats, eller bläddra till, platsen eller URI-adressen för DTDn eller XML-schemafilen. Den använder datorns sökvägsformat för att beskriva filens plats.
    • Välj en Nyckeltyp (URI eller system-ID) som ska matchas.
    • Skriv Suffixet för den identifierare som ska matchas.
    Nästa katalog I fältet Plats för en annan XML-katalogfil skriver du eller bläddrar till den XML-katalog som du vill hänvisa till.
    Delegatkatalog
    • Välj en Nyckeltyp som ska matcha: URI eller system-ID.
    • Matchningsstartsträng: Prefixet för den angivna identifierare som ska matchas.
    • Delegera till den här XML-filen: Den alternativa katalog som ska associeras.
  6. När du är klar med att skapa katalogposter klickar du på OK så stängs dialogrutan Lägg till XML-katalogpost. Klicka åter på OK så att inställningarna sparas.
  7. Se till att fokus ligger på XML-filen och klicka på verktygsfältsknappen Läs in beroenden igen.
XML-filen är nu associerad med den senaste versionen av XML-schemat eller DTD-filen.

Du kan också exportera och importera XML-kataloginformation:

Klicka på Arkiv > Exportera och välj XML > XML-katalog för att exportera. Du uppmanas välja ett projekt och ange ett filnamn när du sparar katalogposterna i en .xmlcatalog-fil, som kan öppnas i navigeringsvyn. Eftersom katalogposterna lagras i en .xmlcatalog-fil kan du checka in dem och ut dem och dela dem, precis som med andra projektresurser.

Klicka på Arkiv > Importera och välj XML > XML-katalog för att importera. Ange sedan den fil du ska användas för inläsning av XML-kataloginställningarna När du importerar en .xmlcatalog-fil läses poster i den in i XML-katalogen (och befintliga poster skrivs över).

Närliggande begrepp
XML-filassociationer med DTDer och XML-scheman
Närliggande uppgifter
Redigera med DTD- eller XML-schemabegränsningar
Redigera DOCTYPE-deklarationer
Uppdatera XML-filer med ändringar som görs i DTDer och scheman
Redigera namnrymdsinformation