Safe Link

Function: a!safeLink()

Defines a link to an external web page. Links can be used in charts, grids, hierarchy browsers, images, link fields, milestones, pickers, and rich text.

See also: Link, Read-Only Grid, Images

Parameters

Notes

• It's recommended that the URI use a specific protocol. When no protocol is specified, the component will generate a hyperlink using the system's protocol and domain.
• The telephone link URI ("tel:") is supported on the Appian for Mobile Devices application. If a user clicks this link in the application, the link will open a mobile device's default phone dialer.
• Telephone links may work in a web browser, but behavior can differ based on operating system and whether any telephone supported applications or extensions are installed.
• A link created by a!safeLink() opens in a new browser window. Note that a user's browser may still be configured so that all new windows are instead opened as new tabs.

Examples

To an external website

1
2
3
4
a!safeLink(
  label: "Company web site",
  uri: "http://www.appian.com"
)

Returns a hyperlink to http://www.appian.com

To a telephone number in the Appian for Mobile Devices Application

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
a!richTextDisplayField(
  value: if( 
    a!isNativeMobile(),
  a!richTextItem(
    text: (
      "(555)-555-5555"
    ),
    link: a!safeLink(
      label: "(555)-555-5555",
      uri: "tel: (555)-555-5555"
    ),

  ),
  "(555)-555-5555"
 )
)

Returns a telephone link which can be used on mobile devices via the Appian for Mobile Devices application. Use isNativeMobile() to only show this link in the Appian for Mobile Devices application.