Contacts and Users

Contacts and users overview

“People” is the generic name used for individuals in apps built with the Core Framework. They can be patients, family members, nurses or health workers. Anyone with a profile in your app is a person.

“Places” is the generic name that represents a level in the hierarchy. “People” belong to “places”, and “places” belong to other higher level “places” in the hierarchy. A “place” could be a geographic area, like a district with the “people” associated to it being health officers. A “place” could also be a structure in the health system, such as a health facility, and the “people” associated to it being nurses. In deployments with CHWs, the lowest “place” in the hierarchy often represents individual households or families, and the individual members of that household are the “people” associated to it.

Users can access their “people” and “places” from the People tab. The permissions set for your role and your placement in the hierarchy will determine which contacts you’re able to see. Advanced configuration options are available for a specific offline user role to manage what level of contact data is downloaded and stored on their device.

Main List

Contact sorting screenshot

The list view on the leftmost screenshot is what a logged-in CHW would see when they access the “People” tab on a small screen.

The item at the top of the list is the “place” the user belongs to. Below that is a list of the “places” they serve, represented by families. Individual “people” are not shown here, but will appear in search results.

Because this list defaults to show the “places” below the user in the hierarchy, a CHW supervisor would see a different view. Instead of families, they might see a list of CHW Areas they manage.

New “places” can be added to this level of the hierarchy by clicking on the “Add new +” button at the bottom of the screen. This allows a CHW to add a new family to their list, or a CHW supervisor to add a new Area they manage.

With the UHC Mode configured, the main list of households is displayed as shown on the rightmost screenshot to help health workers ensure that all households are visited regularly.


Searching

Click on the search icon at the top of the screen to search for a “person” or “place”. The freetext search works on all fields included in the “person” or “place” document such as patient name or patient ID. The exact fields depends on which information you’ve configured your app to collect.

After typing a search term, press the “Enter” key on your keyboard, then the list filters to show matching items. Searching will only return items that are lower than you in the hierarchy and that you have permission to view.

To clear the search and return to the default view, click on the arrow icon located to the left of the search box.

Profiles

Clicking an item on the main list will open a profile where you can see detailed information about that person or place. At the top is general information like name and phone number.

If you’re viewing a place profile, you’ll see a list of people or places that belong to this place in the app hierarchy, such as family members. The star signifies the primary contact.

Beneath that, you will find tasks for this person or place. At the very bottom is a history of submitted reports for this person or place.

From profiles, users can edit contact information, take actions, and, if viewing a place profile, add new people and assign a primary contact person. If a place is not at the bottom of the hierarchy, a user can add new places to the level below this.

Fields

Contact Summary

The top card on all profiles contains general information for the contact. All the fields shown in this summary card are configurable.

See Also: Defining Contact Summary

Condition Cards

A “condition” card displays data on a profile that’s been submitted in a report about that person or place. Data can be pulled from one report or summarize many reports.

Condition cards can be permanent or conditional; set to appear only when a specific type of report is submitted. They can also be set to disappear when a condition is resolved or a certain amount of time has passed. You can have as many condition cards as you like, though we recommend keeping the user’s experience in mind.

Configurable elements include:

  • Title
  • Label for each data point displayed
  • Data point for the field
  • Icon for the field, if desired
  • Conditions under which to display

See Also: Defining Condition Cards

Care Guides

“Care Guides” are dynamic forms that you can fill out for a person or place. You can access Care Guides by clicking on the + button at the bottom of a profile. For more info, see the Care Guides overview page.

You’ll see different forms here depending on which person or place you’re viewing. For example, forms for families might include a “Family Survey.” Forms for adult women might include “New Pregnancy.” Forms for adult women who have had a pregnancy report, and no delivery yet reported, would also see “ANC visit.” Forms for children might include “Under-5 Assessment” or “Growth Monitoring.”

Health workers can use these Care Guides at any time. If the app has scheduled a care visit or follow up, it will be listed under “Tasks.”

See Also: Defining Care Guides



Building > Reference > forms/ > contact

Contact Forms: Used for creating and editing people and places

Building > Reference > contact-summary.templated.js

Contact Pages: Customizing the fields, cards, and actions on profile pages

Building > Contact management > Moving Contacts

How to safely move contacts

Building > Contact management > Contacts + Users 1

Creating and editing contacts and users in the CHT UI

Building > Examples > Contact Tracing

A community surveillance tool to help control infectious disease outbreaks and mitigate secondary disease transmission