Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

You will also stop seeing "/data/" as a way to reference form questions. Instead, we have replaced "/data/" with a more intuitive "#form". See our handy hashtag reference cheat sheet for more information.

If you have been using "Edit" forms to edit case data, you can recreate the same functionality by referencing a case property in the "Default Value" field of a form question.

...

Easy References work with parent/child relationships for up to two levels. The case properties window will display case properties of the child case, its parent, and even its grandparent if that exists.

See our handy hashtag reference cheat sheet for more information.

Do Easy References work with the user case?

...

There's no way to undo the upgrade. If you upgrade to Easy References and don't like it, you can "revert" to a previous version of your application that was not using Easy References and continue using the older version of the app builder. However, all applications must eventually upgrade to Easy References.

Do

...

Easy References work with imported cases?

Yes, but you may see warnings. You can directly type in the case property as #case/<property_name> to reference a property that is not in the app structure but was imported via the case importer. However, if that property is not used anywhere else in your application, you will see an "Unknown question" warning. This warning will not prevent you from building your application.

You can make the warnings disappear by creating a "fake" form in your application that references the imported properties:

...

This will not affect your application, but it will enable CommCare's easy references to recognize the imported properties.

Please see the following confluence page for more detailed instructions: Case Importer with Easy References.

Can I reference specific iterations in a repeat with Easy References?

Currently this is not possible. To do this you can use the old style of reference: /data/path/to/repeat/question[1]