Specificare il prodotto

In questa parte del tutorial, esamineremo uno dei principali flussi utente che possono aiutarti a iniziare a usare Requirements Portal:

• Raccogliere e scrivere i requisiti

• Scomporre i requisiti

• Rivedere e migliorare i requisiti

• Approvare e rilasciare le specifiche

Creazione di un nuovo progetto

1. Fai clic sul menu a discesa Project in alto a sinistra e fai clic sul pulsante .

   

2. Nella pagina di configurazione del progetto che si apre, inserisci un nome progetto appropriato (e univoco) (ad esempio, Valifan) nel campo Project name e poi fai clic sul pulsante .

   

Definizione dei requisiti degli stakeholder

La maggior parte della progettazione e dello sviluppo di sistemi segue il ciclo a V. Il primo processo in un ciclo a V consiste nel comprendere le esigenze aziendali e identificare le necessità degli stakeholder. Queste esigenze vengono quindi convertite in requisiti degli stakeholder che possono essere creati direttamente, importati tramite CSV/XLSX o persino creati tramite ValiAssistant basato su AI. Per questa parte del tutorial, ci concentreremo sul metodo di importazione.

1. Scarica il seguente file CSV che contiene i requisiti degli stakeholder:

   Valifan_stakeholder_Requirements.csv

2. Se non l’hai già fatto, vai al modulo Requirements facendo clic sulla voce Requirements nell’albero del progetto a sinistra.

3. Fai clic sul pulsante  nella pagina che si apre e seleziona Import Requirements dal menu visualizzato.

   

4. Nella finestra Document Importer che si apre, fai clic sul collegamento open the legacy importer here.

   

5. Si aprirà la procedura guidata Import Requirements. Nell’area Create a specification, definisci il Name della specifica (ad esempio,Stakeholder_requirements) e poi fai clic sul pulsante .

   

6. Il passaggio successivo consiste nel caricare il CSV in modo che la procedura guidata di importazione possa leggere e importare il file. Trascina il file CSV scaricato nell’area Drop file della procedura guidata Import Requirements (oppure fai clic sull’area per caricare il file tramite una finestra di dialogo).

   

    Fai clic su  per procedere.

7. Nel passaggio successivo, assicurati che le colonne di dati del file CSV siano mappate correttamente alle colonne in Requirements Portal. Se necessario, usa i menu a discesa Map To nella parte superiore della tabella. 

   

   Fai clic su  per procedere.

8. La pagina successiva della procedura guidata ti informerà dell’avvenuta importazione. Fai clic sul controllo Check now nella parte superiore della finestra per convertire valori e unità in parametri (valis), seguendo un approccio di system engineering guidato dai dati.

   

9. Nella finestra Valify Requirements che si apre, verrai informato che i cinque requisiti stanno per essere valificati. Fai clic su  per procedere e ricevere una notifica che sono stati trovati due valis. Fai clic su  per procedere e poi fai clic su .

   

10. Come puoi vedere, 50 dB e 50 W sono stati trasformati da semplice testo in valis che potremo usare in seguito.

    

    Chiudi la finestra Valify Requirements per procedere. Tutti i requisiti sono stati aggiunti e tutti i valori rilevati sono stati trasformati in valis. I valis sono evidenziati nei requisiti.

    

Aggiunta dei requisiti di sistema

In un tipico flusso di system engineering, i requisiti di sistema vengono creati a partire dai requisiti degli stakeholder. La maggior parte dei progetti tecnici deve rispettare requisiti rigorosi, come quelli relativi a massa, consumo di potenza e costo. Requirements Portal fornisce una vista completa di quanto bene un progetto soddisfi tutti questi requisiti.

Ora creeremo manualmente alcuni requisiti di sistema.

1. Fai clic con il pulsante destro del mouse sulla voce Requirements nell’albero del progetto a sinistra e seleziona Create Specification dal menu visualizzato. Nella finestra Create new specification, inserisci Fan_Specs nel campo Name e fai clic su .

   

2. Fai clic sulla voce della specifica appena creata nell’albero del progetto. Una volta in questa specifica, fai clic su  il pulsante  e seleziona Create Requirement dal menu visualizzato.

   

3. Si aprirà la finestra Create new requirement. In questa finestra:

   1. Nel campo Specification, assicurati che sia selezionata la specifica corretta (Fan_Specs).

   2. Nel campo Identifier, inserisci un identificatore univoco, ad esempio R-Fan-001.

   3. Nel campo Requirement text, inserisci The Mass of the fan shall not exceed 300g.

   4. Assicurati che l’opzione Check for possible Valis sia abilitata.

      Quando questa opzione è abilitata, i valori numerici all’interno del requisito vengono controllati e convertiti direttamente in valis tramite la funzione Valify.

   5. Fai clic sul pulsante .

   

4. Nella finestra Valify Requirements visualizzata, fai clic sul pulsante . Nel requisito verrà trovato un vali. Fai clic sul pulsante  per convertire il valore in un vali, quindi fai clic sul pulsante  per procedere e infine fai clic sul pulsante  per completare il processo.

5. Allo stesso modo, aggiungi un altro requisito con identificatore R-Fan-002 e testo del requisito The Mass of the propeller shall not exceed 50g, ma questa volta disabilita l’opzione Check for possible Valis (un vali verrà creato manualmente in seguito a partire da un valore all’interno di questo requisito).

   

6. I requisiti aggiunti verranno elencati quando è selezionata la specifica Fan_Specs. Nota che mentre R-Fan-001 ha un vali, R-Fan-002 non ha ancora un vali.

   

Creazione di requirement valis all’interno di un requisito

Ora creeremo manualmente un nuovo vali all’interno del campo di testo del requisito.

1. Fai doppio clic sulla cella nella colonna Text del requisito R-Fan-002 ed elimina il testo 50g.

   

2. Digita $ per visualizzare un popup con un elenco di valis/oggetti all’interno del progetto. In alto a destra del popup, fai clic sul pulsante  per creare un vali.

   

3. Nella finestra Create new che si apre. Nella scheda Vali della finestra, inserisci i seguenti dati per il nuovo vali:

   1. Name: Req_Mass_Propeller

   2. Formula and unit: 50g

   3. Display unit: g

      Il campo Display unit è facoltativo. Se lasciato vuoto, erediterà l’unità dal campo Formula and unit .

   

4. Fai clic sul pulsante  per creare un nuovo vali e inserirlo nel campo Text del requisito.

5. Ora il testo 50g appare in modo diverso dal testo normale, il che indica un vali. Questo vali può ora essere utilizzato in diverse parti del progetto (ad esempio report, modulo Blocks, verifica ecc.).

   

Scomposizione dei requisiti con relazioni padre-figlio

1. Fai clic sul controllo Columns a destra della tabella e assicurati che le voci per le colonne Parents e Children siano selezionate in modo da essere mostrate nella tabella.

   

   Fai di nuovo clic sul controllo Columns per nascondere l’elenco.

2. Fai doppio clic sulla cella nella colonna Parent del requisito R-Fan-002 e seleziona il requisito R-Fan-001 dal popup per collegare entrambi i requisiti. Nota che R-Fan-002 verrà aggiunto automaticamente alla colonna Children di R-Fan-001.

   

   

    

3. Fai clic sulla scheda Connections nella parte superiore della tabella dei requisiti per aprire un grafico delle connessioni che mostra la relazione padre-figlio della specifica selezionata.

   I riquadri blu attorno ai requisiti indicano la specifica in cui si trovano.

   

Generazione dei requisiti tramite ValiAssistant

Per accelerare il processo di gestione dei requisiti, puoi generare requisiti/scomporre requisiti usando la funzione AI ValiAssistant. La useremo per creare due requisiti di sicurezza per il progetto del tutorial.

1. Fai clic sul pulsante  in alto a destra per aprire la finestra ValiAssistant - Generate Requirements. Assicurati che l’opzione Generate Requirements sia selezionata nel menu a discesa e fai clic sul pulsante .

   

2. Nella pagina successiva, puoi descrivere il tuo prodotto, sistema, sottosistema e fornire quante più informazioni possibile affinché l’AI possa proporre i requisiti migliori in base alla tua descrizione. Poiché ci interessano i requisiti di sicurezza, richiedi due requisiti di sicurezza per la nostra ventola inserendo il testo Create 2 safety requirements for designing a fan nel campo sotto l’intestazione Generate Description.

   Nel campo di testo sotto l’intestazione Prompt Extension, puoi personalizzare ulteriormente il prompt. Stiamo cercando requisiti scritti secondo INCOSE; inserisci il testo Apply the INCOSE guide to writing requirements nel campo.

   

   Fai clic su  per procedere.

3. Nella pagina successiva verrà presentato l’output dell’AI e potrai rivedere, modificare e accettare o rifiutare eventuali suggerimenti.

   

   Fai clic su  per procedere.

4. Chiudi la finestra di dialogo che ti informa della corretta generazione dei requisiti. I requisiti generati verranno mostrati nella tabella della specifica Fan_Spec.

   

Aggiornamento, gestione e revisione dei requisiti

Durante il processo di sviluppo, è comune che i requisiti evolvano e vengano aggiornati in base a vari fattori, come l’input degli stakeholder e i vincoli di progettazione. In Requirements Portal, puoi aggiornare direttamente i requisiti facendo doppio clic sui campi delle colonne o nella sezione dei dettagli del requisito, e tutte le modifiche vengono registrate nella cronologia per una facile consultazione.

1. Entra in modalità di modifica per il testo del requisito R-Fan-003 o R-Fan-004 facendo doppio clic sulla relativa cella nella colonna Text. Modifica il testo in The fan shall include a protective guard with openings no larger than inches to prevent accidental contact with moving parts. e premi Enter oppure fai clic in un punto qualsiasi della tabella al di fuori della cella per terminare la modifica.

   

   

   

    

2. Fai clic sull’identificatore del requisito modificato per aprire la relativa vista dettagliata, da cui puoi regolare campi aggiuntivi, iscriverti, definire i proprietari, aggiungere una motivazione, creare elementi padre/figli, ecc.

   

3. La tracciabilità è un concetto chiave di Requirements Portal e tutte le modifiche vengono tracciate nella cronologia dei requisiti e di altri oggetti. Fai clic su History per aprire una vista che ti fornisce informazioni su versioni, autore e data delle modifiche, campi e azioni.

   

Convalida dei requisiti

Nelle prime fasi del ciclo di vita del prodotto, è fondamentale convalidare i requisiti prima di procedere con il processo di progettazione. Requirements Portal offre un modo pratico per gestire gli stati dei requisiti utilizzando la colonna State. Per impostazione predefinita, sono inclusi stati come Draft, In Review e Final, ma puoi aggiungere stati aggiuntivi in base alle tue esigenze specifiche.

In questa parte del tutorial assegnerai lo stato Draft ai requisiti appena aggiunti, garantendo un flusso di lavoro strutturato e organizzato.

1. Quando ti trovi nella specifica Fan_Spec, fai clic sul controllo Columns a destra della tabella e assicurati che la voce della colonna State sia selezionata, in modo che venga mostrata nella tabella.

   

2. Seleziona la casella a sinistra dell’intestazione della colonna Identifier per selezionare tutti i requisiti all’interno della specifica.

   

3. Fai doppio clic su una cella di un qualsiasi requisito nella colonna State (se necessario, scorri la tabella verso destra per vedere la colonna) per aprire un menu a discesa con le opzioni disponibili per lo stato. Seleziona Draft nel menu a discesa e conferma l’aggiornamento. Tutti i requisiti avranno lo stato Draft.