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 overview with workspaces, click on
Environment administration.
- In the view Environment administration, click
Application authentications, then External Application Keys.
- In the view External Application Keys, 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 overview with workspaces, click on
Environment administration.
- In the view Environment administration, click
Application authentications, then External Application Keys.
- In the view Access keys to external applications, 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 it is set to disabled, 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 a workspace from the dialog. Press Update.
Integrate Graph client into workspace **
- Create a new external type element.
- In the workspace menu, click on
Settings.
- Click on the menu
Application integration, then Receiving data. - Click on
New interface, choose Microsoft SharePoint Online. This results in the dialog Create interfaces for receiving data (Microsoft SharePoint Online). - In the field Name, give the Graph interface you are about to integrate a relevant name.
- In the field Type element, select the external type element you created in step 1.
- 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 document libraries, select the SharePoint folders you need.
- Optional, tick the checkbox Update ‘relaticselementurl’ in external system to give Sharepoint a direct link to the matching element.
- Click on Create.
Note:
- A prerequisite for the feature Update ‘relaticselementurl’ in external system is:
- that all the selected Sharepoint folders need to have the column ‘relaticselementurl’ of the type single line text.
- the selected Key to access external application needs authorization to write data to SharePoint.
- When multiple workspaces use the same SharePoint site, the relaticselementurl feature is not recommended. Each interface will overwrite the hyperlink with each sync.
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
Settings.
- Click on the menu
Application integration, then Receiving data. - 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 From, select the Graph client field you want to map. When selecting the custom field, the Technical fieldname field is mandatory.
- In the field Mapped to property, select the type property of your type element.
- Click on Create.
* In the environment, the user must have an Environment user type of Environment manager or higher. ** In the workspace, the user type of your user must be set to power user to enable this feature.