Configuring the SharePoint Integration AgileConnector

To configure the SPSIntegration extension, ​do the procedure in this topic.

Prerequisites

How to Start

  1. On the AgilePoint Server machine, in Windows Explorer, right-click the file (AgilePoint Server installation folder) C:\Program Files\AgilePoint\AgilePoint Server\WCFConfigurationUtility.exe, and click Run as Administrator.

    Configuration Utility Run As Administrator Screen
  2. On the AgilePoint Server Manager screen, in the left pane, select your AgilePoint Server instance.

    Select AgilePoint Server Intance
  3. Click Open Server Configuration Open Server Configuration icon.

    Click Open Server Configuration
  4. On the AgilePoint Server Configuration screen, click the Integrations tab.

    Click Integrations Tab
  5. On the Integrations tab, select SPSIntegration.
  6. Click Configure.

Instructions

  1. On the AgileConnector for SharePoint screen, configure the following fields as necessary for your environment, and then click OK.
Field NameDefinition

Max Threads for SharePoint Access
Description:
Specifies the maximum number of concurrent connections between AgilePoint Server and SharePoint.
Allowed Values:
An integer.
Default Value:
10

Windows Authentication
Description:
Specifies if AgilePoint uses Windows Authentication to connect to SharePoint.
Claims Authentication
Description:
Specifies Claims authentication options for SharePoint.
Allowed Values:
If this setting is selected, these types of Claims Authentication are available:
  • Form Based Authentication - Activates Forms based authentication where a custom membership provider to connect to an on-premises SharePoint environment.
  • Microsoft 365 - Activates Claims authentication to connect to SharePoint in an Microsoft 365 environment. You can use this setting side-by-side with on-premises SharePoint.
  • Federated Authentication - Activates Federated authentication to connect to SharePoint — for example, ADFS.
    Note: Out of the box, AgilePoint supports ADFS authentication. If you want to use your own authentication provider, see Federated Authentication Example.
Default Value:
Deselected

Domain
Description:
The authentication domain.

This does not apply to Form Based Authentication.

Username

The user ID of the SharePoint authentication account.

Password
Description:
The password for the authentication account.
Allowed Values:
An alphanumeric string that represents a password.
Default Value:
None
Accepts Variables:
Yes

Fed Auth Url
Description:
The URI of the federated authentication provider. This provider supplies security tokens for federated authentication.
Allowed Values:
A valid federated authentication provider URI.
Default Value:
None
Accepts Variables:
No
Example:
https://fs.agilityclouds.com

Use UTF8 Encoding
Description:
Specifies whether to use UTF-8 encoding when communicating with the external system.
Allowed Values:
  • Selected - Specifies to use UTF-8 encoding.
  • Deselected - Specifies not to use UTF-8 encoding.
Default Value:
Deselected

Send Notification for Suspended Processes
Description:
Specifies whether the SPSIntegration AgileConnector sends a notification to the AgilePoint system administrator if a process instances is suspended as a result of a SharePoint Integration error.
Allowed Values:
  • Deselected - No e-mail notification is sent.
  • Selected - Sends an e-mail notification if a process instance is suspended.
Default Value:
Deselected