› Integration › SharePoint › Configure TotalAgility actions resulting from SharePoint events › Configure a create new case action

Configure a create new case action

Configure a Create new case action for an event against an item in SharePoint. For example, set up the Create new case 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 events.

    The Edit SharePoint site configuration dialog box is displayed.

  2. 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.

  3. Click for Events.

    The New SharePoint event configuration dialog box is displayed.

  4. On the Select source list, select a source.
  5. On the Event list, select the event for which to configure the TotalAgility action, such as ItemAdded.
  6. On the Action list, select Create new case.
  7. In the Case box, select the case map on which to create a new case, or click and enter an inline value.

    If the case map that is used to create a new case has any initialization parameters, the parameters appear under Initialization variables.

  8. Select a dynamic value or enter an inline value for Case reference.
  9. Map the metadata to initialization parameters by selecting the metadata in the Value box for each parameter.
  10. Click Save to save the event configuration.
  11. In the Edit SharePoint site configuration dialog box, click Save.

    TotalAgility creates a case on the selected process map at runtime and displays the correctly populated variables.

    Similarly, you can set up a Create case Job action for the other SharePoint events against a 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 is suspended at runtime. The details of the error appear in the Event Log.

See also: