Anforderungen importieren

Sie können Ihre vorhandenen Anforderungsdaten schnell und einfach mithilfe des Import Wizard  im Requirements Module in das Requirements Portal hochladen. Durch die Nutzung einer KI-gestützten Extraktion können Sie Anforderungen aus unstrukturierten PDF-, Word-, Excel- und CSV-Dateien importieren. Dadurch verringern sich Zeitaufwand und manueller Aufwand für die Übertragung von Anforderungsdaten, und Sie können Anforderungen genauer und effizienter erfassen.

Eine neuere Version des Import Wizard (derzeit in der Beta-Phase) wird auf dieser Seite beschrieben. Wenn Sie in Ihrer Requirements Portal-Instanz keinen Zugriff darauf haben, wird eine frühere Version des Importers verwendet (siehe den aufklappbaren Abschnitt Previous Iteration of the Importer, um mehr zu erfahren).

Zugriff auf den Importer

Auf den Importer kann über das Requirements Module () zugegriffen werden, indem Sie oben links auf der Seite auf die Schaltfläche  klicken und im daraufhin angezeigten Menü Create Requirement auswählen. Alternativ kann, wenn die aktuell angezeigte Spezifikation keine Anforderungen enthält, auf den Importer über die Schaltfläche Import auf der Seite zugegriffen werden.

Hochladen einer Datei

Das Fenster Import Requirements wird geöffnet. In diesem Schritt können Sie eine Datei eines unterstützten Typs hochladen (*.pdf, *.docx, *.xlsx oder *.csv). Ziehen Sie die Datei dazu per Drag-and-drop in den entsprechenden Bereich des Fensters oder klicken Sie auf das Steuerelement select from your computer, um die Datei auf der Festplatte zu suchen und auszuwählen.

Dateien in den Formaten *.pdf und *.docx können nur mit dem KI-Importer importiert werden, der standardmäßig aktiviert ist. Falls erforderlich, kann er von einem Workspace-Administrator über die Option External Provider auf der Seite Settings – ValiAssistant deaktiviert werden (aufrufbar durch Klicken auf das Symbol oben rechts, Auswahl von Settings im daraufhin angezeigten Menü und anschließend Auswahl von ValiAssistant in der Liste im linken Bereich) – .

Wenn die Option External Provider deaktiviert ist, können nur Dateien in den Formaten *.xlsx und *.csv mit dem klassischen Importer importiert werden. In diesem Fall wird oben im Fenster Import Requirements eine entsprechende Meldung angezeigt ().

Auch wenn die hochgeladene Datei unstrukturiert sein kann, können Sie über den Link Excel template eine Datei *.xlsx herunterladen, die zur strukturierten Erfassung von Anforderungen verwendet werden kann. Sie können die Datei auch über diesen Link herunterladen.

  • Die maximale Dateigröße beim Hochladen beträgt 50 MB.

  • Falls eine nicht unterstützte Datei hochgeladen wird, informiert Sie eine Fehlermeldung darüber.

Sobald die Datei erfolgreich hochgeladen wurde, wird ihr Eintrag im Fenster angezeigt. Sie können ihn aus dem Fenster entfernen, indem Sie auf das Symbol  klicken.

Für eine hochgeladene Datei *.xlsx oder *.csv können Sie festlegen, stattdessen den klassischen Importer zu verwenden, indem Sie die Option Classic Import (Non-AI) unten links im Fenster aktivieren.

Überprüfen der extrahierten Daten

Sobald die erforderliche Datei hochgeladen ist, klicken Sie auf die Schaltfläche , um fortzufahren. Die extrahierten Daten werden als Tabelle mit vorgeschlagenen Anforderungen angezeigt, die Sie überprüfen können.

Die Benutzeroberfläche der Überprüfungsseite des KI-Importers

Die Benutzeroberfläche der Überprüfungsseite des klassischen Importers

 

Standardmäßig werden die vorgeschlagenen Anforderungen in die Spezifikation importiert, die angezeigt wurde, als auf den Importer zugegriffen wurde. Sie können die gewünschte Spezifikation auswählen, indem Sie sie in der Dropdown-Liste oben im Fenster auswählen, oder eine neue Spezifikation erstellen, indem Sie den Eintrag + Add specification in der Dropdown-Liste auswählen und den Namen der neuen Spezifikation im dann angezeigten Feld für den Spezifikationsnamen festlegen ().

Beim Erstellen einer neuen Spezifikation müssen die Regeln für die Namensvergabe eingehalten werden. Der Spezifikationsname darf die folgenden Zeichen nicht enthalten: \ / ? % * : | " < >. Außerdem werden führende und nachgestellte Leerzeichen ignoriert.

Aktivieren Sie die Option Update requirements, um vorhandene Anforderungen in der Zielspezifikation durch Ersetzen der Daten zu überschreiben (die Dateidaten ersetzen die Daten in der Spezifikation).

  • Wenn die Option deaktiviert ist und Sie Anforderungen importieren, deren Identifier bereits in der als Ziel ausgewählten Spezifikation vorhanden ist, fügt Requirements Portal den Identifiers der importierten Anforderungen den numerischen Suffix (_1, _2, _3 usw.) hinzu, um sie zu unterscheiden.

  • Wenn die Option deaktiviert ist und Sie Anforderungen importieren, deren Identifiers bereits im aktuellen Projekt, aber nicht in der als Ziel ausgewählten Spezifikation vorhanden sind, fügt Requirements Portal den Identifiers ein Warnsymbol hinzu, das auf einen doppelten Identifier im selben Projekt hinweist.

  • Wenn die Option aktiviert ist, werden leere Werte in der zu importierenden Datei unterstützt, d. h. wenn ein Wert in der Datei leer ist, wird der Wert aus der Anforderung entfernt. Dies gilt auch für Mehrfachauswahlfelder wie Tags.

Aktivieren Sie die Option Parametrize values, um die vorgeschlagenen Anforderungen auf mögliche quantifizierbare Parameter zu prüfen und sie in Valis zu konvertieren.

Bei Verwendung des klassischen Importers sind außerdem die folgenden Optionen verfügbar:

  • Starting row – Sie können auswählen, ab welcher Zeile der importierten Datei Daten erfasst werden sollen, um in Requirements Portal eingefügt zu werden.

  • Sheet – falls eine Datei mehrere Tabellenblätter enthält, können Sie auswählen, aus welchem Tabellenblatt importiert werden soll.

Sie können die Anforderungen auswählen, die Sie importieren möchten, indem Sie die Kontrollkästchen links neben den entsprechenden Zeilen aktivieren.

Datenzuordnung

Sie können festlegen, wie Daten aus der hochgeladenen Datei bestimmten Feldern in Requirements Portal zugeordnet werden. Wenn die Datei Überschriften enthält, die mit den Standardfeldern in Requirements Portal identisch sind, werden diese Felder automatisch zugeordnet. Sie können diese automatische Zuordnung bei Bedarf jedoch überschreiben oder anpassen. Klicken Sie auf eine Spaltenüberschrift und wählen Sie das gewünschte Feld aus der Dropdown-Liste aus.

Alternativ können Sie die Spaltendaten einer neuen, benutzerdefinierten Spalte zuordnen, indem Sie ihren gewünschten Namen in das Feld Search/Add custom in der Dropdown-Liste eingeben und anschließend <custom_column_name> (Create new) aus der Dropdown-Liste auswählen.

Sie können in der Dropdown-Liste auch None auswählen, um die Daten aus der Datei keiner Spalte zuzuordnen (d. h. diese Daten werden nicht importiert).

Mindestens die Spalten Identifier und Text müssen ausgewählt sein. Andernfalls wird eine Warnmeldung angezeigt, bis diese Bedingung erfüllt ist ().

Mit dem Importer können die folgenden Felder in Anforderungen importiert werden:

  • Identifier

  • Text

  • Titel

  • Begründung

  • Children

  • Parents

  • Abschnitt

  • Pfad zum Abschnitt

  • Zugeordneter Block

  • Compliance-Kommentar

  • Typ

  • Status

  • Compliance

  • V&V-Status

  • V&V-Methoden

  • Anwendbarkeit

  • Eigentümer

  • Tags

  • Benutzerdefinierte Spalten

  • Children, V&V Methods, Applicable Blocks, Applicability und Tags können mit mehr als einem Wert pro Anforderung importiert werden. Dazu sollte jeder Wert durch ein Komma getrennt werden.

  • Wenn eine zu importierende Verifizierungsmethode, ein zugeordneter Block, ein Anforderungstyp, ein Status, eine Compliance oder ein Tag derzeit in Requirements Portal noch nicht existiert, wird sie bzw. er während des Imports automatisch erstellt und der Anforderung hinzugefügt.

  • Für Applicability können zusammengesetzte Blocktypen mit einem / referenziert werden, zum Beispiel block_A/block_B. Für benutzerdefinierte Spalten sind die folgenden Typen verfügbar: Select, Multiselect, Text, Date, Number.

Bei den folgenden Feldern wird zwischen Groß- und Kleinschreibung unterschieden:

  • Type

  • State

  • Compliance

  • Tags

Wenn zum Beispiel das Tag TBD bereits in Requirements Portal existiert und das Tag tbd importiert wird, wird ein neues Tag tbd erstellt und mit der Anforderung importiert.

Ausführungsbericht

Nachdem die zu importierenden Daten überprüft und die Optionen wie erforderlich konfiguriert wurden, klicken Sie auf die Schaltfläche , um fortzufahren. Wenn der Import abgeschlossen ist, wird ein Bestätigungsfenster angezeigt.

Wenn der Importer Probleme in importierten Anforderungen erkennt, wird dies im Fenster angezeigt (). Klicken Sie auf den Link, um einen Bericht herunterzuladen, der die Gründe für die erkannten Probleme detailliert auflistet. Mögliche Fälle sind:

  • Der Versuch, eine Anforderung mit Beziehungen zu Identifiers zu importieren, die weder im Projekt noch in anderen Anforderungen der importierten Datei existieren.

  • Der Versuch, eine Anforderung mit Beziehungen zu einem Anforderungs-Identifier zu importieren, der entweder im Projekt oder in anderen Anforderungen der importierten Datei zu mehr als einer Anforderung gehört.

  • Der Versuch, eine Anforderung mit einer Compliance-Aussage zu importieren, die derzeit in Requirements Portal nicht definiert ist.

  • Der Versuch, eine Anforderung mit einem Typ zu importieren, der derzeit in Requirements Portal nicht definiert ist.

  • Der Versuch, eine Anforderung mit einem Status zu importieren, der derzeit in Requirements Portal nicht definiert ist.

  • Der Versuch, eine Anforderung mit einem Tag zu importieren, das derzeit in Requirements Portal nicht definiert ist.

  • Der Versuch, eine Anforderung mit einer Anwendbarkeitsbedingung zu importieren, die derzeit in Requirements Portal nicht definiert ist.

  • Der Versuch, eine Anforderung mit einer Methode zu importieren, die derzeit in Requirements Portal nicht definiert ist.

  • Der Versuch, eine Anforderung mit einem zugeordneten Block zu importieren, der derzeit in Requirements Portal nicht definiert ist.

  • Der Versuch, einen Eigentümer zu importieren, der derzeit in Requirements Portal nicht definiert ist.

  • Der Versuch, mehr als einen Eigentümer, Status oder Typ zu importieren, der derzeit in Requirements Portal nicht definiert ist.

Klicken Sie auf die Schaltfläche , um zur Phase des Datei-Uploads des Importers zurückzukehren, oder klicken Sie auf , um den Importer zu verlassen.

Frühere Version des Importers

Wenn Sie keinen Zugriff auf die oben beschriebene neuere Version des Importers haben, wird dessen frühere Version verwendet. Weitere Informationen finden Sie im aufklappbaren Abschnitt unten.

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, über welche Altium-Lösung Sie verfügen – Altium Develop, Altium Agile Teams, Altium Agile Enterprise oder Altium Designer (mit aktivem Laufzeitvertrag).

Wenn Sie eine dokumentierte Funktion in Ihrer tatsächlich verwendeten Software nicht sehen, wenden Sie sich an den Altium-Vertrieb, um mehr zu erfahren.

Inhalt