Using the macro

Unable to access an EA Repository in Confluence Macro

If you are unable to access the configured EA repository in Confluence, this may be due to one of the following reasons: 

1. The configured user (User ID) has been deleted. 

2. The user’s access has been modified in Prolaborate for the Confluence integration. 

3. The repository is inactive in Prolaborate. 

Please check if the configured user is available in Prolaborate’s ‘User Management’ and grant appropriate permissions under ‘Access Permissions’ if necessary. Click here to know more about access permissions. 

Check this guide to troubleshoot issues with a Repository when inactive in Prolaborate.

No results in Confluence macro

Please consider the following reasons that may cause an issue: 

1. The configured user’s access (User ID) might have been changed. 

2. The Repository may not be active in Prolaborate. 

To resolve this issue, kindly verify if the configured user has the required permissions (Menu > Access Permissions). You can also refer to this guide for troubleshooting inactive Repository issues.

Unauthorized Request or Authentication Failed

This reason can be any one of the following: 

1. You do not have the required license for the Integrations add-on. If you have already purchased it, please contact the Prolaborate team. Otherwise, you can buy the add-on. Learn more about this add-on here. 

2. The macro configuration was unable to authenticate due to a security token change or removal. Please review the Application Access Settings page for more information. 

Unable to connect to Prolaborate

This reason can be any one of the following: 

1. You do not have the required license for the Integrations add-on. If you have already purchased it, please contact the Prolaborate team. Otherwise, you can buy the add-on. Learn more about this add-on here. 
2. The macro configuration was unable to authenticate due to a security token change or removal. Please review the Application Access Settings page for more information. 

Unable to Retrieve Information

The reason can be one of the following: 

1. The published model information is no longer available in the EA model 

2. The access of the configured user (User ID) has been altered 

3. The Repository is not Active in Prolaborate. 

Please check whether 

1. This item is available in the EA model. 

2. To check whether the configured user has the necessary permissions, navigate to Menu> Repository Configuration> Access Permissions. 

3. Check whether the repository is active. If the repository is not active, troubleshoot using this guide.

Repository is Inactive

This error message shows up when the Repository is Inactive in Prolaborate. 

Go to Prolaborate and change the status to Active by doing the following 

1. Click on Edit icon on a repository 

2. Enable the Active button under the Repository information 

3. click on Update Repository 

Access Restricted

This message appears when the access of the configured user (User ID) has been modified. Please check whether the user has the necessary permissions to access the package in Prolaborate.  

You can verify the access permission by navigating to Menu > Repository Configuration > Access Permission. 

Click here to learn about Access Permissions.

 Invalid Configuration

There might be one of the following reasons: 

1. The specified user (User ID) has been removed or altered in Prolaborate.  

2. Access permissions for the user have changed. 

Please check that the configured user is available in Prolaborate.  

To confirm this, go to Menu > Portal Settings > User Management and ensure that the user has the relevant privileges. To do this, navigate to Menu > Repository Configuration > Access Permissions.

Repositories are missing the drop-down list

The reason can be one of the following: 

1. The configured user (User ID) has no permission to access the repository 

2. Include in Repository list option is not enabled. 

Please check whether the configured user is available in Prolaborate.  

To confirm this, go to Menu > Portal Settings > User Management and ensure the user has the relevant privileges. To do this, navigate to Menu > Repository Configuration > Access Permissions.  

Also, follow the steps to enable Include in Repository list in Macro Configuration to see the other repositories in the drop-down list 

1. Click on Edit on the Macro configuration page 

2. Click on Connect 

3. Enable the Include in Repository list option under Manage repositories 

4. Click on Save

Repositories are missing in the Manage Repositories

The reason can be one of the following: 

1. Repositories are not added in Prolaborate 

2. The configured user (User ID) has no permission to access the repository 

Refer to this link to add the repositories in Prolaborate and give the user access to the repository. To do this, go to Menu > Portal Settings > User Management and ensure the user has the relevant privileges. To do this, navigate to Menu > Repository Configuration > Access Permissions.

Composite Diagrams

To allow access to the top-level and sub-level models easily, please do the following: 

1. Log in to Prolaborate as admin 

2. Open the relevant repository 

3. Click on Menu > Repository settings 

4. Enable Open Community Access (Not recommended when your Prolaborate site is accessible through Internet) 

5. Go to Confluence and add the top-level model in a Confluence page 

Now, your users can view the top-level model in Confluence. If they want to view the sub-level models, they can 

1. Click on this icon 

2. This diagram will open in a new tab

3. They can double click on the top-level models, and they will be taken to the sub-levels (#4 above is needed to make this step work)

Viewing package contents within Confluence

You can use the Prolaborate 4 macro and HTML macro to publish Prolaborate content to Confluence. 

Please make sure that the Open Community Access feature is enabled. Otherwise, this process will not function as expected. 

Here is how it is expected to work. 

Diagrams are not displayed when exporting Confluence pages as PDF

Diagrams added to Confluence through the Prolaborate Macro are not displayed ibecause Confluence doesn’t include dynamic content, like these diagrams in the exported files such as PDF