Checkpoint Component

The Checkpoint (Centauri v1.0) component helps you track an end-user's location in an application In Unqork an application is a program used to perform specific tasks. An application can be one of two types: workflow or module.. You can place Checkpoint components throughout your application. When end-users reach a checkpoint, the component records a timestamp.

You can use this timestamp data in many ways, including:

For the Checkpoint component to work, you need to trigger it. The easiest way to trigger a Checkpoint component is using an Initializer component.

There's no visual aspect of a Checkpoint component in Express View. When a Checkpoint component executes, it creates an entry in the submission data. You can retrieve this data using metadata.checkpoints.<checkpointPropertyID> and view its timestamp in Unix time.

A static image displaying the checkpoint metadata in the DevTools Console.

You'll find the Checkpoint component under the Data & Event Processing group to the left of the Module Builder.

To learn more about general component settings, view our General Component Settings article.×

Field Text

A static image displaying the Disply Settings of Checkpoint Component.

Setting

Description

Label Text

Label Text conveys what the input component is and what information it displays. Enter the purpose of the corresponding component or field.

User-friendly labels make your module more accessible. Keep labels short and descriptive (a word or two) using title case. For longer entries, use sentence case.

Configure a Checkpoint component to executes when your end-user applies a signature with a Signature component. You'll use an Initializer component to trigger the Checkpoint component.

Configure the Signature Component

First, configure a Signature component so your end-user can apply a signature.

1. In the Module Builder, drag and drop a Signature component onto your canvas.
2. In the Property ID field, enter signature.
3. Click Save Component.

Configure the Checkpoint Component

Next, configure the Checkpoint component to retrieve a timestamp when the end-user applies a signature.

1. Drag and drop a Checkpoint component onto your canvas, placing it below the signature  Signature component.
2. In the Property ID field, enter cpSignature.
3. In the Canvas Label Text field, enter Checkpoint.
4. Click Save Component.

Configure the Initializer Component

Lastly, configure an Initializer component to trigger the Checkpoint component.

1. Drag and drop an  Initializer component onto your canvas, placing it between the signature  Signature and cpSignature  Checkpoint components.
2. In the Property ID field, enter initCheckpoint.
3. In the Canvas Label Text field, enter initCheckpoint.
4. Set the Trigger Type to Watch.
5. In the Inputs table, enter the following:
  Property ID Alias Required

1

signature

 

(checked)

6. In the Outputs table, enter the following:
  Property ID Type Value

1

cpSignature

trigger

GO

7. Click Save Component.
8. Save your module.

Viewing the Checkpoint Metadata

Now, look at the DevTools Console to see how the Checkpoint component works.

To open the DevTools Console tab:

1. Preview your module in Express View.
2. Right-click anywhere on your Express View page.
3. Click Inspect. By default, the DevTools panel opens on the right side of your page.

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

4. At the top of the DevTools panel, click the Console tab.

The Console tab lets you view your Unqork application's submission data. A blue arrow to the left of a blank row at the bottom of the Console's feed indicates the Console's command line. You'll use this field to enter commands to get more data details.

With the DevTools Console open, test out the Checkpoint component.

1. In the Signature field, sign your name.
2. Returning to the Console tab, enter the following Angular command in the Console's command line: angular.element('.unqorkio-form').scope().submission.
3. Press Enter/Return. The submission object appears.
4. Click the gray arrows to expand and inspect the submission object until you find the metadata object.

The metadata object is where the checkpoint data lives. Expanding the metadata object, you'll see an object called checkpoints. Inside is the timestamp recorded when you signed your name in the cpSignature  Checkpoint component.

A static image displaying the added signature in Express View and the checkpoint metadata object in the DevTools Console.

As you see in this example, the value is a Unix timestamp of 1679944694537. Converted to a readable date, this value is GMT Monday, March 27, 2023 7:18:14.537 PM.