Tutorial sulla ventola 1 - Specifica del prodotto - Parte 1

Questa pagina della documentazione è stata sostituita e non viene più mantenuta. Per il tutorial più aggiornato, fare riferimento alla seguente pagina: Specifying the Product.

In questo tutorial, esamineremo uno dei principali flussi utente che possono aiutarti a iniziare a usare Requirements & Systems Portal:

  • Raccogliere e scrivere i requisiti

  • Scomporre i requisiti

  • Rivedere e migliorare i requisiti

  • Approvare e rilasciare le specifiche

I primi due aspetti, cioè "Gather and write requirements" e "Breakdown requirements", sono trattati nella Parte 1, mentre il resto nella Parte 2 del tutorial Specify Product. Questo primo tutorial richiederà circa 15-20 minuti per essere completato.  Tutti i valori e i requisiti sono arbitrari.

(1) Creare un nuovo progetto

Se accedi a Requirements & Systems Portal per la prima volta, puoi passare direttamente alla Figura Quickstart Feature.

 

  • Nell'angolo in alto a sinistra (vedi Figura Creating a New Project), fai clic sul menu a discesa del progetto (1).

  • Nell'elenco dei progetti, seleziona + Create new project (2)

image-20240320-163009.png

Creazione di un nuovo progetto - Puoi creare un nuovo progetto facendo clic su “+ Create new project“

 

  • Una volta selezionata questa opzione, verrai indirizzato alla funzionalità “Quickstart” (vedi Figura Quickstart Feature). Fai clic sull'opzione Simple Create per un “Empty project”

Funzionalità Quickstart - Da qui puoi creare un nuovo progetto in vari modi. Per questo tutorial, seleziona “Simple create“.

 

  • Una volta fatto clic su Simple Create , ti verrà chiesto di "Inserire un nome progetto univoco (non ancora esistente)" (ad es. ValiFan_yourname) (1) e premere Create Project (2). Questo è mostrato anche nella Figura Setting up a Project Name.  Nelle autorizzazioni del progetto, puoi scegliere di usare le stesse autorizzazioni del workspace, il che significa che gli utenti che hanno accesso al workspace avranno accesso anche al progetto. Puoi anche impostare autorizzazioni personalizzate per selezionare tu stesso i permessi utente. Per questo tutorial, seleziona “Use workspace permissions (Read & Write)” per le autorizzazioni del progetto.

Il nome del progetto non riconosce caratteri speciali ad eccezione di “_” e “-”.  Inoltre, gli spazi non sono accettati.

Impostazione del nome del progetto - Qui puoi scegliere il nome del progetto e le autorizzazioni. Per questo tutorial, per ora lascia le autorizzazioni così come sono.

 

  • Dopo la creazione del progetto, vedrai automaticamente la “Dashboard” predefinita.

  • Vai a About (1) nel pannello di navigazione a sinistra e sentiti libero di aggiungere informazioni sul tuo progetto. Qui puoi anche cambiare il nome del tuo progetto (2) in qualsiasi momento (vedi Figura About Project Page).

  • Puoi sempre comprimere o espandere il pannello di navigazione principale facendo clic sulla freccia (3) accanto ad esso.

image-20240320-163942.pngPagina Informazioni sul progetto - Qui vengono visualizzate informazioni cruciali sul progetto, come nome, descrizione, immagine e date di inizio e fine.

(2) Definire i requisiti degli stakeholder - Importare i requisiti


Most system design and development follows the V cycle. The first process in a V cycle is understanding the business needs and eliciting the stakeholders' needs. These stakeholder needs are then converted to Stakeholder Requirements. The stakeholder's requirements can be directly created, imported through CSV/XLSX, or even created through the AI-powered “ValiAssistant.”  For this section, we will concentrate on the import method.

Abbiamo ricevuto un file dai nostri stakeholder e importeremo questi requisiti.


Per farlo, scarica il seguente file CSV:

Valifan_stakeholder_Requirements.csv

  • Vai al modulo Requirements (vedi Figura Requirements Module) facendo clic su Requirements nel pannello di navigazione a sinistra (1)

  • Una volta entrato nel modulo Requirements, fai clic su Import Requirements (2)

 

Modulo Requirements - Questo è il modulo Requirements di Requirements & Systems Portal. Qui caricheremo i requisiti degli stakeholder.

 

Una volta selezionata l'opzione, puoi scegliere una specifica o crearne una direttamente all'interno della procedura guidata di importazione. Creeremo la specifica all'interno della procedura guidata di importazione (vedi Figura Import Wizard 1).

  • Seleziona Create a Specification, digita Stakeholder_requirements, e fai clic su Continue.

 

image-20240320-165544.png

Procedura guidata di importazione 1 - Nel primo passaggio, creiamo la specifica in cui verranno archiviati i requisiti.

 

Il passaggio successivo consiste nel caricare il CSV in modo che la procedura guidata di importazione possa leggere e importare il file. Una volta completata l'importazione, puoi usare una funzionalità chiamata “Valify“, che trasforma i parametri basati su testo in riferimenti che memorizzano il valore e l'unità, chiamati anche Valis. Questo è mostrato nell'immagine qui sotto.

 

Durante l'importazione dei requisiti, abbiamo mostrato una funzionalità chiamata "Valify." Dopo aver mappato gli attributi e importato i requisiti, viene visualizzata una schermata di messaggio in cui puoi selezionare “Check Now” per usare la funzionalità “Valify”.

L'opzione “Valify” ti consente di convertire automaticamente i valori numerici nei valis del requisito. I valis sono parametri tecnici di blocchi, requisiti o analisi che possono essere usati nei calcoli e nella documentazione. Un vali ha un valore numerico e contiene informazioni aggiuntive come tipo, unità, formula, descrizione e requisiti minimi/massimi.

In futuro, con l'avanzare del progetto, potrai confrontare i vali dei requisiti con i vali del progetto nel modulo System Design.

(3) Aggiungere requisiti di sistema

In a typical system engineering flow, the system's requirements are created with the help of the stakeholder requirements.  Most technical developments are designed against strict requirements, e.g.  mass, power consumption, and budget. Requirements & Systems Portal maintains a complete overview of whether your design fulfills all of these requirements.

Ora creeremo manualmente alcuni requisiti di sistema (vedi Figura Creating the Fan Specification)

  • Fai clic su + Specification (1) e inserisci Fan_Specs (2) quindi fai clic su Create (3)

Creazione della specifica della ventola - Creare manualmente una specifica in Requirements & Systems Portal è semplice.
  • Nella Figura, Create a new requirement manually, fai clic su Fan_Specs (1). All'interno di questa specifica, fai clic su Create Requirements(2). In alternativa, puoi anche fare clic sul pulsante blu “Add requirement” nell'angolo in alto a destra Add Requirement (3).

Creare manualmente un nuovo requisito.

 

  • Nel menu a comparsa, verifica di aver selezionato la specifica corretta. Quindi aggiungi un identificatore univoco (1), ad es. R-Fan-001 e digita The Mass of the fan shall not exceed 300g sotto “Requirement text” (2).

 

image-20240731-112927.pngCreare manualmente un nuovo requisito - Qui puoi aggiungere l'identificatore, il titolo, il testo e persino la motivazione del tuo requisito.

Selezionando la casella Check for possible Valis vengono controllati i valori numerici all'interno del requisito e convertiti direttamente in valis tramite la funzionalità Valify.

  • Usando lo stesso metodo, ma senza selezionare Check for possible Valis, crea un altro requisito chiamato R-Fan-002 con il testo del requisito: The Mass of the propeller shall not exceed 50g.

image-20240731-113013.pngNei due requisiti Fan Spec, R-Fan-001 ha un vali, mentre R-Fan-002 non ha ancora un vali.

Per il secondo requisito, durante la creazione, non abbiamo usato la funzionalità “Valify”. Se non vuoi usare Valify automaticamente, hai la possibilità di creare manualmente i valis all'interno di un requisito. Vediamo come farlo.

Creazione di valis del requisito all'interno di un requisito

  • Fai doppio clic sulla colonna del testo del requisito R-Fan-002 ed elimina 50g.

  • Digita $ e si aprirà una finestra popup che mostra l'elenco dei valis/oggetti all'interno del progetto.

  • Nell'angolo in alto a destra della finestra di dialogo, seleziona l'icona + per creare un Vali.

  • Inserisci i seguenti dettagli. Name: req_mass_propeller, Formula and unit: 50g and Display unit: g

Guarda come si fa nella dimostrazione interattiva qui sotto:

Creazione manuale di un Requirement Vali - Provalo!

Scomporre i requisiti con relazioni padre-figlio

Osserva la Figura Enable Columns per vedere come abilitare più colonne nella tabella dei requisiti.

  • Fai clic su column (1) sul lato destro della tabella

  • Verifica che le caselle Parents e Children siano selezionate (2)

Abilitare le colonne - Verifica che le colonne genitori e figli siano selezionate

.

  • Abilitare le colonne - verifica che le colonne genitori e figli siano selezionate

  • Nella tabella dei requisiti, trova il secondo requisito che hai creato (R-Fan-002). Nella colonna Parents, fai doppio clic sulla cella (1)

  • Nel menu a discesa, digita R-Fan-001 per collegare entrambi i requisiti. Nota che i figli vengono aggiunti automaticamente al requisito R-Fan-001

  • Dopo averlo fatto, i tuoi requisiti dovrebbero apparire così:

image-20240324-114433.pngCreazione di una relazione padre-figlio - Facendo doppio clic su Parents o Children, puoi assegnare l'ereditarietà tra i requisiti.
  • Facendo clic sulla scheda Connections Graph (2 nella Figura Creating parent_child relationship) che si trova nella parte superiore centrale della tabella dei requisiti, puoi vedere e verificare questa relazione (vedi Figura Connection Graph)

image-20240731-114240.pngGrafico delle connessioni - Il grafico delle connessioni mostra la relazione padre-figlio della specifica selezionata. I riquadri blu attorno ai requisiti indicano la specifica in cui si trovano.

Prova questo: puoi generare requisiti/requisiti derivati tramite ValiAssistant. Ad esempio, fai clic su ValiAssitant, scegli l'opzione Generate Requirements e digita un prompt come Create 2 safety requirements for designing a fan.

Ricorda che ValiAssistant è basato su un LLM (Large Language Model) e i risultati dei requisiti generati possono variare.

I passaggi sono mostrati nella dimostrazione interattiva qui sotto:

Generazione di requisiti di sicurezza tramite ValiAssistant con un prompt.

AI-LocalizedLocalizzato tramite A
Se trovi un problema, seleziona il testo/l’immagine e premi Ctrl + Invio per inviarci il tuo feedback.
Disponibilità delle funzionalità

Le funzionalità disponibili dipendono dalla soluzione Altium in uso – Altium Develop, un’edizione di Altium Agile (Agile Teams o Agile Enterprise), oppure Altium Designer (con licenza attiva).

Se non vedi nel tuo software una funzionalità descritta,  contatta il team vendite di Altium per saperne di più.

Contenuto