Określanie produktu

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

• Zbieranie i zapisywanie wymagań

• Rozbijanie wymagań

• Przeglądanie i ulepszanie wymagań

• Zatwierdzanie i publikowanie specyfikacji

Tworzenie nowego projektu

1. Na stronie Home Requirements & Systems 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.

   

4. Przejdź do modułu Project, klikając ikonę  na pasku Module Navigation po lewej stronie, i wybierz pozycję About na liście Overview. Stąd możesz w dowolnym momencie zmienić nazwę i opis projektu.

   
   Podstawowe informacje o projekcie, takie jak nazwa, opis, obraz oraz data rozpoczęcia i zakończenia, są dostępne na stronie About Project.

   Główny panel nawigacyjny możesz zawsze zwinąć lub rozwinąć, klikając przycisk strzałki  obok niego ().

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 generować 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. Przejdź do modułu Requirements, klikając ikonę  na pasku Module Navigation po lewej stronie.

3. Kliknij przycisk  na otwartej stronie.

   

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

   

5. 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ć.

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

   

   Kliknij , aby kontynuować.

7. 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 data-driven system engineering.

   

8. W otwartym oknie Valify Requirements zobaczysz informację, że pięć wymagań zostanie poddanych valifikacji. Kliknij , aby kontynuować i otrzymać powiadomienie, że znaleziono dwa valis. Kliknij , aby kontynuować, a następnie kliknij .

   

9. Jak widać, 50 dB i 50 W zostały przekształcone z czystego tekstu w valis, których będziemy mogli 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 kosztu. Requirements & Systems Portal zapewnia kompleksowy wgląd w to, jak dobrze projekt spełnia wszystkie te wymagania.

Teraz ręcznie utworzymy kilka wymagań systemowych.

1. Kliknij przycisk . W wyświetlonym oknie Create new specification wpisz Fan_Specs w polu Name  i kliknij .

   

2. Kliknij pozycję nowo utworzonej specyfikacji na liście po lewej stronie. Będąc w tej specyfikacji, kliknij przycisk  (alternatywnie kliknij przycisk  w prawym górnym rogu).

   

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 wpisz 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 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. 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 System Design, 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 w R-Fan-001.

   ❯ ❮ Javascript ID: RSP_FanTutorial_Requirements_ParentsChildren_Add

3. Kliknij przycisk  u góry tabeli wymagań, aby otworzyć graf 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 za pomocą funkcji AI ValiAssistant. Użyjemy jej do utworzenia dwóch wymagań bezpieczeństwa dla projektu samouczka.

1. Kliknij przycisk  u góry, aby otworzyć okno ValiAssistant - Generate Requirements.

   

   Funkcja ta proponuje różne sposoby wykorzystania AI w pracy z wymaganiami, w tym generowanie wymagań, dzielenie wymagań na mniejsze części, tworzenie podsumowania, weryfikację wymagań, znajdowanie niespójności itd.

   Upewnij się, że 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 przygotować jak najlepsze wymagania na podstawie 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 Customize ValiAssistant output możesz dalej dostosować prompt. Szukamy wymagań zapisanych zgodnie z INCOSE, wpisz tekst Apply the INCOSE guide to writing requirements w polu.

   

   Kliknij  , aby kontynuować.

3. Na następnej stronie zostanie wyświetlony wynik działania AI i będzie można 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 wymagania często ewoluują i są aktualizowane na podstawie różnych czynników, takich jak uwagi interesariuszy i ograniczenia projektowe. W Requirements & Systems Portal możesz bezpośrednio aktualizować wymagania, klikając dwukrotnie pola kolumn lub edytując je w sekcji szczegółów wymagania, a wszystkie zmiany są zapisywane w historii, co ułatwia późniejsze odwołanie się do nich.

1. Przejdź do trybu 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ę.

   ❯ ❮ Javascript ID: RSP_FanTutorial_Requirements_UpdateManageReview

2. Kliknij identyfikator wymagania, aby otworzyć widok szczegółowy wymagania, 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 & Systems 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.

   

Tworzenie dyskusji dotyczących wymagania

Współpraca i przeglądy są kluczowe, aby zapewnić dokładne omówienie i ocenę wymagań. Requirements & Systems Portal oferuje zaawansowane funkcje, takie jak dyskusje, zadania i centrum przeglądów, aby wspierać te istotne etapy.

W tej części samouczka zobaczysz, jak skutecznie wykorzystywać dyskusje do prowadzenia wartościowych rozmów z grupami lub współpracownikami, wspierając współpracę i zapewniając jak najlepszy rezultat projektu.

1. Kliknij przycisk  w polu Identifier wymagania R-Fan-002 i wybierz z wyświetlonego menu polecenie Add » Discussion.

   

2. Otworzy się okno Discussions relating to. W tym oknie możesz przeglądać wszystkie dyskusje, komentować istniejące dyskusje i rozpoczynać nowe. Wpisz @ w polu tekstowym okna, aby wyświetlić rozwijaną listę użytkowników.

   

3. Wybierz dowolnego użytkownika z listy (oznaczony użytkownik otrzyma powiadomienie) i dodaj następujący tekst: Is it feasible to have propellers for 50g, or do we need more mass allocation?

   

4. Kliknij , a następnie w oknie Discussions relating to. Dyskusja zostanie dodana, a ikona będzie widoczna w tabeli specyfikacji.

   

5. Kliknij ikonę u góry strony, aby otworzyć panel Discussions, z którego masz dostęp do wszystkich dyskusji dotyczących specyfikacji lub całego modułu. Dyskusje można zakładać praktycznie dla każdego obiektu w Requirements & Systems Portal.

   

Weryfikacja wymagań

Na wczesnych etapach cyklu życia produktu kluczowe jest zweryfikowanie wymagań przed przejściem dalej w procesie projektowania. Requirements & Systems 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żna dodawać dodatkowe stany zależnie od konkretnych potrzeb.

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 ona widoczna w tabeli.

   

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

   

3. Kliknij dwukrotnie komórkę w kolumnie State, aby otworzyć listę rozwijaną z dostępnymi opcjami stanu.

   

4. Wybierz Draft z listy rozwijanej i potwierdź aktualizację. Wszystkie wymagania będą miały stan Draft.

   

Tworzenie analizy/dokumentacji

Jako inżynier możesz potrzebować utworzyć analizę, aby wykorzystać dane inżynierskie i udokumentować właściwości projektu. Requirements & Systems Portal umożliwia tworzenie wewnętrznej dokumentacji, do której można pobierać i odwoływać się do wymaganych danych.

W tej części samouczka dodasz opisową analizę przy użyciu modułu Analyses.

1. Przejdź do modułu Analyses, klikając ikonę ​ na pasku nawigacji modułów po lewej stronie.

2. Kliknij przycisk na otwartej stronie, aby utworzyć nową analizę. W otwartym oknie Create Document wpisz Project_Summary w polu Document Name i kliknij .

   

3. Otworzy się nowa analiza.

   Za pomocą przycisku w lewym panelu nawigacyjnym możesz utworzyć folder do organizowania raportów.

   Analiza składa się z bloków, którymi mogą być teksty, obrazy, filmy, wykresy lub tabele. Kliknij w istniejącym bloku 1. Write heading... i wpisz Introduction.

   

4. Kliknij w istniejącym bloku Write text... i dodaj do niego następujące zdanie: The ValiFan is designed in a way that it works with less power than conventional Fans.

   

5. Kliknij poza blokiem, aby zapisać zawartość.

6. Można dodawać dodatkowe bloki różnych typów (tekst, obrazy, odwołania do wymagań i valis, budżety, grafy lub wykresy). Utworzymy tabelę wymagań ze specyfikacji interesariuszy. Kliknij kontrolkę Click to add new block, a w otwartym oknie Add Block rozwiń wpis Table i wybierz Requirements.

   

7. Zostanie dodana tabela pokazująca wszystkie wymagania w projekcie. Zobaczmy, jak wyświetlić tylko wymagania związane ze specyfikacją interesariuszy. W tym celu najedź kursorem na nagłówek kolumny Text i kliknij wyświetloną ikonę .

   

8. W otwartym oknie podręcznym kliknij ikonę , aby wyświetlić listę dostępnych kolumn. Odznacz wszystkie wpisy kolumn na liście i zaznacz tylko wpisy Text i Specification.

   

9. Najedź kursorem na nagłówek kolumny Specification, kliknij ikonę , a następnie kliknij ikonę w wyświetlonym oknie podręcznym, aby uzyskać dostęp do opcji filtrowania. Wyłącz wpis specyfikacji Fan_Specs i pozostaw włączony wpis Stakeholder_requirements.

   

10. Teraz wyświetlane są tylko wymagania specyfikacji Stakeholder_requirements. Filtry można stosować do dowolnej kolumny, co zapewnia elastyczność podczas prezentowania wymagań. 

    

11. Utworzoną analizę możesz udostępnić współpracownikom, interesariuszom lub osobom spoza Requirements & Systems Portal. W tym celu kliknij przycisk w prawym górnym rogu strony i wybierz z wyświetlonego menu Share. W otwartym oknie Share analysis wybierz dowolnego użytkownika z listy rozwijanej View as i kliknij przycisk . Spowoduje to utworzenie nowego łącza, które możesz skopiować i udostępnić.

    

    • Udostępniona analiza to widok internetowy dokumentu, który jest tworzony w Requirements & Systems Portal i pozostaje aktualny wraz z najnowszymi zmianami.

    • Widok internetowy może być dostępny dla każdego, bez uzyskiwania dostępu do Twojego Workspace.