Controls – PatientSearchInputBox

The PatientSearchInputBox control allows you to enter textual search data for a patient in what appears to be a standard textbox. A parsing method allows the text search criteria to be parsed and exposed as properties.

ASP.NETWinForms

Example ASP.NET control (embedded):

(e.g. mr subramanyan chandrasekhar 14/07/1945 SO50 7TH)Update on every keystroke

Family name:
Given name:
NHS Number:
Age:
Date of Birth:
Gender:
Title:
Address:
Postcode:

Usage Hints

Enter search information for the patient in the entrybox
Check Update on every keystroke if you want the search to be performed as you type
Click GO to perform your search if you do not have Update on every keystroke checked
The data entered in the entrybox is parsed and the results displayed in the fields associated with different data properties

Properties

The PatientSearchInputBox control is initialized with the following code:

<NhsCui:PatientSearchInputBox ID="PatientSearchInputBox1" Width="400px" 
    MaximumAge="130" InformationDelimiter="," runat="server" />

Address – gets or sets the address
Age – gets or sets the age
AgeUpper – the upper value in an age range
CommonFamilyNames – a list of common family names
DateOfBirth – gets or sets the date of birth
DateOfBirthUpper – the upper value in a date of birth range
EndGroupDelimiter – the character that is used to delimit the end of a group of words
FamilyName – gets or sets the family name
Gender – gets or sets the gender
GivenName – gets or sets the given name
InformationDelimiter – the character that is used to delimit the end of a group of words
InformationFormat – the list of PatientSearch. Information enumeration values that are used to parse the Text property
IsCommonFamilyName – “True” if FamilyName is found in CommonFamilyNames
IsDateOfBirthAgeMismatch – “True” if both DateOfBirth and Age have been entered and the number of years of the Age is not the same number of years for the DateOfBirth based on the current date; otherwise “False”
IsGenderTitleMismatch – “True” if both Gender and Title have been entered and the Title has a PatientSearch.Gender of Male or Female and the Gender's PatientSearch.Gender is not the same; otherwise “False”
IsMandatoryInformationEntered – “True” if all of the values in MandatoryInformation are not the default values; if MandatoryInformation is null, IsMandatoryInformationEntered is “False”
MandatoryInformation – the list of PatientSearch.Information enumeration values that are mandatory
MaximumAge – gets or sets the maximum age recognized by the parser
NhsNumber – gets or sets the patient identification number
Postcode – gets or sets the postcode
StartGroupDelimiter – the character that is used to delimit the end of a group of words
Text – the patient search criteria to be parsed
Title – gets or sets the title
Titles – gets or sets a list of Title objects
UnmatchedText – the remaining text that could not be matched after the parsing process has identified all other values

Additional Information

All the PatientSearchInputBox properties are read-only apart from CommonFamilyNames, EndGroupDelimiter, InformationDelimiter, InformationFormat, MandatoryInformation, MaximumAge, StartGroupDelimiter and Titles.

Example WinForms control (screenshot):

PatientSearchInputBox WinForms control screenshot

The full source code for this control can be found in the Microsoft Health Common User Interface Toolkit, which can be downloaded from our CodePlex site.

Usage Hints

Enter search information for the patient in the entrybox
Check Update on every keystroke if you want the search to be performed as you type
Click GO to perform your search if you do not have Update on every keystroke checked
The data entered in the entrybox is parsed and the results displayed in the fields associated with different data properties

Properties

Address – gets or sets the address
Age – gets or sets the age
AgeUpper – the upper value in an age range
CommonFamilyNames – a list of common family names
DateOfBirth – gets or sets the date of birth
DateOfBirthUpper – the upper value in a date of birth range
EndGroupDelimiter – the character that is used to delimit the end of a group of words
FamilyName – gets or sets the family name
Gender – gets or sets the gender
GivenName – gets or sets the given name
InformationDelimiter – the character that is used to delimit the end of a group of words
InformationFormat – the list of PatientSearch. Information enumeration values that are used to parse the Text property
IsCommonFamilyName – “True” if FamilyName is found in CommonFamilyNames
IsDateOfBirthAgeMismatch – “True” if both DateOfBirth and Age have been entered and the number of years of the Age is not the same number of years for the DateOfBirth based on the current date; otherwise “False”
IsGenderTitleMismatch – “True” if both Gender and Title have been entered and the Title has a PatientSearch.Gender of Male or Female and the Gender's PatientSearch.Gender is not the same; otherwise “False”
IsMandatoryInformationEntered – “True” if all of the values in MandatoryInformation are not the default values; if MandatoryInformation is null, IsMandatoryInformationEntered is “False”
MandatoryInformation – the list of PatientSearch.Information enumeration values that are mandatory
MaximumAge – gets or sets the maximum age recognized by the parser
NhsNumber – gets or sets the patient identification number
Postcode – gets or sets the postcode
StartGroupDelimiter – the character that is used to delimit the end of a group of words
Text – the patient search criteria to be parsed
Title – gets or sets the title
Titles – gets or sets a list of Title objects
UnmatchedText – the remaining text that could not be matched after the parsing process has identified all other values

Additional Information

Associated Design Guidance and Samples

Design Guidance	Samples
Find a Patient	PatientSearchInputBox