Search In: Doc:Документация: Altium 365
Altium DesignerAltium 365Altium MCAD CoDesignerAltium On-Prem Enterprise ServerCompany DashboardAltium Infrastructure ServerAltium Developer Center
Close
Поиск Поиск по документации

Пользовательские шаблоны экспорта документов

Updated: марта 23, 2026

Мастер экспорта документов в Requirements & Systems Portal — ваш основной инструмент для быстрого создания редактируемых файлов Microsoft Word *.docx напрямую из ваших требований и операций V&V. Вы можете использовать предопределенные шаблоны или загружать собственные. Работа мастера основана на библиотеке Python-Docx-Template, которая, в свою очередь, использует механизм шаблонов Jinja. Этот мощный тандем позволяет создавать собственные шаблоны.

Библиотека Python-Docx-Template

Библиотека Python-Docx-Template — это мощный инструмент, расширяющий возможности библиотеки Python-Docx. Она включает механизм шаблонов Jinja, что позволяет динамически генерировать содержимое в ваших файлах Word. Это означает, что вы можете использовать переменные, циклы и условные конструкции для заполнения документа данными на лету. По сути, это как дать вашему документу Word заряд бодрости.

Обратите внимание, что для полей с форматированным текстом в шаблоне экспорта необходимо использовать префикс r. Например, текстовое поле требования должно быть включено в шаблон как r requirement.text.

Управление шаблонами экспорта

Шаблоны, доступные для вашего экземпляра Requirements & Systems Portal, перечислены на странице Export templates (  » Settings » Export templates).

  • По умолчанию предоставляются шесть шаблонов — три для экспорта документов требований и три для экспорта документов операций V&V.

    • Дополнительные сведения о шаблонах экспорта требований см. на странице Document Export.

    • Дополнительные сведения о шаблонах экспорта операций V&V см. на странице Document Export.

  • Чтобы добавить новый пользовательский шаблон, нажмите кнопку  в правом верхнем углу страницы. В появившемся окне Add template выберите, должен ли новый шаблон применяться к Requirements или V&V Activities, используя раскрывающийся список Applicable objects, а затем в области Select template выберите файл шаблона.

    Нажмите кнопку  в диалоговом окне, чтобы добавить шаблон. Он будет показан в списке на странице Export templates, после чего его можно будет использовать при экспорте документов.

  • Файл любого шаблона можно скачать. Для этого нажмите кнопку  в столбце Name нужного шаблона и выберите команду Download. В зависимости от ваших персональных настроек браузера файл либо будет автоматически загружен в заранее заданное место, либо браузер предложит выбрать, где сохранить его на жестком диске.

  • Пользовательский шаблон можно перезаписать новым файлом шаблона. Для этого нажмите кнопку  в столбце Name нужного шаблона и выберите в появившемся меню команду Overwrite Template. В открывшемся окне Overwrite template задайте область применения шаблона и выберите новый файл. Включите параметр I confirm I want to overwrite и нажмите кнопку , чтобы завершить процесс.

Приложение — Структура объекта данных шаблонов экспорта требований

В экземпляре Requirements & Systems Portal доступны три стандартных шаблона экспорта требований, каждый из которых сложнее предыдущего. Поэтому, если вы хотите лучше освоить создание шаблонов, разумно разбирать их по порядку. Вот они:

  • spec_doc.docx — это простой, стандартный шаблон, предназначенный для создания вывода, идентичного представлению Document View для требований. Он отлично подходит для начинающих и охватывает простые циклы и переменные.

  • spec_table.docx — следующий уровень сложности: в этом шаблоне появляются условные конструкции и фильтры. Именно здесь становится интереснее. Это версия Jinja нашего Word-шаблона на основе сценариев с полями слияния.

  • req_verification.docx — самый продвинутый из наших шаблонов. Он насыщен вложенными циклами и условными конструкциями, а также включает таблицы. Если вы его освоите, можно считать, что вы настоящий мастер шаблонов документов.

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

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

Сортировка полей

Вы можете сортировать требования с помощью функции Sort в документе шаблона Jinja. Например, можно добавить |sort(attribute='identifier') , чтобы требования были отсортированы в алфавитно-цифровом порядке по столбцу идентификатора.

Пример:

{% for requirement in requirements|selectattr("specification_id", "equalto", specification.id)|selectattr("group_id", "none") |sort(attribute='identifier') -%}

Пользовательские столбцы

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

{% for custom_field in requirement.custom_fields|selectattr(“field”, “equalto”, “Name of Custom Column”) %}{{r custom_field.value }}{% endfor %}

Обязательно замените текст Name of Custom Column на фактическое имя столбца, указанное в его заголовке.

Если пользовательский столбец не является текстовым и представляет собой параметр с множественным выбором, пользователь может использовать следующий код и адаптировать его под свой сценарий. 

{%- if requirement.custom_fields -%}
     {%- set additional_info_values = [] -%}
     {%- set category_values = [] -%}
     {%- set additional_info_custom_fields = requirement.custom_fields | selectattr('field', 'equalto', 'Additional Information') -%}
     {% for custom_field in additional_info_custom_fields -%}
      {%- set additional_info_values = additional_info_values + custom_field.value -%}
     {% endfor -%}
     {%- set category_custom_fields = requirement.custom_fields | selectattr('field', 'equalto', 'Category') -%}
     {% for custom_field in category_custom_fields -%}
           {%- set category_values = category_values + custom_field.value -%}
     {% endfor -%}
{%- set additional_info_string = additional_info_values | join(';') -%}
{%- set category_string = category_info_values | join(';') -%}
{%- endif -%}

Приложение — Структура объекта данных шаблонов экспорта операций V&V

Ниже приведена базовая структура объекта, из которого ваши шаблоны экспорта операций V&V будут получать информацию.

AI-LocalizedЛокализовано с помощью ИИ
Если вы обнаружили проблему, выделите текст/изображение и нажмитеCtrl + Enter, чтобы отправить нам свой отзыв.
Доступность функций

Доступные вам функции зависят от того, какое решение Altium вы используете: Altium Develop, Altium Agile Teams, Altium Agile Enterprise или Altium Designer (при активной подписке).

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

Контент