Process Task Link Component (a!processTaskLink)

Process Task Link Component

Function

a!processTaskLink( label, task, showWhen, openLinkIn )

Defines a link to a process task. Links can be used in charts, grids, hierarchy browsers, images, link fields, milestones, pickers, and rich text.

See also:

Name	Keyword	Types	Description
Label	`label`	Text	Text displayed as the link name the user clicks on.
Task	`task`	Task	ID of the process task to use as the address of the link.
Visibility	`showWhen`	Boolean	Determines whether the component is displayed on the interface. When set to false, the component is hidden and is not evaluated. Default: true.
Open Link In	`openLinkIn`	Text	(Browser-Only) Determines where the linked content should open. Valid values: `"SAME_TAB"` (default), `"NEW_TAB"`.

To retrieve task IDs, use the Execute Process Report Smart Service and pull from the column that returns the list of IDs.

To display a single link or array of links, use the process task link inside of the link field component.
To display a link in a grid, use the process task link inside of a grid text column.
To add a link to an image, use the process task link inside of a document image or web image.
To add a link to a chart series, use the process task link inside of the chart series component.

Click EXPRESSION to copy and paste an example into the Interface Definition to see it displayed.

a!processTaskLink(
  label: "Approval Task",
  task: 1
)

The table below lists this component's compatibility with various features in Appian.

Feature	Compatibility	Note
Portals	Incompatible
Offline Mobile	Incompatible
Sync-Time Custom Record Fields	Incompatible
Real-Time Custom Record Fields	Incompatible	Custom record fields that evaluate in real time must be configured using one or more Custom Field functions.
Process Reports	Incompatible	Cannot be used to configure a process report.
Process Events	Incompatible	Cannot be used to configure a process event node, such as a start event or timer event.

The following patterns include usage of the Process Task Link Component.

Display a User's Tasks in a Grid With Task Links (Grids, Reports, Looping): Display the tasks for a user in a Read-Only Grid and allow them to click on a task to navigate to the task itself.
Task Report Pattern (Grids, Filters, Process Task Links, Task Reports): Provides a simple way to create and display an Appian task report.

Process Task Link Component