Popular Help Content

No popular content.

Versions Compared


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

This page lists some examples of organization structures that were used in projects. They can be used as models when you are designing the levels and permissions for the locations in your project.


titleWARNING: Advanced Techniques

Some of the designs below may involve custom xml or other advanced features; they are provided here just as examples to help design location hierarchies.


Example 1: Agricultural Extension Agents


  • Province
    • District
      • Administrative Post


The people involved in the project were in the following hierarchy:

Worker TypeNotesCoverage
Provincial Managers (PM)Use a separate PM application in which they should be able to see cases created by any user in the entire provinceEach PM is responsible for all cases/data collected by all of the district supervisors and extension agents in their province.
District Supervisors (DS)Also work as Extension Agents, but should be able to see and update cases of other Extension Agents in their districtEach supervisor is responsible for exactly one District, which includes 3-5 Administrative Posts
Extension Agents (EA)Collects data using the Extension Agent appEach extension agent is responsible for one or more Administrative Posts

Location Design

Image Modified

Notes on each level


  • This app used the location hierarchy as a Lookup Table as described in Assigning cases to one of multiple groups. Imagine you are an Extension Agent assigned to the Extension Agent level, which has three Administrative Posts under it. When create a case you would see a lookup table question which shows a list of the three Administrative Posts assigned to you. When you choose one and then submit the form that new case is assigned to the post you selected. It is also not necessary to maintain a separate lookup table
  • The application also captures the names of the locations above it in the hierarchy as described in Referencing the Location/Organization Hierarchy in Applications
  • It is very easy to reassign administrative posts; you can just move the location to a different district in the hierarchy, and once the users sync their data the transfer will be complete
  • One drawback of this approach is that one person can only be assigned to one district; so if there were workers that covered a subset of districts that would need to be another level in the hierarchy