Contents

Introduction

The GP Appointment Booking plugin allows members of the public to book and cancel GP appointments using Digital Interactive TV.

As a Starter Kit plugin, the functionality is presented in the context of a Starter Kit microsite, in the theme (colours, logos etc) of the microsite.

The plugin is essentially a "presentation proxy" for the EMIS Access application, a third party API which links to EMIS systems used by around 5000 GP surgeries nationwide.

The following sequence of figures shows screenshots from the TV service, and the XML generated by the plugin for each screen.

Model-View-Controller pattern

The GP plugin uses a MVC Model 2 design paradigm to separate control, business, and presentation logic. This is implemented in J2EE using the Struts and Spring MVC frameworks. Form action targets are specified using logical action references, serviced by action classes which handle workflow concerns and delegate presentation (i.e. XML generation) to JSPs. This approach has proven invaluable in this reasonably complex plugin. There are many ways to achieve the same thing with different technologies.

For more on MVC:

http://java.sun.com/blueprints/guidelines/designing_enterprise_applications_2e/web-tier/web-tier5.html

For an approach to MVC in .NET:

http://builder.com.com/5100-6387-1044951.html

Workflow diagram

The following diagram describes the logical sequence of screens in the GP plugin.

Workflow diagram
(click thumbnail to enlarge)

Screenshots and XML

Login screen

Screenshot

XML

(click thumbnail to enlarge)

<?xml version="1.0" encoding="ISO-8859-1"?> <screen xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.digitv.gov.uk/schemas/plugin.xsd"> <page backup="exit:" title="Book a doctors appointment" transform="default"> <form action="/gpplugin/loginSubmit.do" method="get" name="login"> <static value="Please key in your details:"/> <numbersField hint="Enter your practice ID" label="Practice ID:" name="practiceId" size="10" value=""/> <numbersField hint="Enter your access ID" label="Access ID:" name="accessId" size="10" value=""/> <textField hint="Enter your password" label="Password:" name="password" size="10" value=""/> <static value="If you have forgotten your password, please contact your surgery."/> <static value="If you have not yet registered, please select 'New users'."/> <submit name="left" title="New users"/> <submit name="right" title="Sign in"/> <hiddenField name="formAction" value="/gpplugin/loginSubmit.do"/> <hiddenField name="formMethod" value="get"/> </form> </page> </screen>

Your appointments (none booked)

Screenshot

XML

(click thumbnail to enlarge)

<?xml version="1.0" encoding="ISO-8859-1"?> <screen xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.digitv.gov.uk/schemas/plugin.xsd"> <page backup="login.do" title="Your appointments" transform="default"> <form action="/gpplugin/yourAppointmentsSubmit.do" method="post" name="blank"> <static value="You have no appointments booked."/> <static value="You can have a maximum of two appointments booked at any one time."/> <static value="Select 'Book' to book a new appointment."/> <submit name="right" title="Book"/> <hiddenField name="formAction" value="/gpplugin/yourAppointmentsSubmit.do"/> <hiddenField name="formMethod" value="post"/> </form> </page> </screen>

Your appointments (1 booked)

Screenshot

XML

(click thumbnail to enlarge)

<?xml version="1.0" encoding="ISO-8859-1"?> <screen xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.digitv.gov.uk/schemas/plugin.xsd"> <page backup="login.do" title="Your appointments" transform="default"> <form action="/gpplugin/yourAppointmentsSubmit.do" method="post" name="blank"> <static value="You have the following appointment(s):"/> <static value="Thu 20 Sep at Back Lane Surgery with Dr Stanley Fraser at 14:00"/> <static value="You can have a maximum of two appointments booked at any one time."/> <static value="Use the options below to book or cancel an appointment."/> <submit name="left" title="Cancel"/> <submit name="right" title="Book"/> <hiddenField name="formAction" value="/gpplugin/yourAppointmentsSubmit.do"/> <hiddenField name="formMethod" value="post"/> </form> </page> </screen>

Your appointments (2 booked)

Screenshot

XML

(click thumbnail to enlarge)

<?xml version="1.0" encoding="ISO-8859-1"?> <screen xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.digitv.gov.uk/schemas/plugin.xsd"> <page backup="login.do" title="Your appointments" transform="default"> <form action="/gpplugin/yourAppointmentsSubmit.do" method="post" name="blank"> <static value="You have the following appointment(s):"/> <static value="Thu 20 Sep at Back Lane Surgery with Dr Stanley Fraser at 14:00"/> <static value="Fri 21 Sep at Main Rd Surgery with DR ROB MOVERLEY at 09:00"/> <static value="You can have a maximum of two appointments booked at any one time."/> <static value="Use 'Cancel' to cancel an appointment."/> <submit name="left" title="Cancel"/> <hiddenField name="formAction" value="/gpplugin/yourAppointmentsSubmit.do"/> <hiddenField name="formMethod" value="post"/> </form> </page> </screen>

Select date (1 of 2)

Screenshot

XML

(click thumbnail to enlarge)

<?xml version="1.0" encoding="ISO-8859-1"?> <screen xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.digitv.gov.uk/schemas/plugin.xsd"> <page backup="yourAppointments.do" title="Book an appointment" transform="default"> <form action="selectDateSubmit.do" method="get" pagingText="Page 1 of 2"> <hiddenField name="pageNum" value="1"/> <static value="Select the date you would like an appointment:"/> <multisubmitField name="selection"> <fieldOption name="Wed 19 Sep" value="2007-09-19"/> <fieldOption name="Thu 20 Sep" value="2007-09-20"/> <fieldOption name="Fri 21 Sep" value="2007-09-21"/> <fieldOption name="Sat 22 Sep" value="2007-09-22"/> <fieldOption name="Mon 24 Sep" value="2007-09-24"/> <fieldOption name="Tue 25 Sep" value="2007-09-25"/> <fieldOption name="Wed 26 Sep" value="2007-09-26"/> <fieldOption name="Thu 27 Sep" value="2007-09-27"/> <fieldOption name="Fri 28 Sep" value="2007-09-28"/> </multisubmitField> <submit name="left" title="Back"/> <submit name="right" title="More"/> <hiddenField name="formAction" value="selectDateSubmit.do"/> <hiddenField name="formMethod" value="get"/> </form> </page> </screen>

Select date (2 of 2)

Screenshot

XML

(click thumbnail to enlarge)

<?xml version="1.0" encoding="ISO-8859-1"?> <screen xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.digitv.gov.uk/schemas/plugin.xsd"> <page backup="yourAppointments.do" title="Book an appointment" transform="default"> <form action="selectDateSubmit.do" method="get" pagingText="Page 2 of 2"> <hiddenField name="pageNum" value="2"/> <static value="Select the date you would like an appointment:"/> <multisubmitField name="selection"> <fieldOption name="Sat 29 Sep" value="2007-09-29"/> <fieldOption name="Mon 1 Oct" value="2007-10-01"/> <fieldOption name="Tue 2 Oct" value="2007-10-02"/> <fieldOption name="Wed 3 Oct" value="2007-10-03"/> <fieldOption name="Thu 4 Oct" value="2007-10-04"/> <fieldOption name="Fri 5 Oct" value="2007-10-05"/> <fieldOption name="Sat 6 Oct" value="2007-10-06"/> <fieldOption name="Mon 8 Oct" value="2007-10-08"/> <fieldOption name="Tue 9 Oct" value="2007-10-09"/> </multisubmitField> <submit name="left" title="Back"/> <hiddenField name="formAction" value="selectDateSubmit.do"/> <hiddenField name="formMethod" value="get"/> </form> </page> </screen>

Select surgery

Screenshot

XML

(click thumbnail to enlarge)

<?xml version="1.0" encoding="UTF-8" ?> <screen xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.digitv.gov.uk/schemas/plugin.xsd"> <page backup="yourAppointments.do" title="Book an appointment on Wed 19 Sep" transform="default"> <form action="selectSiteSubmit.do" method="get" pagingText=""> <hiddenField name="pageNum" value="1"/> <static value="Please choose your surgery:"/> <multisubmitField name="selection"> <fieldOption name="Back Lane Surgery" value="2"/> <fieldOption name="Main Rd Surgery" value="1"/> </multisubmitField> <submit name="left" title="Back"/> <hiddenField name="formAction" value="selectSiteSubmit.do"/> <hiddenField name="formMethod" value="get"/> </form> </page> </screen>

Select time

Screenshot

XML

(click thumbnail to enlarge)

<?xml version="1.0" encoding="ISO-8859-1"?> <screen xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.digitv.gov.uk/schemas/plugin.xsd"> <page backup="yourAppointments.do" title="Book an appointment on Thu 20 Sep" transform="default"> <form action="selectTimeSubmit.do" method="get" pagingText=""> <hiddenField name="pageNum" value="1"/> <static value="Select the time you would like an appointment:"/> <multisubmitField name="selection"> <fieldOption name="14:00 with Dr Stanley Fraser" value="1190293200000"/> <fieldOption name="14:40 with Dr Stanley Fraser" value="1190295600000"/> <fieldOption name="15:20 with Dr Stanley Fraser" value="1190298000000"/> <fieldOption name="16:00 with Dr Stanley Fraser" value="1190300400000"/> </multisubmitField> <submit name="left" title="Back"/> <hiddenField name="formAction" value="selectTimeSubmit.do"/> <hiddenField name="formMethod" value="get"/> </form> </page> </screen>

Confirm booking

Screenshot

XML

(click thumbnail to enlarge)

<?xml version="1.0" encoding="ISO-8859-1"?> <screen xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.digitv.gov.uk/schemas/plugin.xsd"> <page backup="yourAppointments.do" title="Confirm booking" transform="default"> <form action="confirmBookingSubmit.do" method="get"> <hiddenField name="pageNum" value="1"/> <static value="You have selected the following appointment:"/> <static value="Thu 20 Sep at Back Lane Surgery with Dr Stanley Fraser at 14:00"/> <static value="Do you really want to book this appointment?"/> <submit name="left" title="No"/> <submit name="right" title="Yes"/> <hiddenField name="formAction" value="confirmBookingSubmit.do"/> <hiddenField name="formMethod" value="get"/> </form> </page> </screen>

Select cancellation

Screenshot

XML

(click thumbnail to enlarge)

<?xml version="1.0" encoding="ISO-8859-1"?> <screen xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.digitv.gov.uk/schemas/plugin.xsd"> <page backup="yourAppointments.do" title="Cancel appointment" transform="default"> <form action="/gpplugin/selectCancellationSubmit.do" method="get" name="blank"> <static value="Please select appointment to cancel:"/> <multisubmitField name="selection"> <fieldOption name="Thu 20 Sep at Back Lane Surgery with Dr Stanley Fraser at 14:00" value="0"/> <fieldOption name="Fri 21 Sep at Main Rd Surgery with DR ROB MOVERLEY at 09:00" value="1"/> </multisubmitField> <submit name="left" title="Back"/> <hiddenField name="formAction" value="/gpplugin/selectCancellationSubmit.do"/> <hiddenField name="formMethod" value="get"/> </form> </page> </screen>

Confirm cancellation

Screenshot

XML

(click thumbnail to enlarge)

<?xml version="1.0" encoding="ISO-8859-1"?> <screen xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.digitv.gov.uk/schemas/plugin.xsd"> <page backup="yourAppointments.do" title="Cancel appointment" transform="default"> <form action="/gpplugin/confirmCancellationSubmit.do" method="get" name="blank"> <hiddenField name="index" value="0"/> <static value="You have selected to cancel this appointment:"/> <static value="Thu 20 Sep at Back Lane Surgery with Dr Stanley Fraser at 14:00"/> <static value="Do you really want to cancel this appointment?"/> <submit name="left" title="No"/> <submit name="right" title="Yes"/> <hiddenField name="formAction" value="/gpplugin/confirmCancellationSubmit.do"/> <hiddenField name="formMethod" value="get"/> </form> </page> </screen>

How to sign up

Screenshot

XML

(click thumbnail to enlarge)

<?xml version="1.0" encoding="ISO-8859-1"?> <screen xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.digitv.gov.uk/schemas/plugin.xsd"> <page backup="login.do" title="How to sign up" transform="default"> <form action="/gpplugin/howToRegisterSubmit.do" method="get" name="blank"> <static value="To use this service you must sign up in person at your local surgery. The surgery will give you details which you will need to register online to create an account."/> <static value="If you have already been given your details, select &quot;Register&quot; below."/> <multisubmitField name="selection"> <fieldOption name="Data protection and terms of use" value="1"/> </multisubmitField> <submit name="left" title="Back"/> <submit name="right" title="Register"/> <hiddenField name="formAction" value="/gpplugin/howToRegisterSubmit.do"/> <hiddenField name="formMethod" value="get"/> </form> </page> </screen>

Data protection (1 of 3)

Screenshot

XML

(click thumbnail to enlarge)

<?xml version="1.0" encoding="UTF-8" ?> <screen xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.digitv.gov.uk/schemas/plugin.xsd"> <page backup="howToRegister.do" title="Data protection and terms of use" transform="default"> <form action="dataProtection1Submit.do" method="get" pagingText="Page 1 of 3"> <static value="You cannot register without first visiting your doctors surgery."/> <static value="During initial registration we ask for your name, birth date and NHS number. We use this information to help us verify your identity by cross-checking the records kept at your doctors surgery. We do not gather or store personal information about you."/> <submit name="left" title="Back"/> <submit name="right" title="More"/> <hiddenField name="formAction" value="dataProtection1Submit.do"/> <hiddenField name="formMethod" value="get"/> </form> </page> </screen>

Data protection (2 of 3)

Screenshot

XML

(click thumbnail to enlarge)

<?xml version="1.0" encoding="UTF-8" ?> <screen xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.digitv.gov.uk/schemas/plugin.xsd"> <page backup="dataProtection1.do" title="Data protection and terms of use" transform="default"> <form action="dataProtection2Submit.do" method="get" pagingText="Page 2 of 3"> <static value="Once registered, you account is password-protected."/> <static value="You must take reasonable care to protect your password and notify your surgery immediately if you suspect anyone else is using your account."/> <submit name="left" title="Back"/> <submit name="right" title="More"/> <hiddenField name="formAction" value="dataProtection2Submit.do"/> <hiddenField name="formMethod" value="get"/> </form> </page> </screen>

Data protection (3 of 3)

Screenshot

XML

(click thumbnail to enlarge)

<?xml version="1.0" encoding="UTF-8" ?> <screen xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.digitv.gov.uk/schemas/plugin.xsd"> <page backup="dataProtection2.do" title="Data protection and terms of use" transform="default"> <form action="dataProtection3Submit.do" method="get" pagingText="Page 3 of 3"> <static value="We try to provide this service 24 hours a day but reserve the right to take the system out of use for maintenance and other activities."/> <static value="By using this service you are agreeing to these terms of use."/> <static value="Select &quot;Continue&quot; to return to the registration screen."/> <submit name="left" title="Back"/> <submit name="right" title="Continue"/> <hiddenField name="formAction" value="dataProtection3Submit.do"/> <hiddenField name="formMethod" value="get"/> </form> </page> </screen>

Registration step 1

Screenshot

XML

(click thumbnail to enlarge)

<?xml version="1.0" encoding="ISO-8859-1"?> <screen xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.digitv.gov.uk/schemas/plugin.xsd"> <page backup="howToRegister.do" title="Registration" transform="default"> <form action="registration1Submit.do" method="get" pagingText="Page 1 of 6"> <static value="Please enter the details given to you by your doctors to allow you to access this service:"/> <numbersField hint="Enter your Practice ID" label="Practice ID:" name="practiceId" size="10" value=""/> <numbersField hint="Enter your Access ID" label="Access ID:" name="accessId" size="10" value=""/> <numbersField hint="Enter your PIN" label="PIN:" name="pin" size="10" value=""/> <textField hint="Enter your NHS Number" label="NHS number:" name="nhsNumber" size="10" value=""/> <submit name="left" title="Back"/> <submit name="right" title="Next"/> <hiddenField name="formAction" value="registration1Submit.do"/> <hiddenField name="formMethod" value="get"/> </form> </page> </screen>

Registration step 2

Screenshot

XML

(click thumbnail to enlarge)

<?xml version="1.0" encoding="ISO-8859-1"?> <screen xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.digitv.gov.uk/schemas/plugin.xsd"> <page backup="registration1.do" title="Registration" transform="default"> <form action="registration2Submit.do" method="get" pagingText="Page 2 of 6"> <static value="We need your surname and date of birth to further verify your identity. They'll be checked against the record held at your practice."/> <textField hint="Enter your first name" label="Your first name:" name="firstName" value=""/> <textField hint="Enter your surname" label="Your surname:" name="lastName" value=""/> <numbersField hint="Enter your date of birth in DDMMYYYY format" label="Date of birth:" name="birthDate" size="8" value=""/> <static value="Please use DDMMYYYY format for your date of birth, e.g. 27 June 1974 as 27061974."/> <submit name="left" title="Back"/> <submit name="right" title="Next"/> <hiddenField name="formAction" value="registration2Submit.do"/> <hiddenField name="formMethod" value="get"/> </form> </page> </screen>

Registration step 3

Screenshot

XML

(click thumbnail to enlarge)

<?xml version="1.0" encoding="ISO-8859-1"?> <screen xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.digitv.gov.uk/schemas/plugin.xsd"> <page backup="registration2.do" title="Choose a password" transform="default"> <form action="registration3Submit.do" method="get" pagingText="Page 3 of 6"> <static value="Choose a password and enter it in both fields to ensure it is correct."/> <textField hint="Enter your chosen password" label="Password:" name="password1" value=""/> <textField hint="Enter your chosen password again" label="Confirm password:" name="password2" value=""/> <static value="Tip: using both letters and numbers makes the password more secure."/> <submit name="left" title="Back"/> <submit name="right" title="Next"/> <hiddenField name="formAction" value="registration3Submit.do"/> <hiddenField name="formMethod" value="get"/> </form> </page> </screen>

Registration step 4

Screenshot

XML

(click thumbnail to enlarge)

<?xml version="1.0" encoding="UTF-8" ?> <screen xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.digitv.gov.uk/schemas/plugin.xsd"> <page backup="registration3.do" title="Security question" transform="default"> <form action="registration4Submit.do" method="get" pagingText="Page 4 of 6"> <static value="We'll ask you a security question should you forget your password. So choose an answer that you'll remember but isn't easily guessable by others."/> <static value="Please select your question:"/> <multisubmitField name="question"> <fieldOption name="Who is your favourite sportsman?" value="Who is your favourite sportsman?"/> <fieldOption name="Who is your favourite author?" value="Who is your favourite author?"/> <fieldOption name="Who is your favourite actor?" value="Who is your favourite actor?"/> </multisubmitField> <submit name="left" title="Back"/> <submit name="right" title="Next"/> <hiddenField name="formAction" value="registration4Submit.do"/> <hiddenField name="formMethod" value="get"/> </form> </page> </screen>

Registration step 5

Screenshot

XML

(click thumbnail to enlarge)

<?xml version="1.0" encoding="UTF-8" ?> <screen xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.digitv.gov.uk/schemas/plugin.xsd"> <page backup="registration4.do" title="Security question" transform="default"> <form action="registration5Submit.do" method="get" pagingText="Page 5 of 6"> <static value="Please provide your answer to the question &quot;Who is your favourite sportsman?&quot;"/> <textField hint="Enter your answer" label="Answer:" name="answer" value=""/> <submit name="left" title="Back"/> <submit name="right" title="Next"/> <hiddenField name="formAction" value="registration5Submit.do"/> <hiddenField name="formMethod" value="get"/> </form> </page> </screen>

Registration confirmation

Screenshot

XML

(click thumbnail to enlarge)

<?xml version="1.0" encoding="UTF-8" ?> <screen xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.digitv.gov.uk/schemas/plugin.xsd"> <page backup="login.do" title="Registration complete" transform="default"> <form action="confirmRegistrationSubmit.do" method="get" pagingText="Page 6 of 6"> <static value="Your sign-up has been successful, thank you!"/> <static value="Select &quot;Start&quot; to sign in and use the service."/> <submit name="right" title="Start"/> <hiddenField name="formAction" value="confirmRegistrationSubmit.do"/> <hiddenField name="formMethod" value="get"/> </form> </page> </screen>