You are here:
Using Randomization to Anonymize Participant Allocation
Randomization involves allocating clinical trial participants into different comparison groups. The randomization API is available as an invocable action allowing it to be used through a flow or via a REST invocation.
Required Editions
| Available in: Lightning Experience |
| Available in: Enterprise and Unlimited Editions with Life Sciences Cloud or Health Cloud and the Participant Enrollment Add-On license |
Randomization
To set up the randomization API during the design phase, use the 'Assign Candidate to Research Study Group' invocable action to assign the candidate to a research study comparison group to facilitate the randomization. Use these specific criteria to invoke the invocable action through the randomization API.
- The API will have an input parameter researchStudyCandidateId, which is the ID of the research study candidate who must be randomized.
- The API will have an output parameter researchStudyComparisonGroupId, which is the group ID where the participant fits based on the randomization.
- The API will have an output parameter such as candidateAllocationSourceId, which is the context through which the research study candidate is mapped to the research study group.
These output parameters can be accessible to the user only in these scenarios.
- If the attribute Randomization Assigns Candidates To Groups is set to false in the Research Study Randomization object, or
- If the attribute Randomization Assigns Candidates To Groups is set to true in the Research Study Randomization object and the user can access the Research Study Comparison Group Candidate object.
Invoke Randomization Invocable Action Using Flows
You can create a screen flow to invoke the Assign Candidate to Research Study Group invocable action. Your flow must meet these criteria.
- The flow must have a research study candidate record ID as an input variable.
- This invocable action must use the research study candidate record ID as an input parameter.
- The flow must use the invocable action Assign Candidate to Research Study Group.
- If necessary, the flow can display the result of the action element inside a screen element.
Launch this Flow from an Object Page
You can launch this flow from an object page with a quick action. To create a quick action and add it to a page layout, see Create Quick Actions.
For example, you can create a quick action in a research study candidate. After the quick action is set up, you can use it to trigger the flow from research study candidate records. The participants are allocated according to the configuration defined in the research study randomization.
