Dodawanie pozycji do katalogu XML

Pozycja w katalogu XML składa się z dwóch części - klucza (reprezentującego definicję DTD lub schemat XML) oraz identyfikatora URI (zawierającego 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.

Pozycje katalogu XML mogą być wykorzystywane w różnych sytuacjach. Jeśli na przykład pracujesz na pliku XML przy użyciu podstawowego komputera desktop i skierujesz schemaLocation na schemat c:\MySchema.xsd, to możesz zapisać plik na komputerze laptop, aby pracować na nim w innym terminie. Kiedy jednak otworzysz plik na komputerze laptop, wystąpi problem. Edytor XML nie będzie mógł znaleźć schematu MySchema.xsd, ponieważ jest on w rzeczywistości zapisany na dysku D. Trzeba więc będzie zmienić wartość schemaLocation, aby wskazywała na d:\MySchema.xsd. Po zakończeniu edycji pliku XML, a przed opublikowaniem go na stronie WWW należy znowu zmienić identyfikator URI tak, aby wskazywał na zasób dostępny z poziomu sieci WWW. Jak widać, problem jest oczywisty. Identyfikator URI w pliku XML nie jest tak przenośny, jak powinien być. Aby nie trzeba było wprowadzać częstych zmian w dokumencie XML, można użyć katalogu XML.

Pozycja katalogu XML jest wykorzystywana przez procesor XML przy rozwiązywaniu odwołań do encji. Można udostępnić reguły do katalogu, które będą określać, jak mają być rozwiązywane encje. Wracając do poprzedniego przykładu, 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 ono na zasób umieszczony na lokalnym komputerze programisty (na przykład "file:///C:/MySchema.xsd"). Zamiast ciągle zmieniać dokumenty XML w celu zaktualizowania identyfikatorów URI (co może być szczególnie uciążliwe, jeśli w projekcie jest wiele dokumentów), wystarczy wówczas zaktualizować jedną 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. Wybierz opcje Okna > Preferencje > WWW i XML > Katalog XML.
  3. Pole Pozycje katalogu XML zawiera listę wszelkich zdefiniowanych przez użytkownika i przez wtyczkę pozycji katalogu.
    1. Wybierz pozycję, aby wyświetlić szczegółowe informacje w polu Szczegóły.
    2. Kliknij przycisk Dodaj, aby utworzyć nową pozycję katalogu.
  4. W polu Identyfikator URI wpisz położenie definicji DTD lub schematu XML bądź użyj przeglądania, aby go wyszukać.
  5. Jeśli w polu Identyfikator URI została podana definicja DTD, możesz wybrać opcję Identyfikator publiczny lub Identyfikator systemowy w polu Typ klucza. 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śc powinna odpowiadać wartości identyfikatora systemowego w deklaracji DOCTYPE pliku XML.
  6. Jeśli w polu Identyfikator URI został podany schemat XML, możesz wybrać opcję Nazwa przestrzeni nazw lub Położenie schematu w polu Typ klucza. 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.
  7. 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 wówczas, gdy wybierzesz opcję Identyfikator publiczny (dla definicji DTD) lub Nazwa przestrzeni nazw (dla schematu) w polu Typ klucza.
  8. Jeśli chcesz mieć możliwość odnoszenia się do innego katalogu bez importowania go do środowiska roboczego, kliknij przycisk Następny katalog. Wpisz lub wyszukaj nazwę katalogu XML, do którego chcesz się odnosić.
  9. Po zakończeniu tworzenia pozycji katalogu kliknij przycisk OK, aby zamknąć okno dialogowe Dodawanie pozycji katalogu XML.
  10. Kliknij przycisk Zaawansowane, jeśli chcesz zaimportować lub wyeksportować ustawienia katalogu XML.
  11. Kliknij przycisk Eksportuj, jeśli chcesz utrwalić informacje w katalogu XML. Wyeksportowane zostaną tylko pozycje określone przez użytkownika.
    1. Zostaniesz 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 będą zapisane w pliku .xmlcatalog, można je będzie pobierać i zwracać oraz współużytkować podobnie jak inne zasoby projektu.
    2. Kliknij przycisk OK.
  12. Kliknij przycisk Importuj, jeśli chcesz zaimportować plik .xmlcatalog. Zostaniesz poproszony o wybór pliku do zaimportowania.
    1. Po zaimportowaniu pliku .xmlcatalog wszelkie pozycje w nim zawarte zostaną załadowane do katalogu XML (a istniejące zostaną zastąpione).
    2. Kliknij przycisk OK.
  13. Kliknij przycisk OK, aby zamknąć okno dialogowe Zaawansowane preferencje katalogu XML.
  14. 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.
Pojęcia pokrewne
Powiązania plików XML z definicjami DTD i schematami XML
Zadania pokrewne
Edytowanie z ograniczeniami schematów XML lub definicji DTD
Edytowanie deklaracji DOCTYPE
Aktualizowanie plików XML z uwzględnieniem zmian w definicjach DTD i schematach XML
Edytowanie informacji o przestrzeni nazw