...
...
| title | This feature requires a CommCare Software Plan |
|---|
| Multiexcerpt include macro | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
The feature allows HQ users to create "profiles" consisting of a set of app user fields, with values. Instead of setting every individual field for an app user, you can then assign a user a profile to automatically give the user the values defined in the profile. This feature was built for projects that use many fields, to save time and reduce room for error when creating and updating users.
...
From the mobile workers page, click the Edit User Fields button:
...
This takes you to your user field definitions:
...
You can add, edit, and delete profiles under the Profiles tab:
...
A profile can contain values for any or all fields defined for your project. The values used in the profile must pass field validation: for example, if a field specifies choices, any profiles with that field may only use those choices as values.
...
Users can be assigned to profiles when they are created or edited, in the same Additional Information area where user data is edited. Each user may only be assigned to one profile. Users can also be assigned profiles using bulk user upload (see next section). Any fields filled out by by the profile will be disabled.
...
Bulk Download and Upload of Users
...
The bulk user download contains a user_profile column containing the name of the profile the user is assigned to, if any. This field can be edited and re-uploaded. Blanking out this field will un-assign the user from the profile.
...
When removing a field from a profile, the field will also be immediately removed from any users assigned to the profile. If you wish to remove a field from a profile but have users retain that value, follow these steps:
Bulk download users and retain the file.
Blank out the user_profile column for the relevant users to un-assign them from the profile.
Edit the profile to remove the field.
Re-upload the original users file. This will reassign the users to the profile, and it will also add the removed field to each user's user data. Note that between the time you do the upload to un-assign users and the time you re-upload the file to re-assign them and add the removed field, users will be missing that field.
Deleting Profiles
Profiles may not be deleted until all users have been unassigned from them. This un-assignment should be straightforward to accomplish with a bulk user upload.
...
The user API does not support user_profile like bulk upload does. Profiles can be updated using the user API by updating the user_data field commcare_profile with the profile id. However, this is deliberately not publicly documented and it is not guaranteed that this behavior will remain the same in the future.