Skip to main content

Approve documents

How documents can be approved and listed in the Published document state.

Updated over 4 months ago

In BIMcollab, document approval is part of the document management process. Documents can be approved (listed in the Published Documents tab) in one of two ways, depending on whether the document is part of a workflow:

  • If not part of a workflow: This can be done manually from the Document Details page

  • If it is part of a workflow: Approval happens based on the outcome of a Review task

⚠️ Attention: By default, users can view documents in the Published category. If you need access to Shared (non-published) documents, your administrator will need to enable it by going to User Groups > Permissions and checking the box for "Has access to non-published documents."

Approve a Document Manually

📝 Note: To be able to manually approve documents, users need to be in a user role with appropriate permissions, including the permission to "Manually approve documents".

Document versions can be approved at any point using the [Approve] button on the document details page.

  1. Go to the documents tab

  2. Select the document number you would like to approve

  3. Click on the [Approve] button located in the action bar

  4. A window will appear asking if you would like to publish the latest version of the document. Click on "Yes, publish".

  5. The document is now visible in the Published Documents list.

Once a document version has been approved, the Approve document button will disappear. Only once a new document version has been uploaded, then this button will become available again.

The information about the approval, including the person who approved it, is logged in the Events tab of the document details page.

Approve a Document through a Review

If a document is part of a Workflow, documents can also be approved through the completion of Review Tasks. When the administrator creates a Review action, there is an optional "To publish" checkbox. If this is selected, once the review task is approved, the associated documents will appear in the Published folder. The outcome of the review - Approved or Rejected - not only determines the subsequent step in the workflow, but also determines the status the review task will receive, and under which filter the document it will appear.

With this option, documents can only be approved by the responsible person of the Review Task. The completion of this will also be attached to a deadline as determined in the workflow.

💡 Tip: For more information on how regular users can view the details of workflows that are created for a project as well as their associated documents, refer to this article: View active workflows as a user

  1. An action is triggered in a workflow that requires a document Review Task to begin, and the responsible persons are assigned to this.

  2. The documents that are still yet to be reviewed will first appear in the Shared category

  3. A responsible person will then complete the review task by selecting the [Approve] button for the relevant Review task

  4. The document will then move from the Shared category to the Published category

When a new document version is uploaded, another Review task will be automatically triggered if the new version's metadata matches the Workflow criteria. This means that the review process for this document version will start again in the Shared folder (marked with the "Older version has been published" icon), while the previous document version will stay in the Published folder. The responsible person will be required to complete the Review task before the new document version appears in the Published documents category.

💡 Tip: For more information on how to handle Review Tasks, refer to this article: Review tasks

📝 Note: It is only possible to use one of the above methods to approve a document. If a document enters a workflow with a Review Task, the manual approval button will automatically become unavailable (greyed out).

Did this answer your question?