Схема 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 Список комментариев для обсуждения
  • Состояние
  • Текст
  • 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.

Таблицы

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

Таблицы 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 определяется модулем, контрольной версией и представлением. Извлечь данные из нескольких модулей, или контрольных версий, или представлений можно одним из следующих способов:

Комментарии