Data Reference Mapping Editor

   MaestroThe UI design product.  |   Form Builder |  22.04 This feature was introduced in 22.04.

The Maestro editor comes with the Data Reference Mapping editor allowing you to create and manage key / value mappings, which may be required to configure different components, for example, . The mappings are stored as a JSONJSON (JavaScript Object Notation) is an open standard file format and data interchange format that uses human-readable text to store and transmit data objects consisting of attribute–value pairs and arrays. object.

The editor is attached to a field of a type called fieldRefMap, which exists in the following standard widgets: Dynamic Data Button, Auto Tab Controller, Autocomplete Field and Signature Pad. The fieldRefMap collects a list of field references with a key, which you can be used in various ways by scripts. However, the common use case is to get data out of the data model into a JSON object as the key field and the fields references. You can map data coming into the form with the key in an object and where it maps to in the data model, for example, handling the response from the dynamic data call and where the data gets injected in to the form data model.

To create an input field mapping in the editor:

1. Open a form or a template in the Maestro editor and click the Design tab.
2. Select a component and switch to the Properties tab.
3. Click Click to Browse to open the Data Reference Mapping editor.

   

   Note

   The component's property must be enabled for the key-value content, otherwise this option is not available.

4. Click Add to create a new mapping and provide a key in the Key column and its value in the Value column. You can add field reference paths in the following ways:
   • Drag the field from the tree and drop it in the relevant input field.
   • Double-click the field in the tree, the data reference path will be added to the selected row.
5. Click Save to save your changes.

Next, learn about Properties pane.