Přidání položek do katalogu XML

Položky katalogu XML se používají k mapování odkazů na externí entitu na lokální definované prostředky. Můžete uvést pravidla určující, jak jsou tyto entity řešeny.

Podrobnosti ke standardu pro katalogy XML viz: http://www.oasis-open.org/committees/download.php/14809/xml-catalogs.html.

Například pracujete se souborem XML na počítači a atribut schemaLocation ukazuje na schéma s názvem c:\MySchema.xsd. Potom jakmile skončíte s úpravami souboru XML a jste připraveni jej publikovat na web a nepoužíváte katalog XML, potřebujete upravit atribut schemaLocation tak, aby ukazoval na prostředek dostupný na webu.

Chcete-li zabránit častým změnám na vašem dokumentu XML, můžete použít katalog XML: můžete třeba zadat pravidlo, které přesměrovává odkaz na internetový prostředek (např. "http://www.ibm.com/published-schemas/MySchema.xsd") na prostředek na lokálním počítači (např. "file:///C:/MySchema.xsd"). Nyní namísto častých úprav dokumentů XML pro aktualizaci URI nebo umístění (zvláště, pokud váš projekt obsahuje mnoho dokumentů) stačí aktualizovat jen jedno pravidlo ve vašem katalogu XML.

Následující pokyny jsou určeny pro perspektivu Prostředek, nicméně jsou aplikovatelné i na mnohé další perspektivy.

Chcete-li přidat položku do katalogu XML, postupujte takto:

  1. Otevřete soubor XML, který chcete přidružit k DTD nebo schématu XML.
  2. Klepněte na volbu Okno > Předvolby a vyberte XML > Katalog XML. Část Katalog XML obsahuje seznam všech položek katalogu definovaných uživatelem a modulem plug-in. Vyberte položku a podrobnosti o ní se zobrazí v části Podrobnosti.
  3. Klepnutím na tlačítko Přidat vytvoříte novou položku katalogu.
  4. Ve sloupci na levé straně klepněte na typ položky katalogu, kterou chcete přidat:
    Volba Popis
    Položka katalogu Používá ji procesor XML při řešení odkazů na entitu. Můžete katalogu poskytnout pravidla pro určení způsobu řešení entit.
    Položka katalogu XML má dvě části:
    • Klíč (který představuje schéma DTD nebo XML).
    • Umístění (podobné identifikátoru URI, obsahuje informace o umístění DTD nebo schématu XML).
    Klíč může být umístěn do souboru XML. Jakmile na něj procesor XML narazí, použije položku katalogu XML k nalezení umístění DTD nebo schématu XML přidruženého ke Klíči
    Položka přepisu Používá se k přesměrování sady entit.
    Položka přípony Používá se k porovnání přípony klíče URI nebo systemID.
    Další katalog Používá se k odkazování na jiný katalog bez toho, abyste jej importovali do pracovní plochy.
    Delegovat katalog Používá se k přidružení alternativního katalogu k identifikátoru.
  5. Vyplňte pole pro vámi vybranou položku katalogu:
    Tabulka 1. Typy položky katalogu a přidružená pole
    Typ katalogu Pole
    Položka katalogu
    • Do pole Umístění zadejte nebo vyhledejte umístění nebo URI souboru DTD nebo schématu XML. K popisu umístění souboru se používá styl cesty vašeho počítače.
    • Vyberte volbu Typ klíče:
      • Pokud jste zadali DTD: Z pole Typ klíče vyberte volbu Veřejné ID, Systémové ID nebo URI. Pokud vyberete Veřejné ID, hodnota, kterou zadáte do pole Klíč, by měla být stejná jako Veřejné ID v deklaraci DOCTYPE souboru XML. Pokud vyberete Systémové ID, zadaná hodnota by měla odpovídat systémovému ID v deklaraci DOCTYPE souboru XML. Pokud vyberete URI, musíte jako hodnotu zadat úplný identifikátor URI.
      • Pokud jste zadali schéma XML: Z pole Typ klíče vyberte buď Název oboru názvů, nebo Umístění schématu. Pokud schéma definuje cílový obor názvů, bude zobrazen automaticky v poli Klíč. Jinak můžete zadat umístění schématu do pole Klíč.
    • Označte zaškrtávací políčko Určit alternativní webovou adresu, pokud chcete, aby bylo možno zadat alternativní webovou adresu prostředku.
      Tato webová adresa se použije, pokud je z této položky katalogu generována instance XML.
      Poznámka: Tato volba je dostupná, pouze pokud v poli Typ klíče zvolíte volbu Veřejné ID (pro DTD) nebo Název oboru názvů (pro schéma).
    Položka přepisu
    • Vyberte položku Typ klíče pro shodu, URI nebo systemID.
    • Odpovídající počáteční řetězec: Předpona pro shodu odebíraná z poskytnutého identifikátoru.
    • Předpona přepisu: Předpona použitá místo odebrané předpony.
    Položka přípony
    • Do pole Umístění zadejte nebo vyhledejte umístění nebo URI souboru DTD nebo schématu XML. K popisu umístění souboru se používá styl cesty vašeho počítače.
    • Vyberte položku Typ klíče (URI nebo systemID) pro shodu.
    • Zadejte příponu identifikátoru pro shodu.
    Další katalog Do pole Umístění jiného souboru katalogu XML zadejte nebo procházením vyhledejte katalog XML, na který chcete odkazovat.
    Delegovat katalog
    • Vyberte položku Typ klíče pro shodu, URI nebo systemID.
    • Odpovídající počáteční řetězec: Předpona identifikátoru poskytnutého pro shodu.
    • Delegovat na tento soubor XML: Alternativní přidružený katalog.
  6. Jakmile dokončíte vytváření položek katalogu, klepněte na tlačítko OK, a tím uzavřete dialogové okno Přidat položku katalogu XML. Dalším klepnutím na tlačítko OK nastavení uložíte.
  7. Ujistěte se, že je vybrán soubor XML, a klepněte na tlačítko panelu nástrojů Znovu načíst závislosti.
Soubor XML je nyní přidružen k poslední verzi schématu XML nebo DTD.

Informace o katalogu XML lze také exportovat a importovat:

Chcete-li exportovat, klepněte na volbu Soubor > Exportovat a vyberte XML > Katalog XML. Budete vyzváni k výběru projektu a zadání názvu souboru pro uložení vašich položek katalogu do souboru .xmlcatalog, který může být otevřen v pohledu Navigátor. Protože se vaše položky katalogu ukládají do souboru .xmlcatalog, můžete je vracet, zapůjčovat a sdílet jako kterékoli jiné prostředky projektu.

Chcete-li importovat, klepněte na volbu Soubor > Importovat a vyberte XML > Katalog XML . Potom určete soubor, který se má použít k načtení nastavení katalogu XML. Pokud naimportujete soubor .xmlcatalog, všechny položky v tomto souboru budou načteny do katalogu XML (a všechny stávající položky budou přepsány).

Související koncepce
Přidružování souboru XML definicím DTD a schématům XML
Související úlohy
Úprava s omezeními DTD nebo schématu XML
Úprava deklarací DOCTYPE
Aktualizace souborů XML s použitím změn DTD a změn schémat XML
Úprava informací o oboru názvů