Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Text about bulk adding locations, removed old screenshot

In a lot of use cases CommTrack mobile worker needs to be associated with potentially multiple locations (i.e. 50-100 facilities per mobile worker). This page would walk you through the bulk upload tool to create multiple locations, and the tool to associate each CommTrack mobile worker with multiple locations.

Image Removed

 

...

There are two ways creating mobile users: Manual creation and Bulk upload. You should use bulk upload tool if:

  1. You have more than a certain number of mobile users (anyway, a lot)
  2. In your project each mobile user is associated with multiple locations / programs

Manual Creation

Go to Users screen and select "New Mobile Worker". Two steps are included in this manual creation process:

  1. Basic input: username and password
  2. CommCare Supply settings: clicking the username of the newly created mobile user, select 'Locations' to the right of 'Groups' and associate the mobile user with a specific supply point and program. 

Bulk Upload

This tool would allow you to create mobile workers in bulk and associate them with different locations all in one go.

...

 Go to Users and select Bulk Upload. Download excel file.

...

Image Added

Image RemovedImage Added

In sheet users, username and password are two required columns. All else are optional (phone-number would also be required if you are using CommTrack CommCare Supply SMS instead of mobile app). 

Image Removed

Once you are done with the sheet, go to sheet locations and associate each mobile worker with facilities. It is necessary to fill in username and location-sms-code columns.

Image Removed

Once you are done with these two sheets, upload it and click 'Create Mobile Workers'. After you see the line "Your bulk user upload is completed!",  go back to Mobile Worker page and check if they are associated with facilities you assigned them.

Image Removed

Displaying all the facilities that that person is linked to is a future feature, but is not currently implemented. Right now we just show 1 facility that the mobile worker is associated with. In matt's case, Go to CommTrack and you would see the Supply Point he is associated with clinic 6.

...

Image Added

Fill in the other fields as necessary and note that a user can be assigned a location (Supply Point) through the location columns. A user can be assigned multiple locations if desired, though for each additional location a new column must be added in excel (location_code 2, etc.)

Once you are done editing the download, upload it and if there are no errors, you will be shown a screen like the image below.

Image Added

On the Mobile Workers page, selecting that worker's user name will bring you to Edit Mobile Workers. The Locations tab on this screen will show you what Locations (or Supply Points) are assigned to this user. Here, you can also see that user's primary location and any associated Program.

Image Added