ContentListener AgileConnector

The Content Listener AgileConnector extension enables you to initiate processes on items in a SharePoint list or library based on conditions you specify. The Content Listener AgileConnector runs a CAML query based on a schedule you specify to evaluate the items in the SharePoint list and initiate the appropriate processes.

For example, you could initiate an escalation processes for all items in a SharePoint list that are designated high priority or past due.

Background and Setup

To configure an AgileConnector, ​ 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

Enable the ContentListener AgileConnector

To enable the ContentListener AgileConnector, ​ do the procedure in this topic.

How to Start

  1. On the AgilePoint Server Configuration screen, in the Integrations tab, click Add.

    Click Add

Procedure

  1. Go to the assembly (AgilePoint Server installation folder) C:\Program Files\AgilePoint\AgilePoint Server\bin\Ascentn.AgileConnector.ContentListener.dll.
    Note: The Name field will be auto-populated, DO NOT change it. Leave the Impersonator field blank.
  2. Click OK.

Configure the ContentListener AgileConnector

To configure the ContentListener AgileConnector, ​ do the procedure in this topic.

Prerequisites

How to Start

  1. On the AgilePoint Server Configuration screen, in the Integrations tab, select ContentListener.
  2. Click Configure.

Fields

Field NameDefinition
Add Task

Creates a new task.

Delete Task

Removes an existing task.

SharePoint Access Credentials

The credentials you wan to use to authenticate to SharePoint.

  • AgilePoint System Account - The standard AgilePoint system account
  • Custom Account - Credentials for an account you specify in the Domain, User, and Password fields.
Schedule Name

A name for the schedule.

Site

The URL of the SharePoint site associated with the process.

List

The SharePoint list associated with the process.

Process

The process model to use for the initiated process.

CAML Query

Specifies the CAML query used to initiate the process.

You can type or paste a CAML query in the box, or click the Ellipses button to open the CAML Query Configuration screen.

For more information, refer to CAML Query activity.

Recurrence

Specifies the schedule to run the CAML query. Options are:

  • One Time - The schedule occurs only one time.
  • By Minute - The schedule occurs once every specified number of minutes.
  • By Day - Recurs at the specified time on the specified interval of days.
  • By Week - Recurs at the specified time on the specified days.
  • By Month - Recurs at the specified time on the specified days of the specified months.