Добавление записей к каталогу XML

Записи каталога 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 выполните следующие действия:

  1. Откройте файл XML, который вы хотите связать со схемой XML или DTD.
  2. Выберите Окно > Параметры , затем выберите XML > Каталог XML. Раздел Записи каталога XML содержит список пользовательских и встроенных записей каталога. Выберите запись для просмотра описания в разделе Сведения.
  3. Нажмите кнопку Добавить для создания записи каталога.
  4. В левом столбце щелкните на типе каталога, который требуется добавить:
    Параметр Описание
    Запись каталога Используется процессором XML при обработке указателей записи. Можно предоставить каталогу правила, чтобы указать способ обработки записей.
    Запись каталога XML состоит из двух частей:
    • Ключ (представляет DTD или схему XML)
    • Расположение (аналогично URI, который содержит информацию о расположении DTD или XML схемы).
    Можно поместить ключ в файл XML. Когда процессор XML встречает его, он с помощью записи каталога XML находит расположение схемы XML или DTD, связанное с ключом.
    Перезаписать запись Применяется для перенаправления набора сущностей.
    Запись суффикса Применяется для сравнения суффикса URI или systemID.
    Следующий каталог Позволяет указать другой каталог, не импортируя его в рабочую среду.
    Делегировать каталог Применяется для связывания альтернативного каталога с идентификатором.
  5. Заполните поля для выбранной записи каталога:
    Таблица 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: альтернативный каталог для связывания.
  6. Завершив создание записей каталога нажмите кнопку OK, чтобы закрыть окно диалога Добавить запись каталога XML. Снова нажмите кнопку OK, чтобы сохранить параметры.
  7. Убедитесь, что выбран файл XML и нажмите кнопку Обновить зависимости.
Файл XML теперь связан с последней версией схемы XML или DTD.

Кроме того, можно экспортировать и импортировать информацию о каталоге XML:

Для экспорта выберите Файл > Экспортировать , затем выберите XML > Каталог XML. Вам будем предложено выбрать проект и предоставить имя файла для сохранения записей каталога в файле .xmlcatalog, который может быть открыт в панели Навигатор. Поскольку записи каталога хранятся в файле .xmlcatalog, их можно изъять и вернуть и совместно использовать, как любые другие ресурсы проекта.

Для импорта выберите Файл > Импортировать, затем выберите XML > Каталог XML . Укажите файл для загрузки параметров каталога XML. После импорта файла .xmlcatalog все записи в нем будут загружены в каталог XML (все существующие записи будут перезаписаны).

Связанные концепции
Связывание файлов XML с DTD и схемами XML
Связанные задачи
Редактирование при наличии ограничений DTD или схемы XML
Изменение объявлений DOCTYPE
Обновление файлов XML при изменениях в DTD или схеме
Изменение информации о пространстве имен