How to use the online version of EQ-5D in your intervention

What is EQ-5D?

EQ-5D is a standardised questionnaire for use as a measure of health outcome.

Information on EQ-5D, including licencing, costs and a demo, can be found here: http://www.euroqol.org/

How can it be used with LifeGuide?

The online version of EQ-5D can be incorporated into LifeGuide interventions. After clicking on a button on one of the pages in your intervention, end-users will be taken to the Euroqol website to complete the EQ-5D, and will then automatically return to one of the pages in your intervention.

The data from EQ-5D will be saved to the end-user and stored on our server with the rest of the LifeGuide data, provided the end-user completes EQ-5D and returns to your intervention via the appropriate page. Euroqol keep an anonymised copy of EQ-5D data on their system.

How do I get started?

When you have decided that you want to use the online version of EQ-5D in your intervention, you will need to fill out a registration form on the EuroQol website: http://www.euroqol.org/register-to-use-eq-5d.html

You will then be sent information on how to proceed. You will need a licence code from EuroQol, which you will need to insert into the LifeGuide logic for the pages to load correctly.

How to set up EQ-5D in LifeGuide

The example below refers to using EQ-5D in a baseline questionnaire and 6-month follow-up questionnaire.

EQ-5D is usually placed near the end of your baseline questionnaires.

Step 1 - Create the pages and add content

Create the pages

Baseline questionnaire pages:

In addition to your current baseline questionnaire pages, you will need to create the following new pages:

- baseline_eq5d_1 (this page will have a link that takes the end-user to the EuroQol website)

- baseline_eq5d_2 (this is the page that end-users return to after they have answered the questions on the EuroQol website)

Follow-up questionnaires pages:

You will also need to create two pages for the follow-up:

- followup_eq5d_1 (this page will have a link that takes the end-user to the EuroQol website)

- followup_eq5d_2 (this is the page that end-users return to after they have answered the questions on the EuroQol website)

Add the content to the pages

Page baseline_eq5d_1:

- Insert a text box and the following text (please adapt as necessary):

Thank you for answering all of the questions so far. There are just a few more short questions to answer. The next page will look slightly different to the rest of [Name of your intervention], as we had to use an external website to gather the information. Please do not close your browser. Please answer the questions and you will then be automatically redirected back to [Name of your intervention].

- Insert a text box, and cut and paste the following in the textbox properties box on the right-hand side of the authoring tool:

<printedVariable identifier="url" class="asAnchor" label="Please click here to continue"/>

Page baseline_eq5d_2:

- Insert a text box and insert the following text (please adapt as necessary):

Thank you for answering all of the questions. It is very important that you click on the 'Next' button below to save your answers.

- Insert 6 Text Entry boxes with the following Unique names (please make sure you enter the names exactly as they are below as you will refer to these names in the logic file):

1) hiddenauto_EQ5D_A

2) hiddenauto_EQ5D_SELFCARE

3) hiddenauto_EQ5D_M

4) hiddenauto_EQ5D_USUALACT

5) hiddenauto_EQ5D_PAIN

6) hiddenauto_EQ5D_VAS

These 6 text-entry boxes will be hidden from users and can be placed anywhere on the page.

N.B. It is important that end-users click on the Next button on this page so that their data is saved. If they do not click Next, their EQ-5D data will not be saved.

Step 2 -The logic - part 1 [In progress]

The following logic will need to appear near the top of your logic file. You can use the variable names listed below (e.g. eq5d_intervention_base_url, eq5d_license, etc.) and change some of the other logic as stated below so that it is specific to your intervention.

set eq5d_intervention_base_url to "https://www.lifeguideonline.org/player/play/....."

The URL given above is the address of your intervention after it has been uploaded. It needs to be changed to match the match the URL of your intervention. The "....." will need to match the shortname of your intervention. Please be aware that the URL will vary depending on which of our servers you are using. If you are using your own server, the URL will be completely different! If you are previewing your intervention, the URL will look like this "http://localhost:38180/player/play/....."

set eq5d_license to "xxx"

The "xxx" above needs to be the license code supplied by EuroQol

set eq5d_base to (append ("https://www.onlineeq5d.org/TEGV4_1/Common/hub/GET_MANAGE_LIC_QUEX_REQUEST.CFM?RTP=URL&LID=9&CEVN=ANXIETYDEPRESSION/FIELD_EQ5D_ANXIETY%2CMOBILITY/FIELD_EQ5D_MOBILITY%2CPAINDISCOMFORT/FIELD_EQ5D_PAIN%2CSELFCARE/FIELD_EQ5D_SELFCARE%2CUSUALACTIVITES/FIELD_EQ5D_USUALACT%2CVAS/FIELD_EQ5D_VAS%2CMETA_STPARTNERSUBJECTID/FIELD_EQ5D_SUBJECTID&LPCID=_beginurlencoded_", eq5d_license, "_endurlencoded_&RID=_beginurlencoded_", username, "_endurlencoded_&")).

The line above needs to be cut and pasted EXACTLY as it is in order the data to be saved correctly.

Step 3 - The logic - part 2 [In progress]

The following logic will need to appear near the show baseline_eq5d_1 set eq5d_callback_url1 to "jumpto=baseline_eq5d_2&thiz=baseline_eq5d_1"#jwz#12/02/14#"thiz=baseline_eq5d_2&jumpto=baseline_eq5d_2"

1. Change this value to change the text for the link

set baseline_eq5d_1.text to "Click here to complete the final questions" set baseline_eq5d_1.target to (append(eq5d_base, "&PBU=_beginurlencoded_", eq5d_intervention_base_url,"?", eq5d_callback_url1, "_endurlencoded_"))

show baseline_eq5d_2 savevalue (username, "EQ5Ddone", baseline_eq5d_2.hiddenauto_EQ5D_ANXIETY)

The data

The text entry interactions with the names starting "hiddenauto_EQ5D" will be filled in with the EQ-5D data.