org.openmrs.web.controller.patient

Class ShortPatientFormController

java.lang.Object

org.openmrs.web.controller.patient.ShortPatientFormController

@Controller
public class ShortPatientFormController
extends Object

This controller is used for the "mini"/"new"/"short" patient form. Only key/important attributes for the patient are displayed and allowed to be edited

See Also:

PatientFormController

Constructor Summary

Constructors

Constructor and Description
ShortPatientFormController()

Method Summary

Modifier and Type	Method and Description
Location	getDefaultLocation()
boolean	getIdentifierLocationUsed()
List<PatientIdentifierType>	getIdentifierTypes()
List<Location>	getLocations()
ShortPatientModel	getPatientModel(Integer patientId, org.springframework.ui.ModelMap model, org.springframework.web.context.request.WebRequest request)
static String	getPersonNameString(PersonName name) Convenience method that transforms a person name to a string while ignoring null and blank values, the returned string only contains the givenName, middleName and familyName
String	saveShortPatient(org.springframework.web.context.request.WebRequest request, PersonName personNameCache, PersonAddress personAddressCache, Map<String,Relationship> relationshipsMap, ShortPatientModel patientModel, org.springframework.validation.BindingResult result) Handles the form submission by validating the form fields and saving it to the DB
void	showForm()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ShortPatientFormController

public ShortPatientFormController()

Method Detail

showForm

@RequestMapping(method=GET,
                value="/admin/patients/shortPatientForm")
public void showForm()

getPatientModel

@ModelAttribute(value="patientModel")
public ShortPatientModel getPatientModel(@RequestParam(value="patientId",required=false)
                                                                               Integer patientId,
                                                                               org.springframework.ui.ModelMap model,
                                                                               org.springframework.web.context.request.WebRequest request)

getLocations

@ModelAttribute(value="locations")
public List<Location> getLocations()

getDefaultLocation

@ModelAttribute(value="defaultLocation")
public Location getDefaultLocation()

getIdentifierTypes

@ModelAttribute(value="identifierTypes")
public List<PatientIdentifierType> getIdentifierTypes()

getIdentifierLocationUsed

@ModelAttribute(value="identifierLocationUsed")
public boolean getIdentifierLocationUsed()

saveShortPatient

@RequestMapping(method=POST,
                value="/admin/patients/shortPatientForm")
public String saveShortPatient(org.springframework.web.context.request.WebRequest request,
                                                                                                                      @ModelAttribute(value="personNameCache")
                                                                                                                      PersonName personNameCache,
                                                                                                                      @ModelAttribute(value="personAddressCache")
                                                                                                                      PersonAddress personAddressCache,
                                                                                                                      @ModelAttribute(value="relationshipsMap")
                                                                                                                      Map<String,Relationship> relationshipsMap,
                                                                                                                      @ModelAttribute(value="patientModel")
                                                                                                                      ShortPatientModel patientModel,
                                                                                                                      org.springframework.validation.BindingResult result)

Handles the form submission by validating the form fields and saving it to the DB

Parameters:

request - the webRequest object

relationshipsMap -

patientModel - the modelObject containing the patient info collected from the form fields

result -

Returns:

the view to forward to

Expected Behavior:

Should pass if all the form data is valid

Should create a new patient

Should send the user back to the form in case of validation errors

Should void a name and replace it with a new one if it is changed to a unique value

Should void an address and replace it with a new one if it is changed to a unique value

Should add a new name if the person had no names

Should add a new address if the person had none

Should ignore a new address that was added and voided at same time

Should set the cause of death as none a coded concept

Should set the cause of death as a none coded concept

Should void the cause of death obs that is none coded

Should add a new person attribute with a non empty value

Should not add a new person attribute with an empty value

Should void an existing person attribute with an empty value

Should should replace an existing attribute with a new one when edited

Should not void address if it was not changed

Should void address if it was changed

getPersonNameString

public static String getPersonNameString(PersonName name)

Convenience method that transforms a person name to a string while ignoring null and blank values, the returned string only contains the givenName, middleName and familyName

Parameters:

name - the person name to transform

Returns:

the transformed string ignoring blanks and nulls