Importowanie wymagań

Możesz szybko i łatwo przesłać istniejące dane wymagań do Requirements Portal, korzystając z Import Wizard dostępnego w module Requirements.

AI Assisted Requirements Importer

Inżynieria wymagań często rozpoczyna 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 rejestrowania 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 być włączany i wyłączany przez administratora za pomocą opcji External Provider na stronie Settings – ValiAssistant (dostępnej po kliknięciu ikony  w prawym górnym 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 jest dostępny z modułu Requirements () po kliknięciu przycisku  w lewym górnym rogu strony i wybraniu 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 element sterujący select from your computer, aby przeglądać dysk i wybrać plik.

Maksymalny rozmiar przesyłanego pliku to 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 rejestrowania wymagań w sposób ustrukturyzowany. Możesz także użyć tego łącza, aby pobrać plik.

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 kontynuować. Importer przetworzy przesłany plik. Po zakończeniu procesu wyodrębnione dane zostaną przedstawione w formie 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 kontynuować. 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

Podczas otwierania importera (dowiedz się więcej) możesz wybrać kontynuowanie pracy ze starszym narzędziem importu w celu przesłania ustrukturyzowanych danych wymagań. Ponadto starszy importer jest dostępny tylko wtedy, gdy opcja External Provider jest wyłączona w ustawieniach Requirements 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 Valifying lub importowanie innych plików. Etapy 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 ma żadnych istniejących specyfikacji, 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 lub kliknij element sterujący 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 Comma Separated Values (.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 importowania 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, a 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, a 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, informującą o zduplikowanym identyfikatorze 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 do wstawienia w Requirements Portal.

W tabeli u dołu okna Import Requirements możesz wyświetlić podgląd przesłanego pliku i zmapować jego kolumny na pola w Requirements Portal. Pozwala to zdefiniować, w jaki sposób dane z pliku będą odpowiadać określonym 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:

    • Identyfikator

    • 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 i 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 Identyfikator musi być zaznaczona. W przeciwnym razie będzie wyświetlany komunikat ostrzegawczy, dopóki ten warunek nie zostanie spełniony ().

  • Następujące pola rozróżniają wielkość liter:

    • Typ

    • Stan

    • Zgodność

    • Tagi

    Na przykład, jeśli tag TBD już istnieje w Requirements Portal, a tag tbd jest importowany, zostanie utworzony nowy tag tbd i zaimportowany wraz z wymaganiem.

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 → Identyfikator elementu nadrzędnego lub podrzędnego nie istnieje w projekcie

  • Nie można ustanowić relacji → Identyfikator 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 Vali wewnątrz wymagania.

Aby uzyskać więcej informacji, zobacz stronę 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