Записи каталога XML применяются для связывания ссылок на внешние сущности с локальными
ресурсами. Способ обработки сущностей можно указать с помощью правил.
Дополнительная информация о стандарте для каталогов XML приведена на веб-странице http://www.oasis-open.org/committees/download.php/14809/xml-catalogs.html.
Например: вы работаете с файлом XML на компьютере и указываете для его опции
schemaLocation схему c:\MySchema.xsd. Если каталог XML не применяется, то перед публикацией файла XML в Интернете, необходимо
изменить параметр schemaLocation таким образом, чтобы он указывал на
ресурс, доступный в Интернете.
Для того чтобы избавиться от необходимости часто вносить изменения в документ XML, можно
использовать Каталог XML: можно указать правило, перенаправляющее ссылки на веб-ресурсы (например "http://www.ibm.com/published-schemas/MySchema.xsd")
в локальные ресурсы (например "file:///C:/MySchema.xsd"). Теперь, вместо частого изменения URI или расположений в документах XML (особенно, когда проект
имеет много
документов), необходимо изменить только одно правило в Каталоге XML.
Далее описаны инструкции по работе в проекции Ресурсы, но многое из описанного будет применимо и в других проекциях.
Для добавления записи к каталогу XML выполните следующие действия:
- Откройте файл XML, который вы хотите связать со схемой XML или DTD.
- Выберите , затем
выберите . Раздел Записи каталога XML содержит список
пользовательских и встроенных записей каталога. Выберите запись для просмотра описания в разделе Сведения.
- Нажмите кнопку Добавить для создания записи каталога.
- В левом столбце щелкните на типе каталога, который требуется добавить:
| Параметр |
Описание |
| Запись каталога
|
Используется процессором XML при обработке указателей записи. Можно
предоставить каталогу правила, чтобы указать способ обработки записей.Запись каталога XML состоит из двух частей:
- Ключ (представляет DTD или схему XML)
- Расположение (аналогично URI, который содержит информацию о расположении
DTD или XML схемы).
Можно поместить
ключ в файл XML. Когда процессор XML встречает его, он с помощью записи
каталога XML находит расположение схемы XML или DTD, связанное с ключом.
|
| Перезаписать запись
|
Применяется для перенаправления набора сущностей. |
| Запись суффикса
|
Применяется для сравнения суффикса URI или systemID. |
| Следующий каталог
|
Позволяет указать другой каталог, не импортируя его в рабочую среду. |
| Делегировать каталог
|
Применяется для связывания альтернативного каталога с идентификатором. |
- Заполните поля для выбранной записи каталога:
Таблица 1. Типы записей каталога и связанные поля
| Тип каталога |
Поля |
| Запись каталога |
- В поле Расположение введите или выберите расположение или URI файла DTD или файла
схемы XML. Расположение файла указывается в формате, применяемом системой.
- Выберите тип ключа:
- Если указан DTD: выберите Общий ИД, ИД системы или URI
в поле Тип ключа. Если вы выбрали Внешний ИД, то значение в
поле Ключ должно совпадать со Внешним ИД в
объявлении DOCTYPE файла XML. Если вы выбрали ИД
системы, то введенное значение должно соответствовать ИД
системы в объявлении DOCTYPE файла XML.
Если выбрано значение URI, то следует указать полный URI.
- Если указана схема XML: выберите Имя пространства имен или Расположение схемы
в поле Тип ключа. Если схема определяет целевое пространство имен, оно автоматически
появится в поле Ключ.
В противном случае, можно
ввести расположение схемы в поле Ключ.
- Выберите переключатель Указать альтернативный адрес
Web, если вы хотите иметь возможность задать альтернативный
адрес Web для ресурса.
Этот адрес Web используется при генерации экземпляра XML из этой
записи каталога. Примечание: Эта опция доступна только в случае выбора значения Общий ИД (для
DTD) или Название пространства имен (для схемы) в поле Тип ключа.
|
| Перезаписать запись |
- В поле Тип ключа для проверки выберите значение URI или systemID.
- Совпадающая начальная строка: совпадающий префикс удаляется из указанного
идентификатора.
- Переписать префикс: префикс для применения вместо удаленного
префикса.
|
| Запись суффикса |
- В поле Расположение введите или выберите расположение или URI файла DTD или файла
схемы XML. Расположение файла указывается в формате, применяемом системой.
- В поле Тип ключа выберите URI или systemID.
- В поле Суффикс введите суффикс идентификатора для сравнения.
|
| Следующий каталог |
В поле Расположение другого файла каталога XML введите или найдите каталог
XML, на который вы хотите сослаться. |
| Делегировать каталог |
- В поле Тип ключа для проверки выберите значение URI или systemID.
- Совпадающая начальная строка: префикс идентификатора для сравнения.
- Делегировать в этот файл XML: альтернативный каталог для связывания.
|
- Завершив создание записей каталога нажмите кнопку OK, чтобы закрыть
окно диалога Добавить запись каталога XML. Снова нажмите кнопку OK, чтобы сохранить параметры.
- Убедитесь, что выбран файл XML и нажмите кнопку Обновить зависимости.
Файл XML теперь связан с последней версией схемы XML или DTD.
Кроме того, можно экспортировать и импортировать информацию о каталоге XML:
Для экспорта выберите , затем выберите . Вам будем предложено выбрать проект и предоставить имя файла для
сохранения записей каталога в файле .xmlcatalog, который может быть открыт
в панели Навигатор. Поскольку записи каталога хранятся в файле .xmlcatalog, их можно изъять и вернуть и
совместно использовать, как любые другие ресурсы проекта.
Для импорта выберите ,
затем выберите . Укажите файл для загрузки параметров каталога XML. После импорта файла .xmlcatalog все записи в нем будут загружены в
каталог XML (все существующие записи будут перезаписаны).