Defining a link dynamically

To dynamically control a link element, a callback must respond with data which defines the link element properties, and you must map this data to the link element properties.

Note

To map callback response data to a link element, you must define the link element ID property. Otherwise, the link element will not appear on the Model side of the the mapping tool.

The callback response object must have the following structure:

{
  "type": "object",
  "properties":
  {
      "href":
      {
        "type": "string"
      },
      "text":
      {
        "type": "string"
      }
  }
}

where:

• href corresponds to the URL property of the link element.

• text corresponds to the Text property of the link element.

Example

Important

This example illustrates mapping individual callback response object properties with individual link element object properties.

In this example, the root form contains a table element which displays an array of customer data.

An On row click action is created to trigger a callback called GetWebsite, , which has the request schema mapped to ref field in the user table.

The callback responds with data for the selected customer’s website link, which are mapped to the link element properties.

In this way, each time the user selects a different table row, the link element will be updated.

GetWebsite request schema

{
   "type": "object",
   "$schema": "http://json-schema.org/draft-04/schema",
   "properties":
   {
     "items":
     {
       "type": "object",
       "properties":
       {
         "userid":
         {
           "type": "string"
         }
       }
     }
   }
 }

GetWebsite response schema

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-04/schema",
  "properties":
  {
    "items":
    {
      "type": "object",
      "properties":
      {
          "URL":
          {
            "type": "string"
          },
          "text":
          {
            "type": "string"
          }
      }
    }
  }
}