Importuj wymagania

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

AI Assisted Requirements Importer

Inżynieria wymagań często zaczyna się od spisywania 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, a 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 oraz CSV.

Funkcjonalność importera wspomaganego przez AI jest obecnie w wersji Beta.

Następujące pola można importować do wymagań za pomocą importera wspomaganego przez AI:

  • Identyfikator

  • Tekst

  • Metody

  • Dotyczące bloki

  • Tytuł

  • Uzasadnienie

  • Nadrzędne

  • Podrzędne

  • Typ

  • Stan

  • Zgodność

  • Komentarz dot. zgodności

  • Właściciel

  • Tagi

  • Ścieżka do sekcji

Uzyskiwanie dostępu do importera

Do AI Assisted Importer można uzyskać dostęp z 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ń, do importera można uzyskać dostęp, klikając przycisk Import na stronie.

Przebieg importu

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

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

W następnym kroku 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ć i wybrać plik z dysku.

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żna wykorzystać do zapisywania wymagań w sposób ustrukturyzowany. Możesz też 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 przejść dalej. Importer przetworzy przesłany plik. Po zakończeniu procesu wyodrębnione dane zostaną przedstawione jako tabela 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 uruchomienia importera. Możesz wybrać wymaganą specyfikację, wybierając ją z listy rozwijanej u góry okna importera, lub utworzyć nową specyfikację, wybierając pozycję As new (creates new specification) z listy rozwijanej i definiując nazwę nowej specyfikacji w polu 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 powody wykrytych problemów. 

Kliknij przycisk  , aby wrócić do etapu przesyłania pliku w importerze, lub kliknij  , aby wyjść z importera.

Starszy importer

Podczas uzyskiwania dostępu do importera (dowiedz się więcej), możesz wybrać kontynuowanie pracy ze starszym narzędziem importu, aby przesłać ustrukturyzowane dane wymagań. 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 sekcjach poniżej.

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ę oraz 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 oraz blok, do którego ma zostać przypisana) bez wychodzenia z 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 istniejących specyfikacji, należy ją utworzyć.

  • Podczas definiowania nazwy nowej specyfikacji należy spełnić 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 kontrolkę Drop file, aby przeglądać i wybrać plik z dysku. Po pomyślnym przesłaniu pliku w oknie zostanie wyświetlone powiadomienie.

 
  • Obsługiwane są tylko pliki Excel (.xls, .xlsx) oraz Comma Separated Values (.csv). Pliki Excel Macro (.xlsm) nie są obsługiwane.

  • W przypadku przesłania nieobsługiwanego pliku pojawi się komunikat o błędzie.

  • Po przesłaniu pliku możesz kontynuować proces importu lub 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 oraz zmapować dane z pliku na pola wymagań.

Obszar Destination okna Import Requirements zapewnia wizualne wskazanie, gdzie 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 poprzez podstawienie 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, sygnalizując 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 użyć ogólnego wiersza nagłówka referencyjnego dostarczanego przez Requirements Portal (tj. nagłówków kolumn jako A, B, C itd.).

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

  • Sheet – w przypadku pliku z wieloma arkuszami możesz wybrać, z którego arkusza chcesz importować.

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

W tabeli na dole okna Import Requirements możesz zobaczyć podgląd przesłanego pliku i zmapować jego kolumny na pola w Requirements Portal. Pozwala to zdefiniować, jak dane z pliku będą odpowiadać konkretnym polom w Requirements Portal, wybierając odpowiednie pole 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 nadpisać lub dostosować to automatyczne mapowanie.

  • Następujące pola można wybrać do mapowania:

    • Identyfikator

    • Tekst

    • Tytuł

    • Uzasadnienie

    • Nadrzędne

    • Podrzędne

    • Ścieżka do sekcji

    • Typ

    • Stan

    • Tagi

    • Zgodność

    • Komentarz dot. zgodności

    • Metody V&V

    • Zastosowanie

    • Dotyczące bloki

    • Właściciel

    • Tagi

    • Kolumny niestandardowe

  • Children, V&V Methods, Applicability, Applicable Blocks oraz Tags można importować z więcej niż jedną wartością dla każdego wymagania. Aby to zrobić, każdą wartość należy oddzielić przecinkiem.

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

  • W przypadku Zastosowania (Applicability) 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 zostać wybrana. 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:

    • Type

    • State

    • Compliance

    • Tags

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

Raport wykonania

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

Jeśli wystąpią jakiekolwiek błędy miękkie (soft errors), 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

  • Oświadczenie zgodności wymagania (Requirement Compliance Statement) nie istnieje w projekcie

  • Typ wymagania nie istnieje w projekcie

  • Stan wymagania nie istnieje w projekcie

  • Tag nie istnieje w projekcie

  • Warunek zastosowania (Applicability Condition) nie istnieje

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

Po udanym imporcie możesz także rozpocząć proces Valify, klikając kontrolkę Check now u góry okna. Proces ten przeskanuje tekst zaimportowanych wymagań w poszukiwaniu możliwych parametrów mierzalnych, które można przekształcić na Valis w ramach 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