The property() function is a previously documented method that was used to return metadata property values related to the survey submitter’s collecting environment. As this function has since been deprecated from the XLSForm spec, alternative methods of storing the metadata previously accessed through the property() function are available. Several properties are available through dedicated question types; additionally, a new method has been implemented to support this functionality. This new method can be implemented with the following calculation:
The documentation regarding this function can be found in the Survey123 for ArcGIS web help: Device and user properties.
Note: Survey123 Connect and the Survey123 field app still provide backward compatibility with surveys containing the property() function. The web app will return null values.
The table below lists the properties that were previously supported by the property() function. It also provides a description of the function, an example of the returned metadata value, and whether the property is currently supported by the pulldata("@property", 'propertyname') function.
|Use 'username' question type
|Username with identifier
|Use 'deviceid' question type
|Device ID with operating system identifier
|Use 'email' question type
|Email with identifier