Welcome > Integration module > Microsoft SharePoint > Configure TotalAgility actions resulting from SharePoint events

Configure TotalAgility actions resulting from SharePoint events

You can configure and execute TotalAgility actions for SharePoint events. For example, you can configure a TotalAgility job that starts when a purchase order is uploaded to SharePoint.

Important When you log on to TotalAgility on Integration Server, you can configure the events in the same way as you would do in TotalAgility on-premise.

When the event is raised on the Integration server, the action is executed on Azure.

TotalAgility provides the following actions for SharePoint events:

  • Create New Job

  • Create New Case

  • Create Job in Case

  • Change State

  • Raise Event

SharePoint events

You can configure TotalAgility actions for the following events in SharePoint.

SharePoint Event

Occurs

Item Added

When an item is added to the SharePoint repository.

Item Updated

When an item is updated in the SharePoint repository.

Item Deleting

When an item is deleted from the SharePoint repository.

Item Checked In

When an item is checked into the SharePoint repository.

Item Checked Out

When an item is checked out of the SharePoint repository.

Item Undo Check Out

When an item checkout is undone in the SharePoint repository.

Note Events like Item Checked in, Item Checked Out, and Item Undo Check Out help to ensure the integrity of documents by enabling you to require document checkout before editing, view past revisions and restore to previous versions, and set document-specific security.

SharePoint items

The following table outlines the SharePoint events that occur for the custom (user) defined columns in SharePoint.

Actions Performed in SharePoint Triggered SharePoint Events Number of Jobs Created
Add an item

  • Item Added

One job for both adding item and for updating custom defined columns.
Upload an item

  • Item Added

  • Item Updated

Two Jobs:

  • For uploading the item

  • For updating custom defined columns

Check in an item

  • Item Checked In

  • Item Updated (occurs along with the check in.)

  • Item Updated (occurs while updating the custom-defined column properties.)

Three Job:

  • Two for checking the item

  • One for updating the custom defined columns.

When the ItemAdded and ItemUpdated Events (when a custom column is configured) are triggered:

When a document is added to library,

  • Sharepoint adds the document to the library.

  • Sharepoint fires the ItemAdded event.

  • SharePoint displays the property editing screen to the user.

  • User can edit the properties and click on Save.

  • SharePoint fires ItemUpdated event.

  • SharePoint now begins the process of automatically checking-in the document.

  • SharePoint fires ItemUpdated event.

  • SharePoint first ItemCheckedIn event.

Note The first time ItemUpdated event fires, it is in response to the changes of document properties. The second time it fires, it is in response to the document being checked-in. It appears as though it is firing twice in this scenario.