Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

View the introduction video for Custom User Data

...

...

Configure Custom User Data

...

This configuration would then update the Mobile Worker Registration Page to look like this:

...

Add Custom User Data

There are two ways to add custom user data - through the Mobile Workers section of CommCareHQ, or through Bulk Upload

...

Info

This feature requires a CommCare Software Plan

This feature (Bulk User Management) is only available to CommCare users with a Standard Plan or higher. For more details, see the CommCare Software Plan page.

You can use the Upload Mobile Workers in Bulk tool to add and update custom user data in bulk.

...

Some additional information is also available through custom user data. They are automatically added to the data:

Data

Path

Format

User's first name

instance('commcaresession')/session/user/data/commcare_first_name


User's last name

instance('commcaresession')/session/user/data/commcare_last_name


User's phone number

instance('commcaresession')/session/user/data/commcare_phone_number


User's primary location

instance('commcaresession')/session/user/data/commcare_location_id


User's locations

instance('commcaresession')/session/user/data/commcare_location_ids

space-separated list

User type

instance('commcaresession')/session/user/data/commcare_user_type

"web" or "commcare"

For example, to combine the user's first and last name into a single name in a hidden value, you can do the following:

...

If you do not check this box, the field will be removed, but users will still have the related data, which is now called "unrecognized" or "uncategorized." If you created a field called "size," assigned a value to a user, and then deleted the field, when you view the user you will see this section of "unrecognized" data. As described in the warning, if you save this user, the "size" value will be deleted.

...

 This This unrecognized data will still appear in mobile worker downloads and can still be edited. It will appear in columns marked "Uncategorized."

...

There are instances where custom user data will not be activated when used in an Application that was copied from another one.