4 Add Participants


You must add Participants to be able to enter data.



A Participant is a person who participates in your Study and provides data. This could be a patient receiving treatment or a test subject in a clinical trial.



For example, a Participant might have a specific demographic or medical condition that is required to participate in the Study.


Adding Participants

You must add Participants to a Study before you can enter data for those Participants. There are different ways to add Participants:

Your study must have a Status of Available to add Participants. To set the Status to Available:

1. From the User menu, select My Studies.

2. Select Share and the environment in which you want to share the study.

3. Click the Change Status link at the top of the screen.

4. Select a Status of Available.


Depending on the study settings, studies can be configured to allow you to do one of the following:

  • Manually enter the Participant ID.
  • Automatically generate a Participant ID based on a predefined format template.
  • Add Participants in batch using Web Services (for Administrators with Data Manager access).

For more information on Study Settings, see Edit Settings. For more information on Web Services, see OpenClinica 4 Technical Documentation.


Note: If you do not see the Add New Participant link above the Participant Matrix, either your User Role does not have access to add Participants, or the Data Manager has set a limit for the number of Participants allowed in the study, and your study has reached the maximum number of Participants. In addition, you cannot add Participants if a study has a status of In Design, Frozen, or Locked. If you are a Data Manager and want to change the maximum number of Participants allowed for a study, see the Study Settings information in Create a Study.


You can add Participants:

  • Manually.
  • Automatically.
  • In a batch.


The Method of Creation field is set to Manual Entry by default. To change this setting to allow automatic entry:

1. From the My Studies screen, click the Settings (gear) icon under the study name, and select Settings.

2. Click the Edit link next to the Participant ID Settings header.

3. Click the radio button next to System-generated.

Note: If Method of Creation is set to System-generated, only Data Managers can edit the Participant ID.

If you choose System-generated, you must specify the template for the system-generated ID.


You can generate Participant IDs by the following methods:

  • The Participant Count Method: Generate Participant IDs sequentially.
  • The Random number Method: Generate Participant IDs using random numbers.

You can build your ID Template using one or more of the following components:

1. ${siteId} - The unique identifier for the site the Participant is being added to.

2. ${siteParticipantCount} - The current number of Participants at the site. This is generally used like ${(siteParticipantCount+1)} to have the ID increment the Participant count for each new Participant added.

3. ${helper.random(n)} - Generates a random number with up to n digits each time a Participant ID is generated.

4. ?string[‘000’] - Added to the resulting values to pad them with leading zeros to equal the number of digits specified, for example, ${(siteParticipantCount+1)?string[‘000’]} or ${(helper.random(5))?string[‘00000’]}.

5. Prefixes, suffixes, separators - Include other text (such as "-" or a Study-specific prefix) to include standard content in each ID.


Note: Each ID Template must include #2 or #3.




The Participant Count Method template, ${siteId}-${(siteParticipantCount+1)?string[‘000]}, for site University Hospital (Site ID = “UH”) would produce the IDs, UH-001, UH-002, UH-003, etc.

The Random number Method template, P-${(helper.random(5))?string[‘00000’]}, would produce IDs with a fixed prefix of “P-” followed by a 5-digit random number (including leading zeros), for example P-00362, P-82394, P-35070.


To manually add a Participant:

1. From the Tasks menu, select Add Participant, or on the Participant Matrix screen, click Add New Participant above the matrix.

2. Enter a Participant ID in the Add New Participant screen. (This should be a unique identifier, e.g. 001).

3. Click the Add button.


To make the system automatically generate a Participant:

1. Set the Method of Creation field to System-generated (see above).

2. From the Tasks menu, select Add Participant, or on the Participant Matrix screen, click Add New Participant above the matrix.

3. Click the Add button in the Add New Participant screen to generate a Participant ID.


To add Participants in a batch:

1. From the User menu, select Administration.

2. Click the Web Services Information button.

3. Execute the API to create a batch of Participant IDs.


Once you have added a Participant to your study, you can enter data.

Approved for publication by ktamm. Signed on 2020-08-27 4:06PM

Not valid unless obtained from the OpenClinica document management system on the day of use.