HomeGuidesRecipesAPI
HomeGuidesAPILog In
Guides
These docs are for v14. Click to read the latest docs for v31.

Data Store

Configuring Data Objects used at Submission

Updating writable data upon submission occurs in the background most likely without the user knowing. Individual writes can occur upon the completion of a workflow state or at the end of an entire workflow.
Configuration involves mapping the writable data objects field's (via placeholders) to appropriate questions in the question set.

Configuring a Submission Writable Data Object (Data Store)

From an Form Project project use the Data Stores Icon on the right hand pane to find your writable data objects in the fly-out, drag and drop your selection onto the finish page icon in the question set. A properties panel will display for the Data Store, where appropriate give it a meaningful name.

1498

Design will automatically create an item in the placeholders fly-out. These will need to be mapped to the question set.

396

Drag the placeholders to appropriate questions in the question set, more information about data types and appropriate quesitons can be found here.

1380

Test your project in Produce and Confirm with the administrator of your data connection that the record has been maintained correctly.

Workflow Write Considerations and Configuration

For forms that contain workflow, a 'Write On' drop-down will appear on the data store's properties panel, defaulting to "All transitions". A decision can be made as to whether to:

  • Commit the data on all workflow transitions
  • Commit the data only at the conclusion of the workflow
  • Do not commit the data automatically

In the second and third cases, the "Writable Data Object Override" action is used to manually commit data on a per-workflow-transition basis as desired.

357

The Writable Data Object Override action is described in detail here.

📘

Object persistence

By default (using Write On All Transitions) the Data Store will attempt to maintain and update a single data record for a workflow. If multiple records need to be created within a single workflow, the Writable Data Object Override action must be used and the ObjectID field should be overridden with a new value.

Repeating Writable Data Objects

Writable data objects can be driven by repeating pages or sections so that an individual record is created for each instance of the repeat. For workflow projects that write on each or more than one workflow transition the initial write will create the records whereas the subsequent writes will edit them including the delete.

🚧

Repeat Sources

Repeating Writable Data Objects cannot be driven by a repeating data source. I.e. must be driven by a repeating section.

Use the Repeat checkbox and select an appropriate source to configure a submission data object as repeating.

1170