TrialKit allows users to automatically populate values based on a specified condition and trigger. Populating can be based on all available conditions. Any field type can be populated with the exception of upload fields. This document explains how Populate Value works.
Populating fields happens during some trigger event. That event is defined in the "condition" portion of the Conditional Action. Any field defined in the condition, becomes a trigger field. When a value in that field changes, the event is triggered. Because of this, and similar to Hide and Disable conditional actions, dynamic events must be triggered by checkbox or choice field. Trigger events are only supported from the main form (not sub forms or normalized tables).
Populating can also be accomplished based on the form simply opening up, assuming the conditon is true and there is a "Manual" property set on the Conditional action.
To create a Manual condition, simply enter the text "Manual" as the first part of the conditional action name.
When doing this Similar to a computed field. The following icon will appear next to the field and the condition will get checked automatically when a record is opened by a user.If the condition is not yet true, the icon can be tapped the user to manually trigger the populate if there is not trigger condition already set.
Defining a Populate Value Conditional ActionThe Populate Value conditional action is the key to automatically populating field values. Like all other conditional actions, you must define a Populate Value for each field that you want populated.
The following shows a Populate Value conditional action that inserts the number 3 into a numeric field. The "3" is a Number type selected in the lower portion of the window.
The above image shows you how to conditionally populate field values. You must first enter the condition and then define the data with which to populate the field.
Remember, the condition is what defines the event to populate the field. In this case, the ABC_LFT select field is defined to be “Yes”. When the user selects “Yes” in the ABC_LFT field that will trigger the Populate Value event. In this case, the target field will be populated with the value “3.4”.
Understanding Populate Value Logic
Populate Value will only populate a field if the condition that is defined is true. In other words if the condition is met, the field will be populated. Of course this only happens if an event is triggered that causes the system to evaluate the Populate Value CA.
Types of Values with Which to Populate
The following describes the types of values with which to populate. It is important to understand the system will recognize the field type that you are populating and provide you with the appropriate values. There are rules for getting values to populate. They include not populating fields from other fields that have unlike field types.
- Number - Allows you to type in a number value. Remember you should only use like types. For example, you would not want to use this when populating a date field.
- Value - Allows you to enter a direct value to populate with. For example, it will include all the choices for select and radio fields. For text fields, it will allow you to enter text. For a date/Time field, it will give you a date control.
- Field - Allows you to choose from a list of fields within the current form. This list will contain fields with the same type.
- Constant - Allows you to populate with a predefined constant, including a randomization allocation. Be sure you select a like typed constant or you will receive an error message when saving the form.
- External Value - This allows you to pull data from any external field and populate the target or current field. A list of external fields that have been defined within the study will be presented.
Using Populate Value to Clear a Field - Clearing Data from a field with conditional action.
You can use the Populate Value conditional action to clear a field. It processes the condition exactly the same way. However, if you want to clear the target field, do not enter anything into the target value area, which is located at the bottom of the conditional action window. By leaving this blank, when the event is triggered by the user, the system will clear the field if the condition is true.