Параметризация в Document Publisher

Parametrics in Document Publisher

Возможность параметризации шаблонов в Document Publisher может быть очень полезна.  Использование знака вопроса ? указывает Document Publisher, что эта опция должна быть заполнена пользователем при публикации документа.

Это позволяет пользователям задать ИД/Ключ одного или нескольких элементов, которые необходимо опубликовать. Это также может быть использовано для иерархий или при линейном выводе элементов одного типа. Параметризация может быть использована и для задания других свойств в фильтрах.

Одиночная параметризация

Использование одиночной параметризации (?) позволяет пользователю публиковать шаблон много раз, но каждый раз с разным ID или Ключом элемента. Примечание: использование одиночной параметризации в нескольких местах шаблона применительно к одному и тому же типу элементов приведет к использованию одного и того же ИД/Ключа во всех местах.

Параметризация может использоваться на уровне элементов или их атрибутов, чтобы задать элементы (атрибуты) для публикации. На верхнем уровне (на уровне элементов) параметризация задается в поле ID/Key, как показано на рисунке 1.

database_parametric

Рисунок 1. Определение параметризации на верхнем уровне

При таких настройках при публикации данного шаблона пользователю будет предоставлена возможность ввести значение ID/Key для параметризованного типа элементов. Пример такого запроса приведен на рисунке 2.

database_parametric_popup

Рисунок 2. Запрос ввести значение параметра во время публикации отчета

Аналогично можно параметризовать фильтры на уровне полей (см рисунок 3):

field_parametric-768x272

Рисунок 3. Параметризация фильтра на уровне полей требований

В этом случае выбранное поле требования будет выведено только, если статус требования будет соответствовать тому, что введет пользователь при публикации шаблона, в данном случае Accepted (см рисунок 4).

field_parametric_popup

Ниже, на рисунке 5, показан результат публикации. Обратите внимание, что только для элементов со статусом равным Accepted опубликован и Ключ и ИД:

Рисунок 5. Результат публикации полей с параметризованным фильтром

Рисунок 5. Результат публикации полей с параметризованным фильтром

Поименованная параметризация

Использование поименованной параметризации (?named) означает, что пользователь может определить несколько параметров внутри шаблона и для каждого из них будет задан вопрос о его значении в ходе публикации.

Например, пользователь может установить два разных поименованных параметра для одной и той же категории требований, но в разных местах шаблона (см рисунок 6)

Рисунок 6. Два разных поименованных параметра шаблона

Рисунок 6. Два разных поименованных параметра шаблона для одного и того же атрибута

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

В результате опубликованный шаблон может выглядеть, например, таким образом:

named_parametrics_output

Рисунок 7. Пример опубликованного фрагмента ТЗ на основе поименованной параметризации

Поименованные параметры могут повторно использоваться и среди нескольких типов элементов, например, для того, чтобы вывести И требования И системные требования со статусом Agreed, как показано на рисунке 8:

Рисунок 8. Пример опубликованного фрагмента на основе поименованной параметризации для нескольких типов элементов

Рисунок 8. Пример опубликованного фрагмента на основе поименованной параметризации для нескольких типов элементов

При этом два поименованных параметра использовались для обоих типов элементов.

Добавить комментарий