Start List Form activity

An activity that shows a form made with a SharePoint list that lets a user start a process.



Configure the Start List Form activity

To configure the Start List Form activity, do the procedure in this topic.

Video: Using SharePoint List Forms with AgilePoint

Prerequisites

Good to Know

  • ​​To send an e-mail notification, click Advanced Advanced icon > E-mail Notifications E-mail Notifications icon.

    For more information, refer to Configure E-mail Notifications for Any Activity.

  • In most text fields, you can use process data variables as an alternative to literal data values.
  • The Standard List Form activity and Start List Form activity can not be used on the lists where forms-based application is created. The List Form activities are only for legacy applications.
  • Documentation for Integrations with Third-Party, External, or Open Source Technologies

    For examples of use case implementations or configuration field input values for third-party products, AgilePoint recommends these resources.For more information, refer to Where Can I Find Information and Examples for Third-Party Integrations?

    • AgilePoint Community Forums - An AgilePoint-moderated, crowd-sourcing user forum where you can ask questions about specific techniques, the solutions to use cases, workarounds, or other topics that may not be covered in the Product Documentation.
    • Professional Services - If you can not find the information you need for your specific business problem, mentoring is available through AgilePoint Professional Services.
    • Personalized Training - AgilePoint can provide personalized training for your organization. To request personalized training, contact AgilePoint Sales.
    • Third-Party Vendor Documentation - Whenever feasible, AgilePoint provides links to third-party vendor documentation.

      This does not include technology standards or protocols, such as JavaScript, REST, or FTP. Resources for these technical standards are publicly available on the Internet.

How to Start

  1. On the Application Explorer screen, do one of these:
  2. Do one of these:
    • Add an activity:
      1. In the Process Builder, go to the Activity Library, and open the SharePoint SharePoint icon tab.
      2. On the SharePoint SharePoint icon tab, drag the Start List Form Start List Form icon activity onto your process.
    • Change an activity:
      1. In your process, double-click your activity.

List Form Configuration

Specifies if the fields on a SharePoint List Form are editable, read-only, or hidden.

Figure: List Form Configuration screen

List Form Configuration screen

Fields

Field Name Definition

SharePoint

Function:
Specifies the access token that connects to your SharePoint site.
Accepted Values:
A list of access tokens configured for your environment.
Default Value:
None
Accepts Process Data Variables:
No
Example:
Refer to:
Limitations:
  • OAuth 2.0 authentication is not supported for this activity.

Site URL

Function:
Specifies the URL for your SharePoint site.
Accepted Values:
A valid SharePoint site URL.
Default Value:
None
Accepts Process Data Variables:
No
Example:

List

Function:
Specifies the name of your SharePoint list.
Accepted Values:
The name of your SharePoint list.
Default Value:
None
Accepts Process Data Variables:
Yes
Example:
Refer to:

Show All Fields

Function:
Specifies whether to show only the column display names from your SharePoint list in the Customize List Form Interface table.
Accepted Values:
  • Deselected - Shows only the column display names.
  • Selected - Shows the SharePoint internal column names and the columns display names.
Default Value:
Deselected

Field Name

Function:
Specifies the names of the SharePoint list form fields.
Accepted Values:
Read only.

This column shows the columns in your SharePoint list.

Field Type

Function:
Specifies the data types of the SharePoint list form fields.
Accepted Values:
Read only.

Editable

Function:
Specifies that the runtime app user can change the value in the field.

Read Only

Function:
Specifies that the selected SharePoint list form field is read-only.

Hidden

Function:
Specifies that the selected SharePoint list form field is hidden.

General Configuration

Specifies the basic settings for the Start List Form activity.

Figure: General Configuration screen

General Configuration screen

Fields

Field Name Definition

Display Name

Function:
Specifies the activity name that shows in your process.
Accepted Values:
One line of text that can have spaces.
Default Value:
None
Accepts Process Data Variables:
No
Example:
Refer to:

Description

Function:
Specifies an optional text description for your activity.
Accepted Values:
More than one line of text.
Default Value:
None
Accepts Process Data Variables:
No

Time to Complete

Function:
Specifies the maximum amount of time that should be allowed for the completion of the task associated with this activity before it is considered Overdue. This is a combination of a number of minutes, hours, days, or weeks.
Accepted Values:
A number of minutes, hours, days, or weeks.
Default Value:
1 Day
Accepts Process Data Variables:
Yes

Priority

Function:
Specifies the importance of a task.
Accepted Values:
  • High - Specifies a high priority task. A high priority task shows High High icon icon.
  • Normal - Specifies a normal priority task. A normal priority task shows Normal Normal icon icon.
  • Low - Specifies a low priority task. A low priority task shows Low Low icon icon.
Default Value:
Normal
Accepts Process Data Variables:
Yes

Participants

Specifies the user who starts the process..

Figure: Participants screen

Participants screen

Fields

Field Name Definition

Details

Function:
Shows participants for the task.
Accepted Values:
  • Any user, group, or role - You can add users, groups, or roles as participants, as long as ProcessInitiator is also included in the list.
  • A process data variable.
  • ProcessInitiator - This is a process data variable for that represents a participant who completes a form to start a process instance. This value is required for start tasks.
Default Value:
  • ProcessInitiator - For start tasks.
  • None - For other tasks.
Accepts Process Data Variables:
Yes

Participant Type list

Function:
Specifies a category of participants to add to the task. The list of participants of the type you select shows.
Accepted Values:
Default Value:
Groups
Accepts Process Data Variables:
No

Search

Function:
Does a search based on the specified criteria.

The maximum number of participants to complete this task

Function:
Specifies the number of group members who need to be assigned as participants for a task.
Accepted Values:
  • An integer that specifies a number of participants within a group required to complete a task.
  • Unlimited Participants - Specifies that all members of a group are required to participate.
Default Value:
1
Example:
If the participant is set to a group of users, and Max number of people to complete this task is 2, then 2 members of the group actually are required to participate in the task.

Assign task to the same participants each time activity runs

Function:
Specifies if, when a activity runs more than one time during a process, the same participants must complete the task each time.
Accepted Values:
  • Selected - If an activity is runs more than one time, the same participants who took assignment the first time are also assigned the task each time after.
  • Deselected - If an activity is runs more than one time, any participants can take assignment each time.
Default Value:
Selected
Example:
Ann is part of a group, and takes assignment for a task. She rejects the task. If this field is selected, the next time the process starts this task, the same user, Ann is assigned the task. If this field is deselected, the task goes back into the pool, and anyone in the group can take assignment.

User Defined Properties

Specifies ClientData process data variable values that are associated with a human task activity when a process runs. You can specify a set of variables as name/value pairs that are sent to your web forms. This is an alternative to sending data with URL parameters.

Figure: User Defined Properties screen

User Defined Properties screen

Fields

Field Name Definition

Name

Function:
Specifies the name for the ClientData.

The ClientData property stores data related to the human task activity. This is like defining a process data variable to store specific values.

Accepted Values:
One line of text that can have spaces.
Default Value:
None
Accepts Process Data Variables:
Yes
Limitations:

Some information about third-party integrations is outside the scope of the AgilePoint NX Product Documentation, and it is the responsibility of the vendors who create and maintain these technologies to provide this information. This includes specific business uses cases and examples; explanations for third-party concepts; details about the data models and input and output data formats for third-party technologies; and various types of IDs, URL patterns, connection string formats, and other technical information that is specific to the third-party technologies. For more information, refer to Where Can I Find Information and Examples for Third-Party Integrations?

Value

Function:
The value for the ClientData variable.
Accepted Values:
A number or a text string that can contain spaces.

You can set the value for the process data variable by using an XML value.

Default Value:
None
Accepts Process Data Variables:
Yes
Limitations:

Some information about third-party integrations is outside the scope of the AgilePoint NX Product Documentation, and it is the responsibility of the vendors who create and maintain these technologies to provide this information. This includes specific business uses cases and examples; explanations for third-party concepts; details about the data models and input and output data formats for third-party technologies; and various types of IDs, URL patterns, connection string formats, and other technical information that is specific to the third-party technologies. For more information, refer to Where Can I Find Information and Examples for Third-Party Integrations?

Type

Function:
Determines the data type for the ClientData variable.
Accepted Values:
  • string
  • int
  • bool
  • decimal
Default Value:
string

Add Add icon

Function:
Creates a row where you can specify a ClientData property.

Delete Delete icon

Function:
Deletes the selected row from the user defined properties list.