Dynamic Link

Function: a!dynamicLink()

Defines a link that triggers updates to one or more variables. 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

Name Keyword Type Description
Label label Text Text displayed as the link name the user clicks on.
Value value Any Type The value that is saved when the user clicks the link.
Save Value To saveInto Save Array One or more variables that are updated with the link's value when the user clicks it. Use a!save(target, value) to save a modified or alternative value to a variable.
Visibility showWhen Boolean Determines whether the component is displayed on the interface. When set to false, the component is hidden and is not evaluated. Default: true.

Notes

  • To display a single link or array of links, use inside the Link Field component. To display a link in a grid, use inside a Grid Text Column. To add a link to an image, use inside a document or web image. To add a link to a chart series, use inside the a!chartSeries() function. To add a link to an image, use inside a document, user, or web image.

Examples

Copy and paste an example into the INTERFACE DEFINITION in EXPRESSION MODE to see it displayed.

Dynamic Link that Saves into a Local Variable

1
2
3
4
5
6
7
8
9
10
11
12
13
14
=a!localVariables(
  local!priority,
  a!linkField(
    label: "Link Field",
    instructions: if(isnull(local!priority), null, "local!priority is " & local!priority),
    links: {
      a!dynamicLink(
        label: "Set priority to high",
        value: "High",
        saveInto: local!priority
      )
    }
  )
)

The following patterns include usage of the Dynamic Link.

Open in Github Built: Wed, Aug 17, 2022 (01:05:05 PM)

On This Page

FEEDBACK