Protocols (formerly known as client templates) are useful tools to enrol multiple people into the same survey schedule. Usually, you would set up your m-Path platform to automatically enrol anyone who joins your population into a standard protocol, or manually assign protocols afterwards. However, if you have various protocols for different cases that you want to automatically assign, the Apply Protocol module provides the additional control you need.
The Apply Protocol module has just one field, named Protocol. This field generates a dropdown menu containing all your active protocols. Select the one you want to enroll this user in, and as soon as the user finishes the questionnaire containing this item, they will be enrolled in the selected protocol.
If the specific protocol in apply protocol was already scheduled for the participant, the old protocol is removed. However, if another protocol was already scheduled, nothing happens to the old protocol and the new protocol is added.
General
Specific
This specific settings are currently only available starting from dashboard version 15b. If you cannot find this module and are sure you need it, contact us at stijn.verdonck@kuleuven.be.
Start relative to
The default is ‘Current day‘. This means that the protocol is applied, starting on the current day. The other option is ‘Custom date‘. In this case the protocol is shifted to the specific date reference date.
Shift time (seconds or label)
Here it is possible to shift the protocol with a certain amount of seconds. It is possible to input a number. For example 3600 will shift the protocol with 1 hour. It is also possible to shift the protocol with a specific label. It is for example possible to set a specific label to a number in a computation item such as:
toShift=7200Subsequently, toShift can be filled in the field Shift time (seconds or label). In this case, the protocol would be shifted with 2 hours.
Clear this protocol and don’t reschedule
If this is enabled, the specific protocol is cleared. All scheduled interactions from this protocol are removed for the participant or client.
Clear all existing notifications
All scheduled interactions are cleared. It is possible to add a new protocol in the same apply protocol. In this case, first everything is cleared and subsequently the new protocol is added.
How to personalize a schedule.
Using Apply Protocol, it is possible to personalize a schedule for a specific participant. Here we propose an example on how to do so.
First, create a protocol where the daily schedule starts at the earliest possible time for all participants (for example 06:00 in the morning). We call this protocol defaultProtocol:
Second, in the intake questionnaire (the questionnaire that is presented to the participant immediately when the participants adds your research), the question is asked when the participant wakes up. Here, a multiple choice question is used.
Third, conditionally on this multiple choice question we apply the protocol with a specific shift. For example, when the participant indicates she/he wakes up at 08:00, we shift the protocol that starts at 06:00 with two hours or 7200 seconds. This is shown in the following picture. The protocol with name defaultProtocol will now start everyday at 08:00 for this participant.
