About this Website

Community Technology Preview (CTP)

This release contains CTP versions of the following controls:

MedicationsListView

As changes may be made between CTP and release versions, no official support or statement of quality can be offered for CTP controls prior to the development and distribution of release versions.

Contact Us

We welcome feedback on the Design Guidance, the controls and samples and all other aspects of this Website. Please use the feedback facilities on our CodePlex pages to let us know what you think.

Change Record – Guidance and Controls

The Change Record acts as a mechanism for tracking the availability of the Design Guidance documents, Controls and Samples for the current Release of the Microsoft Health Common User Interface.

DESIGN GUIDANCE

Document Title	Release Date	Action	Comment
Design Guidance – Date Display	December 2007	Updated	Replaces previous version of Design Guidance – Date Display
Design Guidance – Medications Management – Drug Administration	December 2007	Updated	Replaces previous version of Design Guidance – Medications Management – Drug Administration
Design Guidance – Medications Management – Medications Views	December 2007	Updated	Replaces previous version of Design Guidance – Medications Management – Medications Views
Design Guidance – Patient Banner	December 2007	Updated	Replaces previous version of Design Guidance – Patient Banner
Design Advice – Abbreviations and Acronyms	April 2008	Added
Design Advice – Abbreviations and Acronyms in Free Text Input	April 2008	Added
Design Guidance – Address Information Display	April 2008	Removed	Replaced with Design Guidance – Address Input and Display
Design Guidance – Address Input and Display	April 2008	Added	Replaces Design Guidance – Address Information Display, which is no longer available on the Website
Design Advice – Alert Symbol Design	April 2008	Added
Design Guidance – Decision Support	April 2008	Added
Design Guidance – Email Address Input and Display	April 2008	Added
Design Guidance – Icons and Symbology	April 2008	Added
Design Guidance – Medications Line ID	April 2008	Added
Design Guidance – Patient Identification Number Display	April 2008	Removed	Replaced with Design Guidance – Patient Identification Number Input and Display
Design Guidance – Patient Identification Number Input and Display	April 2008	Added	Replaces Design Guidance – Patient Identification Number Display, which is no longer available on this Website
Design Guidance – Patient Name Input and Display	April 2008	Added
Design Guidance – Search and Prescribe	April 2008	Added
Design Guidance – Telephone Number Display	April 2008	Removed	Replaced with Design Guidance – Telephone Number Input and Display
Design Guidance – Telephone Number Input and Display	April 2008	Added	Replaces Design Guidance – Telephone Number Display, which is no longer available on this Website
Design Groundwork Exploration – Abbreviations and Acronyms	June 2008	Updated	The guidance for Abbreviations and Acronyms has now been renamed to "Design Guidance Exploration – Abbreviations and Acronyms"
Design Groundwork Exploration – Abbreviations and Acronyms in Free Text	June 2008	Updated	The guidance for Abbreviations and Acronyms in Free Text has now been renamed to "Design Guidance Exploration – Abbreviations and Acronyms in Free Text"
Design Groundwork Exploration – Alert Symbol Design	June 2008	Updated	The guidance for Alert Symbol Design has now been renamed to "Design Guidance Exploration – Alert Symbol Design"
Design Groundwork Exploration – Decision Support	June 2008	Updated	The guidance for Decision Support has now been renamed to "Design Guidance Exploration – Decision Support"
Design Groundwork Exploration – Icons and Symbology	June 2008	Updated	The guidance for Icons and Symbology has now been renamed to "Design Guidance Exploration – Icons and Symbology"
Design Groundwork Exploration – Search and Prescribe	June 2008	Updated	The guidance for Search and Prescribe has now been renamed to "Design Guidance Exploration – Search and Prescribe"
Design Guidance – Date and Time Input	August 2008	Updated	Replaces previous version of Design Guidance – Date and Time Input
Design Guidance – Displaying Graphs and Tables	August 2008	Added
Design Guidance – Micro Patient Banner	August 2008	Added
Design Guidance – Time Display	August 2008	Updated	Replaces previous version of Design Guidance – Time Display
Design Guidance – Displaying Adverse Drug Reaction Risks	February 2009	Added
Design Guidance – Displaying Graphs and Tables	February 2009	Updated	Replaces previous version of Design Guidance – Displaying Graphs and Tables
Design Guidance – Medication Line	February 2009	Updated	Replaces previous version of Design Guidance – Medication Line
Design Guidance – Medications List	April 2009	Added	Supersedes Design Guidance – Medications Views, which will remain available until the next MSCUI release
Design Guidance – Filtering, Sorting and Grouping	April 2009	Added
Design Guidance – Recording Adverse Drug Reaction Risks	April 2009	Added
Design Guidance – Admissions Clerking	September 2009	Added
Design Guidance – Timeline View	September 2009	Added
Design Guidance – Medications Views	September 2009	Removed	Superseded by Design Guidance – Medications List
Design Groundwork Exploration – Display of Clinical Statements	February 2010	Added
Design Groundwork Exploration – Noting Using Templates	February 2010	Added
Design Groundwork Exploration – Truncation of Clinical Terms	February 2010	Added
Design Guidance – Patient List View	February 2010	Added
Design Guidance – Address Input and Display	February 2010	Updated	Replaces previous version of Design Guidance – Address Input and Display
Design Guidance – Date and Time Input	February 2010	Updated	Replaces previous version of Design Guidance – Date and Time Input
Design Guidance – Date Display	February 2010	Updated	Replaces previous version of Design Guidance – Date Display
Design Guidance – Drug Administration	February 2010	Updated	Replaces previous version of Design Guidance – Drug Administration
Design Guidance – Micro Patient Banner	February 2010	Updated	Replaces previous version of Design Guidance – Micro Patient Banner
Design Guidance – Patient Banner	February 2010	Updated	Replaces previous version of Design Guidance – Patient Banner
Design Guidance – Patient Identification Number Input and Display	February 2010	Updated	Replaces previous version of Design Guidance – Patient Identification Number Input and Display
Design Guidance – Patient Name Input and Display	February 2010	Updated	Replaces previous version of Design Guidance – Patient Name Input and Display
Design Guidance – Search and Prescribe	February 2010	Updated	Replaces previous version of Design Groundwork Exploration – Search and Prescribe
Design Guidance – Sex and Current Gender Input and Display	February 2010	Updated	Replaces previous version of Design Guidance – Sex and Current Gender Input and Display
Design Guidance – Telephone Number Input and Display	February 2010	Updated	Replaces previous version of Design Guidance – Telephone Number Input and Display
Design Guidance – Time Display	February 2010	Updated	Replaces previous version of Design Guidance – Time Display

CONTROLS

Control Name	Release Date	Action	Comment
AddressLabel	January 2008	Updated	This control replaces the previous version of the AddressLabel control
ContactLabel	January 2008	Updated	This control replaces the previous version of the ContactLabel control
DateInputBox	January 2008	Updated	This control replaces the previous version of the DateInputBox control
MonthCalendar	January 2008	Added
PatientBanner	January 2008	Updated	This control replaces the previous version of the PatientBanner control
TimeInputBox	January 2008	Updated	This control replaces the previous version of the TimeInputBox control
TimeLabel	January 2008	Updated	This control replaces the previous version of the TimeLabel control
MedicationGrid	April 2008	Removed	Replaced with the MedicationsListView control. The AJAX MedicationGrid control has been deprecated in this release because it no longer conforms with the latest Design Guidance. Rather than update the AJAX control, it was decided that a brand new version should be built using Silverlight. The code for the old AJAX control is still available in the previous releases section of the CodePlex Website. ISVs are free to modify the AJAX control if they wish, however it does not conform to the latest Design Guidance
MedicationLine	April 2008	Removed	Replaced with the MedicationsListView control. The AJAX MedicationLine control has been deprecated in this release because it no longer conforms with the latest Design Guidance. Rather than update the AJAX control, it was decided that a brand new version should be built using Silverlight. The code for the old AJAX control is still available in the previous releases section of the CodePlex Website. ISVs are free to modify the AJAX control if they wish, however it does not conform to the latest Design Guidance
MedicationNameLabel	April 2008	Removed	Replaced with the MedicationsListView control. The AJAX MedicationNameLabel control has been deprecated in this release because it no longer conforms with the latest Design Guidance. Rather than update the AJAX control, it was decided that a brand new version should be built using Silverlight. The code for the old AJAX control is still available in the previous releases section of the CodePlex Website. ISVs are free to modify the AJAX control if they wish, however it does not conform to the latest Design Guidance
MedicationsListView	June 2008	Added	This control has been updated to work with Silverlight 2 Beta 2. It replaces the MedicationNameLabel, MedicationLine and MedicationGrid controls
AddressLabel, ContactLabel, GenderLabel, IdentifierLabel, NameLabel, PatientBanner	August 2008	Updated	Silverlight and Windows Presentation Foundation (WPF) versions of these controls have been added to ensure compatibility with new technologies. The AJAX and WinForms versions are still available
MedicationsListView	August 2008	Updated	Silverlight and Windows Presentation (WPF) versions of this control have been reissued to be reusable and easily customizable, with enhanced usability, performance and rich styling capabilities
AddressLabel, ContactLabel, GenderLabel, IdentifierLabel, NameLabel, PatientBanner	October 2008	Updated	These controls have been updated to work with Silverlight 2 RTW. Both the Silverlight and WPF versions have been updated due to their common codebase. The AJAX and WinForms versions are still available
MedicationsListView	October 2008	Updated	This control has been updated to work with Silverlight 2 RTW. Both the Silverlight and WPF versions have been updated due to their common codebase
Graphing	February 2009	Added
MedicationsListView	February 2009	Updated	This control has been enhanced and now includes support for large numbers of rows
SingleConceptMatching	April 2009	Added
PatientBanner	April 2009	Updated	This control has been updated with the removal of styling properties to align with other controls and accepted best practices
DateLabel, TimeLabel	September 2009	Updated	Silverlight and Windows Presentation Foundation (WPF) versions of these controls have been added to ensure compatibility with new technologies. The AJAX and WinForms versions are still available
AddressLabel, ContactLabel, GenderLabel, IdentifierLabel, NameLabel, PatientBanner	September 2009	Updated	These controls have been updated to work with Silverlight 3. Both the Silverlight and WPF versions have been updated due to their common codebase. The AJAX and WinForms versions are still available
Graphing, MedicationsListView, SingleConceptMatching	September 2009	Updated	These controls have been updated to work with Silverlight 3. Both the Silverlight and WPF versions have been updated due to their common codebase
SearchAndPrescribe, Timeline	February 2010	Added

SAMPLES

Sample Name	Release Date	Action	Comment
Date and Time (all variants)	January 2008	Updated	This sample replaces the previous version of the Date and Time (all variants) sample
Date (CSS Styling)	January 2008	Added
Input Validation (all variants)	January 2008	Updated	This sample replaces the previous version of the Input Validation (all variants) sample
PatientBanner (all variants)	January 2008	Updated	This sample replaces the previous version of the PatientBanner (all variants) sample
MedicationGrid	April 2008	Removed	This sample has been deprecated in this release because it no longer conforms with the latest Design Guidance
PatientBanner (all variants)	August 2008	Updated	This sample replaces the previous version of the PatientBanner (all variants) sample

Accessibility

This Website, the Design Guidance and the Toolkit controls and samples have been designed with consideration to usability and accessibility for users who utilize alternative methods of interacting with computer systems.

Testing was performed on all Winforms and ASP.NET with Version 8.0 of the JAWS® for Windows screen reader. The tooltips for the Toolkit controls appear only on first focus and are not read by the screen reader.

The Design Guidance documents are provided in PDF format and consist of sequential pages starting with a title page and a table of contents.

The Web pages and controls based on Silverlight technology have more limited accessibility functionality.

Known Issues

Browser Compatibility
- This Website has been designed to work optimally on Internet Explorer and Firefox browsers running on Windows. If other browsers, such as Safari, are used, certain elements of this Website may not display or operate correctly, such as the demonstrators and controls.
CSS Styling
- The ASP.NET versions of the controls have been designed to work with Cascading Style Sheets so the controls can easily fit in with ISV applications. Many styles for the controls are exposed, allowing developers to alter them without any constraints. If the controls are styled outside the parameters set by the Design Guidance, they can no longer be considered to conform to the Microsoft Health CUI Design Guidance.
DateInputBox Can Throw an Exception When Used on Multiple Threads
- If multiple threads are using DateInputBox, an 'An entry with the same key already exists' exception is sometimes thrown. This appears to be a threading issue with the ASP.NET AJAX Control Toolkit.
Namespaces
- We are currently changing our root namespace to Microsoft.Cui. Controls under the previous namespace will be updated as they are revisited in accordance with the roadmap.
Some Controls Cannot Be Created Dynamically Using Client-Side Code
- The DateInputBox, TimespanInputBox, MonthCalendar and TimeInputBox controls can be instantiated through JavaScript on the client PC. Implementing this functionality for other controls may be planned for a future release.
Telephone Number Format in PatientBanner Guidance and Control Does Not Match Format in Design Guidance for Telephone Number Input and Display
- The Design Guidance for Telephone Number Input and Display requires area codes to be enclosed in brackets, but the Design Guidance for Patient Banner and the PatientBanner control do not currently use this format. This will be resolved in a future release.
ViewState Security Best Practice
- You should avoid storing sensitive data in ViewState. If you need to manage sensitive data, maintain it on the server in, for example, a session state. If your ViewState does contain sensitive data, you should perform encryption. For further information, see How To: Configure MachineKey in ASP.NET 2.0.
Web.config Configuration
- There are different versions of the AJAX Control Toolkit JavaScript libraries for development and production. In development parameter validation is desirable to ensure that errors are detected in code. Deployed applications normally omit this checking; this is done by setting the flag <compilation debug="false" /> in the web.config file for an application. Failure to do this may result in performance problems in the client.
Web.config Security Best Practice
- You should set the customErrors mode tag of Web.config to "off" to prevent detailed errors returning to the client. Microsoft recommends you follow the best practice guidance given in the Exception Management section of Security Practices: ASP.NET 2.0 Security Practices at a Glance.