How Do I Start an AgilePoint Process When I Create a SharePoint List Item with PowerShell?

Prerequisites

• AgilePoint NX OnPremises or AgilePoint NX Private Cloud.
• SharePoint Integration in an on-premises environment.
• PowerShell is installed on the appropriate SharePoint machines.
• Set the WsHttp Server URL in the AgilePoint Configuration List.

  For more information, refer to Set the AgilePoint Configuration List for SharePoint Integration On Premises.

• Create a process-based app to start from SharePoint.
• Publish a process-based app.

  For more information, refer to (Example) Save, Check In, and Publish a Process-Based App.

  .
• Associate your AgilePoint process with a SharePoint list.

Good to Know

• If the prerequisites are met, once you create the list item with PowerShell, your process starts.

How to Start

1. On the primary SharePoint front-end web server, open the PowerShell command line tool.

   For SharePoint 2013, the default location is Start > Microsoft SharePoint 2013 Products > SharePoint 2013 Management Shell.

Procedure

1. Use a PowerShell script to create a list item to start an AgilePoint process.

   Format:

   $web = Get-SPWeb {Your SharePoint site URL}
     $list = $web.Lists["{list name}"]
     $items = $list.Items
     $item = $items.Add()
     $item["Title"] = "{list item name}"
     $item.Update()

   Example:

   $web = Get-SPWeb http://win2012r2:30198
     $list = $web.Lists["Customer List"]
     $items = $list.Items
     $item = $items.Add()
     $item["Title"] = "Acme Inc."
     $item.Update()