Please enable JS

Enterprise Architect and Microsoft Teams Integration

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

There is no export/import or copy/paste needed and everyone can discuss on the most up-to-date information from the EA models.

Generate Security Token

While this is optional, it is recommended for enhanced security.

Click on Menu > Application Access Settings. Enable the settings.

Enter Application Name (say Microsoft Teams), the Teams link, Description (optional), and click on Add Application.

An entry would be added.

You can click on the key icon to view and copy the security token.

Add Prolaborate App

Click on Apps and search for Prolaborate.

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

Configure App

Search for Prolaborate using the search bar and select it.

Click on the ellipsis icon as shown above and then on Settings.

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
Token Security token generated in the previous section
User Id A Prolaborate user’s email id. Detailed notes below.

Click on Connect.

If the connection is successful, you will be shown the list of repositories you have created in Prolaborate.

Select a Repository and click on Save.

Relevance of User Id

You might have configured the complete EA model in Prolaborate but you might not want to expose everything to Teams users. If yes, this can be easily achieved by following these steps:

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

Please note:

  1. This user should NOT be an 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 Teams channel and type @Prolaborate.

Select the Prolaborate app.

Enter a keyword or name of a diagram to search.

Select a diagram and click on Send.

The current state of the diagram will be posted in the channel.

The modelers can discuss with the business stakeholders easily.

If there are any changes to the diagram after it is shared here, the users can click on Open in Prolaborate to see a real-time view of the diagram.