Określanie produktu

W tej części samouczka przejdziemy przez jeden z głównych scenariuszy użytkownika, który pozwoli Ci rozpocząć pracę z Requirements Portal:

• Zbieranie i zapisywanie wymagań

• Rozbijanie wymagań

• Przegląd i ulepszanie wymagań

• Zatwierdzanie i publikowanie specyfikacji

Tworzenie nowego projektu

1. Kliknij menu rozwijane Project w lewym górnym rogu, a następnie kliknij przycisk .

   

2. Na otwartej stronie konfiguracji projektu wprowadź odpowiednią (i unikalną) nazwę projektu (np. Valifan) w polu Project name, a następnie kliknij przycisk .

   

Definiowanie wymagań interesariuszy

Większość projektowania i rozwoju systemów przebiega zgodnie z cyklem V. Pierwszym procesem w cyklu V jest zrozumienie potrzeb biznesowych i zidentyfikowanie potrzeb interesariuszy. Te potrzeby interesariuszy są następnie przekształcane w wymagania interesariuszy, które można tworzyć bezpośrednio, importować przez CSV/XLSX, a nawet tworzyć za pomocą wspieranego przez AI ValiAssistant. W tej części samouczka skupimy się na metodzie importu.

1. Pobierz następujący plik CSV zawierający wymagania interesariuszy:

   Valifan_stakeholder_Requirements.csv

2. Jeśli jeszcze tego nie zrobiono, przejdź do modułu Requirements, klikając wpis Requirements w drzewie projektu po lewej stronie.

3. Kliknij przycisk  na otwartej stronie i wybierz Import Requirements z wyświetlonego menu.

   

4. W otwartym oknie Document Importer kliknij łącze open the legacy importer here .

   

5. Otworzy się kreator Import Requirements. W obszarze Create a specification zdefiniuj Name specyfikacji (np. Stakeholder_requirements), a następnie kliknij przycisk .

   

6. Następnym krokiem jest przesłanie pliku CSV, aby kreator importu mógł go odczytać i zaimportować. Przeciągnij i upuść pobrany plik CSV do obszaru Drop file kreatora Import Requirements (lub kliknij obszar, aby przesłać plik za pomocą okna dialogowego).

   

    Kliknij , aby kontynuować.

7. W następnym kroku upewnij się, że kolumny danych z pliku CSV są poprawnie zmapowane na kolumny w Requirements Portal. W razie potrzeby użyj list rozwijanych Map To u góry tabeli. 

   

   Kliknij , aby kontynuować.

8. Następna strona kreatora poinformuje Cię o pomyślnym imporcie. Kliknij element sterujący Check now u góry okna, aby przekształcić wartości i jednostki w parametry (valis), zgodnie z podejściem inżynierii systemów opartej na danych.

   

9. W otwartym oknie Valify Requirements zostaniesz poinformowany, że pięć wymagań zostanie poddanych valify. Kliknij , aby kontynuować i otrzymać powiadomienie, że znaleziono dwa valis. Kliknij , aby kontynuować, a następnie kliknij .

   

10. Jak widać, 50 dB i 50 W zostały przekształcone z czystego tekstu w valis, których możemy później użyć.

    

    Zamknij okno Valify Requirements, aby kontynuować. Wszystkie wymagania zostały dodane, a wszystkie wykryte wartości zostały przekształcone w valis. Valis są wyróżnione w wymaganiach.

    

Dodawanie wymagań systemowych

W typowym przepływie inżynierii systemów wymagania systemowe są tworzone na podstawie wymagań interesariuszy. Większość projektów technicznych musi spełniać rygorystyczne wymagania, takie jak wymagania dotyczące masy, zużycia mocy i kosztu. Requirements Portal zapewnia kompleksowy widok tego, jak dobrze projekt spełnia wszystkie te wymagania.

Teraz ręcznie utworzymy kilka wymagań systemowych.

1. Kliknij prawym przyciskiem myszy wpis Requirements w drzewie projektu po lewej stronie i wybierz Create Specification z wyświetlonego menu. W oknie Create new specification wprowadź Fan_Specs w polu Name  i kliknij .

   

2. Kliknij wpis nowo utworzonej specyfikacji w drzewie projektu. Będąc w tej specyfikacji, kliknij  przycisk  i wybierz Create Requirement z wyświetlonego menu.

   

3. Otworzy się okno Create new requirement. W tym oknie:

   1. W polu Specification upewnij się, że wybrano właściwą specyfikację (Fan_Specs).

   2. W polu Identifier wprowadź unikalny identyfikator, np. R-Fan-001.

   3. W polu Requirement text wprowadź The Mass of the fan shall not exceed 300g.

   4. Upewnij się, że opcja Check for possible Valis jest włączona.

      Gdy ta opcja jest włączona, wartości liczbowe w obrębie wymagania są sprawdzane i przekształcane bezpośrednio w valis za pomocą funkcji Valify.

   5. Kliknij przycisk .

   

4. W wyświetlonym oknie Valify Requirements kliknij przycisk . W wymaganiu zostanie znaleziony vali. Kliknij przycisk , aby przekształcić wartość w vali, następnie kliknij przycisk , aby kontynuować, a potem kliknij przycisk , aby zakończyć proces.

5. Podobnie dodaj kolejne wymaganie z identyfikatorem R-Fan-002 i tekstem wymagania The Mass of the propeller shall not exceed 50g, ale tym razem wyłącz opcję Check for possible Valis (vali zostanie później utworzony ręcznie z wartości w tym wymaganiu).

   

6. Dodane wymagania będą widoczne na liście po wybraniu specyfikacji Fan_Specs. Zwróć uwagę, że R-Fan-001 ma vali, natomiast R-Fan-002 nie ma jeszcze vali.

   

Tworzenie valis wymagań w obrębie wymagania

Teraz ręcznie utworzymy nowy vali wewnątrz pola tekstowego wymagania.

1. Kliknij dwukrotnie komórkę w kolumnie Text dla wymagania R-Fan-002 i usuń tekst 50g .

   

2. Wpisz $, aby wyświetlić okno podręczne z listą valis/obiektów w projekcie. W prawym górnym rogu okna podręcznego kliknij przycisk , aby utworzyć vali.

   

3. W otwartym oknie Create new. Na karcie Vali okna wprowadź następujące dane dla nowego vali:

   1. Name: Req_Mass_Propeller

   2. Formula and unit: 50g

   3. Display unit: g

      Pole Display unit jest opcjonalne. Jeśli pozostanie puste, jednostka zostanie pobrana z pola Formula and unit .

   

4. Kliknij przycisk , aby utworzyć nowy vali i wstawić go do pola Text wymagania.

5. Teraz tekst 50g wyświetla się inaczej niż zwykły tekst, co wskazuje na vali. Ten vali może być teraz używany w różnych częściach projektu (np. raportach, module Blocks, weryfikacji itp.).

   

Rozbijanie wymagań z relacjami nadrzędny–podrzędny

1. Kliknij element sterujący Columns po prawej stronie tabeli i upewnij się, że zaznaczone są pozycje dla kolumn Parents i Children, aby były widoczne w tabeli.

   

   Kliknij ponownie element sterujący Columns, aby ukryć listę.

2. Kliknij dwukrotnie komórkę w kolumnie Parent  dla wymagania R-Fan-002 i wybierz wymaganie R-Fan-001 z okna podręcznego, aby powiązać oba wymagania. Zwróć uwagę, że R-Fan-002 zostanie automatycznie dodane do kolumny Children w R-Fan-001.

   

   

    

3. Kliknij kartę Connections u góry tabeli wymagań, aby otworzyć wykres połączeń pokazujący relację nadrzędny–podrzędny dla wybranej specyfikacji.

   Niebieskie obramowania wokół wymagań wskazują specyfikację, w której się znajdują.

   

Generowanie wymagań przy użyciu ValiAssistant

Aby przyspieszyć proces zarządzania wymaganiami, możesz generować wymagania/rozbijać wymagania przy użyciu funkcji AI ValiAssistant. Użyjemy jej do utworzenia dwóch wymagań bezpieczeństwa dla projektu samouczka.

1. Kliknij przycisk  w prawym górnym rogu, aby otworzyć okno ValiAssistant - Generate Requirements. Upewnij się, że w liście rozwijanej wybrano opcję Generate Requirements, a następnie kliknij przycisk .

   

2. Na następnej stronie możesz opisać swój produkt, system i podsystem oraz podać jak najwięcej informacji, aby AI mogło zaproponować najlepsze wymagania zgodne z Twoim opisem. Ponieważ interesują nas wymagania bezpieczeństwa, poproś o dwa wymagania bezpieczeństwa dla naszego wentylatora, wpisując tekst Create 2 safety requirements for designing a fan w polu pod nagłówkiem Generate Description.

   W polu tekstowym pod nagłówkiem Prompt Extension możesz dodatkowo dostosować prompt. Szukamy wymagań zapisanych zgodnie z INCOSE; wprowadź do pola tekst Apply the INCOSE guide to writing requirements.

   

   Kliknij  , aby kontynuować.

3. Na następnej stronie zostanie przedstawiony wynik działania AI i możesz przejrzeć, zmienić oraz zaakceptować lub odrzucić wszelkie sugestie.

   

   Kliknij  , aby kontynuować.

4. Zamknij okno dialogowe informujące o pomyślnym wygenerowaniu wymagań. Wygenerowane wymagania zostaną pokazane w tabeli specyfikacji Fan_Spec.

   

Aktualizowanie, zarządzanie i przegląd wymagań

W trakcie procesu rozwoju często zdarza się, że wymagania ewoluują i są aktualizowane na podstawie różnych czynników, takich jak uwagi interesariuszy czy ograniczenia projektowe. W Requirements Portal możesz bezpośrednio aktualizować wymagania, klikając dwukrotnie pola w kolumnach lub w sekcji szczegółów wymagania, a wszystkie zmiany są zapisywane w historii, co ułatwia późniejsze odwołania.

1. Wejdź w tryb edycji tekstu wymagania R-Fan-003 lub R-Fan-004, klikając dwukrotnie jego komórkę w kolumnie Text. Zmień tekst na The fan shall include a protective guard with openings no larger than inches to prevent accidental contact with moving parts. i naciśnij Enter lub kliknij w tabeli poza komórką, aby zakończyć edycję.

   

   

   

    

2. Kliknij identyfikator zmienionego wymagania, aby otworzyć jego widok szczegółowy, z którego możesz dostosować dodatkowe pola, zasubskrybować, zdefiniować właścicieli, dodać uzasadnienie, utworzyć relacje nadrzędne/podrzędne itd.

   

3. Identyfikowalność (traceability) to kluczowe pojęcie w Requirements Portal, a wszystkie zmiany są śledzone w historii wymagań i innych obiektów. Kliknij History, aby otworzyć widok zawierający informacje o wersjach, kto i kiedy wprowadził zmianę, oraz o polach i akcjach.

   

Walidacja wymagań

We wczesnych etapach cyklu życia produktu kluczowe jest zwalidowanie wymagań przed przejściem dalej w procesie projektowania. Requirements Portal zapewnia wygodny sposób zarządzania stanami wymagań za pomocą kolumny State. Domyślnie uwzględnione są stany takie jak Draft, In Review i Final, ale możesz dodać dodatkowe stany zgodnie ze swoimi potrzebami.

W tej części samouczka przypiszesz stan Draft do nowo dodanych wymagań, zapewniając uporządkowany i zorganizowany przepływ pracy.

1. Będąc w specyfikacji Fan_Spec, kliknij kontrolkę Columns po prawej stronie tabeli i upewnij się, że pozycja dla kolumny State jest zaznaczona, aby była widoczna w tabeli.

   

2. Zaznacz pole po lewej stronie nagłówka kolumny Identifier, aby wybrać wszystkie wymagania w specyfikacji.

   

3. Kliknij dwukrotnie komórkę dowolnego wymagania w kolumnie State (w razie potrzeby przewiń tabelę w prawo, aby zobaczyć kolumnę), aby otworzyć listę rozwijaną z dostępnymi opcjami stanu. Wybierz Draft z listy rozwijanej i potwierdź aktualizację. Wszystkie wymagania będą miały stan Draft.