{"id":3657,"date":"2021-06-15T18:39:05","date_gmt":"2021-06-15T18:39:05","guid":{"rendered":"https:\/\/m-path.io\/manual\/?post_type=ht_kb&#038;p=3657"},"modified":"2025-03-11T15:41:04","modified_gmt":"2025-03-11T15:41:04","slug":"protocols","status":"publish","type":"ht_kb","link":"https:\/\/app-manual-wp-001-atfsdabuggg7fzdq.germanywestcentral-01.azurewebsites.net\/knowledge-base\/protocols\/","title":{"rendered":"Protocols (formerly known as client templates)"},"content":{"rendered":"\n<p>If you are interested in using the same schedule for multiple clients, you can make use of a protocol. You can think of a protocol as a schedule for a fictional client that you can later copy to different real clients. Protocols exist of a combination of interactions\/questionnaires and a schedule.<\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">Creating and using protocols are <strong><a href=\"\/knowledge-base\/subscriptions-and-billing\/\">premium<\/a> <\/strong>functions.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Create and open protocols<\/strong><\/h3>\n\n\n\n<p>The following guide will show you how to create and open your protocols<\/p>\n\n\n\n<iframe loading=\"lazy\" src=\"https:\/\/scribehow.com\/embed\/How_to_Create_and_Open_Protocols_on_m-Path__4IizfEhNTzON6DpzaIZWcg\" width=\"640\" height=\"640\" allowfullscreen=\"\" frameborder=\"0\"><\/iframe>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Fill in or edit a protocol<\/strong><\/h3>\n\n\n\n<p>For a protocol, just as for a normal client, it is possible to add multiple questionnaires and a schedule. The creation of the questionnaires is exactly the same as for normal clients. However, the scheduler has some additional options. When clicking on a planned notification (see following video), there are three possibilities:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>&nbsp;This specific day<\/strong>: The schedule is created for the specific days on the calendar.<\/li>\n\n\n\n<li><strong>&nbsp;This day, relative to the starting date<\/strong>: The schedule is created relative to the starting date. When this protocol is used for a new participant or client, the first day of this schedule will be moved to the current day.<\/li>\n\n\n\n<li>&nbsp;<strong>The next day of this type (1st monday, 3rd tuesday, &#8230;), relative to the starting date<\/strong>: This is useful for when different questionnaires are planned on different days (for example a weekday vs. a weekend day).<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-video\"><video controls src=\"\/wp-content\/uploads\/2021\/06\/Untitled-Project2.mp4\"><\/video><\/figure>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-alert\">When using the <em>The next day of this type<\/em> setting, keep in mind that the day you are creating the protocol will not always be the day clients enroll to your protocol.<br><em>E.g. <\/em><meta charset=\"utf-8\"><\/meta><em>Let\u2019s say you were programming the protocol on Thursday. The next Wednesday is indeed pretty straight forward (6 days later), but the next Friday should not be programmed 2 days after that Wednesday, but as the Friday before: indeed starting from the day of editing (Thursday) the next Friday is already the day after.<\/em><\/p>\n\n\n\n<figure data-wp-context=\"{&quot;imageId&quot;:&quot;6a0c6d14d9993&quot;}\" data-wp-interactive=\"core\/image\" class=\"wp-block-image size-large wp-lightbox-container\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"138\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on-async--click=\"actions.showLightbox\" data-wp-on-async--load=\"callbacks.setButtonStyles\" data-wp-on-async-window--resize=\"callbacks.setButtonStyles\" src=\"\/wp-content\/uploads\/2025\/03\/next-of-type-1-1024x138.png\" alt=\"Table that shows that when the protocol starts on thursday, the next friday is the next day and the next wednesday is 6 days later. And when the protocol starts on monday, the next wednesday is two days later and the next friday 4 days later. So even though it's the same protocol, depending on when the protocol starts, that decides which day is going to occur first.\" class=\"wp-image-13737\" srcset=\"\/wp-content\/uploads\/2025\/03\/next-of-type-1-1024x138.png 1024w, \/wp-content\/uploads\/2025\/03\/next-of-type-1-300x40.png 300w, \/wp-content\/uploads\/2025\/03\/next-of-type-1-768x103.png 768w, \/wp-content\/uploads\/2025\/03\/next-of-type-1-50x7.png 50w, \/wp-content\/uploads\/2025\/03\/next-of-type-1-60x8.png 60w, \/wp-content\/uploads\/2025\/03\/next-of-type-1-100x13.png 100w, \/wp-content\/uploads\/2025\/03\/next-of-type-1.png 1123w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><button\n\t\t\tclass=\"lightbox-trigger\"\n\t\t\ttype=\"button\"\n\t\t\taria-haspopup=\"dialog\"\n\t\t\taria-label=\"Enlarge\"\n\t\t\tdata-wp-init=\"callbacks.initTriggerButton\"\n\t\t\tdata-wp-on-async--click=\"actions.showLightbox\"\n\t\t\tdata-wp-style--right=\"state.imageButtonRight\"\n\t\t\tdata-wp-style--top=\"state.imageButtonTop\"\n\t\t>\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewBox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\" \/>\n\t\t\t<\/svg>\n\t\t<\/button><figcaption class=\"wp-element-caption\">Visualisation of the explanation of &#8220;The next day of this type&#8221;<\/figcaption><\/figure>\n\n\n\n<p>When creating a protocol for research that does not require participant tailored content, you may want to refer directly to interactions in the library rather than using local interactions (the interaction tabs above the calendar). You can do this by selecting an interaction straight from the library using the <em>Interaction<\/em> drop down search in <em>Beep properties<\/em>. The consequence of not using a local tab interaction and referring straight to a library interaction is that if somewhere during the experiment you want to make a change to the content of that interaction (by editing and overwriting it in the library), this will apply to all new notifications sent with this particular interaction, also for participants that have already been enrolled. If, alternatively, you use a local tab interaction, this is simply copied from the protocol to the enrolling participant, and afterwards no longer synchronizes with the local tab interaction in the protocol. This has the advantage of allowing tailored content per participant.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Use a protocol for a single client<\/strong><\/h3>\n\n\n\n<p>To add a protocol to a specific client, go to the <em>Edit<\/em> tab for this client and click on the &#8216;+&#8217; icon. The <em>Add a new interaction<\/em> screen is now shown (see figure below). In the upper row, all available protocols are shown. You can scroll through all available  protocols by clicking on the left and right arrow. Click on one of the protocols to use it for the specific client.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"662\" height=\"536\" src=\"\/wp-content\/uploads\/2021\/06\/cap5.png\" alt=\"\" class=\"wp-image-3678\" srcset=\"\/wp-content\/uploads\/2021\/06\/cap5.png 662w, \/wp-content\/uploads\/2021\/06\/cap5-300x243.png 300w, \/wp-content\/uploads\/2021\/06\/cap5-50x40.png 50w, \/wp-content\/uploads\/2021\/06\/cap5-60x49.png 60w, \/wp-content\/uploads\/2021\/06\/cap5-100x81.png 100w\" sizes=\"auto, (max-width: 662px) 100vw, 662px\" \/><figcaption class=\"wp-element-caption\">In the upper row, all available protocols are shown.<\/figcaption><\/figure>\n\n\n\n<p>Now, you are greeted by the protocol planning dialog. There are a few options here:<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Start relative to<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Today<\/strong>: The protocol will start from today.<\/li>\n\n\n\n<li><strong>Custom date<\/strong>: You can set a custom starting date. This is useful to schedule a protocol starting in the future, or re-enrolling a participant who had already started earlier but has to re-enroll with a different account for some reason<\/li>\n\n\n\n<li><strong>Previous starting date<\/strong>: If you want to reapply the protocol for someone but use the previously used starting date, choose this.<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Set seed<\/h4>\n\n\n\n<p>For questionnaires within protocols that have timespans where they fire randomly, you can set the randomisation seed manually here. This way, you can make it so people with the same seed get their questionnaires randomly, but all at the same time.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"747\" src=\"\/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-26-at-17.22.50-1024x747.png\" alt=\"\" class=\"wp-image-11269\" srcset=\"\/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-26-at-17.22.50-1024x747.png 1024w, \/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-26-at-17.22.50-300x219.png 300w, \/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-26-at-17.22.50-768x560.png 768w, \/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-26-at-17.22.50-50x36.png 50w, \/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-26-at-17.22.50-60x44.png 60w, \/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-26-at-17.22.50-100x73.png 100w, \/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-26-at-17.22.50.png 1218w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Automatically use a protocol for multiple clients (for research)<\/strong><\/h3>\n\n\n\n<p>Each researcher or practitioner account can set a protocol that will automatically start when a client adds them. To do so, navigate to the <em>&#8220;Auto-enroll&#8221;<\/em>-menu under <em>Settings<\/em> in the sidebar Subsequently, under <em>Baseline settings<\/em>, choose <em>Use protocol<\/em> and choose the protocol you want to use. Finally, make sure that <em>Start baseline schedule automatically when a client adds me<\/em> is checked and click on <em>Save<\/em>. With these settings, the chosen protocol will automatically be loaded to every participant that adds you in the app.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Enrol participants in a protocol according to invitation code<\/h3>\n\n\n\n<p>It is possible to control which participants will be entered into which protocols, by supplying them with specific invitation codes. The following guide will show you how this is done.<\/p>\n\n\n\n<iframe loading=\"lazy\" src=\"https:\/\/scribehow.com\/embed\/How_to_Auto_Enroll_Users_into_Questionnaire_Template_on_M-Pathio__XkY2BkhxSd-uGN5irDZ5Bg\" width=\"640\" height=\"640\" allowfullscreen=\"\" frameborder=\"0\"><\/iframe>\n\n\n\n<h3 class=\"wp-block-heading\">Conditionally enroll clients in a protocol<\/h3>\n\n\n\n<p>If you want to assign different protocols to different clients conditionally, you can use an intake questionnaire which includes several <a href=\"\/knowledge-base\/apply-protocol\/\">Apply Protocol<\/a> modules, and use branching logic to trigger these on conditions of your choosing. As an example of this, the following guide shows you how you can enrol participants in a translation of a protocol depending on which language preference they declare in a default intake.<\/p>\n\n\n\n<iframe loading=\"lazy\" src=\"https:\/\/scribehow.com\/embed\/How_to_create_a_multi-language_study_in_m-Path__020ZUuVGTd6IoWgh9QMugw\" width=\"640\" height=\"640\" allowfullscreen=\"\" frameborder=\"0\"><\/iframe>\n\n\n\n<h4 class=\"wp-block-heading\">Start after consent<\/h4>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">The <meta charset=\"utf-8\"><em>Start baseline schedule after consent is given in intake<\/em> option is a <strong><a href=\"\/knowledge-base\/subscriptions-and-billing\/\">premium<\/a> <\/strong>function.<\/p>\n\n\n\n<p>When the option <em>Start baseline schedule after consent is given in intake<\/em> is chosen, the protocol will only be loaded and started after the intake questionnaire has been filled in by the participant and questions with a label that starts with &#8216;consent&#8217; have been answered with yes. This can be used to make sure that participants who don&#8217;t give consent won&#8217;t receive further questionnaires. For example, a Yes\/No question &#8216;Do you give consent to use your answers in research&#8217; with label &#8216;consent_question_1&#8217; can be added to the intake questionnaire. Only if the participant answers yes to this question (and all other questions with a label that start with &#8216;consent&#8217;), the baseline questionnaire will be started.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>If you are interested in using the same schedule for multiple clients, you can make use of a protocol.<\/p>\n","protected":false},"author":3,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"ht-kb-category":[364,114],"ht-kb-tag":[904,333,312],"class_list":["post-3657","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-scheduling","ht_kb_category-study-setup-and-deployment","ht_kb_tag-protocol","ht_kb_tag-research","ht_kb_tag-template"],"_links":{"self":[{"href":"https:\/\/app-manual-wp-001-atfsdabuggg7fzdq.germanywestcentral-01.azurewebsites.net\/wp-json\/wp\/v2\/ht-kb\/3657","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/app-manual-wp-001-atfsdabuggg7fzdq.germanywestcentral-01.azurewebsites.net\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/app-manual-wp-001-atfsdabuggg7fzdq.germanywestcentral-01.azurewebsites.net\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/app-manual-wp-001-atfsdabuggg7fzdq.germanywestcentral-01.azurewebsites.net\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/app-manual-wp-001-atfsdabuggg7fzdq.germanywestcentral-01.azurewebsites.net\/wp-json\/wp\/v2\/comments?post=3657"}],"version-history":[{"count":45,"href":"https:\/\/app-manual-wp-001-atfsdabuggg7fzdq.germanywestcentral-01.azurewebsites.net\/wp-json\/wp\/v2\/ht-kb\/3657\/revisions"}],"predecessor-version":[{"id":13749,"href":"https:\/\/app-manual-wp-001-atfsdabuggg7fzdq.germanywestcentral-01.azurewebsites.net\/wp-json\/wp\/v2\/ht-kb\/3657\/revisions\/13749"}],"wp:attachment":[{"href":"https:\/\/app-manual-wp-001-atfsdabuggg7fzdq.germanywestcentral-01.azurewebsites.net\/wp-json\/wp\/v2\/media?parent=3657"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/app-manual-wp-001-atfsdabuggg7fzdq.germanywestcentral-01.azurewebsites.net\/wp-json\/wp\/v2\/ht-kb-category?post=3657"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/app-manual-wp-001-atfsdabuggg7fzdq.germanywestcentral-01.azurewebsites.net\/wp-json\/wp\/v2\/ht-kb-tag?post=3657"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}