How do version control and the Aconex audit trail work?

Aconex brings visibility and accountability to your projects.

Once you've added a document, mail, or other project information to Aconex, you can't remove it. Everything is securely retained and tracked in the un-alterable project record, giving you a full history of changes and decisions.

When you update a document, Aconex creates a new version of the document and records who made the change and when. Its previous versions remain in the audit trail.

Version control is a way to track the changes made to a document.

The audit trail is a record of changes made to documents, mail, and other project information, such as packages and issues.

What is version control?

Version control records any change made to a document or its metadata (like the document status or attributes) by keeping a copy of every version of the document.

Version numbers apply across the entire project, not separately within each organization. For example, if your organization creates version 1 and another organization later updates the same document, Aconex creates version 2.

Each time that document is updated, the version increases by 1. This is maintained regardless of:

  • the order in which documents are transmitted or issued
  • the Revision field value.

Version control helps participants identify the latest version available to their organization. Updates made by another organization become available after that organization transmits them.

It’s also an element of good project governance and due diligence. Version control is an important part of the Aconex audit trail.

What is the audit trail?

The Aconex audit trail records the changes made to documents, mail, and other information in Aconex. It lets you see who was responsible for which decisions.

  • Document History logs all versions and revisions of a document. Learn more
  • The Event Log tracks changes made to a document by people in your organization, as well as who made the change, and when. It also links to relevant transmittals, so you can see who the document was distributed to. Learn more
  • The Mail thread shows who was involved in a conversation, when mail was sent, and what details were included in the mail. Learn more

Tip!

Every user has access to most of the information making up the audit trail for their own organization, but some information can be restricted. For example, a mail may have been sent as confidential or a document may be restricted using access control.

What is a revision?

A Revision is a text value entered by a user against a document record. For a drawing, this should match the revision printed in the title block of the document. Generally, this is a letter (A, B, C) or a number (1, 2, 3) but could be any combination as decided by the project team. The revision is a free text field of up to 15 characters and is not controlled or validated by Aconex.

What is a version?

A version is a system-generated number that increases consecutively each time a document is updated. For example:

  1. If you register a new document it begins as version 1.
  2. You change the document's status, and version 2 is created as the most recent copy of that document.
  3. Another organization uploads revision B, so Aconex creates version 3.
  4. You fix a typo. The document is now version 4. 

Tip!

All historical versions of a document are retained in the audit trail. You will not have access to versions created by other organizations until they have been transmitted to your organization.

What is a rendition?

A rendition is a secondary file associated with a document, allowing multiple file types to be stored under a single document record. Document versioning applies to the document record as a whole, ensuring revisions are kept together for data accuracy.

How long are records kept?

Your project’s records will be kept according to the legal requirements imposed by the country or region where your project’s data is located. Aconex is fully compliant with the laws and regulations for data security and storage for each country we operate in.

At the end of your project, you can request a Project Archive. This is a read-only copy of all your organization’s activity in Aconex over the life of your project.