Data object action

Use the Data object action to get or set values in a data object variable to manipulate the data.

  1. On the form modeling bar, click Actions and click New.

    The New action dialog box is displayed.

  2. On the Type list, select Data Object.
  3. Change the default Name (DataObject1) to something meaningful.
  4. Optional. Enter a Description for the action.
  5. Optional. Select Multilingual to configure a unique action for each language separately. See Configure multilingual actions.
  6. Select a data object variable on the Data object variable list.
  7. On the Operation list, select either option and configure:

    Get Fields

    You can get a field from the data model structure based on the data object variable. To get a field

    1. Click . The New Target dialog box is displayed.

    2. On the Source/Value list, select the field in the data object whose value you want to get.

      Selecting the field displays the field path such as Customer.Address.Addressline1.

    3. On the Target list, select the target control or form or global variable to which you want to map the field value.

      If the selected data object field is a list then only table controls are available for the target and you can map table columns to list columns.

    To get multiple fields in one go, add more fields by repeating the above steps.

    Update Fields

    You can select a field to update from the data object that you want to update. To get a field

    1. Click . The New Target dialog box is displayed.

    2. On the Source/Value list, select the field in the data object whose value you want to update.

      Selecting the field displays the field path such as Customer.Address.Addressline1.

    3. On the Target list, select the source control or form or global variable, inline value or expression that you want to use as the new value.

      If the selected data object field is a list then only table controls are available for the source and you can map table columns to list columns.

    To update multiple fields in one go, add more fields by repeating the above steps.

  8. Click Add.

    The newly created action is added to the table.

  9. Associate the action with the control to trigger this action. See Configure actions for form control events. Alternatively to call this action for a form event, associate the action with the form. See Associate an action with a form.

    When this action is triggered, the data is manipulated depending on whether you have configured the action to get or update the values in a data object variable.