a!userRecordLink( label, user, view, showWhen, openLinkIn, targetLocation )
Defines a link to a user record. User record links must be used in a link parameter of another component, such as the links parameter in the link component.
See also:
Name | Keyword | Types | Description |
---|---|---|---|
Label |
|
Text |
Link text that users click to open the link. |
User |
|
User |
The user whose record will be linked. |
View |
|
Text |
The URL stub for the record view that the link will open. Default is |
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 |
Determines how the record link should open, either in the same tab or a new tab. Valid values: |
Target Location |
|
Any Type |
The location where the record should open, which can be either a site page or Tempo. To reference a site page, use the following structure: |
"SAME_TAB"
option and open the link in the same page. However, if you're linking to a related record, it's better to use the "NEW_TAB"
option and have the link open a different tab that fits the related record.To experiment with examples, copy and paste the expression into an interface object.
Site object references are specific to each environment. If you copy and paste these examples into your interface, they will not evaluate. Use them as a reference only.
1
2
3
4
5
6
7
8
9
10
11
a!linkField(
labelPosition: "COLLAPSED",
links: {
a!userRecordLink(
label: "Daniel Nelson",
/* Replace this user with a user in your environment */
user: "daniel.nelson",
view: "summary"
)
}
)
The following example will open the user record in a new tab and target location.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
a!linkField(
labelPosition: "COLLAPSED",
links: {
a!userRecordLink(
label: "Daniel Nelson",
/* Replace this user with a user in your environment */
user: "daniel.nelson",
view: "summary",
openLinkIn: "NEW_TAB",
/* For the "targetLocation" parameter below, replace the site page reference (site!CompanyHome.pages.org-chart)
with a valid site page reference in your environment */
targetLocation: site!CompanyHome.pages.org-chart
)
}
)
A user profile card will display when you hover over a user record link. The profile card displays the following fields from the record summary automatically as long as values are specified:
For example, if the user profile only has an email specified and the phone number, address, and supervisor fields are blank, only an email address will display.
This example shows the profile card that would display when hovering over a user link created with the example expression:
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 User Record Link Component.
Comments Patterns (Comments, Looping): Use this pattern when displaying a chronological list of messages from different users, such as comments on a topic or notes on a case.
Event Timelines (Timeline, Events): Use the event timeline pattern to display a dated list of events and actions in chronological order. This pattern uses a combination of cards, rich text, and user images to show an easy to navigate list of dated events.
Task Report Pattern (Grids, Filters, Process Task Links, Task Reports): Provides a simple way to create and display an Appian task report.
User List Pattern (Looping): The user list pattern retrieves all the users in a specified group and displays them in a single column.
User Record Link Component