It is considered best to implement these as four separate plugins given the experience with Transport Direct. This will enable users to select the plugins appropriate to them and avoid plugins if they already provide health information on a particular area within their microsite.
The four plugins will be:
News
Services Search
Live Well (API available July 2008)
Health A-Z (API available September 2008)
NHS Choices have a requirement regarding accreditation and logo usage:
"As specified in the Service Level Agreement / Memorandum of Understanding NHS Choices content must be accredited and accompanied by the NHS Choices logo wherever it appears which should link to [dev:www.nhs.uk]. The official logo is provided below and should not be altered or changed in any way:"
After discussion with Guy it was felt best that we did not include the logo within the plugin but provided a Common Content menu displaying the logo.
Guy felt that we could cover the fact that a LA could link to the plugins without using the Common Content menu through an addendum to the account contract. Textual accreditation would need to be made within the plugin. The requirement for a link to [dev:www.nhs.co.uk] is inappropriate for TV and it's omission would need to be negotiated with NHS Choices.
Limitations
Note that the Web Services have been written with web consumers in mind and we will have to consider how we will deal with these on a technical or non-technical basis:
The content contains HTML and links and references to 'click on the link above'.
Some of the articles are video content with no text. We will have to consider how we technically strip out or exclude such content.
New topic list and Live Well topic list are not available as a Web Service. I believe that this means we will have to hard code these lists into our plugin which is far from ideal.
News
Services Search
Live Well
Health A-Z
Screens
News
Introduction
NHS Choice will no doubt want to provide some introductory text. I have cloned this text from an e-mail from NHS Choices to Guy as a starter.
Introductory Static Text: Welcome to an unbiased and evidence-based analysis of health stories that make the news; new articles added every day. Brought to you by NHS Choices. Select 'Start' to continue.
'Start' menu button - navigate to 'News Topic List' page.
Topic List
A list of news topics can be seen here. They should be presented as a list selection screen (multiSubmit fields) as per Jobcentre Plus job group selection.
All Headlines
Food/diet
Lifestyle/exercise
Heart/lungs
Pregnancy/child
Cancer
Medication
Neurology
Medical practice
Obesity
Genetics
Mental health
Older people
Diabetes
Page title 'News topics from NHS Choices'.
'Back' from the first page should take the user back to the Introduction page, 'Back' from the second topic page should take the user back to the first topic page.
Topic numbering should be displayed - '1-10 of 14' should be displayed on the first list page, '11-14 0f 14' should be displayed on the second page.
On topic selection a call should be made to the NewsArticlesList Web Service.
'topic' should be set to the topic selected or left blank if 'All Headlines' is selected.
'max' should be set to 100.
Note: Ideally there should be a Web Service to retrieve the news topic list. The NHS Choices Syndication Team have taken this feedback on board and aim to develop one. In the meantime they have developed a dynamic XML feed which we could use temporarily, but is unsupported.
Each 'HeadLine' returned from the NewsArticlesList Web Service should be displayed on a link in a list selection screen. Appropriate truncation with '...' may be required where the length 'HeadLine' text would cause wrapping. It is not felt that the date of new articles is important to users and has been omitted from display.
'Back' from the first page should take the user back to the topic list, 'Back' from subsequent article list pages should take the user back to the previous article list page.
To aid navigation [dev:Return to news topic list] should be displayed as the 10th link on each screen and should navigate the user to the first Topic List page.
Article numbering should be displayed - '1-9 of x' should be displayed on the first list page, with appropriate numbers on subsequent pages.
On topic selection a call should be made to the NewsArticle Web Service.
'guid' should be set to the GUID unique identifier supplied in the result set of the NewsArticleList Web Service.
News Item
Page title 'data item Heading' - passed back in the return from the NewsArticle Web Service (This may require truncation with '...').
All the DataContent returned in the NewsArticle Web Service should be displayed with paragraph space line separation between each DataContent element.
'Back' from the first page should take the user back to the article list, 'Back' from subsequent news item pages should take the user back to the previous news item page.
To aid navigation [dev:Return to news article list] should be displayed at the bottom of each page and should navigate the user to the Article List page they navigated from.
Paging and page numbering as appropriate.
Services Search
Introduction
NHS Choice will no doubt want to provide some introductory text. I have cloned this text from an e-mail from NHS Choices to Guy as a starter.
Introductory Static Text: Enter your postcode, place or organisation to find details of all manner of local NHS services including dentists, GPs, pharmacists and others.
'Start' menu button - navigate to 'service Selection' page.
Service Selection
The services currently available through this API are shown below. They should be presented as a list selection screen (multiSubmit fields) as per Jobcentre Plus job group selection:
GP
Dentists
Pharmacists
Opticians
Hospitals
Walk-in centres
Stop-smoking services
NHS trusts
Sexual health services
Drugs
Alcohol services
Respite care
Renal services
Breast cancer services
Independent living support
Note that some services available via the Internet are not available though the API due to licensing restrictions.
Services Coming Soon
Community Clinics
Diabetes Clinics
Asthma Clinics
Termination of Pregnancy Clinics
Page title 'Services available from NHS Choices'.
'Back' from the first page should take the user back to the Introduction page, 'Back' from the second Service Selection page should take the user back to the first Service Selection page.
Service numbering should be displayed - '1-10 of 15' should be displayed on the first list page, '11-15 0f 15' should be displayed on the second page.
On topic selection the user should be navigated to the Postcode/Place/Organisation page.
Note: the 'Max' parameter has been deprecated in favour of Pagination. The pagination parameters are "PageNumber" and PageSize"
Note: Ideally there should be a Web Service to retrieve the Service Selection list list and I have made this suggestion to the NHS Choices Syndication Team.
Postcode/Place/Organisation
Page title 'Services available from NHS Choices'.
'Back' from the Postcode/Place/Organisation page should take the user back to Service Selection.
Static Text: Please enter a postcode, place, or organisation and then select 'Search'.
Channel specific data entry help text should also be displayed.
On 'Search' selection a call should be made to the ServicesSearch Web Service.
Note: the 'Max' parameter has been deprecated in favour of Pagination. The pagination parameters are "PageNumber" and PageSize"
Location/Organisation Match List
If multiple locations or organisations are found against the input value, the Services Search Web Service returns the list of all matched locations (root element 'Locations').
Page title 'Location/Organisation Selection'.
'Back' from the first Location Selection page should take the user back to the Postcode/Place/Organisation page, 'Back' from subsequent Location Selection pages should take the user back to the previous Location Selection page.
Static Text: There is more than one location that matches your search. Please choose where you would like to search.
Possible matching locations should be presented as a list selection screen (multiSubmit fields) as per Jobcentre Plus job group selection.
Match numbering should be displayed - '1-10 of x' should be displayed on the first list page, with appropriate numbering on subsequent pages.
On location selection a call should be made to the ServicesSearch Web Service using the co-ordinates for that location supplied in the previous ServicesSearch response.
Note: the 'Max' parameter has been deprecated in favour of Pagination. The pagination parameters are "PageNumber" and PageSize"
Provider List
If one exact match for location or organisation is found against the input value, the Services Search Web Service returns the list of service providers around the matching location (root element 'Services').
Page title 'Provider List'.
Each 'Name' returned from the ServicesSearch Web Service should be concatenated with 'Distance' (in brackets) displayed on a link in a list selection (multiSubmit field) screen. Appropriate truncation with '...' may be required where the length of 'Name' and 'Distance' text would cause wrapping.
'Back' from the first Provider List page should take the user back to the Postcode/Place/Organisation page, 'Back' from subsequent Provider List pages should take the user back to the previous Provider List page.
Service numbering should be displayed - '1-10 of x' should be displayed on the first list page, with appropriate numbering on subsequent pages.
On service selection further details should be displayed on the Provider Detail page.
Provider Detail
Details of the service provider selected from the Services List should be displayed on this page using the details passed back in the ServicesSearch Web Service.
Page title 'Name' (from ServicesSearch Web Service truncation with '...' where likely to cause truncation.
Fields from the ServicesSearch Web Service to be displayed:
Address including Postcode
Telephone
Website
I believe this data should display on a single page rather than requiring paging logic. If this is the case then:
'Back' from the first Provider Detail page should take the user back to the Provider List page, 'Back' from subsequent Provider Detail pages should take the user back to the previous Provider Detail page.
'Next' should take the user to the next provider details on the list.
To aid navigation [dev:Back to provider list] should be displayed as the last line on each Provider Detail page and should navigate the user to the Provider List page.
Live Well
Introduction
NHS Choice will no doubt want to provide some introductory text. I have cloned this text from an e-mail from NHS Choices to Guy as a starter.
Introductory Static Text: Welcome to Live Well which has guides, tips and information on how we can all live healthier lives. New stories are continually added to the site and is brought to you by NHS Choices. Select 'Start' to continue.
'Start' menu button - navigate to Topic List page.
Topic List
A list of all 76 Live Well topics can be seen here. They should be presented as a list selection screen (multiSubmit fields) as per Jobcentre Plus job group selection.
'Back' from the first page should take the user back to the Introduction page, 'Back' from the second topic page should take the user back to the first topic page.
Topic numbering should be displayed.
On topic selection a call should be made to the LiveWellArticlesList Web Service.
'topic' should be set to the topic selected.
Note: the 'Max' parameter has been deprecated in favour of Pagination. The pagination parameters are "PageNumber" and PageSize"
'top' should be set to 'true'.
Note: Ideally there should be a Web Service to retrieve the topic list. The NHS Choices Syndication Team have taken this feedback on board and aim to develop one. In the meantime they have developed a dynamic XML feed which we could use temporarily, but is unsupported.
To retrieve the full list we will need to paginate through all 5 pages by changing the Page= variable.
Top Articles List
Page title 'Top articles from NHS Choices'.
Each 'Title' returned from the LiveWellArticlesList Web Service should be displayed on a link in a list selection screen. Appropriate truncation with '...' may be required where the length 'Title' text would cause wrapping. It is not felt that the date of new articles is important to users and has been omitted from display.
'Back' from the first page should take the user back to the topic list page the navigated from, 'Back' from subsequent article list pages should take the user back to the previous article list page.
The 9th link should display [dev:All articles for xxxx], where xxxx = the Live Well topic.
To aid navigation [dev:Return to news topic list] should be displayed as the 10th link on each screen and should navigate the user to the first Topic List page.
Article numbering should be displayed - '1-8 of n' should be displayed on the first list page, with appropriate numbering on subsequent pages.
On article selection a call should be made to the Live WellArticle Web Service.
'guid' should be set to the GUID unique identifier supplied in the result set of the LiveWellArticleList Web Service.
On selection of [dev:All articles for xxxx] a call should be made to the LiveWellArticle Web Service.
'topic' should be set to the topic selected.
Note: the 'Max' parameter has been deprecated in favour of Pagination. The pagination parameters are "PageNumber" and PageSize".
'top' should be set to 'false'.
Note: We have asked if there could be a 'predominantly video' flag passed back in the LiveWellArticleList so that they can be excluded from TV and mobile. Until this flag is present we need to find some way to strip out articles with video content.
All Articles List
Page title 'All articles from NHS Choices'.
Each 'Title' returned from the NewsArticlesList Web Service should be displayed on a link in a list selection screen. Appropriate truncation with '...' may be required where the length 'Title' text would cause wrapping. It is not felt that the date of new articles is important to users and has been omitted from display.
'Back' from the first page should take the user back to the topic list page the navigated from, 'Back' from subsequent article list pages should take the user back to the previous article list page.
The 9th link should display [dev:Back to top articles for xxxx], where xxxx = the Live Well topic and should navigate the user to the first Top Articles list page.
To aid navigation [dev:Return to news topic list] should be displayed as the 10th link on each screen and should navigate the user to the first Topic List page.
Article numbering should be displayed - '1-8 of n' should be displayed on the first list page, with appropriate numbering on subsequent pages.
On article selection a call should be made to the Live WellArticle Web Service.
'guid' should be set to the GUID unique identifier supplied in the result set of the LiveWellArticleList Web Service.
Article Detail
Page title 'data item Title' - passed back in the return from the NewsArticle Web Service (This may require truncation with '...').
There will need to be some more detailed analysis of examples of data being returned. At present I believe that the data to be displayed is:
'Back' from the first page should take the user back to the calling article list page, 'Back' from subsequent news item pages should take the user back to the previous Live Well article page.
To aid navigation [dev:Return to Live Well article list] should be displayed at the bottom of each page and should navigate the user to the Article List page they navigated from.
Paging and page numbering as appropriate.
Health A-Z
Introduction
NHS Choice will no doubt want to provide some introductory text. I have cloned this text from an e-mail from NHS Choices to Guy as a starter.
Introductory Static Text: Welcome to Heath A-Z which contains information on the most common medical conditions and procedures; doctors and health professionals give their advice and support. Brought to you by NHS Choices.
'Start' menu button - navigate to 'searchSelection' page.
Subjects List
The 'TopicsList' Web service generates a list of all Body Parts associated with the Health A-Z body map or top level Subjects. Body Part retrieved depends on the gender passed to the Web.
'Back' from the first page should take the user back to the Introduction page, 'Back' from the second topic page should take the user back to the first topic page.
Topic numbering should be displayed.
On topic selection a call should be made to the SpecialisedAreaList Web Service.
'topic' should be set to the topic selected.
Specialised Areas
Page title 'Specialised Areas'.
Each 'Title' returned from the SpecialisedAreasList Web Service should be displayed on a link in a list selection screen. Appropriate truncation with '...' may be required where the length 'Title' text would cause wrapping. It is not felt that the date of new specialised areas is important to users and has been omitted from display.
'Back' from the first page should take the user back to the subject list page they navigated from, 'Back' from subsequent specialised area list pages should take the user back to the previous specialised area list page.
The 9th link should display [dev:All articles for xxxx], where xxxx = the specialised area.
To aid navigation [dev:Return to specialised area list] should be displayed as the 10th link on each screen and should navigate the user to the first Topic List page.
Article numbering should be displayed - '1-8 of n' should be displayed on the first list page, with appropriate numbering on subsequent pages.
On article selection a call should be made to the ConditionsArticle Web Service.
'guid' should be set to the GUID unique identifier supplied in the result set of the SpecialisedAreaList Web Service.
On selection of [dev:All articles for xxxx] a call should be made to the ConditionsArticle Web Service.
'topic' should be set to the topic selected.
Condition
'Back' from the first page should take the user back to the calling article list page, 'Back' from subsequent condition pages should take the user back to the previous Condition article page.
To aid navigation [dev:Return to Specialist areas list] should be displayed at the bottom of each page and should navigate the user to the Specialist Article page they navigated from.
Paging and page numbering as appropriate.
Further investigation is necessary to decide how to display the different content fields in the conditions article Paragraph1 - ParagraphX (should these be simply extra pages)
.jpg)
