› Integration › SharePoint › Configure TotalAgility actions resulting from SharePoint events › Change state action

Change state action

Configure a Change state action for an event against an item in SharePoint. For example, you can set up the Change state action for the ItemAdded event against a document library in SharePoint.

  1. On the SharePoint page, select the site for which you want to configure the events.

    The Edit SharePoint site configuration dialog box is displayed.

  2. Enter the Receiver service URL and click Save.

    You can configure events only when you specify the Receiver service URL and save the URL.

  3. In the Receiver service URL field, enter the name of the Receiver service URL in TotalAgility, which is a web service URL that SharePoint communicates to when an event occurs. For example, http://<KTA server name>/Services/Core/Integration/SharepointReceiverService.svc

    • This URL must be accessible from the SharePoint server.

    • You can configure events only when you specify the Receiver service URL and save the URL.

  4. Click for Events.

    The New SharePoint event configuration dialog box is displayed.

  5. On the Select source list, select a source, such as Shared Documents.
  6. On the Event list, select the event for which you want to configure the TotalAgility action, such as ItemAdded.
  7. On the Action list, select Change state.
  8. To display the state of a job at runtime, select the dynamic value or click and enter a static value for Job ID and State.
  9. Click Save to save the configuration.

    The event is added and displayed in the table under Events.

  10. In the Edit Exchange site configuration dialog box, click Save.

    When an item is added to a document library in SharePoint, the state of the job changes to the state specified when configuring the event.

  11. Click Save to save the event configuration.
  12. In the Edit Exchange site configuration dialog box, click Save.

    When a folder is created in the Exchange system, a job in case is created on the selected process map at runtime displaying the correctly populated variables.

    Similarly, you can set up a Change state action for the other SharePoint events against forms library, Wiki library, picture library, contacts, discussion board, announcement, agenda, links, calendar, tasks, issue tracking, survey, and custom list in SharePoint.

    If there are insufficient privileges, the parameter values supplied are incorrect or there is a mismatch between the selected location and the TotalAgility Web service, the item is not configured, and the job suspends at runtime. The details of the error appear in the Event Log.

See also: