Civillo Documentation

# CDE integrations

Civillo can connect directly to a common data environment (CDE) so you can browse its folder structure and import or revise Civillo layers without leaving Civillo. Files stay sourced and version-controlled in the CDE; Civillo tracks which version of a file each layer was imported from and lets you check for newer versions manually.

Civillo currently supports two CDEs:

  • Autodesk Forma (formerly Autodesk Construction Cloud, or ACC)
  • 12d Synergy

TIP

CDE integrations are an opt-in feature and are not available by default. Please contact the Civillo sales team at sales@civillo.com to request access to this functionality for your organization or project.

Each Civillo user manages their own set of connections; a connection created by one user is not shared with other users of the project. You will need to create your own connection to use this feature, even if a colleague has already connected to the same CDE.

# Access

To create or manage CDE integrations you must be a project administrator, or hold the Layer create/edit group role.

To reach the CDE integrations page, navigate to

Administration -> Integrations -> Common data environments

# Create a connection

  1. On the Common data environments page, click the Green plus icon button next to the integration dropdown to open the Create integration dialog.
  2. Enter a Name to identify this connection (e.g. Main Forma Hub, East Office Synergy).
  3. Select the Integration type: Autodesk (Forma) or 12d Synergy.
  4. Follow the steps below for the integration type you selected, then click Create.

# Autodesk Forma

No further fields are required in the dialog. After clicking Create, you will be redirected to Autodesk to sign in and authorize Civillo to access your data.

Civillo requests read-only access to your Forma hubs; it cannot modify or delete files in Forma. Once you approve access, you will be returned to Civillo and the connection will be ready to use.

# 12d Synergy

Selecting 12d Synergy reveals three additional fields:

Field Description
URL The URL of your 12d Synergy web application or API endpoint.
PAT name The name you gave the personal access token in 12d Synergy.
PAT value The personal access token value itself.

Before you can fill these in, your 12d Synergy administrator must generate a Personal Access Token (PAT) for you:

  1. Ensure PAT creation is enabled on your 12d Synergy server. In the 12d Synergy Administration application, under System Settings → Web, the Creation and Authentication of Personal Access Tokens setting must be set to Yes. If this is set to No, the Personal Access Tokens tab will not appear in your profile.
  2. Generate a PAT from whichever 12d Synergy client you use:
  3. Note down the PAT's name and value, then enter them in Civillo along with your server URL.

TIP

A PAT is only valid against the single 12d Synergy server it was generated on. If you need to connect to more than one 12d Synergy server, you will need a separate PAT, and a separate Civillo connection, for each.

Civillo can only access what the PAT's user account can access. If a file or folder is restricted in 12d Synergy, it will be restricted in Civillo too.

# Browse and import files

Once connected, select the integration from the dropdown to browse its folder structure. Both Forma hubs and 12d Synergy jobs are shown as organizations, and their projects (or, for 12d Synergy, sub-jobs) as projects, so the same browsing experience applies regardless of which CDE you're using.

Navigate through the folder tree to locate the file you want, then click the layers-plus icon icon next to it to import it. This opens the standard Upload file to Civillo layer creation form, pre-filled with the file's latest version. Fill out the layer name, description, and any other layer options as usual, then click Upload.

# Revise an existing layer

If a file has already been imported and a newer version is available in the CDE, the import icon is replaced with a layers-edit icon icon. Clicking it opens the Revise layer in Civillo dialog, which uploads the latest version as a new revision of the existing layer, carrying over settings such as spatial reference system from the previous revision.

The revise icon is disabled once the Civillo layer is already at or ahead of the CDE's latest version, or if you don't have download permission for the file on the remote server.

# Check for newer versions

Version checking is manual. For 12d Synergy connections, you can check every imported file in a job at once, rather than file-by-file. Click the cog-sync icon icon at the organization level to open the Pending version updates dialog. This lists every file with a newer version available in 12d Synergy, alongside the version currently in Civillo.

Select the files you want to update and click Update selected, or click Update all to revise every listed file. Files you don't have download permission for on the remote server are listed separately and excluded from the update.

# Including files in the version check

Each imported file has a toggle that controls whether it's included in the version check: table-eye icon means the file is included, and table-eye-off icon means it's excluded. Version checking itself is still run manually; this toggle only controls which files show up in the results when you do.

# Reconnect a connection

If a connection's access has expired, it is marked with a alert icon icon and the tooltip "Authentication expired. Please reconnect to this integration.", along with a Reconnect button.

Clicking Reconnect opens the same dialog used to create the connection, with the name and type locked. For an Autodesk connection this re-runs the sign-in and authorization step; for a 12d Synergy connection you will need to supply a valid PAT name and value again.

# Delete a connection

Click the Delete icon icon next to a connection to remove it. Deleting a connection does not affect any layers already imported through it; those layers remain intact in Civillo and will stay associated with the connection if you reconnect later.

# Next steps

Last Updated: 18/09/2026

← Permits overview →