List Form

This AgileShape can be used to leverage a SharePoint List as the form UI for manual tasks. This feature provides an easy way of building forms with different views based on a SharePoint List. A simple configuration window allows you to determine how fields on the form are displayed to the end-user (e.g. Editable, Locked, or Hidden). This drastically simplifies the effort and time required to build UI forms and therefore, building processes has become even easier for business users.

Properties for This AgilePart

Field Name	Definition
UserDefinedProperties	Note: Developers may need to write code to fully implement this. This property allows the process modeler to configure initial ClientData values that will be associated with the AgileShape's associated task(s) at runtime. This is basically a way of allowing you to specify a set of name/value pairs that are passed to your Web page via an object called a WorkItem. This is an alternative to passing data via URL parameters. In your Web page you can retrieve this data via the ClientData property of the WorkItem. It is then up to you to decide how to use the data. Click the Ellipses button to open the configuration dialog.
ListForm Controls	Once a SharePoint List is created and associated to the process model, this property specifies the view characteristics of each SharePoint List form field for the selected work to perform view such as Edit, Lock, and Hide. Click the Editable, Read Only, or Hidden field to make a field editable, read only, or hidden when it is served to the end user at runtime.
SubmitStep	Default value: False This property should be set to 'True' if the Form is used as the Submit step (i.e. the first step where you are creating the list item). Note: If you have configured a custom field as 'required' in a SharePoint list, it must be editable on the Submit step, or SharePoint will throw an exception. Note: If you have configured a field to be of type ' Multiple lines of text' the field cannot be configured as 'Read Only'.

Field Name

Definition

UserDefinedProperties

Note: Developers may need to write code to fully implement this.

This property allows the process modeler to configure initial ClientData values that will be associated with the AgileShape's associated task(s) at runtime. This is basically a way of allowing you to specify a set of name/value pairs that are passed to your Web page via an object called a WorkItem. This is an alternative to passing data via URL parameters. In your Web page you can retrieve this data via the ClientData property of the WorkItem. It is then up to you to decide how to use the data.

Click the Ellipses button to open the configuration dialog.

ListForm Controls

Once a SharePoint List is created and associated to the process model, this property specifies the view characteristics of each SharePoint List form field for the selected work to perform view such as Edit, Lock, and Hide.

Click the Editable, Read Only, or Hidden field to make a field editable, read only, or hidden when it is served to the end user at runtime.

SubmitStep

Default value: False

This property should be set to 'True' if the Form is used as the Submit step (i.e. the first step where you are creating the list item).

Note: If you have configured a custom field as 'required' in a SharePoint list, it must be editable on the Submit step, or SharePoint will throw an exception.

Note: If you have configured a field to be of type ' Multiple lines of text' the field cannot be configured as 'Read Only'.

AgileWork Properties

The properties of the basic AgileWork AgileShape are also included in this AgileShape. For more information, see AgileWork.

Parent topic: SharePoint / Microsoft SPS