Importowanie wymagań

Możesz szybko i łatwo przesłać istniejące dane wymagań do Requirements Portal za pomocą Import Wizard dostępnego w Requirements Module.

AI Assisted Requirements Importer

Inżynieria wymagań często zaczyna się od opracowania wymagań interesariuszy w dokumentach takich jak pliki PDF i arkusze Excel, gdzie dane nie są dobrze ustrukturyzowane. Ręczne wyodrębnianie danych wymagań z takich nieustrukturyzowanych dokumentów może być pracochłonne i podatne na błędy, dlatego aby przyspieszyć proces przechwytywania wymagań w Requirements Portal, możesz wykorzystać możliwości AI do importowania wymagań z nieustrukturyzowanych plików PDF, Excel, Word i CSV.

Funkcja AI-assisted Importer jest obecnie w wersji Beta.

Następujące pola mogą być importowane do wymagań za pomocą AI-assisted Importer:

  • Identyfikator

  • Tekst

  • Metody

  • Odpowiednie bloki

  • Tytuł

  • Uzasadnienie

  • Elementy nadrzędne

  • Elementy podrzędne

  • Typ

  • Stan

  • Zgodność

  • Komentarz dotyczący zgodności

  • Właściciel

  • Tagi

  • Ścieżka do sekcji

Dostęp do Importera

AI Assisted Importer może zostać włączony lub wyłączony przez administratora za pomocą opcji External Provider na stronie Settings – ValiAssistant (dostępnej po kliknięciu ikony w lewym dolnym rogu, wybraniu Settings z wyświetlonego menu, a następnie wybraniu ValiAssistant z listy w panelu po lewej stronie).

Gdy opcja External Provider jest wyłączona, dostępny i możliwy do użycia jest tylko starszy importer. Aby dowiedzieć się więcej o starszym importerze, zapoznaj się z sekcją Legacy Importer poniżej.

Po włączeniu AI Assisted Importer można uzyskać do niego dostęp z poziomu Requirements Module (), klikając przycisk  w lewym górnym rogu strony i wybierając Create Requirement z wyświetlonego menu. Alternatywnie, gdy aktualnie wyświetlana specyfikacja nie zawiera żadnych wymagań, dostęp do importera można uzyskać, klikając przycisk Import na stronie.

Przebieg importu

Po otwarciu importera wyświetlane jest okno Document Import. Aby kontynuować z AI Assisted Importer, kliknij przycisk .

W tym oknie możesz również, jeśli chcesz, wybrać użycie starszego importera, klikając łącze open the legacy importer here. Sposób korzystania ze starszego importera został opisany poniżej na tej stronie.

W następnym etapie możesz przesłać plik obsługiwanego typu (*.pdf, *.docx, *.xlsx lub .*csv). Aby to zrobić, przeciągnij i upuść plik do odpowiedniego obszaru okna albo kliknij kontrolkę select from your computer, aby przeglądać dysk i wybrać plik.

Maksymalny rozmiar przesyłanego pliku wynosi 100 MB.

Chociaż przesyłany plik może być nieustrukturyzowany, możesz użyć łącza Excel template, aby pobrać plik *.xlsx, który może zostać użyty do uporządkowanego zapisywania wymagań.

Po pomyślnym przesłaniu pliku jego wpis zostanie wyświetlony w oknie. Możesz usunąć go z okna, klikając ikonę . Alternatywnie przeciągnij i upuść do okna inny plik, aby zastąpić istniejący.

Kliknij przycisk , aby przejść dalej. Importer przetworzy przesłany plik. Po zakończeniu procesu wyodrębnione dane zostaną przedstawione w postaci tabeli sugerowanych wymagań. Możesz wybrać wymagania, które chcesz zaimportować, zaznaczając pola wyboru po lewej stronie odpowiednich wierszy.

Domyślnie wyodrębnione wymagania zostaną zaimportowane do specyfikacji, która była wyświetlana w momencie otwarcia Importera. Możesz wybrać wymaganą specyfikację z listy rozwijanej u góry okna Importera albo utworzyć nową specyfikację, wybierając pozycję As new (creates new specification) z listy rozwijanej i definiując nazwę nowej specyfikacji za pomocą pola Specification name, które pojawi się w oknie.

Kliknij przycisk , aby przejść dalej. Po zakończeniu importu pojawi się okno potwierdzenia.

Jeśli importer wykryje problemy w importowanych wymaganiach, zostanie to wskazane w oknie (). Kliknij łącze, aby pobrać raport zawierający szczegółowe przyczyny wykrytych problemów. 

Kliknij przycisk , aby wrócić do etapu przesyłania pliku w importerze, albo kliknij , aby zamknąć importer.

Legacy Importer

Po otwarciu Importera (dowiedz się więcej) możesz wybrać kontynuację pracy ze starszym narzędziem importu, aby przesłać ustrukturyzowane dane wymagań. Ponadto starszy importer jest dostępny tylko wtedy, gdy opcja External Provider jest wyłączona w ustawieniach Requirements & System Portal przez administratora.

Proces prowadzi przez trzy główne etapy: Specification, Upload i Review. Po zakończeniu importu specyfikacji wyświetlane jest podsumowanie oraz możliwość wykonania dodatkowych działań, takich jak walidacja lub import innych plików. Etapy te i działania opisano w poniższych sekcjach.

Specyfikacja

Na tym etapie Import Wizard możesz zdefiniować docelową specyfikację importu:

  • Użyj obszaru Select a specification po lewej stronie okna Import Requirements, aby wybrać istniejącą specyfikację i opcjonalnie jej sekcję.

  • Użyj obszaru Create a specification po prawej stronie okna Import Requirements, aby utworzyć nową specyfikację (a także zdefiniować skrót i blok, do którego ma zostać przypisana) bez opuszczania kreatora importu.

Kliknij wymagany obszar, aby użyć preferowanej metody.

 
  • Jeśli Import Wizard zostanie uruchomiony w kontekście Specyfikacji lub Sekcji, zostanie ona wstępnie wybrana jako miejsce docelowe importu.

  • Jeśli nie istnieją żadne specyfikacje, należy utworzyć nową.

  • Przy definiowaniu nazwy nowej Specyfikacji muszą zostać spełnione reguły nazewnictwa – dozwolone są wyłącznie znaki alfanumeryczne oraz znak specjalny _ (podkreślenie).

Przesyłanie

Na tym etapie Import Wizard możesz przesłać plik obsługiwanego typu. Aby to zrobić, przeciągnij i upuść plik po prawej stronie okna Import Requirements albo kliknij kontrolkę Drop file, aby przeglądać dysk i wybrać plik. Po pomyślnym przesłaniu pliku w oknie zostanie wyświetlone powiadomienie.

 
  • Obsługiwane są tylko pliki Excel (.xls, .xlsx) oraz pliki wartości rozdzielanych przecinkami (.csv). Pliki Excel Macro (.xlsm) nie są obsługiwane.

  • W przypadku przesłania nieobsługiwanego pliku zostanie wyświetlony komunikat o błędzie.

  • Po przesłaniu pliku możesz kontynuować proces importu albo przesłać nowy plik (zastępując poprzedni).

Przegląd

Na tym etapie Import Wizard możesz przejrzeć wyniki importu danych z przesłanego pliku, skonfigurować opcje pliku i zmapować dane z pliku na pola wymagań.

Obszar Destination okna Import Requirements zapewnia wizualne wskazanie miejsca, do którego dane zostaną zaimportowane (w odniesieniu do specyfikacji lub sekcji).

Obszar File options udostępnia następujące opcje:

  • Update requirements – po włączeniu wszelkie istniejące wymagania w docelowej specyfikacji zostaną nadpisane przez zastąpienie danych (dane z pliku zastępują dane w specyfikacji).

    • Jeśli opcja jest wyłączona i importujesz wymagania, których Identyfikator już istnieje w specyfikacji wybranej jako miejsce docelowe, Requirements Portal doda sufiks _import do identyfikatorów importowanych wymagań, aby je rozróżnić.

    • Jeśli opcja jest wyłączona i importujesz wymagania, których Identyfikatory już istnieją w bieżącym projekcie, ale nie w specyfikacji wybranej jako miejsce docelowe, Requirements Portal doda ikonę ostrzeżenia do identyfikatorów, aby zasygnalizować zduplikowany identyfikator w tym samym projekcie.

    • Jeśli opcja jest włączona, obsługiwane są puste wartości w importowanym pliku, tzn. jeśli wartość w pliku jest pusta, wartość zostanie usunięta z wymagania. Dotyczy to również pól wielokrotnego wyboru, takich jak Tags.

  • Use header row – możesz zdecydować, czy użyć wiersza nagłówka przesłanego pliku, czy ogólnego referencyjnego wiersza nagłówka dostarczanego przez Requirements Portal (tj. nagłówków kolumn takich jak A, B, C itd.).

    Requirements Portal traktuje wiersz nagłówka jako pierwszy wiersz każdego przesłanego pliku.

  • Sheet – w przypadku pliku zawierającego wiele arkuszy możesz wybrać, z którego arkusza chcesz importować.

  • Starting row – możesz wybrać, od którego wiersza importowanego pliku dane mają zacząć być pobierane w celu wstawienia ich do Requirements Portal.

W tabeli na dole okna Import Requirements możesz wyświetlić podgląd przesłanego pliku i zmapować jego kolumny na pola w Requirements Portal. Pozwala to określić, w jaki sposób dane z pliku będą odpowiadać konkretnym polom w Requirements Portal, poprzez wybranie odpowiedniego pola z listy rozwijanej Map To dla każdej kolumny. Jeśli plik zawiera nagłówki identyczne z domyślnymi polami w Requirements Portal, pola te zostaną zmapowane automatycznie. W razie potrzeby możesz jednak zastąpić lub dostosować to automatyczne mapowanie.

  • Do mapowania można wybrać następujące pola:

    • Identifier

    • Tekst

    • Tytuł

    • Uzasadnienie

    • Elementy nadrzędne

    • Elementy podrzędne

    • Ścieżka do sekcji

    • Typ

    • Stan

    • Tagi

    • Zgodność

    • Komentarz dotyczący zgodności

    • Metody V&V

    • Zakres stosowania

    • Obowiązujące bloki

    • Właściciel

    • Tagi

    • Kolumny niestandardowe

  • Elementy podrzędne, metody V&V, zakres stosowania, obowiązujące bloki oraz tagi można importować z więcej niż jedną wartością dla każdego wymagania. W tym celu każdą wartość należy oddzielić przecinkiem.

  • Jeśli metoda weryfikacji, obowiązujący blok, typ wymagania, stan, zgodność lub tag importowany obecnie nie istnieje w Requirements Portal, zostanie automatycznie utworzony podczas importu i dodany do wymagania.

  • W przypadku zakresu stosowania złożone typy bloków mogą być wskazywane za pomocą /, na przykład block_A/block_B.

  • Dla kolumn niestandardowych dostępne są następujące typy: Select, Multiselect, Text, Date, Number.

Co najmniej kolumna Identifier musi być zaznaczona. W przeciwnym razie będzie wyświetlany komunikat ostrzegawczy do momentu spełnienia tego warunku ().

Raport wykonania

Po zakończeniu procesu importu, jeśli import zakończy się pomyślnie, zostanie wyświetlony komunikat o powodzeniu oraz wprowadzone zmiany. Jeśli import się nie powiedzie, zostanie wyświetlony komunikat o niepowodzeniu. Przykład pomyślnego importu pokazano poniżej.

Jeśli wystąpią jakiekolwiek błędy miękkie, również zostaną wyświetlone (). Możliwe błędy miękkie to:

  • Nie można ustanowić relacji → Identifier elementu nadrzędnego lub podrzędnego nie istnieje w projekcie

  • Nie można ustanowić relacji → Identifier elementu nadrzędnego lub podrzędnego jest zduplikowany w projekcie

  • Instrukcja zgodności wymagania nie istnieje w projekcie

  • Typ wymagania nie istnieje w projekcie

  • Stan wymagania nie istnieje w projekcie

  • Tag nie istnieje w projekcie

  • Warunek zakresu stosowania nie istnieje

Niezależnie od tego, czy import zakończył się powodzeniem, czy nie, możesz ponownie zaimportować dane lub wykonać nowy import, klikając Import new file (powodzenie) lub Try again (niepowodzenie), co przeniesie Cię z powrotem do etapu 1 (Specification).

Po pomyślnym imporcie możesz również rozpocząć proces Valify, klikając kontrolkę Check now u góry okna. Proces ten przeskanuje tekst zaimportowanych wymagań pod kątem możliwych mierzalnych parametrów, które można przekształcić w Vale wewnątrz wymagania.

Więcej informacji znajdziesz na stronie Valify Requirements.

AI-LocalizedTłumaczenie SI
Jeśli znajdziesz błąd, zaznacz tekst/obraz i naciśnij Ctrl + Enter aby wysłać nam wiadomość.
Feature Availability

The features available to you depend on which Altium solution you have – Altium Develop, an edition of Altium Agile (Agile Teams or Agile Enterprise), or Altium Designer (on active term).

If you don’t see a discussed feature in your software, contact Altium Sales to find out more.

Content