Evaluate XPath in Data Preview

The Evaluate XPath feature in the Data Preview tool provides an advanced way to test and troubleshoot the logic of your forms during development. This functionality allows you to write XPath expressions and instantly see how they evaluate against the current state of your form data. This is particularly useful for validating calculations, conditional logic and data constraints before finalizing your form.

Key Features of Evaluate XPath

1. Real-time Evaluation

   Evaluate XPath expressions dynamically as you interact with the form. This helps in checking how the logic responds to changes in the form's data during entry.

2. Data Exploration

   Query specific nodes or values in the XML structure of the form using XPath. This is valuable for debugging complex logic involving hidden fields, repeat groups, or nested data.

3. Error Identification

   Test conditions or expressions to identify errors or unexpected behavior in your form's logic, such as:

   • Incorrect field references
   • Misaligned data conditions
   • Unexpected null or default values

How to Use Evaluate XPath

1. Access the Tool
   • Open the Data Preview tool during form entry (as described under "Basic Usage").
   • Navigate to the Evaluate XPath tab.
2. Enter an XPath Expression
   • Use the /data/... syntax to reference fields in your form. For example:
     • To check the value of a specific field: /data/field_name
     • To validate a condition: /data/field1 + /data/field2
     • To query nodes in repeat groups: /data/repeat_group[position()=1]/field_name
3. Run the Expression
   • After entering your XPath, press the Evaluate button.
   • The result will display immediately, showing the evaluated value or highlighting any errors.

Best Practices

• Use Absolute References: Always use the /data/... syntax for field references, as opposed to #form/..., to ensure compatibility with the XML structure.
• Validate Complex Logic: Test multi-condition expressions, such as if() or selected(), to confirm their accuracy.
• Iterate in Repeat Groups: Use positional functions like position() to target specific entries in a repeat group.
• Debug Hidden Calculations: Check hidden or auto-calculated fields to ensure their formulas work as expected.

Limitations

• Ensure you have the necessary “edit_data” permissions to access this feature.
• Evaluate XPath does not simulate server-side behaviors or constraints but is limited to the current form's XML data.

The Evaluate XPath feature is a powerful addition for developers and advanced users, simplifying debugging and ensuring forms are logically sound before deployment. If you're new to XPath, start with simple expressions and gradually explore more complex queries to fully leverage this tool.

XPath Function: concat(*arg)