Схема Rational DOORS

Схема Rational DOORS во многом напоминает структуру модуля Rational DOORS.

Вы можете использовать стандартную схему, которая является шаблонной и допустимой для всех формальных модулей Rational DOORS. Используйте эту стандартную схему, когда вы работаете либо с представлением в целом, либо со стандартными атрибутами представления, не требующими извлекаемых пользовательских атрибутов. Когда требуются пользовательские атрибуты, воспользуйтесь мастером поиска схем в Document Studio для создания схемы Rational DOORS.

Запросы и атрибуты в стандартной схеме

Стандартная схема содержит следующие запросы и атрибуты.
Табл. 1. Запросы и атрибуты
Запрос Результаты Атрибуты
Module Отдельная сущность - модуль, указанный в конфигурации источника данных
  • Name: имя модуля
  • Description: описание модуля
  • Baseline: версия модуля
Module/Attribute Список атрибутов уровня модуля для модуля
  • Name: имя атрибута
  • _value: значение атрибута
Module/Discussion Список обсуждений для модуля Неприменимо
Module/Discussion/Attribute Список атрибутов для обсуждения
  • Name: имя атрибута
  • _value: значение атрибута
Module/Discussion/Comment Список комментариев для обсуждения
  • Status
  • Text
  • Changed Status
  • Created On
Module/View Отдельный результат - представление, определенное для каждого источника данных Rational DOORS из спецификации документа
  • Name: имя представления
Module/View/Column Список имен заголовков столбцов для выбранного представления
Прим.: Этот запрос позволяет получить структуру представления, например информацию о столбцах, без извлечения самих данных представления. Информацию о содержимом столбцов выдает запрос Module/Object/Column.
  • Column Text: указание этого атрибута в шаблоне приводит к выдаче сообщения <атрибут данных не найден>.
  • Main: является ли столбец главным
  • Name: имя столбца
  • Attribute: атрибут столбца является не атрибутом Rational DOORS, на котором основан этот столбец, а конструктивным элементом Rational Publishing Engine. Атрибут заполняется отдельным значением текста столбца во время выполнения. Извлечь из Attribute информацию о базовом атрибуте или DXL для столбца нельзя.
  • _value: пустой
Module/Object Список всех объектов с указанной версией модулей, отфильтрованный и упорядоченный по выбранному представлению. Любой атрибут, поднятый пользователем в мастере поиска схем.
  • Object Identifier
  • Object Text
  • Object Heading
  • Absolute Number
  • Object Level
Module/Object/Attribute Список атрибутов объекта, если запрос попадает в контекст запроса module/object. В противном случае - список всех атрибутов всех объектов в модуле.
  • Name: имя атрибута
  • _value: значение атрибута
Module/Object/Column Данные столбца из выбранного представления для текущего объекта
  • Column Text: данные из столбца
  • Main: является ли столбец главным
  • Name: имя столбца
  • Attribute: атрибут столбца является не атрибутом Rational DOORS, на котором основан этот столбец, а конструктивным элементом Rational Publishing Engine. Атрибут заполняется отдельным значением текста столбца во время выполнения. Извлечь из Attribute информацию о базовом атрибуте или DXL для столбца нельзя.
  • _value: пустой
Module/Object/Table Отдельный результат (таблица Rational DOORS), если объект является заголовком таблицы. Отсутствие результатов, если текущий объект отличен от таблицы Rational DOORS. Неприменимо
Module/Object/Table/Row Строки таблицы Неприменимо
Module/Object/Table/Row/object Набор объектов; ячейки текущей строки. Выдается тот же список атрибутов, что и по запросу module/object.
  • Object Identifier
  • Object Text
  • Object Heading
  • Absolute Number
  • Object Level
Module/Object/External Link Набор внешних ссылок для объекта
  • URL: URL сущности с внешней ссылкой и прочих атрибутов, определенных в Rational DOORS.
Module/Object/Link Список ссылок Rational DOORS для объекта Неприменимо
Module/Object/Link/Attribute Список атрибутов для ссылки
  • Name: имя атрибута
  • _value: пустой
Module/Object/Link/Linked Object Список опорных объектов Неприменимо

Изображения

Изображения извлекаются из модуля Rational DOORS со значениями атрибута. Запросить одни только изображения нельзя.

Для настройки размера извлекаемых изображений задайте свойства Максимальная ширина изображения и Максимальная высота изображения. Эти свойства можно задать в двух местах:
  • Информация о формате элемента определяет размер изображений, содержащихся в этом элементе шаблона. Доступна только для текстовых элементов шаблона.
  • Метаданные спецификации документа определяют размер изображений во всех шаблонах. Значения формата элемента переопределяют эти глобальные значения.

Объекты OLE

Из источника данных Rational DOORS можно извлечь встроенные объекты, например объекты OLE. Объекты OLE всегда обрабатываются как изображения в выводе HTML, PDF и XSL-FO, поскольку эти форматы не поддерживают объекты OLE.
В случае вывода Microsoft Word вы должны задать свойство Объекты OLE как статические изображения в разделе метаданных спецификации документа.
  • Если свойство Объекты OLE как статические изображения равно true, то объекты OLE включаются в выходной документ как статические изображения. Если объекты OLE добавляются в документ вывода в качестве статических изображений, то документ является автономным.
  • Если свойство Объекты OLE как статические изображения равно false, то в расположении выходного документа Microsoft Word генерируется папка ref. Если объекты OLE не добавляются в документ вывода в качестве статических изображений, то документ не будет автономным, поскольку в этом случае требуется отдельная папка ref.
Папка ref содержит файлы .rtf для объектов OLE. Для каждого экспортированного объекта OLE в вывод Microsoft Word добавляется одно поле, указывающее на файл .rtf. Так как IBM® Rational Publishing Engine не может обновлять поля Microsoft Word, то добавленные поля не отображаются при открытии документа Microsoft Word. Для того чтобы сделать их видимыми, выполните одно из следующих действий:
Табл. 2. Действия
Действие Результат
Выберите содержимое документа целиком и выполните функцию Обновить поля в Microsoft Word. Объекты OLE показаны в документе. Документ не является законченным.
Запустите макрос updateFields, предоставляемый Rational Publishing Engine. Объекты OLE показаны в документе. Документ не является законченным.
Запустите макрос insertOLEs, предоставляемый Rational Publishing Engine. Объекты OLE показаны в документе. Документ является законченным.
Запустите макрос rpe или insertOLEs, предоставляемый Rational Publishing Engine. Объекты OLE показаны в документе. Документ является законченным.
Прим.: Если вы переместите незаконченный документ на другой компьютер, то не сможете редактировать объекты OLE. Во избежание этого запустите макрос rpe или insertOLEs.

Таблицы

Таблицы Rational DOORS не извлекаются автоматически; их необходимо запрашивать явно. В настоящем руководстве описаны способы тонкого управления форматом таблиц. Таблица создается только для тех объектов Rational DOORS, которые начинают таблицу.

Пример запроса, извлекающего таблицу:

Container DOORS 1 $1 Module/Object
Paragraph
Text
Module/Object/Object/Text
Table DOORS 1 $2 Module/Object/Table
Row DOORS 1 $3 Module/Object/Table/Row
Cell DOORS 1 $4 Module/Object/Table/Row/Object
Text
Module/Object/Table/Row/Object/Object Text

Прим.: У ячеек таблицы нет выделенного типа в схеме Rational DOORS. Для извлечения содержимого ячеек воспользуйтесь запросом Module/Object/Table/Row/Object. У объектов, являющихся ячейками таблицы, есть атрибут Object Text, сочетающий Object Heading и Object Text.

Внешние ссылки

Запрос Module/Object/External Link извлекает информацию, относящуюся к ссылкам Rational DOORS. Эта информация состоит из URL внешней сущности и набора прочих атрибутов, определенных для внешней ссылки.

Внутренние ссылки

С помощью запросов можно извлекать информацию, относящуюся к внутренним ссылкам Rational DOORS. Внутренние ссылки создают ссылку между блоками связанной информации. Например, можно создать ссылку от пользовательского требования к функции проектирования. Ссылки на объекты и объекты, связанные ссылками, можно запрашивать.

Рекурсивное извлечение

Для рекурсивного следования по ссылкам Rational DOORS укажите в свойстве Уровень рекурсии в панели Свойства ненулевое значение. В этом случае будет осуществляться переход по ссылкам от начального объекта и всех объектов, связанных с ним ссылками, до указанного уровня рекурсии.

Прим.: Переход по ссылкам отнимает много времени. Обычно у каждого объекта много ссылок, поэтому количество обрабатываемых объектов растет экспоненциально с повышением уровня. Для экономии времени воспользуйтесь стандартным фильтром, позволяющим сократить количество обрабатываемых ссылок.

Стандартная фильтрация

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

Фильтрация по направлению

Синтаксис команды фильтрации всех входящих или исходящих ссылок следующий:

Link direction in|out

Фильтрация по модулю ссылок

Синтаксис команды фильтрации всех ссылок через модуль ссылок следующий: Link module путь_и_имя_модуля_ссылок

Этот фильтр учитывает регистр символов.

В следующем примере фильтруются все ссылки от Link Module 1:

Link module /Demo/Car/Link Module 1

Фильтрация по целевому модулю

Синтаксис команды фильтрации всех ссылок, ведущих от или к указанному модулю, следующий: Link analyze module путь_и_имя_целевого_модуля

В следующем примере фильтруются все ссылки между модулями analyze и system requirement: Link analyze module /Demo/Car/System Requirements

Комбинирование стандартных фильтров ссылок

Фильтры на вкладке стандартных фильтров можно комбинировать. Каждый фильтр должен быть указан на отдельной строке.
Например, на вкладке Стандартный фильтр введите фильтр в следующем виде:

Link direction out.
Link analyze module /Demo/Car/System Requirements.

Что нельзя извлечь

Источник данных Rational DOORS в Rational Publishing Engine определяется модулем, контрольной версией и представлением. Запросить список контрольных версий или список представлений для модуля нельзя. Источник данных Rational DOORS определяется модулем, контрольной версией и представлением. Извлечь данные из нескольких модулей, или контрольных версий, или представлений можно одним из следующих способов:

Комментарии