Part of Understanding the Calc Editor. These four categories return identity and position information rather than form data directly: a full user record, a bare user or group identifier, or a geographic position.
What each category returns
User returns a user record, an object carrying a person's name and email address, which is not the same thing as a bare identifier. Userid returns that identifier on its own, and Groupid the equivalent identifier for a group. Location returns a geographic position, most often the device's position at the time the form is filled in.
Converting between a user record and its identifier, or between a group's name and its identifier, uses the String category instead. Email-For-User and Name-For-Group-Id live there. See Calc Editor: String Expressions.
User expression reference
Expression | What it does |
|---|---|
Current-User | The user record for the person currently filling in or viewing the form. |
If-Set | Uses one user value if a field has a value, and another if it does not. |
Unset | Clears the property, removing the calculation. |
User-By-Email | Looks up a user record by email address. |
User-By-Id | Looks up a user record by user ID. |
Userid expression reference
Expression | What it does |
|---|---|
Field | A reference to a userid field. |
Id-For-User | Extracts the ID from a user record. |
If | Evaluates a boolean to decide which userid result to use. |
If-Set | Uses one userid value if a field has a value, and another if it does not. |
Unset | Clears the property, removing the calculation. |
Groupid expression reference
Expression | What it does |
|---|---|
Constant | A fixed group ID value. |
Field | A reference to a groupid field. |
Group-Id-For-Group | Looks up a group's ID from a group reference. |
If | Evaluates a boolean to decide which groupid result to use. |
If-Set | Uses one groupid value if a field has a value, and another if it does not. |
Parent-Id-For-Group-Id | The ID of a group's parent group, given the group's own ID. |
Unset | Clears the property, removing the calculation. |
Location expression reference
Expression | What it does |
|---|---|
Constant | A fixed location value. |
Field | A reference to a location field. |
If | Evaluates a boolean to decide which location result to use. |
Integration-Data | A location sourced from integration data. |
Unset | Clears the property, removing the calculation. |
User-Position | The device's current geographic position. Mirata's picker notes that setting this to an empty object selects default options. |
Latitude and Longitude, which pull a single coordinate out of a location value, are filed under Calc Editor: Decimal and Integer Expressions rather than here, because they return a decimal.