Relatics provides users with the ability to relate and manage all data relevant to a systems engineering model. In some situations, however, it might be preferred that data be stored and edited in Microsoft Graph. Therefore, it is possible to integrate Microsoft Graph with Relatics. If Graph is integrated with Relatics, you can relate documents managed in Graph to your elements. The Relatics interface keeps the documents up to date by automatically synchronizing them. Thus, even when other applications also store files for your project in Graph, you always have the current set of documents available in Relatics.
After integrating Microsoft Graph and connecting it to your workspace, you can choose which external type element will be filled (automatically) with data from Graph. This data cannot be edited from within Relatics, but it will be synchronized. So changes made in Graph will be automatically visible in the workspace.
Prepare Graph client for Relatics *
- In the environment administration, click on Application authentications.
- Click on New key. This opens a dialog wherein you can configure the authentication client.
- In the field Name give the Graph client you are about to integrate a relevant name.
- In the field API select Microsoft Graph. The dialog will now update and show the fields to be filled out.
- In the field Client ID provide the Client ID of the Graph client.
- In the field Client Secret provide the Client secret of the Graph client.
- In the field Tenant ID provide the Tenant ID of the Graph client.
- In the field Environment provide the environment of the Graph client (Example: company.sharepoint.com).
- Click on Create. Relatics will check if the connection to the Graph client you just integrated is working.
Give workspace access to Graph access key *
- In the environment administration, navigate to and click on the Graph access key containing the data you want to integrate into a workspace.
- Check if Status is set to enabled. If not click on the icon and in the following dialog toggle Status to enabled. Press Update.
- Link the access key to the desired workspace by pressing the icon next to Workspaces with permission and selecting it from the dialog. Press Update.
Integrate Graph client into workspace **
- Create a new external type element.
- In the workspace menu, click on Application integration.
- Click on New interface, located at the top of the table Interfaces for synchronizing with an external application. This opens a dialog in which you can configure the Graph interface.
- In the field Name, give the Graph interface you are about to integrate a relevant name.
- In the field Type element (with ‘Ownership in’ an external application), select the external type element you created in step 1.
- In the field Setup, select Optimized for Microsoft SharePoint Online.
- In the field Key to access external application, select the name of the Graph access key. Wait until the dialog updates and shows new fields.
- In the field SharePoint site, select the name of the Graph site.
- In the field SharePoint list(s), select the Graph folders you need.
- Click on Create
Map an externally managed property to a Graph client value
- Add a type property with the ownership in an external application to the type element with external ownership.
- In the workspace menu, click on Application integration.
- Open the detail page of the Graph client interface by clicking on the row.
- Click on Add property mapping. This opens the dialog New property mapping.
- In the field Mapped from, select the Graph client field you want to map.
- In the field Property, select the type property of your type element.
- Click on Create.
* In the environment, the administration role of your user must be set to administrator to enable this feature. ** In the workspace, the user type of your user must be set to power user to enable this feature.