Fan Tutorial 1 - Specify Product - Part 2
This is the Continuation of the Fan tutorial - Specify Product - part 1 where we cover the topics of the common flows such as “Review and Improve Requirements” and “Approve and Release Specifications”. In this part, we cover, how you can update or manage requirements, create discussions, reviews and analysis blocks of requirements and share them.
This part would take around 15-25 mins.
(4) Update, Manage and Review Requirements
Throughout the development process, it's common for requirements to evolve and be updated based on various factors such as stakeholder input and design constraints. In Valispace, you can directly update requirements by double-clicking on the column fields or within the details section of the requirement, and all changes are recorded in the History for easy reference. Note also that on any change the requirement is increased by one minor version (please check Version and Releases for more information on this).
Collaboration and reviews are crucial to ensure the requirements are thoroughly discussed and evaluated. Valispace offers powerful features like discussions, Tasks, and the review center to facilitate these crucial steps.
In the following steps, we will demonstrate how you can effectively utilize discussions to engage in meaningful conversations with your groups or colleagues, fostering collaboration and ensuring the best possible outcome for your project.
Creating Discussions on a requirement
To create a discussion on the requirement R-Fan-002
, follow the following steps.
Click on the … on the
Actions
columns and hover over to+ Add
and select :discussion:Discussion
Upon clicking the icon, a dialogue box opens. Here, type
@
and you will have the list of users in the dropdown. Select any user and copy and paste the following questionis it feasible to have propellers for 50g or do we need more mass allocation?
Click on
Add
and thenClose.
The steps to raise a discussion are illustrated in the tutorial below.
Creating a new discussion
Once you tag your colleague using @ and post a discussion, the user will receive a notification under the icon :notifications: , where he can access the discussion and write comments to follow up.
Creating reviews on specifications/requirements [ OPTIONAL FOR TUTORIAL]
(5) Validating Requirements
In the early stages of the product lifecycle, it's crucial to validate requirements before moving forward with the design process. Valispace provides a convenient way to manage requirement states using State columns. By default, Valispace includes states like Draft, In Review, and Final, but users can add additional states based on their specific needs.
The following steps will show you how to assign the "Draft" state to newly added requirements, ensuring a structured and organized workflow.
Hover over to the Fan_Specs
On the side, click
Columns
(1) in the right corner and tickState
(2) if it is not selected. Doing this action shows the state column (see Figure Enable State Column).
![image-20240324-120653.png](../__attachments/2212888579/image-20240324-120653.png?inst-v=44f38daa-57b5-4679-9ae8-efe2696766be)
Enable State Column - To enable the State column open the Columns sidebar and select State
Tick the small rectangular box on the top left of the Identifier column. This selects all the requirements within the specification.
Now, hover over to the state column and double-click on the first cell of the
R-Fan-001
state column. Upon clicking, a drop-down with the “state” options list is shown.Select
Draft
and clickYes
on the confirmation dialog box. This bulk edit adds the draft status to all the requirements.
These steps are illustrated in the click-through below.
Adding the “State” Attribute information
You can perform the reviews through the review center feature and change the “state” accordingly. Also you can create automatic transition of states from “Final” to “draft” or “In Review” whenever there is an edit on the requirement. You can find more information in this article here.
(6) Create an Analysis/documentation within Valispace
As an engineer, you might have to create an Analysis to leverage your engineering data and document the properties of your design. You can use our inbuilt Analyses module for it.
Add a descriptive Analysis.
Go to the Analyses Module (see Figure Accessing the Analysis Module) by clicking the
Analyses
button (1) in the left sidebar.Create a new analysis by clicking on
+ Documents
(2).
![image-20240324-121007.png](../__attachments/2212888579/image-20240324-121007.png?inst-v=44f38daa-57b5-4679-9ae8-efe2696766be)
Accessing the Analysis Module - In the Module Navigation bar select Analyses to reach the Valispace internal documentation module.
In the Create document dialog box (see Figure Creating a Project Summary), name the analysis as
Project_Summary
(1) and clickCreate
(2).
![image-20240324-121249.png](../__attachments/2212888579/image-20240324-121249.png?inst-v=44f38daa-57b5-4679-9ae8-efe2696766be)
Creating a Project Summary - Valispace lets you create internal documentation where you can pull in and reference all the data from your Workspace.
The analysis consists of blocks of text, images, videos, charts, or tables. Click inside the existing block
1. Write heading...
and typeIntroduction
Click on the second block
Click to add new block
and selectText
thenNormal text
to add an introduction text.The analysis content is automatically saved while you type (see FIgure Adding Information to the Document)
![image-20240324-121656.png](../__attachments/2212888579/image-20240324-121656.png?inst-v=44f38daa-57b5-4679-9ae8-efe2696766be)
Adding Information to the Document - Using Blocks any type of information can be added: Text, references to Requirements and Valis, Budgets, Graphs and Tables.
PowerUserTip: click + Folder
in the left navigation pane to create a Folder to organize your Reports.
Creating Table of Requirements - Stakeholder specifications
You can create a table of requirements from the stakeholder specifications. To create a table,
Select the
Click to add new block
Select the option
Tables
on the popup dialog box. Here, chooseRequirements
.
Now valispace creates a table with all the requirements from the project. Also, we can select the list of columns we would like to have in the tables. Since we would like to have only the stakeholder specification, we can use the filter option for the specification. This is demonstrated in the following tutorial.
Adding “Stakeholders requirements” to our analysis
Sharing the Analysis Module
You can share the analysis module with your colleagues or stakeholders through the option “Share”. To do that
Click on the three vertical dots in the upper right corner
Select the option
Share
from the dropdown menu
![image-20240324-122140.png](../__attachments/2212888579/image-20240324-122140.png?inst-v=44f38daa-57b5-4679-9ae8-efe2696766be)
Share your Report - By clicking on the three dots in the upper right-hand corner and selecting Share you can create a shareable link for anyone outside of Valispace.
Select any user from the drop-down and click on
Create new link
(1). This creates a new link which you can copy and share with your colleagues or stakeholders(2).
Check out Figure Creating a Link to see how this is done.
![image-20240326-112453.png](../__attachments/2212888579/image-20240326-112453.png?inst-v=44f38daa-57b5-4679-9ae8-efe2696766be)
Creating a Link - The created link cann be shared with external Stakeholders and the shared Report will always stay up to date with the latest information.
Next Steps?
Congratulations! You now know how to specify a product in Valispace.
You can still improve your Desktop Fan project. Here are some ideas:
Use ValiAssistant to “Breakdown Requirements” for you
Use ValiAssistant to “Create Summary” of your requirements in the analysis module.
Look at our Fan Tutorial 2 to learn how to design a Desktop fan with the System Design Module.
Spoiler Alert: the documentation automatically updates itself whenever you change a Vali.