Insert reference fields

Insert references to create dynamic values to be used in settings or displayed as text. Reference tokens and functions are calculated at runtime and the resulting values are used in the form.

To insert a referenc​e field

  1. Click to display the Insert Reference dialog box.
  2. In the Insert Reference dialog box, select the reference category tab and then double-click the reference to add it to the Dynamic text to insert text box.
  3. In the Dynamic text to insert text box, add any required text or function arguments.
  4. Click OK to save changes and close the dialog box.

Reference categories​

Reference categories are indicated by tabs in the Insert Reference dialog box. Availability of reference categories depends on the context in which the Insert Reference dialog box is accessed. Following are possible reference categories. 

  • Common: General tokens and properties specific to the context of the list item, or the workflow and the current task within the workflow (requires Nintex Workflow). Following are references in this category.
    • Approval URL (through the Nintex external platform): The Endpoint URL to the task response form for the current task.
    • Current Date: The current date.
    • Current Time: The current time.
    • Current User: The user domain and user name of the current user. 
      • When inserted as a function (for example, with the Calculated Value control), displays the user domain and user name.
        Example of returned value for an account using claims-based authentication: i:0#.w|crestan\jsmith
        Example of returned value for an account using integrated Windows authentication: crestan\jsmith 
      • When inserted as a value (for example, default value for a People control field), resolves to the display name.
        Example of returned value for a SharePoint user: John Smith 
    • Is Display Mode: Returns true if the form is in display or view only mode.
    • Is Edit Mode: Returns true if the form is in edit mode.
    • Is New Mode: Returns true if the form is in new mode.
    • Is Nintex External Platform: Returns true where the form is displayed using Nintex external forms.
    • Item Display Name: The display name of the current list item.
    • Item URL: The URL of the current list item.
    • List ID: The unique ID of the current list.
    • List Name: The name of the current list.
    • New Line: The new line character.
    • Site Collection ID: The ID of the current site collection.
    • Site ID: The ID of the current site.
    • Site Name: The title of the current site.
    • Tab: The tab character.
    • Web URL: The full URL of the current site.
  • Inline Functions: Allows for additional processing on a text or value, calculated at the time the form is loaded. Refer to inline functions for more information.
  • Item Properties: Columns available for the list item.
  • Named Controls: Named controls in the current form. Inserting a reference to a named control dynamically references the value specified for the named control in the form at runtime. 
  • Runtime Functions: Allows for additional processing on a text or value, calculated at the time the form is loaded and when any changes occur in fields within the form. Refer to Runtime Functions for more information. 

  • Workflow Constants (available when designing forms in Nintex Workflow): Globally set values for use in workflows. Workflow constants are set globally for Nintex Workflow at the level of web farm, site collection, or site.

  • Workflow Variables (available when designing forms in Nintex Workflow): Variables configured for the workflow.

Related information

Inline functions

Inline functions usage examples