Skip to content

add section about ${} reference variables #283

Description

@lindsay-stevens

There is a section on the ODK docs but not XLSForm.org. It should mention key things like:

  • the referenced name can be any question, group, or repeat on the survey sheet; or instanceID to get the unique identifier for that submission.
  • when a form uses them, the referenced name has to be unique anywhere in the form. The workaround in that case is to write the XPath string that would have been inserted.
  • if the referenced name is prefixed with last-saved# (e.g. ${last-saved#age}) then the token will be resolved to a reference to the value of that name in the previously saved record.
  • reference variables can be used on the sheets: settings, entities, survey, and choices; in most columns except for name/type columns.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions