Customize Dispatched, Saved, and Submitted Form Names with Data Record Naming

Available on all tiers:

Essentials
Advanced
Enterprise

About

A Data Record NamingClosed A Data Record Naming expression provides a way to create a unique name for dispatched, saved, and submitted forms. The naming expression also applies to forms that a user saves as draft on their device. A customized name helps you and your mobile users quickly search for and identify forms. expression provides a way to create a unique name for dispatched, saved, and submitted forms. The naming expression also applies to forms that a user saves as draft on their device. A customized name helps you and your mobile users quickly search for and identify forms.

The system displays the unique, customized name at various stages of your workflow:

You can use DREL references in the Data Record Naming expression, such as form name, username, or the answers to questions.

Info:The Data Record Naming expression described in this topic does not affect how the system names and organizes your form submission documents in cloud-based Data DestinationsClosed A Data Destination specifies where to send data from a submitted form. You can use Data Destinations to automate data sharing and storage, routing data to a specific service (such as email or cloud storage) in several different formats.. The topic Change How Form Submissions Are Named and Organized in Cloud Services describes how to customize the folder and form submission document names.

How a customized name improves search results

The TrueContext search functionality relies predominantly on the name given to a form submission. For example, to search submitted forms by the submitter’s name, your naming expression must include %u. The DRELClosed Data Reference Expression Language (DREL) is used to get form data and metadata and add it to a string, such as dates, usernames, or answers to questions in forms. reference %u dynamically appends the submitter’s name to your form submission name.

Info:The topic DREL Complete Reference List provides a list of all DREL properties you can use in the naming expression.

Mobile app search

Online TrueContext Mobile App users can use the search box to enter a form submission name. The following example shows the search results of all form submissions in the TrueContext server with the customer “KT Technologies” in the name.

A user searches for all form submissions related to a specific customer.

Info:The topic How the Mobile Search Works describes how a naming expression affects search results.

Web Portal search

The TrueContext Web Portal uses the unique name generated by the naming expression to display and search on the form submission name. The following example shows the search results for a TrueContext TeamworkClosed TrueContext Teamwork is an Enterprise tier feature that enables mobile users to transfer incomplete forms for other users to complete as part of a multi-user workflow. This can be useful for jobs that require someone else's expertise or that span multiple shifts.-enabled form (Enterprise tier only) that has %r[state] in the naming expression.

Shows how a user searches for form submissions by name and gets results for submitted forms with the incomplete form state in their form submission names

Best practices for Data Record Naming

Guidelines

  1. The TrueContext search functionality relies predominantly on the name given to a form submission.

    Note:Make sure you use a naming expression that always generates a unique form submission name.

    The default expression %f - %d %t always produces a unique name because it includes a date and timestamp.

    When the naming expression doesn’t result in a unique string, the Mobile App Search and the App‑to‑App search action return a list of matching forms.

  2. Think about how your users might search the TrueContext Mobile App and the Web Portal and customize the form submission name accordingly.

  3. You can use the %r[id] DREL expression to reference the form submission ID without the timestamp. This results in a shorter name and reduces clutter in form submission lists.

  4. You can use the %a[uniqueID] DREL property to reference answers to questions in a form.

    Note: Use required questions in the naming expression to avoid blanks in the form submission names.

    For example, a form might be dispatched to users prefilled with customer information. If the naming expression references the required question with unique ID “Customer”, the customer name shows in the user's Inbox.

Examples

The following table describes some typical naming expressions that reference data and metadata from the form.

Naming expression Result
%d - %a[Customer] - %a[Priority] 2021-05-30 - KT Technologies- Urgent
%r[id] - Work Order - %a[Customer] 1812345 - Work Order - KT Technologies
Store Visit - %t[HHmm] - %a[Address] Store Visit - 14:15 - 123 Avenue Street

Info:The topic DREL Complete Reference List provides a list of all DREL properties you can use in the naming expression.

Set up a custom naming expression

The %-prefixed items use Data Reference Expression Language (DREL) to reference properties from the form. You can also use static text.

  1. Navigate to the desired form.

  2. Select Edit Form.

  3. Go to Settings > Advanced Properties.

  4. In the Data Record Naming section, enter a Naming expression.

    2019-04-26-WP-EnableSearch07.png

    The expression in this example captures the following information:

    • %f—the name of the form
    • %a[selectprojectname]—the answer to a question with the specified unique ID, in this case, the project name that the user selected
    • %d—the form submission date

    Tip:The example updates as you type to show you what the customized name will look like.

In the Mobile App's Sent box, for example, this naming expression would give you form submissions like this:

2019-04-23-iOS-DRNaming.png