Suche in: Doc:Documentation: Altium 365
Altium DesignerAltium 365Altium MCAD CoDesignerAltium On-Prem Enterprise ServerAltium CircuitMakerAltium CircuitStudioCompany DashboardAltium Infrastructure ServerAltium Developer Center
Close
Suche Suche in der Dokumentation
Documentation Altium 365 Requirements Portal Allgemeine Einstellungen

Benutzerdefinierte Vorlagen für den Dokumentenexport

Updated: March 23, 2026

Mit dem Dokumentenexport-Assistenten von Requirements Portal können Sie editierbare Microsoft Word *.docx dateien direkt aus Ihren Anforderungen und V&V-Aktivitäten zu erstellen. Sie können vordefinierte Vorlagen verwenden oder Ihre eigenen Vorlagen hochladen. Der Assistent wird von der Python-Docx-Template-Bibliothek angetrieben, die wiederum die Jinja Templating Engine nutzt. Dieses dynamische Duo ermöglicht es Ihnen, eigene Vorlagen zu erstellen.

Python-Docx-Template-Bibliothek

Die Python-Docx-Template-Bibliothek ist ein leistungsstarkes Werkzeug, das die Funktionalität der Python-Docx-Bibliothek erweitert. Sie enthält die Jinja Templating Engine und ermöglicht die dynamische Generierung von Inhalten in Ihren Word-Dateien. Das bedeutet, dass Sie Variablen, Schleifen und Bedingungen verwenden können, um Ihr Dokument während der Bearbeitung mit Daten zu füllen. Im Grunde ist es so, als würden Sie Ihrem Word-Dokument einen Schuss Espresso geben.

Beachten Sie, dass für die Felder, die Rich-Text sind, das r präfix in der Exportvorlage verwendet werden muss. Zum Beispiel muss das Feld Anforderungstext in der Vorlage als r requirement.text.

Verwalten von Exportvorlagen

Die für Ihre Requirements Portal-Instanz verfügbaren Vorlagen werden auf der Seite Export templates seite ( » Settings » Export templates).

  • Standardmäßig werden sechs Vorlagen bereitgestellt - drei für den Export von Anforderungsdokumenten und drei für den Export von V&V-Aktivitätsdokumenten.

    • Weitere Informationen zu Vorlagen für den Anforderungsexport finden Sie auf der Seite Dokumentenexport.

    • Weitere Informationen zu den Exportvorlagen für V&V-Aktivitäten finden Sie auf der Seite Dokumentenexport.

  • Um eine neue benutzerdefinierte Vorlage hinzuzufügen, klicken Sie auf die Schaltfläche oben rechts auf der Seite. In dem Add template erscheinenden Fenster wählen Sie aus, ob die neue Vorlage angewendet werden soll auf Requirements oder V&V Activities anwenden soll, indem Sie die Applicable objects aus und verwenden Sie dann den Bereich Select template um die Vorlagendatei auszuwählen.

    Klicken Sie im Dialog auf die Schaltfläche , um die Vorlage hinzuzufügen. Sie wird dann in der Liste auf der Seite Export templates seite angezeigt und kann dann beim Dokumentenexport verwendet werden.

  • Die Datei einer beliebigen Vorlage kann heruntergeladen werden. Klicken Sie dazu unter auf die Schaltfläche in der Name spalte der gewünschten Vorlage und wählen Sie den Download befehl. Je nach Ihren persönlichen Browsereinstellungen lädt Ihr Browser die Datei entweder automatisch an einen vordefinierten Ort herunter oder fragt Sie, wo Sie sie auf Ihrer Festplatte speichern möchten.

  • Eine benutzerdefinierte Vorlage kann mit einer neuen Vorlagendatei überschrieben werden. Klicken Sie dazu auf die Schaltfläche in der Spalte Name spalte der gewünschten Vorlage und wählen Sie den Befehl Overwrite Template aus dem angezeigten Menü. Verwenden Sie das Overwrite template das sich öffnet, um die Anwendbarkeit der Vorlage zu definieren und die neue Datei auszuwählen. Aktivieren Sie die I confirm I want to overwrite option und klicken Sie auf die Schaltfläche , um den Vorgang abzuschließen.

Anhang - Datenobjektstruktur von Anforderungsexportvorlagen

In einer Instanz des Anforderungsportals stehen drei Standardvorlagen für den Anforderungsexport zur Verfügung, von denen jede komplexer ist als die andere. Wenn Sie also Ihre Vorlagenkenntnisse verbessern möchten, ist es sinnvoll, sie nacheinander anzugehen. Hier ist die Aufstellung:

  • spec_doc.docx - Diese Vorlage ist eine einfache, alltägliche Vorlage, die eine identische Ausgabe wie die Dokumentansicht für Anforderungen erzeugt. Sie eignet sich hervorragend für Anfänger und deckt einfache Schleifen und Variablen ab.

  • spec_table.docx - Mit dieser Vorlage werden Konditionale und Filter eingeführt. Hier fangen die Dinge an, pikant zu werden. Es handelt sich um die Jinja-Version unserer skriptbasierten Word-Vorlage mit Platzhaltern.

  • req_verification.docx - der Großmeister unserer Vorlagen. Diese Vorlage ist reich an verschachtelten Schleifen und Bedingungen, und sie enthält sogar Tabellen. Wenn Sie diese Vorlage beherrschen, sind Sie im Grunde ein Jedi der Dokumentenvorlagenerstellung.

Fügen Sie ruhig Abschnitte hinzu, entfernen Sie sie oder ändern Sie sie, um sie besser an Ihre Dokumentationsanforderungen anzupassen. Nachdem Sie die Standardvorlagendateien in der oben angegebenen Reihenfolge durchlaufen haben, werden Sie vielleicht den Mut haben, die Grenzen dessen auszutesten, was Sie in Ihre Berichte aufnehmen können.

Hier sehen Sie die Grundstruktur des Objekts, aus dem Ihre Anforderungsexportvorlagen Informationen beziehen.

Sortierung der Felder

Sie können die Anforderungen sortieren, indem Sie die Sort funktion im Jinja-Vorlagendokument sortieren. Zum Beispiel können Sie hinzufügen |sort(attribute='identifier') einfügen, wobei die Anforderungen alphanumerisch nach der Bezeichnerspalte sortiert werden.

Beispiel:

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

Benutzerdefinierte Spalten

Mit dem aktuellen Dokumentenexporter können Sie die Werte benutzerdefinierter Spalten einfach exportieren. Für eine einfache textbasierte benutzerdefinierte Spalte können Sie die folgende generische Struktur verwenden:

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

Stellen Sie sicher, dass Sie den Name of Custom Column text durch den tatsächlichen Namen der Spalte ersetzen, der in der Spaltenüberschrift angegeben ist.

Handelt es sich bei der benutzerdefinierten Spalte nicht um einen Text, sondern um eine Mehrfachauswahloption, kann der Benutzer den folgenden Code verwenden und ihn für seinen Anwendungsfall aktualisieren. 

{%- 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 -%}

Anhang - Datenobjektstruktur der Exportvorlagen für V&V-Aktivitäten

Hier ist die grundlegende Struktur des Objekts, aus dem Ihre Exportvorlagen für V&V-Aktivitäten Informationen beziehen.

AI-LocalizedAI-localized
Wenn Sie ein Problem feststellen, wählen Sie den Text/das Bild aus und drücken SieStrg + Eingabe, um uns Ihr Feedback zu senden.
Funktionsverfügbarkeit

Die Ihnen zur Verfügung stehenden Funktionen hängen davon ab, welche Altium-Lösung Sie verwenden – Altium Develop, eine Edition von Altium Agile (Agile Teams oder Agile Enterprise), oder Altium Designer (mit aktivem Abonnement).

Wenn Sie eine besprochene Funktion in Ihrer Software nicht sehen, kontaktieren Sie den Altium-Vertrieb , um mehr zu erfahren.

Inhalt