Dodawanie pozycji do katalogu XML

Pozycje katalogu XML są używane do odwzorowania odwołań encji zewnętrznych na lokalnie zdefiniowane zasoby. Istnieje możliwość określenia sposobu, w jaki te encje są rozstrzygane

Szczegółowe informacje na temat katalogów XML zawiera strona: http://www.oasis-open.org/committees/download.php/14809/xml-catalogs.html.

Przykład: użytkownik pracuje na pliku XML przy użyciu komputera i kieruje atrybut schemaLocation na schemat o nazwie c:\MojSchemat.xsd. Jeśli katalog XML nie jest używany, wtedy po zakończeniu edycji pliku XML, a przed jego opublikowaniem na stronie WWW należy zmienić atrybut schemaLocation tak, aby wskazywał na zasób dostępny w sieci WWW.

Aby uniknąć potrzeby przeprowadzania częstych zmian w dokumencie XML, można użyć katalogu XML: można określić regułę, która będzie przekierowywać odwołanie do zasobu internetowego (na przykład "http://www.ibm.com/published-schemas/MySchema.xsd") tak, aby wskazywało na zasób umieszczony na komputerze lokalnym (na przykład "file:///C:/MojSchemat.xsd"). Dzięki temu aktualizowanie identyfikatorów URI oraz położeń przez częstą edycję dokumentów XML (co jest szczególnie uciążliwe w przypadku dużej liczby dokumentów w projekcie) nie będzie już konieczne, ponieważ wystarczy zaktualizować pojedynczą regułę w katalogu XML.

Poniższe instrukcje zostały napisane dla perspektywy Zasób, ale będą też działać w wielu innych perspektywach.

Aby dodać pozycję do katalogu XML, wykonaj następujące czynności:

  1. Otwórz plik XML, który chcesz powiązać z definicją DTD lub schematem XML.
  2. Kliknij opcje Okna > Preferencje , a następnie wybierz kolejno opcje XML > Katalog XML. Sekcja Pozycje katalogu XML zawiera listę wszystkich pozycji katalogu zdefiniowanych przez użytkownika i wtyczkę. Aby wyświetlić w sekcji Szczegóły informacje na temat dowolnej pozycji, należy wybrać tę pozycję.
  3. Kliknij przycisk Dodaj, aby utworzyć nową pozycję katalogu.
  4. W kolumnie po lewej stronie kliknij typ pozycji katalogu, który chcesz dodać:
    Opcja Opis
    Pozycja katalogu Wykorzystywana przez procesor XML przy rozstrzyganiu odwołań do encji. Można udostępnić reguły do katalogu, które będą określać, jak mają być rozstrzygane encje.
    Pozycja katalogu XML składa się z dwóch części:
    • klucza (reprezentującego definicje DTD lub schemat XML),
    • położenia (podobnego do identyfikatora URI, które zawiera informacje o położeniu definicji DTD lub schematu XML).
    Klucz można umieścić w pliku XML. Kiedy procesor XML go znajdzie, użyje pozycji katalogu XML do znalezienia położenia definicji DTD lub schematu XML powiązanego z tym kluczem.
    Przebuduj pozycję Służy do przekierowywania zbioru encji.
    Pozycja przedrostka Służy do dopasowania przedrostka identyfikatora URI lub systemID.
    Następny katalog Służy do odnoszenia się do innego katalogu bez importowania go do środowiska roboczego.
    Deleguj katalog Służy do powiązania alternatywnego katalogu z identyfikatorem.
  5. Wypełnij pola dla wybranej pozycji katalogu:
    Tabela 1. Typy pozycji katalogu i powiązane pola
    Typ katalogu Pola
    Pozycja katalogu
    • W polu Położenie wprowadź (bądź wyszukaj) położenie lub identyfikator URI pliku definicji DTD lub schematu XML. Położenie pliku jest określane przy użyciu ścieżki charakterystycznej dla danego komputera.
    • Wybierz Typ klucza:
      • Jeśli jako typ określono definicję DTD: W polu Typ klucza wybierz wartość Identyfikator publiczny, Identyfikator systemowy lub Identyfikator URI. Jeśli wybierzesz opcję Identyfikator publiczny, wartość wprowadzona w polu Klucz powinna być taka sama, jak identyfikator publiczny w deklaracji DOCTYPE pliku XML. Jeśli wybierzesz opcję Identyfikator systemowy, wprowadzona wartość powinna odpowiadać wartości identyfikatora systemowego w deklaracji DOCTYPE pliku XML. Jeśli zostanie wybrana opcja Identyfikator URI, wprowadzona wartość musi być pełnym identyfikatorem URI.
      • Jeśli jako typ określono schemat XML: W polu Typ klucza wybierz wartość Nazwa przestrzeni nazw lub Położenie schematu. Jeśli w schemacie określona jest docelowa przestrzeń nazw, zostanie automatycznie wyświetlona w polu Klucz. W przeciwnym razie można w polu Klucz wpisać położenie schematu.
    • Zaznacz pole wyboru Podaj alternatywny adres WWW, jeśli chcesz mieć możliwość podania alternatywnego adresu WWW dla zasobu.
      Adres ten jest wykorzystywany, kiedy z tej pozycji katalogu generowana jest instancja XML.
      Uwaga: Ta opcja jest dostępna tylko wtedy, gdy w polu Typ klucza zostanie wybrana wartość Identyfikator publiczny (w przypadku definicji DTD) lub Nazwa przestrzeni nazw (w przypadku schematu).
    Przebuduj pozycję
    • Wybierz Typ klucza do dopasowania - identyfikator URI lub systemID.
    • Zgodny łańcuch początkowy: Zgodny przedrostek do usunięcia z podanego identyfikatora.
    • Przedrostek przebudowywania: Przedrostek do wykorzystania zamiast tego, który został usunięty.
    Pozycja przedrostka
    • W polu Położenie wprowadź (bądź wyszukaj) położenie lub identyfikator URI pliku definicji DTD lub schematu XML. Położenie pliku jest określane przy użyciu ścieżki charakterystycznej dla danego komputera.
    • Wybierz Typ klucza (identyfikator URI lub systemID) w celu dopasowania.
    • Wpisz Przedrostek identyfikatora w celu dopasowania.
    Następny katalog W polu Położenie kolejnego pliku katalogu XML wpisz lub wyszukaj nazwę katalogu XML, do którego chcesz się odnosić.
    Deleguj katalog
    • Wybierz Typ klucza do dopasowania - identyfikator URI lub systemID.
    • Zgodny łańcuch początkowy: Przedrostek podanego identyfikatora do dopasowania.
    • Deleguj do tego pliku XML: Alternatywny katalog do powiązania .
  6. Po zakończeniu tworzenia pozycji katalogu kliknij przycisk OK, aby zamknąć okno dialogowe Dodawanie pozycji katalogu XML. Kliknij przycisk OK ponownie, aby zapisać ustawienia.
  7. Upewnij się, że plik XML jest aktywny i kliknij przycisk Przeładuj zależności umieszczony na pasku narzędzi.
Plik XML jest teraz powiązany z najnowszą wersją schematu XML lub definicji DTD.

Informacje z katalogu XML można również eksportować oraz importować:

Aby wyeksportować te informacje, należy kliknąć opcję Plik > Eksportuj , a następnie wybrać opcję XML > Katalog XML. Użytkownik zostanie poproszony o wybór projektu i podanie nazwy pliku, w którym mają być zapisane pozycje katalogu (plik typu .xmlcatalog). Plik ten będzie można otworzyć w widoku Nawigator. Ponieważ pozycje katalogu są przechowywane w pliku .xmlcatalog, można je wprowadzać i pobierać oraz współużytkować tak samo jak inne zasoby projektów.

Aby zaimportować te informacje, należy kliknąć opcję Plik > Importuj, a następnie wybrać opcję XML > Katalog XML . Następnie należy określić plik, który zostanie użyty do załadowania ustawień katalogu XML. Po zaimportowaniu pliku .xmlcatalog wszelkie pozycje w nim zawarte zostaną załadowane do katalogu XML (a istniejące zostaną zastąpione).

Pojęcia pokrewne
Powiązania pliku XML z definicjami DTD i schematami XML
Czynności pokrewne
Edytowanie z ograniczeniami definicji DTD lub schematów XML
Edytowanie deklaracji DOCTYPE
Aktualizowanie plików XML z uwzględnieniem zmian w definicjach DTD i schematach XML
Edytowanie informacji o przestrzeni nazw