a!safeLink( label, uri, showWhen, openLinkIn )
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:
Name | Keyword | Types | Description |
---|---|---|---|
Label |
|
Text |
Text displayed as the link name the user clicks on. |
URI |
|
SafeURI |
URI target of the hyperlink. See SafeURI. |
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: |
a!safeLink()
opens in a new tab by default. Opening a link in the same tab can be configured using the openLinkIn parameter.Copy and paste an example into the INTERFACE DEFINITION in EXPRESSION MODE to see it displayed.
1
2
3
4
a!safeLink(
label: "Company web site",
uri: "http://www.appian.com"
)
Returns a hyperlink to http://www.appian.com
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 Mobile application. Use isNativeMobile() to only show this link in the Appian Mobile application.
Feature | Compatibility | Note |
---|---|---|
Portals | Compatible | |
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. |
Safe Link Component