Skip to content

Getting Started

This section will take you through the steps to set up a collaboration between your own tenant and the tenant of your collaboration partner. When you want to register a new collaborating partner, please contact your Customer Success Manager in FutureOn. They will ensure the Collaborator is registered with the correct endpoint.

Creating a collaboration

The Collaborate icon is now available to the left of the open project button:

Screenshot

Click on the icon to launch FieldTwin Collaborate. To start a collaboration, select the Collaborations option. This will display a list of your project(s) (Note: Only Projects within an Enterprise License will be listed) .

Screenshot

If you do not have an Enterprise license for your tenant, you will see the following screen:

Screenshot

You will then need to contact your Customer Success Manager in FutureOn to be able to proceed.

Project Share

Select the project you want to share from the list:

Screenshot

This will show you the information on who owns the project and if there are any Local Backdrop(s) linked to this project.

Local Backdrop - If you want Local Backdrop(s) shared together with the project, then toggle the corresponding Active check box.

External Backdrop - This section will display any External Backdrop(s) linked into this Project (e.g., project shared from an external collaborator back to you).

Select Subproject

You will now need to select the subproject from the selected project you would like to share to the external collaborator. The selected subproject will be the only subproject shared in the collaboration. NOTE! If you selected the local backdrop to be shared in the previous step, this sub project will also be shared.

Screenshot

Select Collaboration

Select the company you want to start a collaboration with from the list of registered external collaborators. The selected sub-project will then be shared with them. NOTE! If no list is available, please contact your Customer Success representative as they have to register these for you.

Screenshot

Select User Roles

Select the User Role you want the External Collaborator to have on your shared sub project. You can check the user role by clicking the "i" icon after you have generated the token. You can at any time change the user role during the collaboration, and the change will take effect on the other side the next time they load the project or refresh it.

Screenshot

Mail

In this field you will need to input the corporate email address for the recipient of the collaboration NOTE! This needs to be an Account Administrator in the collaborators tenant.

Screenshot

Generate and share

To initiate the collaboration, you will then need to click the Generate and share token button to generate the secure token that will be sent to your external collaborator.

Screenshot

List of collaborations

Once you have initiated one or more active collaborations you will see the list of ongoing collaborations initiated by you in the bottom right part of your screen (NOTE: The Collaboration needs the "is shared" checkbox turned on to share data).

Screenshot

This list allows you to activate/deactivate the sharing session or to delete it.

Active - Activate/Deactivate the project sharing by checking the is shared checkbox.

Revoke - Press this button to delete the ongoing collaboration session of this project.

User Role - Press the blue "i" icon to see the user roles currently active on the shared project.

Once the invitation to collaborate is accepted the question mark will turn into a green tick.

Screenshot

Receiving an invite

When someone is inviting you to start a collaboration you will receive an email invitation as shown below:

Screenshot

Open the email and click on the here link in the email to accept the invitation to collaborate. Note! We strongly recommend that you verify that this email invitation has been initiated by a trusted collaboration partner before you click it.

External Collaborations

Once you have accepted the invite you can select the External Projects entry and a list of the current active projects shared with you from the external tenant will appear as shown below:

Screenshot

By selecting a project in the list you will see the basic information on who owns the external project for your collaboration and when it was last updated. In the middle section you will see which project in your own tenant and instance that is currently linking this shared project in as a backdrop. And finally, the right hand side of the screen displays the user rights you currently have been assigned for the selected project.

Screenshot

Use of sub project versions

You can now select to use a specifc version of a subProject as a Backdrop. Either as a local backdrop or as an external backdrop as shown below:

Sub Project Versions

Versions - In the Versions column select the version you want from the drop down list.