Page Comparison

For users already familiar with CommCare's conditional select functionality, referencing locations within a form is very similar.  To access the list of locations from within a CommCare Supply form, you can use the syntax described HERE.

Much like lookup tables in order to reference location data in a form, you must first include a reference to this instance in the forms xml.  To access this xml, enter your form, and in the top righthand corner, under "Tools", select "Edit Source XML"

...

<instance id="locations" src="jr://fixture/CommCare Supplycommtrack:locations"></instance>

Place this just above the first "<instance>" here:

...

Note that whenever referencing the location hierarchy, only locations with which a mobile user is associated will sync to that users phone.  So, if the mobile user account is linked to outlet 'a', then the only district that will appear on that users phone is the district to which outlet 'a' belongs, and the only state will be the state to which that district belongs.

UPDATE !

In order to set up a single of multiple answer questions on locations, follow these steps:

1. Add a Single/Multiple Answer Lookup Table:
   Image Added
2. Click on the "Lookup Table Data" question
   
   Image Added
3. Edit the following fields:
   Image Added
   
   1. Lookup Table: click on the 3 dots next to the field Image Addedand complete the following fields.
      Image Added
      
      1. Query expression: put here your location instance. For example:
         1. if you want to display the list of states: instance('locations')/states/state
         2. if you want to display the list of districts of a previously selected state: instance('locations')/states/state[site_code=/data/state_selected]/districts/district
            where /data/state_selected is the state previously selected.
      2. Instance ID: locations
      3. Instance URI: jr://fixture/commtrack:locations
         
         
   2. Value Field: what you want to save as an answer (usually an id or a code). For locations you can use site_code or @id.
   3. Label Field: what you want to display to the user. For locations you can use name
   4. (Optional) Filter: can be used to filter the locations displayed.
      
      

 If you don't see the 3 dots (Image Added), you need to activate a feature flag in your project settings.

Add the feature preview "Custom Single and Multiple Answer Questions"  to your project