MyDataHelps Designer has a few different field types that can store participant information as outlined in this article. Refer to the Participant Fields Overview article for basic information about what participant fields are, how to populate them, and how to use them.
Table of Contents
Demographic fields capture standard participant demographic information. Below are the available demographic fields; new demographic fields cannot be created.
The ParticipantIdentifier field capturs the primary, project-specific identifier, unique to the participant.
For any other type of information to collect about a participant, you can create your own project-specific custom fields. Custom fields can be immensely powerful to your project and most projects will have custom fields that are available in a few different formats:
Custom fields are restricted to letters, numbers, and/or underscores (Word characters). Using CamelCase is recommended for ease of readability. Legacy projects may have custom fields with other characters, including spaces. These legacy fields will not be impacted. However, users will be restricted to Word characters only for any custom fields they add to their legacy projects moving forward.
- Date: You might consider storing important date information (e.g. SurgeryDate or DiagnosisDate) in a custom date field.
- Decimal: You might consider storing precise data (e.g. Weight) in a custom decimal field.
- Email: While there is already a demographic email field, additional custom email fields can store a secondary or caretaker’s email address.
- Integer: Similar to decimal, but stores integer (e.g. PriorPregnancies) in a custom integer field.
- Phone: Similar to email, but you might consider storing a secondary or caretaker’s phone number.
- Picklist: A field with pre-specified values that can be selected from a drop-down in many places. Refer to the Custom Field: Picklist article for further details.
- Text: You might want to store a string (e.g. StudySite) in a custom text field.
- Timestamp: Similar to date, but you can store a precise timestamp (e.g. ChildDelivery).
Creating Custom Participant Fields
While demographic and identifier fields cannot be created, you can create any number of custom fields to fit your project needs. To create a custom field:
- Navigate to your project and click on the Custom Fields tab.
- Add a name for your custom field (we strongly recommend using CamelCase for ease of readability).
- Optionally, add a description to your custom field and then click Add.
- You’ll now have the option to change the custom field format (see the above format descriptions) from the drop-down list. The default is “Text”.
- The “Coordinator Editable” checkbox allows coordinators to edit the custom field in the Participant Info tab or via the MyDataHelps REST API. The "Participant Editable" checkbox allows participants to modify the value of the custom field by using the MyDataHelps REST API. Custom Fields are always editable via surveys and schedules regardless of these setting.
Contact us to learn more about using the MyDataHelps REST API to update custom fields.
- After adjusting your custom field, make sure you click “Save Custom Field Settings”.
Alternatively, you can also create a custom field from the Populate Custom Field drop-down within a survey step’s properties by selecting “New Custom Field”.