As explained here, the core content in BriefBuilder is presented by way of trees and detail views. Here, we will explain briefly what a detail view is and what kinds of information you can find on it.
As the name suggests, the detail view is the part of the screen that shows all the detail information of an object. You can see this information when you click on the object in the tree.
Please note that you can hide tables on the detail view that you are not interested in. To do so, just click on the icon in front of the table’s name.
There are a number of things you can do on a detail view.
See below for short explanations of each functionality.
Comments
At the top of each detail page you will find the comments table. This is where you or other team members can add comments (e.g. questions or suggestions for improvement) about the information on this page for this specific object. It is a way to facilitate dialogue within the project.
For more info about how to make comments, respond to them, and find them, see here.
View object history
If you want to know what has happened to the object – in terms of modifications, deletions or additions – you can click on the button in the upper right corner of the object.
Please note that this feature shows every single change that has been made to an object. For this reason, this feature is only available for the working version of the project. To see the differences that have been made between different published versions, you can generate a ‘diff report’.
View requirement ID’s
If you click on the icon in the upper right corner of the detail view, you can choose to extend your view with several types of information (see also the explanations below concerning analysis and verification).
The most basic type of information that you may want to add to your detail view concerns the requirement ID’s. These are automatically generated numbers that you can use to identify individual requirements (e.g. in comments, documents or meetings).
An ID is a ‘fixed’ number, generated when someone creates a requirement. So, it does not change when, for example, adding other requirements above it.
View analysis data
As indicated above, you can also click on the icon in the upper right corner of the detail view to extend your view with analysis data.
Typically, analysis data concerns notes from the design/engineering team about the feasibility or clarity of requirements. The feature can also be used to assign responsibilities (who is responsible for which requirements?).
Click here for more information about requirements analysis.
View verification data
You can also use the icon in the upper right corner to extend your view with verification information concerning the requirements that you see on the detail view.
When doing so, you get to see the verification plan (how to verify whether a requirement has been met) and the verification result (outcome and possible link to a demonstration document)
Click here for more information about verification.
Add a description
In the table General, it is possible to add a description to an object. This will not always be necessary, but it is a good place to describe the general purpose and nature of the object.
Try to refrain from putting too much text in the descriptions. Requirements can best be captured in an explicit way (with a clear unit of measurement etc.) in the other tables of the detail view.
Add labels
Also in the table General , you can add a label or ‘tag’ to an object. The purpose of adding labels is generally to categorize objects to make it easier to find them in trees and tabular overview (e.g. you may want to be able to easily find all spaces that are labelled as ‘open work space’ when defining requirements for acoustic comfort)
To create or add a label, just start typing. When you do so, you will get suggestions based on labels that have been used for other objects.
Add values for standard properties
Standard properties are the properties that are shown for each and every object of a particular type. For the object type ‘spaces’ for example, a standard property may be ‘usable floor area’.
On the detail view, you can just click on the value field to enter the value.
You can define the standard properties in the requirement settings menu. See here for a short video about how you can do that.
Add custom properties
In additional to the standard properties, you may want to add custom properties for a specific element. This is often the case for technical systems which may have very different properties from system to system.
To add custom properties, click on the Add property button. If you do so, you will be able to fill in a name and a value.
If you already have a list of properties, you can also insert a property between two existing ones. To do this, click on the icon that appears when you hoover with your mouse near the starting point of one the table’s separation lines.
Make relations to other objects
In most detail views, there wil be various tables in which you make links/relations to objects from other trees.
You may, for example, want create a relation from a space (e.g. open plan workstation) to a technical element (e.g. powersocket) or to a user activity (e.g. computer work).
To do so, simply click on the Select button. Depending on the type of relation, it may be possible to add a quantity or a distance to the relation.
Upload documents
The Uploads table at the very bottom of the detail view allows you to upload files, as additional information for an object. Think of sketches, photos or other kinds of documentation that can help the design/engineering team with understanding the requirements for the object in question.
To upload a file, simply click on the Upload file button.
It is recommended to be cautious with uploading files. It would, for example, not be smart to upload all sorts of data sheets for an object because the specifications in those data sheets remain ‘hidden’ in that file, which increases the risk that the information will be overlooked or ignored in the design process.