Version control and document comparison

BRIX provides the version control feature. A user can add a new version to a document created in the system, with the previous version marked as outdated.

All versions are shown on the sidebar of the document view page in the Document versions widget. You can view the list, compare the versions, and replace the current version with any of the previous ones.

Please note that version comparison is only available for .doc and .docx files if you have an integration with a file viewing and editing service that allows document comparison.

Only a user with editing permissions for the app item can add a new version.

Note: In the Document versions widget settings, the system administrator can enable the Read only > Yes option. This prevents users from editing the current version or adding new ones.

 

Add version

There are several ways to add a new version:

  1. Click on the plus version button at the top of the document page and upload the new version of the file. If necessary, specify what changes were made in the Comment field.
  2. Click the Edit button on the document page and modify the file attached to the document.
  3. Make changes to the document in a business process by using a script. In this case, the new version will be generated automatically.

Information about all added document versions is displayed on the sidebar of the app item.

loan_agreement_01

To see a full list of versions, click on the All Versions link.

document_comparison_01

You can:

  • Open a version in view mode by clicking its name.
  • Download a version to your computer by clicking the download-icon  icon next to it.
  • Print a version by clicking the print-icon icon. If watermark printing is enabled for an app, the watermark will appear in the document.
  • Delete previous versions by clicking the trash icon.
  • Restore the previous version by clicking Make Current. Please note that this button is not displayed if the system administrator has prohibited changing the current version in the settings of the Document Versions widget.
  • Compare versions. The option is available for .doc and .docx files.

View a document version

On the version view page, you can read its contents.

The buttons on the bottom panel allow you to perform the same actions as in the list of all document versions: restore or delete a previous version and compare versions.

You can also download a version of the document to your computer or print it using the icons in the upper right corner of the page.

docs-version-1

The sidebar displays the associated activity stream of the version. Here you can chat, share files, mention users, react to messages, and add them to Favorites.

 

Please note that messages will only appear on the version you're viewing. They won't be added to the activity stream of the document.

 

Compare versions

начало внимание

Version comparison is only available for .doc and .docx format files, it also requires an integration with a file viewing and editing service that allows document comparison.

конец внимание

If a Document app item contains a .doc or .docx file, you can:

  • Compare the current version with one of the older versions or with a newly uploaded file.
  • Compare any two versions of the file.

The result will be shown in a new window.

Compare the current version

On the sidebar of the view page, click Compare and select one of the options:

comparison_02

  • With File. Upload a file of the same format and click Compare.
  • With Version. Select a file version added before, and click Compare.

Compare any two versions

On the sidebar of an item view page, click All Versions. In the pop-up, click doc-compare-icon next to the name of the file and select the number of the version for comparison. You can only compare versions of the same format.

comparison_03

Comparison results

The comparison result document is shown in a separate window. All changes are highlighted. For details, hover over the highlighted text.

If you have set up an integration with a file viewing and editing service that allows document comparison, you can edit the document with comparison results and then save it as a new version by clicking Add Version.

vers5

The new file will become the current version. It will be displayed in the list of versions on the item’s sidebar.

Note: In the Document versions widget settings, the system administrator can enable the Read only > Yes option. Then the Add Version button will be unavailable an users cannot add a new version of the document.