> For the complete documentation index, see [llms.txt](https://help.besmart.software/be.smart-site-management/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.besmart.software/be.smart-site-management/integrations-and-extensions/machine-control-extension/leica-conx.md).

# Leica ConX

ConX is a platform for machine control systems by Leica.

Start using Leica ConX integration, by opening a project, clicking Integrations and selecting Leica ConX. 

<figure><img src="https://1605669813-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqIBa9qorv0XHooVd4ozT%2Fuploads%2FFRCvcEhAuSBajUpqEF7a%2Fimage.png?alt=media&amp;token=49b372d3-f1ac-43fd-bf1c-d3266e5f906f" alt=""><figcaption><p>Leica ConX -integration</p></figcaption></figure>

{% hint style="info" %}
Before accessing the integration for the first time, please create a project to ConX, via Leica ConX web site.
{% endhint %}

## Setup

To use the integration, Leica ConX project needs to be paired with Site Management project, which is one-time action.&#x20;

<figure><img src="https://1605669813-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqIBa9qorv0XHooVd4ozT%2Fuploads%2FcDDTXlCRTQjNs4GFkKyb%2Fimage.png?alt=media&amp;token=ff99b4f8-ed2e-44a4-b4a1-e6d1f1f5c128" alt=""><figcaption><p>Leica ConX, not connected with Site Management</p></figcaption></figure>

Define, who can use this connection. There are three options:

* Project admins
* All project members
* Specific users and groups&#x20;

{% hint style="info" %}
Please note that the access setting can be changed later.
{% endhint %}

After defining who can use the connection, click **Connect** to proceed.&#x20;

This will open a separate browser window and to use the integration, user must sign in to Leica ConX, by using needed credentials.

<figure><img src="https://1605669813-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqIBa9qorv0XHooVd4ozT%2Fuploads%2FSoU4CY7PQtzT2xz64Zrt%2Fimage.png?alt=media&amp;token=984f7b6a-9ead-46f3-8c67-4636709dc14e" alt=""><figcaption><p>Leica ConX login page, will be in local language. </p></figcaption></figure>

After successful sign in, user must select a ConX project to connect to.

<figure><img src="https://1605669813-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqIBa9qorv0XHooVd4ozT%2Fuploads%2FK169Q1cWFoTXy6oSXuMg%2Fimage.png?alt=media&amp;token=fe41890c-33bb-46d3-9344-57e37b6a60fb" alt=""><figcaption><p>Select a ConX project to connect with Site Management project</p></figcaption></figure>

{% hint style="info" %}
If the listed projects are already connected to Site Management, user must access ConX and create a new project.&#x20;

Please note that Leica ConX project can only be connected to one Site Management project.
{% endhint %}

Once user has successfully connected ConX and Site Management project, the integration is ready to be used.&#x20;

## Using the integration

### Map tab

First view of the integration is called Map, which has two main features; live machine locations and as-built points.

<figure><img src="https://1605669813-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqIBa9qorv0XHooVd4ozT%2Fuploads%2FoVVDm9vyWM5Yy6QrNWxs%2Fimage.png?alt=media&amp;token=63fe5c60-fad6-43f1-a40d-059773f16c8b" alt=""><figcaption><p>Map tab</p></figcaption></figure>

Activating the checkbox in front of the feature, will active the feature.&#x20;

As-built points can be filtered based on date.&#x20;

### Files tab

Next tab is Files, which is opens up the file component.&#x20;

<figure><img src="https://1605669813-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqIBa9qorv0XHooVd4ozT%2Fuploads%2F4SJvENhLcjOriBfTWaaG%2Fimage.png?alt=media&amp;token=65d8f18f-8593-4328-94e8-c284479b2e7c" alt=""><figcaption><p>Files tab</p></figcaption></figure>

Left side shows the files and folders in Site Management and right side shows the files and folders in Leica ConX project.&#x20;

File sending is done by selecting a file from the wanted side, navigating to other side to the wanted folder and clicking the arrow to the correct direction.&#x20;

By clicking three vertical lines above the folder structure, user can, for example, create new folder to either system.&#x20;

{% hint style="info" %}
The connection is live, so once the file is sent to either direction, it is available immediately in the system.&#x20;
{% endhint %}

### Users tab

Users tab is meant to use to manage who has access and can use the integration.&#x20;

<figure><img src="https://1605669813-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqIBa9qorv0XHooVd4ozT%2Fuploads%2FQuq3hkT7Srs1A6K9UTMo%2Fimage.png?alt=media&amp;token=be89e0a0-a00b-4aad-a7f5-394a54f3a79b" alt=""><figcaption><p>Users tab</p></figcaption></figure>

The same setting is available, when the connection is first created. As a reminder, the possible settings are:&#x20;

* Project admins
* All project member
* Specific users and groups

### Connection tab

Last tab is used to disconnect Site Management and ConX project from one another.&#x20;

<figure><img src="https://1605669813-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqIBa9qorv0XHooVd4ozT%2Fuploads%2FhwkGeVZYTy62YFFXxsgT%2Fimage.png?alt=media&amp;token=2e1b0bd7-da1b-4444-a960-8737ff492b2e" alt=""><figcaption><p>Connection tab</p></figcaption></figure>

Clicking disconnect will open a confirmation view and user must reclick the disconnect.&#x20;

<figure><img src="https://1605669813-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqIBa9qorv0XHooVd4ozT%2Fuploads%2F0VsfMxbaI0rpUGau59RN%2Fimage.png?alt=media&amp;token=c68207a2-48d6-4b78-9e8d-365fd7dca8e4" alt=""><figcaption><p>Confirm disconnection</p></figcaption></figure>

Like described in the text, this will only disconnect Site Management from Conx, but not the other way around.&#x20;

To revoke the connection from ConX, access Configure > Integration > Revoke in ConX user interface.&#x20;

After this, the connection can be re-established if needed, by following the workflow described in the Setup section.&#x20;