Submission Data

Estimated Reading Time:  7 minutes


Submission data is a fundamental concept in Unqork. Your end-user creates a new submission any time they save or submit their data. Submissions don't automatically hold all data your end-user enters. In most input-type components, you'll find a setting called Store Data in Database. When this setting is set to On Toggle (ON), data in that component stores in your submission. And when the setting is set to Off toggle (OFF), data in that component won't save.

Remember, end-users End-Users are the individuals accessing an application through Express View. In most cases, end-users are the customers using the product. create a submission when they save their interactions with your module. Each submission links to a unique submission ID. You can then use this to reference the distinct set of submission data in other components. Being able to reference submission data unlocks endless configuration possibilities.

What You'll Learn

This article will help you understand what submission data is, how to view it, and how to use it.

Generating a Submission ID

In Unqork, data saves when an end-user clicks a Save-type Button or navigates between pages of a module. These actions create a submission, with a submission ID tied to the submission data. Anytime this submission data changes, the updates will save to the same submission ID.

NOTE  Button components can have Save, Save Draft, Validate, Event, and Reset actions. Of these, only Save and Save Draft actions save data and create a submission.

Locating the Submission ID

When you first open your module in Express View, the URL only shows the unique module ID. For example,

Take a look at these 2 Express View URLs. They're both from the same application, but the first is before an end-user saves or submits:

And the second is after the end-user saves or submits:

You'll notice the second URL is quite a bit longer. The first addition here (bolded above) is the submission ID. Then, the URL repeats the module ID. In the next few lessons, we'll go over how to use this submission ID to show, revisit, and edit submissions.

Inspecting Submission Data in the DevTools Console

Google Chrome comes standard with a suite of tools called DevTools. DevTools are browser tools for troubleshooting errors, running commands, and inspecting data. Most DevTools include a dedicated JavaScript Console. The Console lets you see the arrays you structured in the Module Editor, and the values saved as part of the submission ID. With the help of a simple Angular command entered into your DevTools Console, you can easily inspect your submission data.

NOTE  The Angular command returns the value of all components in your module. Where you've set Store Data in Database to ON, data in that component stores in your submission. So, the Angular command returns submission data and unstored data cleared on refresh.

To inspect submission data in the DevTools Console:

1. Open your submission in Express View. Ensure that you're using the URL containing the unique submission ID.
2. Right-click anywhere on the page.
3. Select the Inspect option.

TIP  To open the Console in Google Chrome, you can use the Ctrl + Shift + J (Windows/Linux) or Option + Command + J (Mac OS) shortcut.

4. Enter the following Angular command in the Console: angular.element('.unqorkio-form').scope().submission.
5. Press the Enter/Return key. The submission object appears in the Console.
6. Click on the gray arrows to expand the submission object's structure.
7. Expand the data: section to reveal your submission data object.

Here's an example of submission data inspected in the Console:

In this example, each row of the submission data comprises of a key/value pair. Keys display in purple and values display in red. Some of the keys correspond to the module's component Property IDs of the module's components. Their values correspond to the value entered in Express View and saved to the submission data.

Use the key/value pair of "firstName": "Lavera" as an example. The firstName Property ID is associated with the Text Field component labeled First Name. The end-user entered the value Lavera in the First Name field in Express View.

NOTE  Some key/value pairs display in the submission data that the end-user didn't enter in Express View. This includes logs of Button-click events or values housed in Hidden components.

NOTE  Some key/value pairs appear in the submission data that weren't entered by the end-user in Express View. This might include logs of Button-click events, or values housed in Hidden components.