Anforderungen importieren

Sie können Ihre vorhandenen Anforderungsdaten schnell und einfach mithilfe des im Requirements Module verfügbaren Import Wizard in Requirements Portal hochladen.

AI Assisted Requirements Importer

Requirements Engineering beginnt häufig mit der Erstellung von Stakeholder-Anforderungen in Dokumenten wie PDFs und Excel-Tabellen, in denen die Daten nicht gut strukturiert sind. Das manuelle Extrahieren von Anforderungsdaten aus diesen unstrukturierten Dokumenten kann arbeitsintensiv und fehleranfällig sein. Um den Prozess der Erfassung von Anforderungen in Requirements Portal zu beschleunigen, können Sie KI-Funktionen nutzen, um Anforderungen aus unstrukturierten PDF-, Excel-, Word- und CSV-Dateien zu importieren.

Zugriff auf den Importer

Der AI Assisted Importer kann von einem Administrator über die Option External Provider auf der Seite Settings – ValiAssistant aktiviert und deaktiviert werden (aufgerufen durch Klicken auf das Symbol  oben rechts, Auswahl von Settings im daraufhin angezeigten Menü und anschließende Auswahl von ValiAssistant aus der Liste im linken Bereich).

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

Importablauf

Sobald der Importer aufgerufen wird, wird das Fenster Document Import angezeigt. Um mit dem AI Assisted Importer fortzufahren, klicken Sie auf die Schaltfläche .

Im nächsten Schritt können Sie eine Datei eines unterstützten Typs hochladen (*.pdf, *.docx, *.xlsx oder .*csv). Ziehen Sie dazu die Datei 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.

Sobald die Datei erfolgreich hochgeladen wurde, wird ihr Eintrag im Fenster angezeigt. Sie können ihn durch Klicken auf das Symbol  aus dem Fenster entfernen. Alternativ können Sie eine andere Datei per Drag-and-drop in das Fenster ziehen, um die vorhandene Datei zu ersetzen.

Klicken Sie auf die Schaltfläche  , um fortzufahren. Der Importer verarbeitet die hochgeladene Datei. Sobald der Vorgang abgeschlossen ist, werden die extrahierten Daten als Tabelle mit vorgeschlagenen Anforderungen angezeigt. Sie können die Anforderungen auswählen, die Sie importieren möchten, indem Sie die Kontrollkästchen links neben den entsprechenden Zeilen aktivieren.

Klicken Sie auf die Schaltfläche  , um fortzufahren. Sobald der Import abgeschlossen ist, wird ein Bestätigungsfenster angezeigt.

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

Legacy Importer

Beim Aufrufen des Importers (mehr erfahren) können Sie wählen, mit dem Legacy-Importwerkzeug fortzufahren, um strukturierte Anforderungsdaten hochzuladen. Außerdem ist der Legacy Importer nur verfügbar, wenn die Option External Provider in den Einstellungen von Requirements Portal durch einen Administrator deaktiviert ist.

Der Prozess führt Sie durch drei Hauptphasen: Specification, Upload und Review. Nach Abschluss eines Spezifikationsimports wird eine Zusammenfassung angezeigt sowie die Möglichkeit, zusätzliche Aktionen auszuführen, z. B. zu validieren oder andere Dateien zu importieren. Diese Phasen und Aktionen werden in den folgenden Abschnitten beschrieben.

Spezifikation

In dieser Phase des Import Wizard können Sie die Zielspezifikation für den Import festlegen:

• Verwenden Sie den Bereich Select a specification auf der linken Seite des Fensters Import Requirements, um eine vorhandene Spezifikation und optional deren Abschnitt auszuwählen.

• Verwenden Sie den Bereich Create a specification auf der rechten Seite des Fensters Import Requirements, um eine neue Spezifikation zu erstellen (und auch die Abkürzung sowie den zuzuordnenden Block festzulegen), ohne den Importassistenten zu verlassen.

Klicken Sie auf den gewünschten Bereich, um die bevorzugte Methode zu verwenden.

Hochladen

In dieser Phase des Import Wizard können Sie eine Datei eines unterstützten Typs hochladen. Ziehen Sie dazu die Datei per Drag-and-drop auf die rechte Seite des Fensters Import Requirements oder klicken Sie auf das Steuerelement Drop file, um die Datei auf der Festplatte zu suchen und auszuwählen. Sobald die Datei erfolgreich hochgeladen wurde, wird im Fenster eine Benachrichtigung angezeigt.

Überprüfen

In dieser Phase des Import Wizard können Sie die Ergebnisse des Imports der Daten aus der hochgeladenen Datei überprüfen, Dateioptionen konfigurieren und Daten aus der Datei den Anforderungsfeldern zuordnen.

Der Bereich Destination des Fensters Import Requirements zeigt visuell an, wohin die Daten importiert werden (in Bezug auf Spezifikation oder Abschnitt).

Der Bereich File options bietet die folgenden Optionen:

• Update requirements – wenn aktiviert, werden alle vorhandenen Anforderungen in der Zielspezifikation durch Ersetzen der Daten überschrieben (Dateidaten ersetzen die Daten in der Spezifikation).

  • Wenn die Option deaktiviert ist und Sie Anforderungen importieren, deren Bezeichner bereits in der als Ziel ausgewählten Spezifikation vorhanden sind, fügt Requirements Portal den Suffix _import zu den Bezeichnern der importierten Anforderungen hinzu, um sie zu unterscheiden.

  • Wenn die Option deaktiviert ist und Sie Anforderungen importieren, deren Bezeichner bereits im aktuellen Projekt, aber nicht in der als Ziel ausgewählten Spezifikation vorhanden sind, fügt Requirements Portal den Bezeichnern ein Warnsymbol hinzu, das auf einen doppelten Bezeichner 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 Felder mit Mehrfachauswahl, wie z. B. Tags.

• Use header row – Sie können festlegen, ob die Kopfzeile der hochgeladenen Datei verwendet werden soll oder eine allgemeine Referenz-Kopfzeile von Requirements Portal (d. h. Spaltenüberschriften wie A, B, C usw.).

  Requirements Portal betrachtet die Kopfzeile als die erste Zeile jeder hochgeladenen Datei.

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

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

In der Tabelle unten im Fenster Import Requirements sehen Sie eine Vorschau der hochgeladenen Datei und ordnen deren Spalten Feldern in Requirements Portal zu. So können Sie festlegen, wie Daten aus der Datei bestimmten Feldern in Requirements Portal entsprechen, indem Sie für jede Spalte das passende Feld in der Dropdown-Liste Map To auswählen. Wenn die Datei Kopfzeilen enthält, die mit den Standardfeldern in Requirements Portal identisch sind, werden diese Felder automatisch zugeordnet. Bei Bedarf können Sie diese automatische Zuordnung jedoch überschreiben oder anpassen.

Ausführungsbericht

Sobald der Importvorgang abgeschlossen ist und der Import erfolgreich durchgeführt wurde, werden eine Erfolgsmeldung sowie die vorgenommenen Änderungen angezeigt. Falls der Import fehlschlägt, wird eine Fehlermeldung angezeigt. Ein Beispiel für einen erfolgreichen Import ist unten dargestellt.

Unabhängig davon, ob der Import erfolgreich war oder nicht, können Sie durch Klicken auf Import new file (Erfolg) oder Try again (Fehler) erneut importieren oder einen neuen Import durchführen; dadurch gelangen Sie zurück zu Stufe 1 (Specification).