В шаблон можно включать динамические элементы источника
данных, которые должны определяться во время выполнения. Элемент
Конфигурация источника данных позволяет изменить параметры источника
данных.
Rational Publishing Engine
вычисляет URL статических источников данных, когда начинается
генерация документа, а не во время первого запроса из источника
данных.
С помощью элементов конфигурации источника данных можно
управлять временем вычисления элементов в процессе генерации
документа.
Элементы конфигурации источника данных полезны, когда на начальном
этапе создания документа неизвестна информация о соединении. Например, в случае связывания артефактов из двух
продуктов (A и B) информация об источнике данных может динамически
извлекаться из продукта B. Путем повторной настройки источника данных можно изменить такие
свойства, как URI, имя пользователя, пароль и другие свойства источника данных, применяемые
Rational Publishing Engine при извлечении данных.
Прежде чем начать
Элемент Конфигурация источника данных должен быть расположен
в шаблоне документа перед элементом, содержащим запросы для
настроенного источника данных.
Об этой задаче
Для повторной настройки источника данных применяется элемент
Конфигурация источника данных. Элемент конфигурации источника данных должен быть подключен к
схеме источника данных, применяемой в шаблоне. В зависимости от конфигурации источника данных динамический
элемент источника данных содержит свойства, аналогичные свойствам из
спецификации документа. В ходе создания документа этот элемент отвечает за
инициализацию или повторную инициализацию источника
данных. Элемент Конфигурация источника данных позволяет задать только
свойства, которые неизвестны во время выполнения. Применение этого элемента для всех свойств, таких как имя
пользователя, пароль и расположение файлов
exe,
отрицательно сказывается на переносимости шаблона.
Несмотря на то, что
свойства элемента Конфигурация источника данных аналогичны свойствам
элемента источника данных в спецификации документа, свойства из
спецификации документа содержат статические значения, а свойства
элемента Конфигурация источника данных используют значения из другого
источника данных, доступного в их контексте.
Процедура
Для повторной настройки источника данных выполните следующие
действия:
- Из панели Палитра перенесите элемент
Конфигурация источника
данных: в шаблон.
- Выберите элемент конфигурации источника данных.
- На панели Свойства перейдите на вкладку
Данные.
- В свойстве Целевой источник данных
введите имя схемы источника данных. После подключения элемента конфигурации источника данных к схеме
источника данных его свойства форматирования обновляются
с учетом динамических свойств типа схемы источника данных.
- В свойстве Унаследованная конфигурация
данных введите имя схемы источника данных для шаблона. По умолчанию это свойство не содержит значение. Можно
указать имя схемы источника данных из шаблона. В случае применения этого свойства целевой источник данных
настраивается с помощью параметров, полученных из унаследованного
источника данных, а также с помощью свойств, заданных в
конфигурации источника данных.
Свойства унаследованного источника данных применяются только в
том случае, если не указано значение целевого источника данных. Например, URL унаследованного источника данных применяется в качестве
целевого источника данных, если свойство URL целевого источника
данных не заполнено. Как правило, свойство унаследованного источника
данных применяется для предоставления идентификационных данных
для источников данных только один раз.
Другие свойства могут быть указаны или получены из
спецификации документа или источника данных, указанного в
свойстве
Унаследованный источник
данных.
Прим.: В качестве целевого и унаследованного источников данных можно
указать один и тот же источник данных. Если унаследованный источник данных не задан,
применяется целевой источник данных.
Если свойство конфигурации источника данных задано, оно
обладает более высоким приоритетом по сравнению со свойством
спецификации документа. Rational Publishing Engine
сочетает свойства, заданные в элементе Конфигурация источника данных,
со свойствами из элемента Спецификация документа.