Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents

Outline

This page will guide you through the steps of navigating to the Content Forms and then how to create computational forms that can calculate specific scores explains the computational forms feature which can be used to calculate scores for specific attributes based on the patient’s answers .

STEP 1: Click on Forms

Select the Content menu option from the menu panel on the left of the dashboard screen. Click on Forms from the drop-down on the menu panel on the left of the dashboard screen.

...

STEP 2: Create a new form

You can create a new form using the option “New” with the drop-down present on the top right corner of the page.

...

STEP 3: Add Form Details

We can start filling the required details in the field:

In the Details section, we can start adding Title of the form, Description of the form, Language required, and the Status field will have the option to : Publish form once created (if you want the form to be published), or, Don’t publish form (if you want the form not to be published). Select one and go to the Content section by clicking on the 'green >' icon.

...

STEP 4: Add Content

We can attach the required .JSON content to the form in this section. For creating computations forms, use one of the following .JSON content as required - and a computational formula for the attribute. This feature also shows the dashboard user a unique perspective on relative comparison of the scores across form submissions, each time the patient submits the same form. It is part of the Patient Reported Outcome Measures (PROMs) and is customisable to calculate scores for any required attribute which can be used by researchers and clinicians to assist with clinical monitoring of a patient's health journey.

...

Understanding Computations and adding them to .JSON content to create customisable Computational forms

You can add Computations code and formula to a .JSON content similar to the ones below and use that to create computationsl forms.

View file
nameKOOS.json
View file
nameDASS-21HOOS.json
View file
nameHOOSDASS-21.json

(OR) add the following computational code to an existing .JSON contentNote: Please check the bottom of the .JSON content attached above to see the Computations code and formula for KOOS, DASS-21, and HOOS respectively.

Example Computation Code for DASS-21 form

Code Block
  "computations": {
    "depression": {
      "display_name": "Depression",
      "display_order": 1,
      "type": "symbolic",
      "function": "q3 + q5 + q10 + q13 + q16 + q17 + q21",
      "improvement": "decrease"
    },
    "anxiety": {
      "display_name": "Anxiety",
      "display_order": 2,
      "type": "symbolic",
      "function": "q2 + q4 + q7 + q9 + q15 + q19 + q20",
      "improvement": "decrease"
    },
    "stress": {
      "display_name": "Stress",
      "display_order": 3,
      "type": "symbolic",
      "function": "q1 + q6 + q8 + q11 + q12 + q14 + q18",
      "improvement": "decrease"
    }
  }

Note: Please check the bottom of the .JSON forms attached above to see the Computations formula for KOOS, DASS-21, and HOOS respectively.

Upload the required file in this field by cliking on the ‘upload’ icon shown in the figure below. This will open a dialogue box to find a .json file on your computer. Select the desired .json file and then upload it.

...

STEP 4A: Review your uploaded .JSON

...

STEP 6: Review the created form

The final category Review would helps you review the whole summary of the form with the attached content. Press the back arrow if you want to change any details. Click on the Save button to create the new form.

...

In the above example (Line 2-8, computational code for one attribute: Depression),

  • "computations": { is the key that informs the system that there are computations to be done in this form.

  • "depression": indicates the attribute whose score will be calculated.

  • "display_name": "Depression" is the text that will be displayed to the patient on the app for this attribute.

  • "display_order": 1 indicates that the calculated score for the attribute ‘Depression’ will be displayed first among the three attributes on the score card. The dashboard user can just change the value from '1' here, to any other positive integer value to change the order in which the attributes are displayed on the score card in the form results of a patient, on the dashboard. The order is displayed from left to right and top to bottom for more than three attributes as illustrated below -

Depression ("display_order": 1)

Anxiety ("display_order": 2)

Stress ("display_order": 3)

"display_order": 4

"display_order": 5

"display_order": 6

"display_order": 7

"display_order": 8

"display_order": 9

  • "type": "symbolic" indicates the calculated score will be displayed as an integer value ('-ve', ‘0.0’, '+ve') on the dashboard.

  • "function": "q3 + q5 + q10 + q13 + q16 + q17 + q21" is the computational formula for the attribute ‘Depression’ based on which the score will be calculated.

  • "improvement": "decrease" is used to visualize the calculated score in ‘Green’ or ‘Red’ colour prefixed by an ‘Upward’ or ‘Downward’ arrow. This illustrates a relative comparison of the calculated score across form submissions.
    In this case, if the calculated score decreases from the first form submission to the second, it will be shown in green with a downward green arrow in the second form submission. The opposite scenario, i.e., if the calculated scores increase from the first form submission to the second, it will be shown in red with an upward red arrow in the second form submission.
    On the other hand, "improvement": "increase" can be used to achieve the opposite result. Here, if the calculated score decreases from the first form submission to the second, it will be shown in red with an downward red arrow in the second form submission. The opposite scenario, i.e., if the calculated scores increase from the first form submission to the second, it will be shown in green with an upward green arrow in the second form submission.

The same lines of code (2-7) can be repeated as shown in the picture above (repeated 3 times for the attributes - ‘Depression’, Anxiety' and ‘Stress) to calculate scores for various other attributes using the patient’s answers from the same form submission in ‘Form Results’. These scores can be viewed together on the dashboard under the ‘Scores’ card in 'Form Results’ as shown below.

...

Info

Filter by label (Content by label)
showLabelsfalse
max5
spacescom.atlassian.confluence.content.render.xhtml.model.resource.identifiers.SpaceResourceIdentifier@3ffc84e
sortmodified
showSpacefalse
reversetrue
typepage
cqllabel = "kb-how-to-article" and type = "page" and space = "FPAKB"
labelskb-how-to-article

...