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