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. Nella pagina Home di Requirements Portal (accessibile quando apri Requirements Portal dal menu a nove punti in alto a destra dell'interfaccia del Workspace basata su browser – ), fai clic sul pulsante sopra l'elenco dei progetti di requisiti.

   

2. Si aprirà la finestra Create Requirements Project, nella quale puoi specificare i dettagli del progetto:

   • Project Name – inserisci un nome progetto appropriato (e univoco) (ad esempio, Valifan).

   • Description – inserisci una descrizione facoltativa per il progetto (ad esempio, Amazing Valifan project).

   • Electronics Project – lascia questo campo vuoto. 

   Una volta specificati i dettagli del progetto, fai clic sul pulsante .

   

3. Il progetto di requisiti apparirà nell'elenco nella pagina Home. Fai clic sul suo nome per aprirlo in una nuova scheda del browser.

   

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 poi 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, passa al Modulo Requisiti 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, trascina il file CSV scaricato nell'area Drop your file here oppure fai clic sul collegamento upload from your computer per caricare il CSV, in modo che la procedura guidata di importazione possa leggere e importare il file.

   

5. La voce relativa al file caricato apparirà nella finestra. Abilita l'opzione Classic Import (Non-AI) in basso a sinistra nella finestra, quindi fai clic sul pulsante per procedere.

   

6. Nella fase successiva, seleziona + Add specification dal menu a discesa in alto a sinistra e inserisci il nome di una nuova specifica (ad esempio,Stakeholder_requirements) in cui verranno importati i requisiti.

   

7. Assicurati che le colonne dati del file CSV siano mappate correttamente alle colonne in Requirements Portal. Se necessario, usa i menu a discesa nelle intestazioni delle colonne.

   

8. Assicurati che l'opzione Parametrize values sia abilitata e che tutti i requisiti siano selezionati per l'importazione (tutte le caselle di controllo nella colonna più a sinistra della tabella sono abilitate), quindi fai clic su  per procedere.

   

9. La pagina successiva della procedura guidata ti informerà del completamento corretto dell'importazione. Chiudi la finestra per procedere.

   

10. È stata creata una nuova specifica e tutti i requisiti sono stati importati al suo interno. I valori e le unità rilevati sono stati trasformati da testo semplice in valis (parametri), 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 energetico 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 Requirement. In questa finestra:

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

   2. Nel campo Text, inserisci The Mass of the fan shall not exceed 300g.

   3. Fai clic sul pulsante e assicurati che nel campo Specification sia selezionata la specifica corretta (Fan_Specs).

   4. Assicurati che l'opzione Parametrize values sia abilitata.

      Quando questa opzione è abilitata, i valori numerici all'interno del requisito vengono controllati e convertiti direttamente in valis tramite la funzionalità di parametrizzazione.

   5. Fai clic sul pulsante .

   

4. 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 Parametrize values (un vali verrà creato manualmente in seguito da un valore presente in questo requisito).

   

5. 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 Vali 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 una finestra 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. Si aprirà la finestra Create new. 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, prenderà l'unità dal campo Formula and unit.

   

4. Fai clic sul pulsante per creare un nuovo vali e inserirlo nel campo Text del requisito, quindi premi Enter oppure fai clic in un punto qualsiasi della tabella fuori dalla cella per terminare la modifica.

5. Ora il testo 50g appare 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 che vengano mostrate nella tabella.

   

   Fai nuovamente 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 di connessione che mostra la relazione padre-figlio della specifica selezionata.

   Le caselle blu attorno ai requisiti indicano la specifica in cui si trovano.

   

Generazione dei requisiti tramite l'Engineering Assistant

Per accelerare il processo di gestione dei requisiti, puoi generare requisiti/scomporre requisiti utilizzando Engineering Assistant. Lo useremo per creare due requisiti di sicurezza per il progetto del tutorial.

1. Fai clic sul pulsante  in alto a destra per aprire il riquadro Engineering Assistant.

   

    

2. Nel riquadro Engineering Assistant, puoi descrivere il tuo prodotto, sistema, sottosistema e fornire quante più informazioni possibile affinché l'AI possa elaborare i requisiti migliori in base alla tua descrizione. Poiché ci interessano i requisiti di sicurezza, richiedi due requisiti di sicurezza per il nostro ventilatore inserendo un prompt nel campo Ask anything in basso nel riquadro:

   Create 2 safety requirements for designing a fan. Apply the INCOSE guide to writing requirements.

   Fai clic su  o premi Enter per procedere.

   

3. I requisiti suggeriti verranno presentati nell'area della griglia tabellare della specifica. Fai clic sul pulsante nel riquadro Engineering Assistant per creare nuovi requisiti come suggerito.

   

   

    

4. I requisiti generati possono essere modificati in qualsiasi momento dopo la creazione. Se necessario, modifica gli identificatori dei requisiti generati in R-Fan-003 e R-Fan-004 facendo doppio clic sulle relative celle nella colonna Identifier, inserendo il testo e poi premendo Enter oppure facendo clic in un punto qualsiasi della tabella fuori dalla cella per terminare la modifica.

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 all'interno della 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 sua 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 fuori dalla cella per terminare la modifica.

   

   

   

    

2. Fai clic sull'identificatore del requisito modificato per aprire la sua vista dettagliata, dalla quale puoi regolare campi aggiuntivi, iscriverti, definire i proprietari, aggiungere una motivazione, creare relazioni padre/figlio, ecc.

   

3. La tracciabilità è un concetto chiave di Requirements Portal e tutte le modifiche sono tracciate nella cronologia dei requisiti e di altri oggetti. Fai clic su History per aprire una vista che fornisce informazioni su versioni, autore e momento della modifica, 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 aggiunti di recente, 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 per la 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. Fai doppio clic su una cella di qualsiasi requisito nella colonna State (se necessario, scorri la tabella verso destra per visualizzare 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.