User Management FAQ

Resolving an eCHIS-KE Logic Error

This error happens when vital information is missing on the Community Health Unit. You'll need to add the information onto the CHU to resolve this. https://www.loom.com/share/80e130733d094e4a829bdfe063d8b1e6

Deleting an empty CHU or CHP Area

This is useful for removing duplicates but only works when the place you want to delete has no data in it. So you can't delete a CHU with CHP areas like this; or a CHP area with households. The "trick" is that you need to delete the "contact" within the area, and then you can delete the empty area.

Delete.CHP.Area.mp4

How to Reset an Existing CHP's password

Follow these steps to Reset an Existing Password.

Error fetching tasks or Error fetching targets

Error fetching tasks or Error fetching targets can look like either of these:

This error can happen for a variety of reasons, but the most frequently cause is that the user's account was not properly created. Typically, accounts in this state were created without the User Management Tool.

Recommended steps to resolve the issue:

1. Login to the User Management Tool for your instance
2. Follow the steps to Replace a CHP, replacing the CHP with a new CHP with the exact same name and phone number
3. Login using the CHP's new credentials

If this does not resolve the issue, please escalate on the User Management Support WhatsApp channel. Please share the instance and the username.

Change User Language

Change.User.Language.webm

For a better app experience

If a user sees this error

For a better app experience, please contact your administrator or supervisor. Let them know to update cht-android.

Confirm the following:

1. Confirm you are not using the eCHIS training app. This error is visible to all users on the training app.
2. Upgrade to the latest Android System Webview
3. Upgrade to the latest eCHIS Kenya App

Managing the Contact Hierarchy

Moving a CHP or CHU

1. Log in to the user management tool via https://users.echis.go.ke/
2. Click on the Manage tab, then select Move CHP or CHU.
3. Provide the required details as per the form layout and click the move button

4. A summary of the CHP details to be moved is generated as shown below. This enables the user manager to verify them for correctness. 5. Lastly, click the CONFIRM MOVE button. The CHP or CHU will be moved accordingly

NB: Please ensure all affected users have synced their data fully before they are moved, or data may be lost.

Renaming a CHU

Select the CHU and then click "Edit"

How.to.rename.a.CHU.in.eCHIS.mp4

Data in eCHIS is not showing in the User Management Tool

Please click "Refresh". This pulls the latest info in eCHIS into the User Management Tool.

You can also refresh the data directly on the input form. This is helpful in cases where you've created places on eCHIS, eg. CHUs, and want them to be immediately available on the user management app without leaving the form to click refresh as shown above.

After the refresh is done, the search results will be updated with the place you created

How can a CHA correct a CHP name or phone number

You should use these steps only to correct spelling mistakes or edit phone numbers. If you want to change the CHP who is managing the area, you should Replace an Existing Community Health Promoter so fresh credentials are issued and the old credentials are deactivated.

CHA.changing.CHP.Name.and.Phone.Number.webm

Merging Duplicate CHPs or CHUs

https://www.loom.com/share/ff30ef54144845f2bdef082eb5fcec26?sid=eadc04f2-5852-4d47-90c2-fce004ecf5cb

Deleting a CHP Area

https://www.loom.com/share/2796f2fbf3d4410ca5c99b39723dd882?sid=7b77635a-3f1d-4c54-b4a9-38128dfd2933

Missing places in search suggestions

User managers can be assigned new places in the CHT if they need to see suggestions from these new places in the UMT forms

Audit log

Admin users

An audit log exists which is used to keep track of who created a user and when. This is only accessible by admin users but can be exposed via other tools eg. couch2pg for dashboards. The Audit log is stored on the contact documents themselves in CouchDB. For example, this is a stanza on the JSON from a contact created with the tool:

  "user_attribution": {
    "tool": "cht_usr-1.0.2",
    "username": "medic",
    "created_time": 1706062507968
  }

For replacements, the previous primary contact is logged

"user_attribution": {
    "tool": "cht-user-management-2.1.18",
    "username": "medic",
    "created_time": 1750851793126,
    "replacement": "New Chp Area",
    "warnings": [],
    "previousPrimaryContacts": [
      "c8ff5f0cbaf6f6419139d154830088b3"
    ]
  }

Some none-blocking unresolved warnings at the time of creation are logged

"user_attribution": {
    "tool": "cht-user-management-2.1.18",
    "username": "medic",
    "created_time": 1750851555359,
    "warnings": [
      "A place with the same \"CHU Code\" exists on the instance. ID \"[\"b541d403-6c11-4f80-a1a0-27f35670ca3b\"]\""
    ]
  }

To get a list you would need to download every single contact document and aggregate the data you're looking for. Alternately, you may be able to get this data with a couch2pg instance.