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()
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, 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()

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="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

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

result -

status -

Returns:

the view to forward to

Should:

pass if all the form data is valid, create a new patient, send the user back to the form in case of validation errors, void a name and replace it with a new one if it is changed to a unique value, void an address and replace it with a new one if it is changed to a unique value, add a new name if the person had no names, add a new address if the person had none, ignore a new address that was added and voided at same time, set the cause of death as none a coded concept, set the cause of death as a none coded concept, void the cause of death obs that is none coded, add a new person attribute with a non empty value, not add a new person attribute with an empty value, void an existing person attribute with an empty value, should replace an existing attribute with a new one when edited

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