Создание документов с помощью Rational DOORS в качестве источника данных

После создания шаблона отчета и заполнения его указателями на данные вы можете приступить к генерации отчета в различных форматах.

Прежде чем начать

В случае предварительного просмотра данных в приложении Панель запуска, для извлечения данных используются представление и контрольная версия по умолчанию.

Вы можете извлечь объекты OLE (связывание и внедрение объектов) из источника данных Rational DOORS. См. раздел Объекты OLE.

Создание документа с помощью дополнения

Если вы установили встраиваемый модуль Rational DOORS, то вы можете создавать документы непосредственно из пользовательского интерфейса Rational DOORS.

Об этой задаче

  • Лицензия используется компьютером, если локальное создание документа запущено из дополнения Rational Publishing Engine с помощью пользовательского интерфейса или командной строки. Лицензия изымается при запуске удаленного создания документа. Затем лицензия возвращается после завершения создания документов.
  • Лицензия используется сервером, если удаленное создание документа запущено из дополнения Rational Publishing Engine с помощью пользовательского интерфейса или командной строки. Лицензия изымается при запуске удаленного создания документа. Затем лицензия возвращается после завершения создания документов.
Прим.: Пользовательские интерфейсы приложений Document Studio и Панель запуска недоступны во время публикации документа с помощью дополнения Rational Publishing Engine.

Процедура

На панели База данных или Модуль нажмите кнопку Опубликовать.
  • Когда вы нажимаете Опубликовать в панели База данных, вам предлагается указать конфигурации шаблона и спецификации документа, как в случае выбора Спецификация документа > Сгенерировать > Настроить и сгенерировать документ в разделе Rational Publishing Engine.
  • При нажатии кнопки Опубликовать на панели Модуль, можно выбрать новую спецификацию документа и добавить в нее шаблоны; кроме того, можно выбрать существующую спецификацию документа, в которую уже добавлены шаблоны. Затем, если шаблон использует источник данных Rational DOORS, Rational Publishing Engine настраивает этот источник для вас, основываясь на информации из открытого модуля, для генерации документа. Если какая-либо информация о конфигурации, существующая в спецификации документа, не соответствует информации в открытом модуле, то она заменяется на информацию из открытого модуля. Кнопка Готово становится доступной после выбора по крайней мере одного шаблона и одного формата вывода.
    Важное замечание: В случае локального создания документов Rational Publishing Engine может подключаться к активному клиенту Rational DOORS; однако такая возможность не предусмотрена для удаленного создания документов. Если публикация выполняется с помощью удаленной службы создания документов на панели База данных или Модуль, укажите идентификационные данные в спецификации документа перед созданием документа, чтобы удаленная служба Rational Publishing Engine могла создать новый экземпляр клиента Rational DOORS для извлечения данных отчета.

Создание документа с помощью мастера создания документов Rational Publishing Engine

С помощью мастера создания документов можно настроить требования к отчетам.

Процедура

  1. В приложении Document Studio или Удаленные службы откройте мастер создания документа. Для этого выберите Спецификация документа > Создать > Настроить и создать документ.
  2. В разделе Шаблоны показаны шаблоны из спецификации документа. Для добавления шаблона выполните следующие действия:
    1. Выберите расположение шаблонов для добавления:
      • Из централизованной библиотеки: позволяет выбрать шаблоны в компоненте Централизованное управление
      • Из локального или удаленного файла: для того чтобы выбрать локальный или удаленный шаблон, введите URL шаблона или выберите шаблон с помощью кнопки Обзор.
    2. Выберите один или несколько шаблонов для добавления.
      • Если выбран вариант Из централизованной библиотеки и выбраны шаблоны из компонента Централизованное управление, нажмите кнопку Добавить выбранные, чтобы добавить шаблоны в спецификацию документа.
      • Если выбран вариант Из локального или удаленного файла и указан URL отдельного шаблона, то нажмите кнопку Добавить URL, чтобы добавить шаблон в спецификацию документа.
      • Если выбран вариант Из локального или удаленного файла, то при нажатии кнопки Открыть выбранные шаблоны добавляются в спецификацию документа.
    3. Необязательно: Повторите эти действия для добавления дополнительных шаблонов из других расположений.
    4. Необязательно: Для изменения порядка шаблонов в спецификации документа выберите шаблон и нажмите кнопку Вверх или Вниз.
    5. Нажмите кнопку Далее. После добавления шаблона в мастер добавляются источники данных и переменные, указанные в шаблоне.
  3. В разделе Источники данных настройте каждый источник данных.
    Прим.:
    • Если для источника данных уже существует значение по умолчанию или задан URI по умолчанию, то источник данных отображается как настроенный и значение по умолчанию применяется в выводе, если не будет выбрано другое значение.
    • Если выйти из раздела Источники данных и нажать кнопку Назад для внесения дополнительных изменений в источник данных, то всегда открывается первый источник данных в списке.
    1. База данных: Введите имя базы данных для подключения. По умолчанию используется -data 36677@localhost. Если параметр -data не указан, то он добавляется автоматически. Если значение не указано, то Rational Publishing Engine извлекает значение по умолчанию из реестра (если это возможно).
    2. Путь к файлу doors.exe: введите полный путь к файлу doors.exe. Если путь недопустим или недоступен, то мастер попытается исправить его (если это возможно). Пример: C:\Program Files\IBM\Rational\DOORS\version\bin\doors.exe
    3. URI модуляПредставление и Контрольная версия: введите эти значения или нажмите кнопку Поиск, чтобы выбрать значение в списке с помощью мастера. Если выбран мастер поиска, то нажмите кнопку Далее и выполните одно из следующих действий:
      • Нажмите кнопку Далее для выбора значений URI модуля, Представления и Базовой линии. После нажатия кнопки Далее в окне Выберите представление из базы данных DOORS можно выбрать модули, представления и базовые линии. Затем нажмите кнопку Готово.
      • Введите URI модуля. После ввода URI модуля активизируется кнопка Готово, и ее можно нажать для использования стандартных значений представления и базовой линии. Для использования представления и базовой линии, которые отличаются от стандартных, введите значения Представление и Базовая линия вместо значений по умолчанию и нажмите кнопку Готово.
        Прим.: Если вручную указать в поле URI модуля неверное значение, то могут возникнуть ошибки при создании вывода. Когда неверное или пустое значение указано для поля Представление или Контрольная версия, вывод генерируется из стандартного представления текущей версии модуля. Созданный вывод может содержать неправильные данные.
    4. Имя пользователя: введите имя учетной записи Rational DOORS.
    5. Пароль: введите пароль учетной записи Rational DOORS.
    6. Укажите, следует ли использовать опцию Использовать текущий экземпляр DOORS во время создания документа:
      • Если Rational DOORS планируется запускать из расположения, указанного в поле Путь к doors.exe при создании документа из этой спецификации документа, включите переключатель Использовать активный экземпляр DOORS в ходе создания документа. Обработку можно ускорить в случае применения экземпляра Rational DOORS.
      • Если Rational DOORS не планируется запускать из расположения, указанного в поле Путь к doors.exe при создании документа из этой спецификации документа, выключите переключатель Использовать активный экземпляр DOORS в ходе создания документа для запуска нового экземпляра.
        Прим.: Если применяется приложение Удаленные службы, то свойства doors_home и new_instance всегда перезаписываются приложением Удаленные службы. После передачи спецификации документа Rational Publishing Engine перезаписывает свойства в соответствии с конфигурацией сервера.

    Неправильные значения, которые Rational Publishing Engine заменяет в мастере, также обновляется на панели Свойства для источника данных и в значениях флагов.

  4. В разделе Переменные настройте каждую переменную.
    Прим.:
    • Если для переменной уже существует значение по умолчанию, то переменная отображается как настроенная и значение по умолчанию применяется в выводе, если не будет выбрано другое значение.
    • Если выйти из раздела Переменные и нажать кнопку Назад для внесения дополнительных изменений в переменную, то всегда открывается первая переменная в списке.
    1. В выпадающем меню выберите одну из следующих опций:
      • Настройка вручную: позволяет ввести любое значение переменной, для которой не существует другая информация на уровне конфигурации или в компоненте Централизованное управление.
      • Из уровня конфигурации: для того чтобы выбрать значение в метаданных конфигурации, указанных для переменной в шаблоне.
      • С помощью значений переменных из централизованной библиотеки: позволяет выбрать переменную в компоненте Централизованное управление
    2. Введите или выберите значение для конфигурации.
    3. Нажмите кнопку Далее.
  5. В разделе Вывод выберите типы вывода для создания:
    • Microsoft Word
    • PDF
    • HTML
    • XSL-FO
    • Устаревший формат PDF
    1. Необязательно: В поле Расположение для сохранениянажмите кнопку Обзор и выберите каталог для сохранения файла для каждого типа вывода. Можно указать относительный путь из спецификации документа. Если расположение сохранения вывода не указано, то файл создается во временном расположении.
    2. Необязательно: В поле Таблица стилейнажмите кнопку Обзор и выберите таблицу стилей для каждого типа вывода.
    3. Необязательно: Только вывод Microsoft Word: в поле Макрос введите имя макроса из таблицы стилей.
    4. Необязательно: Для того чтобы ввести дополнительные метаданные или настроить другие свойства документа, отсутствующие в мастере, выберите Изменить свойства метаданных.
    5. Нажмите кнопку Далее.
  6. Проверьте правильность информации о шаблоне и выводе в окне сводки.
  7. Выберите действие, выполняемое при нажатии кнопки Готово:
    • Начать процесс создания документа: Позволяет создать указанные типы вывода.
    • Начать процесс создания документа и закрыть RPE: Позволяет создать указанные типы вывода и закрыть приложение Rational Publishing Engine вместе с окном Результаты.
    • Сохранить и закрыть мастер без создания документа: мастер создания документов закрывается, а приложение Панель запуска остается открытым.
    Прим.: В случае применения мастера создания документов из дополнения Rational DOORS при выборе опции Сохранить и закрыть мастер без создания документа закрывается мастер и приложение Панель запуска.

Комментарии