Określanie produktu

W tej części samouczka omówimy jeden z głównych przepływów użytkownika, który pomoże Ci rozpocząć pracę z Requirements Portal:

• Zbieranie i zapisywanie wymagań

• Rozbijanie wymagań

• Przeglądanie i ulepszanie wymagań

• Zatwierdzanie i publikowanie specyfikacji

Tworzenie nowego projektu

1. Na stronie Home Requirements Portal (otwieranej po uruchomieniu Requirements Portal z menu dziewięciu kropek w prawym górnym rogu przeglądarkowego interfejsu Workspace – ), kliknij przycisk  nad listą projektów wymagań.

   

2. Otworzy się okno Create Requirements Project, w którym możesz określić szczegóły projektu:

   • Project Name – wprowadź odpowiednią (i unikalną) nazwę projektu (np. Valifan).

   • Description – wprowadź opcjonalny opis projektu (np. Amazing Valifan project).

   • Electronics Project – pozostaw to pole puste. 

   Po określeniu szczegółów projektu kliknij przycisk .

   

3. Projekt wymagań pojawi się na liście na stronie Home. Kliknij jego nazwę, aby otworzyć go w nowej karcie przeglądarki.

   

Definiowanie wymagań interesariuszy

Większość projektów i procesów rozwoju systemów przebiega zgodnie z cyklem V. Pierwszym procesem w cyklu V jest zrozumienie potrzeb biznesowych i zidentyfikowanie potrzeb interesariuszy. Następnie potrzeby interesariuszy są przekształcane w wymagania interesariuszy, które można tworzyć bezpośrednio, importować przez CSV/XLSX, a nawet tworzyć za pomocą wspieranego przez AI narzędzia 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 ten 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 odwzorowane 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 przekonwertować wartości i jednostki na parametry (valis), zgodnie z podejściem inżynierii systemów opartej na danych.

   

9. W otwartym oknie Valify Requirements otrzymasz informację, że pięć wymagań zostanie poddanych valifikacji. 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 energii i kosztów. Requirements Portal zapewnia kompleksowy wgląd w to, 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 wymaganiu są sprawdzane i bezpośrednio konwertowane na 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 przekonwertować wartość na vali, następnie kliknij przycisk , aby kontynuować, a potem kliknij przycisk , aby zakończyć proces.

5. W podobny sposób dodaj kolejne wymaganie z identyfikatorem R-Fan-002 i treścią 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. Zauważ, że podczas gdy R-Fan-001 ma vali, R-Fan-002 nie ma jeszcze vali.

   

Tworzenie requirement valis w obrębie wymagania

Teraz ręcznie utworzymy nowy vali w polu tekstowym wymagania.

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

   

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

   

3. W otwartym oknie Create new. Na karcie Vali tego 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 wygląda inaczej niż zwykły tekst, co wskazuje, że jest to vali. Tego vali można teraz używać w różnych częściach projektu (np. w raportach, module Blocks, weryfikacji itp.).

   

Rozbijanie wymagań za pomocą relacji nadrzędny-podrzędny

1. Kliknij element sterujący Columns po prawej stronie tabeli i upewnij się, że pozycje dla kolumn Parents i Children są zaznaczone, 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 wyskakującego okna, aby połączyć oba wymagania. Zauważ, że R-Fan-002 zostanie automatycznie dodane do kolumny Children dla 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 ramki 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 za pomocą 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 na liście rozwijanej wybrana jest opcja Generate Requirements, a następnie kliknij przycisk .

   

2. Na następnej stronie możesz opisać swój produkt, system, podsystem i podać jak najwięcej informacji, aby AI mogła wygenerować wymagania jak najlepiej dopasowane do Twojego opisu. 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, wpisz tekst Apply the INCOSE guide to writing requirements w to pole.

   

   Kliknij , aby kontynuować.

3. Na następnej stronie zostanie wyświetlony wynik działania AI, gdzie możesz przejrzeć, zmienić oraz zaakceptować lub odrzucić dowolne 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ądanie 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 i ograniczenia projektowe. W Requirements Portal możesz bezpośrednio aktualizować wymagania, klikając dwukrotnie pola kolumn lub sekcję szczegółów wymagania, a wszystkie zmiany są zapisywane w historii, co ułatwia późniejsze odwołanie się do nich.

1. Włącz 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 gdziekolwiek w tabeli poza komórką, aby zakończyć edycję.

   

   

   

    

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

   

3. Identyfikowalność jest kluczową koncepcją 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ę, a także o polach i działaniach.

   

Walidacja wymagań

Na wczesnych etapach cyklu życia produktu kluczowe jest zweryfikowanie wymagań przed przejściem dalej w procesie projektowym. 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 wpis dla kolumny State jest zaznaczony, 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ć tę 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.