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:
- Otwórz plik XML, który chcesz powiązać z definicją DTD lub schematem XML.
- Kliknij opcje , a następnie wybierz kolejno opcje . 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ę.
- Kliknij przycisk Dodaj, aby utworzyć nową pozycję katalogu.
- 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. |
- 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 .
|
- Po zakończeniu tworzenia pozycji katalogu kliknij przycisk OK, aby
zamknąć okno dialogowe Dodawanie pozycji katalogu XML. Kliknij przycisk OK ponownie, aby
zapisać ustawienia.
- 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ę
, a następnie wybrać opcję . 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ę , a następnie wybrać opcję . 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).