Demonstration documents are the documents that are being used in the verification process to demonstrate that (designed/built) solutions are compliant with the client’s requirements, as stated in BriefBuilder. E.g. test reports, specification sheets, control slips, compliance certificates.
This makes this part of the model a bit different from the rest: demonstration documents are not created by the construction client, but by those that have to do the verifications: typically quality managers on the side of the contractor or design team.
Example: say, you are responsible for the verification of all the acoustic requirements in a project. In that case, you have to indicate for each acoustic requirement whether the design will be compliant or not. And you will need to provide a demonstration document that shows this (e.g. a report from an acoustic simulation). It is that kind of documents that you can create in the demonstration documents tree, and then link to a verification outcome (see image below)
To be able to work with demonstration documents, you have to (1) define the demonstration documents in the tree, and then (2) link/refer to these in your verification outcomes.
Please note that verification permissions might limit your ability to define or edit demonstration documents. Users with the Edit assigned objects verification role can only link/refer to demonstration documents and not create them. Contact your BriefBuilder administrator to update or amend your role if necessary.
Defining the documents
Like pretty much else in BriefBuilder, you capture the demonstration documents in a ‘tree’. The access to this tree is located under the verification heading in the navigation bar. See image below.
In the tree, click on the + icon on top of the page to add a demonstration document or a folder in which you can group such documents.
One demonstration document is often used for multiple verifications. For example: a test report for the acoustic quality of a room is relevant for the verification of multiple acoustic requirements. It is therefore handy to create only one document for this, and then refer to this document from multiple verifications.
On the right side of the page you will see the detail view of the demonstration document. Here you can add a file which contains the evidence for a specific verification of a requirement(s).
There is two ways of working with the actual file.
(1) Upload a file
In this case, you upload a file which means that the file will be stored in the BriefBuilder database. To do so, you can use the table Uploads and click on Upload file.
The advantage of this is that you will have captured all your documentation in one place. The disadvantage is that it can be quite a task to upload all the material and to make sure that all the files are up-to-date.
(2) Refer to a document in a DMS
The second way is to refer to a document in a web-based document management system (DMS, such as BIM360, Dalux Box or Docstream). To do that, the recommendation is to define a standard property called “Link to document” where you can paste the link that refers to a particular document.
This method works best if you are working with a DMS for your project. The disadvantage is that the links in BriefBuilder will no longer work if the DMS is taken off line (e.g. when the project is finished).
To create a standard property for this purpose, you have to:
- Go to verification settings in the menu (lower part of the menu)
- Select “Standard properties”
- Select “Demonstration document”
- Create a standard property
- Add a name (e.g. Link to document)
Linking demonstration documents to verifications
There are two ways to link a demonstration document to a verification outcome: you can do it on the detail view of an object, or you can do it in the verification table.
(1) On the detail view
On the detail view of an object, you have to toggle on the third button in the view options in the upper right corner of the screen. This allows you to see the verification details for all the requirements on that page.
Once you have done that you have to click on the icon(s) to get to see the window where you can add the details of your verification outcome, including the possibility to select a demonstration document.
(2) In the verification table
You can the verification table is the main menu, under the header verification. If you click on that you get to see all the verification information per requirement.
Scroll the right part of the table to see the column Demonstration documents where you add a link to a demonstration document.
