The Case List and Case Detail screens on CommCare Mobile allow mobile users to find and view data about a case on their mobile device, even when offline. This page provides an overview of how Case List and Case Detail screens are used, and explains in detail how to configure them.
...
| Table of Contents | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
About Case Lists & Case Details
Case List
...
You can specify the case property columns that are displayed in the case list. Due to the limited screen space on a mobile phone, you typically want to only include two columns. The phones will also let you search over the case properties in the columns - it is sometimes useful to include an ID that the user can quickly type a search term or scan a barcode to find the case they are looking for. The case list can also be sorted and filtered, based on the state of the case.
...
In the top section you can select the case properties that will be displayed in the list. We recommend you think about the size of your screen when choosing how many properties to include. For example, a java phone can only fit about 2 properties, while a tablet may be able to fit 3 or 4. It is not recommended to use more that 4 properties as columns in the case list as it would shrink the text and make it unreadable. The users are also advised to use shorter and optimised column names to avoid any issues with case lists.
Add a property
select between a default property or calculated property. Simply start typing in the name of the property and it will automatically populate allowing you to select one from the dropdown.
...
Parent Child Selection
...
Using Barcodes to Search the Case List
If you collected and saved any barcode scanner type questions as case properties, you can search the case list by scanning that barcode and recalling the case. In order to do that, you need to:
At the time of registration (or anytime in subsequent workflow), add a https://dimagi.atlassian.net/wiki/spaces/commcarepublic/pages/2213544088/List+of+Question+Types+in+CommCare#Barcode-Scan type question. Save this question as a case property.
In your case details tab, add the barcode scanner question case property. Tip: many people set the property to “search only” since barcodes are typically not readable/ typeable.
When a user enters the case list, they will be able to select the small square barcode icon. Their camera will open, allowing the user to scan the barcode in front of them. The app will display any cases that match the scanned barcode.
Parent Child Selection
If you have https://dimagi.atlassian.net/wiki/x/9i7Kfw set up for your application, you can make it easier to find a particular child case. The phone can be setup to first show a list of parent cases. After selecting a parent, the phone will then display a list of child cases for that parent. After selecting a child, you can open a particular form for that child. This can be extended to multiple levels of selection - for example selecting a village, then a woman's group and the finally a woman within that group.
...
You can also organize the Case Detail page using tabs. Please see documentation at https://dimagi. atlassian.net/wiki/x/RRjKfw.
Text Formatting
It is also possible to use advanced text formatting to the case detail page. Formats that can be used and how to use them can be found at Text Formatting (Markdown).
...
It is also possible to use calculations in the case list/details screen by enabling an Add-Ons via the application settings screen. This feature will allow you to use custom xpath expressions to perform calculations on data and case properties that can be displayed to your mobile workers. For more information on how to enable and use this functionality, please see https://dimagi.atlassian.net/wiki/x/kgXKfw./spaces/commcarepublic/pages/2143951603/Case+List+and+Case+Detail+Configuration#Calculations-in-the-Case-List-and-Details
Localization (Translations in the Case Details/List)
...