Component Data Binding

   MaestroPreviously known as Transact Maestro.  |    Form Builder |  5.1 & Higher This feature is related to 5.1 and higher.

The Maestro editor allows you to link a component in the form to the XML data layer, which is known as data binding. You can perform data using the XML Location of the Integration panel. The binding can be relative and absolute. The differences between them are described below.

Relative Binding

By default, most items (exceptions include pages, sections, blocks, and data fields) are bound under the root element in the XML layer, unless their parent container has been included in the submission data. This is known as Relative binding. If an item's hierarchy changes, the XML Name will automatically be updated to reflect this.

On the Integration panel, you will find the XML Location, XML Name, and Full Path. These options will only display if the component is not part of an entity.

da8a221a5d6ba908b8ce0585882c9e18

Notice, the Full Path in the images below.

Parent not included in submission data

Parent is included in submission data

cad40785df61f210af70db2b3df19ee9

b8cdded12c4895fa4418d996ab814ed5

You can include components in the submission data, by selecting the component and then selecting "Include in Submission Data".

Absolute Binding

If you want to ensure that an item is always going to be bound to a particular XML tag, use "Absolute" binding.

To change to absolute binding, follow these steps:

  1. Select the component and switch to the Integration panel
  2. Clear the Use Auto-generated XML Name checkbox to change the XML Location.
  3. Select Absolute from the XML Location dropdown list.
  4. Change the XML Name to include the component you want to bind the selected component to. This will update the Full Path.

You should also use Absolute binding when you are binding to externally generated XML. It is safer to use Absolute binding to ensure the structure remains as you expect. For more information see the Data Mappersection on the The Data Model page.

Change XML Name

To change the XML name of a component:

  1. Select the component.
  2. Switch to the Integration panel.
  3. Deselect Use Auto-generated XML.
  4. Update the XML Name.

When changing the XML Name, you can type a single level name (FirstName), or you can create additional structure in the XML using a two-level name (personalDetails.FirstName or personalDetails/FirstName).

You can update the XML Name for both "Relative" and "Absolute" binding.

Exclude a Component

You can exclude a component from the form's XML if needed.

  1. Select the component.
  2. Switch to the Properties panel.
  3. Expand Layout.
  4. Select Exclude.

Components Using Entity XML Path

When a component ID contains an entity the Integration panel options will be different.

The XML Location and XML Name properties will not be available. The location will be based on the entity included in the ID property as displayed in the Full Path property. You can deselect Use Entity XML Path to enter a different Full Path.

We recommend checking Submission Data Extract

Next, learn about XML data payload.