Configuring SharePoint Server

<< Click to Display Table of Contents >>

Navigation:  Bizagi Studio > Bizagi from external applications > Portals integration > Bizagi Web parts for SharePoint > Bizagi Web parts for SharePoint On Premises >

Configuring SharePoint Server


This article describes how to configure Bizagi Web Parts for SharePoint, once you have installed them to your SharePoint server.

For more information about Bizagi Web Parts and their installation, refer to Installing the Web Parts.


What you need to do

Before you start to use Bizagi Web Parts, perform the initial Web Parts central configuration (required only once), to specify details regarding  the connection between your SharePoint server and your Bizagi Work portal.


Web Parts central configuration

Carry out the following configuration on SharePoint sites through a browser.


1. Locate the Site actions drop-down option, and click Site settings.

Find the installed Bizagi Web Parts under the SharePoint Extensions category.


Click Bizagi Configuration.




2. Locate the Configuration list at the right hand side, and click it.




You see a list that contains one or more items.




3. Add a new item and enter its details (namely connection details) as described:

Bizagi project name: The name that identifies this item's purpose (connecting to a specific Bizagi Work Portal).

It should be unique and describe the Bizagi project to be integrated.

Bizagi project URL: The URL location to your Bizagi Work portal.

Should be specified as: http://[BIZAGI_SERVER]/[PROJECT_NAME]

Shared domain: This is the domain where the SharePoint and Bizagi BPM servers are included, must be the same for all of them. This field is mandatory.

Cookie path: This is the URL path that must exist in the requested resource. For example, if you set the cookie path as /company any URL that begins with /company is valid. By default this parameter is / when it is leaved empty.



Users accessing the Web Parts need to be created as users in Bizagi.




Click Save to complete Web Parts central configuration.



Changes in the configuration list usually requires resetting the IIS server of your SharePoint services.


Notice that:

You may click Edit Item to modify the connection details at anytime.

You may also add items (should you be integrating with more than one Bizagi Work Portal).




Once you have completed Web Parts central configuration, you are ready to start using Bizagi Web Parts for SharePoint directly in SharePoint content.

For more information about this, refer to Using the Web Parts.


Machine Key

The machine key of the SharePoint web application and the Bizagi BPM Work Portal web application must be the same one.  We recommend copying the SharePoint web application machine key, and set the same one it in the web.config of your Bizagi project. To do that, open the folder of your project:




Select the web.config file, and overwrite the machineKey key. For example, the final machine key looks something like this:


<machineKey validationKey="B9CD...." decryptionKey="715..." validation="HMACSHA256" compatibilityMode="Framework20SP1" />


It is very important to add the compatibility attribute, because Web Parts need to maintain compatibility with the framework 2.0 SP1:




Additional considerations

Follow these considerations when using the Web Parts.


1. IIS optimization settings

When integrating Bizagi in portals, adjust the settings for your Bizagi Work portal so that resources stored in the IIS cache are delete less frequently.

Since users will not be accessing Bizagi Work portal on a regular basis.


For Bizagi work portal setting for the IIS, you would need to edit its application pool so that recycling is optimal for your demands.

This would imply:

Disabling Recycling by assigning Regular time interval to zero.

Editing the Idle Time-out minutes so that information in worker processes and cache are not discarded quickly (e.g within two days).




2. Internet Explorer considerations

For the Bizagi Web Parts to be displayed, you need to check browser support as posted at Bizagi requirements, especially for Internet Explorer since there are old versions which are unsupported, even if you are using them on your SharePoint environment.


Bizagi Web parts relies on SharePoint compatibility related to browsers. The following table explains the browser version you can use based on the SharePoint version:


Sharepoint On-Premises version

Browsers supported


Internet Explorer version 8 and 9 only (versions 10 and 11 are not supported by Microsoft in Windows 10 OS,  therefore Web Parts is not fully compatible , refer to Plan Browser Support)

Google Chrome (latest version)

Mozilla Firefox (latest version)


Internet Explorer 8, 9, 10 and 11

Google Chrome (latest version)

Mozilla Firefox (latest version)


3. HTTPS and certificates

If you are using HTTPS on your Bizagi server, make sure that its server certificates are valid and up-to-date. Otherwise the Web Parts will not be able to connect to Bizagi services.


4. Setup for the geolocalization feature

If your Bizagi project enables the Geolocalization feature, make sure you perform the following adjustments to your SharePoint site configuration:


Edit the SharePoint site's web.config file to include the following custom header (inside of the <customHeaders> element):
<add name="X-UA-Compatible" value="IE=edge" />


Locate the whole <system.webServer> element.

In it, you should have a definition looking somewhat like the image below:




Save the changes.


For this to work, the master page in SharePoint must NOT include:

<meta http-equiv="X-UA-Compatible" content="IE=8"/>