FunctionCopy link to clipboard
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:
- Task
- Link
- Read-Only Grid
- Images
- Execute Process Report Smart Service
- Buttons and link design guidance
ParametersCopy link to clipboard
| Name | Keyword | Types | Description |
|---|---|---|---|
|
Label |
|
Text |
Text displayed as the link name the user clicks on. |
|
Task |
|
Task |
ID of the process task to use as the address of the link. |
|
Visibility |
|
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 |
|
Text |
(Browser-Only) Determines where the linked content should open. Valid values: |
Usage considerationsCopy link to clipboard
Offline mobileCopy link to clipboard
While the process task link component is partially compatible with offline mobile, using the component to link to tasks assigned to groups and social tasks is not supported for offline mobile. However, if a user accepts a group-assigned task while online, they will be able to access it offline.
Retrieving task IDsCopy link to clipboard
- To retrieve task IDs, use the Execute Process Report Smart Service and pull from the column that returns the list of IDs.
Using process tasks links with other componentsCopy link to clipboard
- 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.
ExamplesCopy link to clipboard
To experiment with examples, copy and paste the expression into an interface object.
Basic process task linkCopy link to clipboard
1
2
3
4
a!processTaskLink(
label: "Approval Task",
task: 1
)
Copy
Feature compatibilityCopy link to clipboard
The table below lists this component's compatibility with various features in Appian.
| Feature | Compatibility | Note |
|---|---|---|
| Portals | Incompatible | |
| Offline Mobile | Partially compatible | Can be used with offline mobile if it is loaded at the top of the form. |
| 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. |
| Process Autoscaling | Compatible |
Related PatternsCopy link to clipboard
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.
-
Offline Mobile Task Report (Grids, Filtering, Process Task Links, Task Reports, Looping): Display a task report for a user that will work in Appian Mobile, even when the user is offline.
-
Task Report Pattern (Grids, Filters, Process Task Links, Task Reports): Provides a simple way to create and display an Appian task report.