Built-in Data

Created by Anthony Young, Modified on Mon, 20 Jun, 2022 at 12:33 PM by Anthony Young

Every form entry includes a number of built-in data fields that are available for use in your templates and connectors.


Additionally we provide built-in fields to access to some company level settings like the name of your organisation.

 

Built in values can be used in your templates by using the {{%BuiltInName}} syntax. 

For example if you want to display the entry id as per the table below you would use {{%ENTRYID}} in your template or connector.

 

The built-ins available are as follows:


Company Information

PRIVATETOKEN

Inserts the private token value found in your Organization Setup page. 


ORGID

Inserts the unique integer identifier of your company account on our platform. 


ORGLETTERHEAD

Inserts your organisation letterhead image as setup in the Organisation Setup.

If no letterhead is found, the organisation logo image is used (if any exists).


ORGNAME

Inserts the name of your company as setup in the Organisation Setup. 


User Information

USEREMAIL

Inserts the email address of the user that completed the form.

USEREXTERNALID

Inserts the external Id of the user that completed the form.

USERFIRSTNAME

Inserts the first name of the user that completed the form.

USERLASTNAME

Inserts the last name of the user that completed the form.



Entry Information

COMPLETELAT

Inserts the GPS latitude (in decimal degrees) of the user when completing the entry.


COMPLETELON

Inserts the GPS longitude (in decimal degrees) of the user when completing the entry.


COMPLETEMAP

Inserts a map image for the GPS co-ordinates of the user when completing the entry.


COMPLETETIME

Inserts the date and time that the user completed the Form entry (i.e. clicked upload in the app, regardless of connectivity).

The correctness of this value is dependent on the users device time settings.


COMPLETETIMEUTC

The same as COMPLETETIME, but inserts the date and time in UTC.
ENTRYGUID

Inserts the unique identifier string of this entry, without hyphens (i.e. 00000000000000000000000000000000). The identifier string is unique across all forms and all entries.


ENTRYGUIDFULL

Inserts the unique identifier string of this entry, including hyphens (i.e. 00000000-0000-0000-0000-000000000000).

The identifier string is unique across all forms and all entries."


ENTRYID

Inserts an incremental calculated integer number for this form entry.

The entry id for a specific entry is calculated as the current highest entry id for the form screen (all versions) plus one.

RECEIVEDTIME

Inserts the date and time that the form entry was received by our server. This may differ significantly from the "CompleteTime" value depending on the connectivity of the app.


RECEIVEDTIMEUTC

The same as RECEIVEDTIME, but inserts the date and time in UTC.

STARTTIME

Inserts the date and time that the user started the form entry. The correctness of this value is dependent on the users device time settings.


STARTTIMEUTC

The same as STARTTIME, but inserts the date and time in UTC




Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons

Feedback sent

We appreciate your effort and will try to fix the article