Enterprise Architect and Microsoft Teams Integration

Prolaborate makes it easier to share real-time architecture and modeling information from your Sparx Systems Enterprise Architect (EA) models to Microsoft Teams.

There is no need to export/import or copy/paste data. It can be an open discussion on the most recent information from the EA models in Microsoft Teams.

Generate Security Token

In Prolaborate, click on Menu > Integrated Application- Access Management > Add Application
Enter the details as mentioned below.

Field	Description
Name	Enter the application name
Application ID	Last Name
Authorization	You need to choose the required Authorization from the list.
Scope	You need to choose the required Scope from the list.
Generate Security Token	Please Enable the Toggle Button
Enhance Security using PKCE	Please Enable the Toggle Button
Redirect URL’s	Please skip this field
Post Logout URL’s	Please skip this field

Click Save once the details are entered.

Once saved, a Security Token Popup window will appear. Copy the Application ID and Token from this window. The file can also be downloaded as a CSV file.

Close the window once the token is copied.

If successfully added, users can see the application in Integrated Applications- Access Management.

Users can copy the security token by clicking the key icon.

Add Prolaborate in Teams

To add Prolaborate in Microsoft Teams, click on Apps and search for Prolaborate.

Click on it and then on Add. Prolaborate will be added to Microsoft Teams.

If you are not able to find Prolaborate, download it using this link.

Configure Prolaborate

To configure Prolaborate in Microsoft Team, click on the Plus icon in a chat and search for Prolaborate.

Right-click on Prolaborate and click on Settings.

If you are using Prolaborate V4 or V5, choose the product version as V4.X and fill the form as per instructions below.

Field	Description
Protocol	Protocol of Prolaborate website
Server	IP address of Prolaborate application server or its URL
Port	(Optional) Port of Prolaborate site
User Id	A Prolaborate user’s email id. Detailed notes given below.
Client Id	Client Id which is entered in Prolaborate while adding Microsoft Teams
Client Secret	Security token generated as instructed in the previous section

Once the details are entered, click on Connect.

If the connection is successful, the list of repositories available in Prolaborate will be displayed.

Select a Repository and click on Save.

Relevance of User Id

You might have configured the complete EA model in Prolaborate but might not want to expose everything to Teams users. This can be easily achieved by following the below steps:

• Create a new user in Prolaborate
• Set access only to the repositories, packages, diagrams, and objects which you want to expose to Teams users
• Use the email id of the user while configuring the Prolaborate app in Teams

Note:

1. Prolaborate user should NOT be a SSO user
2. There is no mapping done between Microsoft Teams or Prolaborate/EA users. The sole purpose of specifying a user in the configuration is to control what Teams users can see.

Share Diagrams and Collaborate

Open a chat and click on the Plus icon in a chat and search for Prolaborate. Click on it, search for a diagram using a keyword and select it to add it to the chat.

After selecting the diagram, click on Send. The diagram will be posted in the chat.

Microsoft Teams can be used to have discussions between the modelers and the business stakeholders. 

 A real- time view of the diagram can be seen by clicking Open in Prolaborate to view any changes made to the diagram.