Create an Assessment

In this guide, we’ll walk through how to create Assessments in Workshop.

First steps

Begin by learning about Assessments with this feature overview.
Now that you understand the feature, it’s time to start building. Begin by ensuring that you’ve “Locked” your configuration to make changes.
Next, choose Assessments from the Element section of the Workshop menu. This opens up the Assessments landing page. Once you’ve made an Assessment, it’ll be displayed on this page.
To create an Assessment, click the Create Assessment button.

On the New Assessment page, you will begin making your form. As you build the Assessment, your changes will appear In the Preview screen.

Enter a Name for this Assessment. Choose a name that’s unique, and concisely describes its purpose-- these names are displayed to coaches as a list on the Patient Profile Assessments menu, and as drop-down menu items when building Processes that use Assessments as a condition.
Next, select the Audience for this Assessment. Select Coaches if you don’t want patients to have access to it. Select Coaches and patients if you plan to send the Assessment directly to patients.

Sections

Create multiple Sections to group related questions together, break up the form by workflow, or to simply organize the Assessment so it's easier for the reader to process.

To make more sections, click Add Section.
Similar to Assessment names, enter a Heading to briefly convey the focus of that section to the audience. For example, “Habits & Practices.”
You can write a Description to provide further context for the section. You can also use the Description field to create scripts for coaches administering that Assessment. Ensure the Assessment has Coach as the Audience selection before creating a script that’s not intended for patient view.
Write a Footer if you’d like to end conclude a section with any text for audience. For example, “Thank you for completing the Habits & Practices portions of this survey.”
To delete a section, click Delete Section.

Important note: Deleting a section will delete all questions within that section.

Fields

To add questions to your Assessment, you must first decide on a field type. “Fields” refer to the individual questions that you add to Assessments. Each field type offers a specific format for how responses to that question can be submitted. Consider the information you want to collect, and then select the field option best suited for that response.

Assessment field options are:

Text Field- Text fields provide an empty text box for open-ended text responses.
Read-only Text- Read-only text allows you to add text to your form that’s intended to provide information, not prompt responses. For example, instructions or scripts.
Multiple Choice Field- Multiple choice fields let you create a drop-down menu with predefined response options. You can enable this field to allow the respondent to select multiple options, or just one.
Number Field- Number fields only accept numeric responses. You can enable this field to allow whole or decimal responses.
Date Field- Date fields display a calendar from which the respondent must select a date.

To add a field, click on the (+) button, and select an option from the drop-down menu. Every field will have an automated Field ID, which acts as a reference number for that question.
There are multiple selections you can make inside each field. Begin by entering a Question. You can add “variables” to your questions, to personalize them for the respondent or have them reference specific data.

Variables

“Variables” are placeholder displays that automatically populate with the dynamic data they represent, whenever the Assessment is triggered. The data that appears in place of the variable code is automated based on the context of the Assessment.

For example, if you paste the {{patient_first_name}} variable code after “Hello” in the Question box, and that Assessment is sent to Yogi Bear, the question will read “Hello Yogi.”

Currently, Assessment variables include:

Patient names
Coach names
Appointment information
Custom Data

Important Note: You must first create Appointment Prompts and Custom Data in Workshop, in order for those variable options to appear in the variables menu.

To use a variable, click Add Variable. Select an option from the menu by clicking the variable code to copy it. To close the variables menu, click Close Variables, then insert your cursor into the question where the data should appear, and paste.

Next, select if the question will be Required and/or Conditional.

If this question should be answered by everyone who receives the Assessment, click the Required checkbox. Otherwise, leave the box unchecked.

Conditional fields

Making a field conditional allows you to “enable” it or “disable” it on the form, depending on a previous question’s response. Conditional fields ensure respondents won’t have to process to questions that aren’t relevant to them, so the form stays as brief as possible.

For example: If the initial question asks, “Does this patient smoke?” and is answered “Yes,” then the Assessment will enable a series of follow-up questions based on that response. If “No” is selected, those follow-up questions won’t be active on their Assessment.

If this question should be conditional, click the Conditional checkbox. Otherwise, leave the box unchecked.
After you’ve made the field conditional, select the Conditional Type.
Next, complete the conditions that must be met to “enable” or “disable” on this question on the Assessment.

Important Note: You must create the initial question that impacts this new field before you can make it conditional. When making a conditional field, you’ll need the initial question’s field ID for reference.

Multiple Choice Fields

In multiple choice field, you must create options for the respondent to choose from, that will appear as a drop-down menu.

For each menu item, click Add Option and enter the response.
If you want to allow the respondent to select multiple options, click Allow multiple selections checkbox. Otherwise, leave the box unchecked.

Number Field

To enable decimal or fraction responses in number fields, click the Allow decimal responses checkbox. If you want responses to be submitted using whole number only, leave the box unchecked.

Last steps

Select permissions for this Assessment using the Visible to options:

Select the Roles and Phases this Assessment be accessible to.

Rearrange fields

Once you’ve created questions, you can rearrange them.

Click Rearrange fields to reorder how questions appear in a section, or move them between sections.

When you’re finished building your Assessment, or want to save your work:

Click Create Assessment

Here are some additional resources:

Articles in this section

First steps