Function

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:

• Modify the User Record Type
• Link
• Read-Only Grid
• Images
• Tag Items
• Buttons and link design guidance

Parameters

Usage considerations

Changing and deactivating usernames

• User record links can be created for both active and deactivated users.
• User record links continue to work when the user's username changes as long as the "user" field was configured by referencing a variable (e.g. process variable) rather than a username string.

Link use and security

• Links may be clicked by everyone; however, security settings determine what can be seen. If a user tries to open a URL without having at least viewer rights to the record or record type in that URL, they will see an error.
• When you link to a record from a record list, it's best to use the "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.

Examples

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.

User record link to a user record summary view

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:

• Email
• Supervisor
• Phone number
• Address

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

Related Patterns

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.