org.openmrs.api.impl

Class FormServiceImpl

java.lang.Object

org.openmrs.api.impl.BaseOpenmrsService

org.openmrs.api.impl.FormServiceImpl

All Implemented Interfaces:

FormService, OpenmrsService

@Transactional
public class FormServiceImpl
extends BaseOpenmrsService
implements FormService

Default implementation of the FormService

This class should not be instantiated alone, get a service class from the Context: Context.getFormService();

See Also:

Context, FormService

Constructor Summary

Constructors

Constructor and Description
FormServiceImpl() Default empty constructor

Method Summary

Modifier and Type	Method and Description
void	checkIfFormsAreLocked() Checks if the forms are locked, and if they are throws an exception when saving or deleting a form
Form	duplicateForm(Form form) Duplicate this form and form_fields associated with this form
List<Field>	getAllFields() Fetches all Fields in the database, including retired ones
List<Field>	getAllFields(boolean includeRetired) Fetches all Fields in the database, possibly including retired ones
List<FieldType>	getAllFieldTypes() Get all field types in the database including the retired ones
List<FieldType>	getAllFieldTypes(boolean includeRetired) Get all field types in the database with or without retired ones
List<FormField>	getAllFormFields() Returns all FormFields in the database
List<Form>	getAllForms() Gets all Forms, including retired ones.
List<Form>	getAllForms(boolean includeRetired) Gets all forms, possibly including retired ones
Field	getField(Integer fieldId) Gets a Field by internal database id
FieldAnswer	getFieldAnswerByUuid(String uuid) Get FieldAnswer by its UUID
Field	getFieldByUuid(String uuid) Get Field by its UUID
List<Field>	getFields(Collection<Form> forms, Collection<FieldType> fieldTypes, Collection<Concept> concepts, Collection<String> tableNames, Collection<String> attributeNames, Boolean selectMultiple, Collection<FieldAnswer> containsAllAnswers, Collection<FieldAnswer> containsAnyAnswer, Boolean retired) Returns all Fields that match these (nullable) criteria
List<Field>	getFields(String fuzzySearchPhrase) Find all Fields whose names are similar to or contain the given phrase.
List<Field>	getFieldsByConcept(Concept concept) Finds all Fields that point to the given concept, including retired ones.
FieldType	getFieldType(Integer fieldTypeId) Get fieldType by internal identifier
FieldType	getFieldTypeByName(String name) Get FieldType by its name
FieldType	getFieldTypeByUuid(String uuid) Get FieldType by its UUID
Form	getForm(Integer formId) Get form by internal form identifier
Form	getForm(String name) Get form by exact name match.
Form	getForm(String name, String version) Get form by exact name & version match.
Form	getFormByUuid(String uuid) Get Form by its UUID
Integer	getFormCount(String partialName, Boolean published, Collection<EncounterType> encounterTypes, Boolean retired, Collection<FormField> containingAnyFormField, Collection<FormField> containingAllFormFields, Collection<Field> fields) Same as FormService.getForms(String, Boolean, Collection, Boolean, Collection, Collection, Collection) except that it returns an integer that is the size of the list that would be returned
FormField	getFormField(Form form, Concept concept, Collection<FormField> ignoreFormFields, boolean force) Finds the FormField defined for this form/concept combination while discounting any form field found in the ignoreFormFields collection This method was added when needing to relate observations to form fields during a display.
FormField	getFormField(Integer formFieldId) Gets a FormField by internal database id
FormField	getFormFieldByUuid(String uuid) Get FormField by its UUID
FormResource	getFormResource(Form form, String name) Finds a FormResource based on a given Form and name
FormResource	getFormResource(Integer formResourceId) Finds a FormResource by its id
FormResource	getFormResourceByUuid(String uuid) Finds a FormResource by its uuid
Collection<FormResource>	getFormResourcesForForm(Form form) Finds all FormResources tied to a given form
List<Form>	getForms(String fuzzyName, boolean onlyLatestVersion) Gets all forms with name similar to the given name.
List<Form>	getForms(String partialName, Boolean published, Collection<EncounterType> encounterTypes, Boolean retired, Collection<FormField> containingAnyFormField, Collection<FormField> containingAllFormFields, Collection<Field> fields) Gets all forms that match all the (nullable) criteria
List<Form>	getFormsContainingConcept(Concept concept) Returns all forms that contain the given concept as a field in their schema.
List<Form>	getPublishedForms() Returns all published forms (not including retired ones)
int	mergeDuplicateFields() Audit form, consolidate similar fields
void	purgeField(Field field) Completely removes a Field from the database.
void	purgeField(Field field, boolean cascade) Completely removes a Field from the database.
void	purgeFieldType(FieldType fieldType) Deletes the given field type from the database.
void	purgeForm(Form form) Completely remove a Form from the database.
void	purgeForm(Form form, boolean cascade) Completely remove a Form from the database.
void	purgeFormField(FormField formField) Completely removes the given FormField from the database.
void	purgeFormResource(FormResource formResource) Purges a form resource
Field	retireField(Field field) Retires field
void	retireForm(Form form, String reason) Retires the Form, leaving it in the database, but removing it from data entry screens
Field	saveField(Field field) Creates or updates the given Field
FieldType	saveFieldType(FieldType fieldType) Saves the given field type to the database
Form	saveForm(Form form) Create or update the given Form in the database
FormField	saveFormField(FormField formField) Creates or updates the given FormField
FormResource	saveFormResource(FormResource formResource) Saves or updates the given form resource
void	setFormDAO(FormDAO dao) Method used to inject the data access object.
Field	unretireField(Field field) Unretires field
void	unretireForm(Form form) Unretires a Form that had previous been retired.

Methods inherited from class org.openmrs.api.impl.BaseOpenmrsService

onShutdown, onStartup

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.openmrs.api.OpenmrsService

onShutdown, onStartup

Constructor Detail

FormServiceImpl

public FormServiceImpl()

Default empty constructor

Method Detail

setFormDAO

public void setFormDAO(FormDAO dao)

Method used to inject the data access object.

Parameters:

dao -

getForm

@Transactional(readOnly=true)
public Form getForm(Integer formId)
                                           throws APIException

Description copied from interface: FormService

Get form by internal form identifier

Specified by:

getForm in interface FormService

Parameters:

formId - internal identifier

Returns:

requested form

Throws:

APIException - Should return null if no form exists with given formId Should return the requested form

See Also:

FormService.getForm(java.lang.Integer)

duplicateForm

public Form duplicateForm(Form form)
                   throws APIException

Duplicate this form and form_fields associated with this form

Specified by:

duplicateForm in interface FormService

Parameters:

form -

Returns:

New duplicated form

Throws:

APIException

See Also:

FormService.duplicateForm(org.openmrs.Form)

retireForm

public void retireForm(Form form,
                       String reason)
                throws APIException

Description copied from interface: FormService

Retires the Form, leaving it in the database, but removing it from data entry screens

Specified by:

retireForm in interface FormService

Parameters:

form - the Form to retire

reason - the retiredReason to set

Throws:

APIException - Should set the retired bit before saving

See Also:

FormService.retireForm(org.openmrs.Form, java.lang.String)

unretireForm

public void unretireForm(Form form)
                  throws APIException

Description copied from interface: FormService

Unretires a Form that had previous been retired.

Specified by:

unretireForm in interface FormService

Parameters:

form - the Form to revive

Throws:

APIException - Should unset the retired bit before saving

See Also:

FormService.unretireForm(org.openmrs.Form)

getAllFieldTypes

@Transactional(readOnly=true)
public List<FieldType> getAllFieldTypes()
                                                               throws APIException

Description copied from interface: FormService

Get all field types in the database including the retired ones

Specified by:

getAllFieldTypes in interface FormService

Returns:

list of all field types

Throws:

APIException - Should also get retired field types

See Also:

FormService.getAllFieldTypes()

getAllFieldTypes

@Transactional(readOnly=true)
public List<FieldType> getAllFieldTypes(boolean includeRetired)
                                                               throws APIException

Description copied from interface: FormService

Get all field types in the database with or without retired ones

Specified by:

getAllFieldTypes in interface FormService

Parameters:

includeRetired - true/false whether to include the retired field types

Returns:

list of all field types

Throws:

APIException - Should get all field types including retired when includeRetired equals true Should get all field types excluding retired when includeRetired equals false

See Also:

FormService.getAllFieldTypes(boolean)

getFieldType

@Transactional(readOnly=true)
public FieldType getFieldType(Integer fieldTypeId)
                                                     throws APIException

Description copied from interface: FormService

Get fieldType by internal identifier

Specified by:

getFieldType in interface FormService

Parameters:

fieldTypeId - Integer id of FieldType to get

Returns:

fieldType with given internal identifier

Throws:

APIException - Should return null when no field type matching given id

See Also:

FormService.getFieldType(java.lang.Integer)

getField

@Transactional(readOnly=true)
public Field getField(Integer fieldId)
                                             throws APIException

Description copied from interface: FormService

Gets a Field by internal database id

Specified by:

getField in interface FormService

Parameters:

fieldId - the id of the Field to fetch

Returns:

the Field with the given id

Throws:

APIException - Should return null if no field exists with given fieldId

See Also:

FormService.getField(java.lang.Integer)

getFormField

@Transactional(readOnly=true)
public FormField getFormField(Integer formFieldId)
                                                     throws APIException

Description copied from interface: FormService

Gets a FormField by internal database id

Specified by:

getFormField in interface FormService

Parameters:

formFieldId - the internal id to search on

Returns:

the FormField with the given id

Throws:

APIException - Should return null if no formField exists with given id

See Also:

FormService.getFormField(java.lang.Integer)

getFormField

@Transactional(readOnly=true)
public FormField getFormField(Form form,
                                                            Concept concept,
                                                            Collection<FormField> ignoreFormFields,
                                                            boolean force)
                                                     throws APIException

Description copied from interface: FormService

Finds the FormField defined for this form/concept combination while discounting any form field found in the ignoreFormFields collection This method was added when needing to relate observations to form fields during a display. The use case would be that you know a Concept for a obs, which was defined on a form (via a formField). You can relate the formFields to Concepts easily enough, but if a Form reuses a Concept in two separate FormFields you don't want to only associate that first formField with that concept. So, keep a running list of formFields you've seen and pass them back in here to rule them out.

Specified by:

getFormField in interface FormService

Parameters:

form - Form that this concept was found on

concept - Concept (question) on this form that is being requested

ignoreFormFields - FormFields to ignore (aka already seen formfields)

force - if true and there are zero matches because all formFields were ignored (because of ignoreFormFields) than the first result is returned

Returns:

Formfield for this concept on this form

Throws:

APIException - Should get form fields by form and concept Should not fail with null ignoreFormFields argument Should simply return null for nonexistent concepts Should simply return null for nonexistent forms Should ignore formFields passed to ignoreFormFields

See Also:

FormService.getFormField(org.openmrs.Form, org.openmrs.Concept, java.util.Collection, boolean)

getFieldByUuid

@Transactional(readOnly=true)
public Field getFieldByUuid(String uuid)
                                                   throws APIException

Description copied from interface: FormService

Get Field by its UUID

Specified by:

getFieldByUuid in interface FormService

Returns:

field or null Should find object given valid uuid Should return null if no object found with given uuid

Throws:

APIException

See Also:

FormService.getFieldByUuid(java.lang.String)

getFieldAnswerByUuid

@Transactional(readOnly=true)
public FieldAnswer getFieldAnswerByUuid(String uuid)
                                                               throws APIException

Description copied from interface: FormService

Get FieldAnswer by its UUID

Specified by:

getFieldAnswerByUuid in interface FormService

Returns:

field answer or null Should find object given valid uuid Should return null if no object found with given uuid

Throws:

APIException

getFieldTypeByUuid

@Transactional(readOnly=true)
public FieldType getFieldTypeByUuid(String uuid)
                                                           throws APIException

Description copied from interface: FormService

Get FieldType by its UUID

Specified by:

getFieldTypeByUuid in interface FormService

Returns:

field type or null Should find object given valid uuid Should return null if no object found with given uuid

Throws:

APIException

See Also:

FormService.getFieldTypeByUuid(java.lang.String)

getFieldTypeByName

@Transactional(readOnly=true)
public FieldType getFieldTypeByName(String name)
                                                           throws APIException

Description copied from interface: FormService

Get FieldType by its name

Specified by:

getFieldTypeByName in interface FormService

Returns:

field type or null Should find object given valid name Should return null if no object found with given name

Throws:

APIException

See Also:

FormService.getFieldTypeByName(java.lang.String)

getFormByUuid

@Transactional(readOnly=true)
public Form getFormByUuid(String uuid)
                                                 throws APIException

Description copied from interface: FormService

Get Form by its UUID

Specified by:

getFormByUuid in interface FormService

Returns:

form or null Should find object given valid uuid Should return null if no object found with given uuid

Throws:

APIException

See Also:

FormService.getFormByUuid(java.lang.String)

getFormFieldByUuid

@Transactional(readOnly=true)
public FormField getFormFieldByUuid(String uuid)
                                                           throws APIException

Description copied from interface: FormService

Get FormField by its UUID

Specified by:

getFormFieldByUuid in interface FormService

Returns:

form field or null Should find object given valid uuid Should return null if no object found with given uuid

Throws:

APIException

See Also:

FormService.getFormFieldByUuid(java.lang.String)

getAllFields

@Transactional(readOnly=true)
public List<Field> getAllFields()
                                                       throws APIException

Description copied from interface: FormService

Fetches all Fields in the database, including retired ones

Specified by:

getAllFields in interface FormService

Returns:

all Fields

Throws:

APIException - Should get all fields including retired

See Also:

FormService.getAllFields()

getAllFields

@Transactional(readOnly=true)
public List<Field> getAllFields(boolean includeRetired)
                                                       throws APIException

Description copied from interface: FormService

Fetches all Fields in the database, possibly including retired ones

Specified by:

getAllFields in interface FormService

Parameters:

includeRetired - whether or not to include retired Fields

Returns:

all Fields

Throws:

APIException - Should get all fields including retired when includeRetired is true Should get all fields excluding retired when includeRetired is false

See Also:

FormService.getAllFields(boolean)

getAllFormFields

@Transactional(readOnly=true)
public List<FormField> getAllFormFields()
                                                               throws APIException

Description copied from interface: FormService

Returns all FormFields in the database

Specified by:

getAllFormFields in interface FormService

Returns:

all FormFields in the database

Throws:

APIException - Should get all form fields including retired

See Also:

FormService.getAllFormFields()

getAllForms

@Transactional(readOnly=true)
public List<Form> getAllForms()
                                                     throws APIException

Description copied from interface: FormService

Gets all Forms, including retired ones.

Specified by:

getAllForms in interface FormService

Returns:

all Forms, including retired ones

Throws:

APIException - Should return all forms including retired

See Also:

FormService.getAllForms()

getAllForms

@Transactional(readOnly=true)
public List<Form> getAllForms(boolean includeRetired)
                                                     throws APIException

Description copied from interface: FormService

Gets all forms, possibly including retired ones

Specified by:

getAllForms in interface FormService

Parameters:

includeRetired - whether or not to return retired forms

Returns:

all forms, possibly including retired ones

Throws:

APIException - Should return retired forms if includeRetired is true Should not return retired forms if includeRetired is false

See Also:

FormService.getAllForms(boolean)

getFields

@Transactional(readOnly=true)
public List<Field> getFields(Collection<Form> forms,
                                                           Collection<FieldType> fieldTypes,
                                                           Collection<Concept> concepts,
                                                           Collection<String> tableNames,
                                                           Collection<String> attributeNames,
                                                           Boolean selectMultiple,
                                                           Collection<FieldAnswer> containsAllAnswers,
                                                           Collection<FieldAnswer> containsAnyAnswer,
                                                           Boolean retired)
                                                    throws APIException

Description copied from interface: FormService

Returns all Fields that match these (nullable) criteria

Specified by:

getFields in interface FormService

Parameters:

forms - on any of these Forms

fieldTypes - having any of these FieldTypes

concepts - for any of these Concepts

tableNames - for any of these table names

attributeNames - for any of these attribute names

selectMultiple - whether to return only select-multi fields

containsAllAnswers - fields with all the following answers

containsAnyAnswer - fields with any of the following answers

retired - only retired/unretired fields

Returns:

all Fields matching the given criteria

Throws:

APIException - Should get fields with form in given forms Should get fields with type in given fieldTypes Should get fields with concept in given concepts Should get fields with tableName in given tableNames Should get fields with attributeName in given attributeNames Should get fields with selectMultiple equals true when given selectMultiple equals true

See Also:

FormService.getFields(java.util.Collection, java.util.Collection, java.util.Collection, java.util.Collection, java.util.Collection, java.lang.Boolean, java.util.Collection, java.util.Collection, java.lang.Boolean)

getForm

@Transactional(readOnly=true)
public Form getForm(String name)
                                           throws APIException

Description copied from interface: FormService

Get form by exact name match. If there are multiple forms with this name, then this returns the one with the highest version (sorted alphabetically)

Specified by:

getForm in interface FormService

Parameters:

name - exact name of the form to fetch

Returns:

requested form

Throws:

APIException - Should return null if no form has the exact form name

See Also:

Should return the form with the highest version, if more than one form with the given name exists

getForm

@Transactional(readOnly=true)
public Form getForm(String name,
                                                  String version)
                                           throws APIException

Description copied from interface: FormService

Get form by exact name & version match. If version is null, then this method behaves like FormService.getForm(String)

Specified by:

getForm in interface FormService

Parameters:

name - exact name of the form to fetch

version - exact version of the form to fetch

Returns:

requested form

Throws:

APIException - Should get the specific version of the form with the given name

See Also:

FormService.getForm(java.lang.String, java.lang.String)

getForms

@Transactional(readOnly=true)
public List<Form> getForms(String fuzzyName,
                                                         boolean onlyLatestVersion)

Description copied from interface: FormService

Gets all forms with name similar to the given name. (The precise fuzzy matching algorithm is not specified.)

Specified by:

getForms in interface FormService

Parameters:

fuzzyName - approximate name to match

onlyLatestVersion - whether or not to return only the latest version of each form (by name)

Returns:

forms with names similar to fuzzyName Should match forms with partial match on name Should only return one form per name if onlyLatestVersion is true

See Also:

FormService.getForms(java.lang.String, boolean)

getForms

@Transactional(readOnly=true)
public List<Form> getForms(String partialName,
                                                         Boolean published,
                                                         Collection<EncounterType> encounterTypes,
                                                         Boolean retired,
                                                         Collection<FormField> containingAnyFormField,
                                                         Collection<FormField> containingAllFormFields,
                                                         Collection<Field> fields)

Description copied from interface: FormService

Gets all forms that match all the (nullable) criteria

Specified by:

getForms in interface FormService

Parameters:

partialName - partial search of name

published - whether the form is published

encounterTypes - whether the form has any of these encounter types

retired - whether the form is retired

containingAnyFormField - includes forms that contain any of the specified FormFields

containingAllFormFields - includes forms that contain all of the specified FormFields

fields - whether the form has any of these fields. If a field is used more than once on a form, that form is returning more than once in this list

Returns:

All forms that match the criteria Should get multiple of the same form by field Should return duplicate form when given fields included in form multiple times Should only return published forms when given published equals true Should return both published and unpublished when given published is null Should match to forms with fuzzy partialNameSearch Should return forms with encounterType in given encounterTypes Should return unretired forms when retired equals false Should return retired forms when retired equals true Should return all forms including retired and unretired when retired is null Should return forms containing all form fields in containingAllFormFields Should return forms that have any matching formFields in containingAnyFormField

See Also:

FormService.getForms(java.lang.String, java.lang.Boolean, java.util.Collection, java.lang.Boolean, java.util.Collection, java.util.Collection, java.util.Collection)

getFormCount

@Transactional(readOnly=true)
public Integer getFormCount(String partialName,
                                                          Boolean published,
                                                          Collection<EncounterType> encounterTypes,
                                                          Boolean retired,
                                                          Collection<FormField> containingAnyFormField,
                                                          Collection<FormField> containingAllFormFields,
                                                          Collection<Field> fields)

Description copied from interface: FormService

Same as FormService.getForms(String, Boolean, Collection, Boolean, Collection, Collection, Collection) except that it returns an integer that is the size of the list that would be returned

Specified by:

getFormCount in interface FormService

See Also:

FormService.getFormCount(java.lang.String, java.lang.Boolean, java.util.Collection, java.lang.Boolean, java.util.Collection, java.util.Collection, java.util.Collection)

getPublishedForms

@Transactional(readOnly=true)
public List<Form> getPublishedForms()
                                                           throws APIException

Description copied from interface: FormService

Returns all published forms (not including retired ones)

Specified by:

getPublishedForms in interface FormService

Returns:

all published non-retired forms

Throws:

APIException - Should only return published forms that are not retired

See Also:

FormService.getPublishedForms()

purgeField

public void purgeField(Field field)
                throws APIException

Description copied from interface: FormService

Completely removes a Field from the database. Not reversible.

Specified by:

purgeField in interface FormService

Parameters:

field - the Field to purge

Throws:

APIException - Should delete given field successfully

See Also:

FormService.purgeField(org.openmrs.Field)

purgeField

public void purgeField(Field field,
                       boolean cascade)
                throws APIException

Description copied from interface: FormService

Completely removes a Field from the database. Not reversible. !! WARNING: calling this with cascade=true can be very destructive !!

Specified by:

purgeField in interface FormService

Parameters:

field - the Field to purge

cascade - whether to cascade delete all FormFields pointing to this field

Throws:

APIException - Should throw APIException if cascade is true

See Also:

FormService.purgeField(org.openmrs.Field, boolean)

purgeForm

public void purgeForm(Form form)
               throws APIException

Description copied from interface: FormService

Completely remove a Form from the database. This is not reversible. It will fail if this form has already been used to create Encounters

Specified by:

purgeForm in interface FormService

Throws:

APIException - Should delete given form successfully Should delete form resources for deleted form Should throw an error when trying to delete a form while forms are locked

See Also:

FormService.purgeForm(org.openmrs.Form)

purgeForm

public void purgeForm(Form form,
                      boolean cascade)
               throws APIException

Description copied from interface: FormService

Completely remove a Form from the database. This is not reversible. !! WARNING: Calling this method with cascade=true can be very destructive !!

Specified by:

purgeForm in interface FormService

cascade - whether or not to cascade delete all dependent objects (including encounters!)

Throws:

APIException - Should throw APIException if cascade is true

See Also:

FormService.purgeForm(org.openmrs.Form, boolean)

purgeFormField

public void purgeFormField(FormField formField)
                    throws APIException

Description copied from interface: FormService

Completely removes the given FormField from the database. This is not reversible

Specified by:

purgeFormField in interface FormService

Parameters:

formField - the FormField to purge

Throws:

APIException - Should delete the given form field successfully

See Also:

FormService.purgeFormField(org.openmrs.FormField)

retireField

public Field retireField(Field field)
                  throws APIException

Description copied from interface: FormService

Retires field

Specified by:

retireField in interface FormService

Parameters:

field - the Field to retire

Returns:

the Field that was retired

Throws:

APIException - Should set the retired bit before saving

See Also:

FormService.retireField(org.openmrs.Field)

saveField

public Field saveField(Field field)
                throws APIException

Description copied from interface: FormService

Creates or updates the given Field

Specified by:

saveField in interface FormService

Parameters:

field - the Field to save

Returns:

the Field that was saved

Throws:

APIException - Should save given field successfully Should update an existing field

See Also:

FormService.saveField(org.openmrs.Field)

saveForm

public Form saveForm(Form form)
              throws APIException

Description copied from interface: FormService

Create or update the given Form in the database

Specified by:

saveForm in interface FormService

Parameters:

form - the Form to save

Returns:

the Form that was saved

Throws:

APIException - Should save given form successfully Should update an existing form Should throw an error when trying to save an existing form while forms are locked Should throw an error when trying to save a new form while forms are locked

See Also:

FormService.saveForm(org.openmrs.Form)

saveFormField

public FormField saveFormField(FormField formField)
                        throws APIException

Description copied from interface: FormService

Creates or updates the given FormField

Specified by:

saveFormField in interface FormService

Parameters:

formField - the FormField to save

Returns:

the formField that was just saved

Throws:

APIException - Should propagate save to the Field property on the given FormField Should save given formField successfully Should inject form fields from serializable complex obs handlers

See Also:

FormService.saveFormField(org.openmrs.FormField)

unretireField

public Field unretireField(Field field)
                    throws APIException

Description copied from interface: FormService

Unretires field

Specified by:

unretireField in interface FormService

Parameters:

field - the Field to unretire

Returns:

the Field that was unretired

Throws:

APIException - Should unset the retired bit before saving

See Also:

FormService.unretireField(org.openmrs.Field)

getFields

public List<Field> getFields(String fuzzySearchPhrase)
                      throws APIException

Description copied from interface: FormService

Find all Fields whose names are similar to or contain the given phrase. (The exact similarity algorithm is unspecified.) (includes retired fields)

Specified by:

getFields in interface FormService

Returns:

Fields with names similar to or containing the given phrase

Throws:

APIException - Should get fields with name matching fuzzySearchPhrase at beginning Should get fields with name matching fuzzySearchPhrase at middle Should get fields with name matching fuzzySearchPhrase at end Should return fields in alphabetical order by name

See Also:

FormService.getFields(java.lang.String)

getFieldsByConcept

@Transactional(readOnly=true)
public List<Field> getFieldsByConcept(Concept concept)
                                                             throws APIException

Description copied from interface: FormService

Finds all Fields that point to the given concept, including retired ones.

Specified by:

getFieldsByConcept in interface FormService

Parameters:

concept - the concept to search for in the Field table

Returns:

fields that point to the given concept

Throws:

APIException - Should get fields with concept matching given concept

See Also:

FormService.getFieldsByConcept(org.openmrs.Concept)

getFormsContainingConcept

@Transactional(readOnly=true)
public List<Form> getFormsContainingConcept(Concept concept)
                                                                   throws APIException

Description copied from interface: FormService

Returns all forms that contain the given concept as a field in their schema. (includes retired forms)

Specified by:

getFormsContainingConcept in interface FormService

Parameters:

concept - the concept to search for in forms

Returns:

forms containing the specified concept in their schema

Throws:

APIException - Should get forms with field matching given concept Should get all forms for concept

See Also:

FormService.getFormsContainingConcept(org.openmrs.Concept)

purgeFieldType

public void purgeFieldType(FieldType fieldType)
                    throws APIException

Description copied from interface: FormService

Deletes the given field type from the database. This should not be done. It is preferred to just retired this field type with #retireFieldType(FieldType)

Specified by:

purgeFieldType in interface FormService

Parameters:

fieldType - the field type to purge

Throws:

APIException - Should delete the given field type successfully

See Also:

FormService.purgeFieldType(org.openmrs.FieldType)

saveFieldType

public FieldType saveFieldType(FieldType fieldType)
                        throws APIException

Description copied from interface: FormService

Saves the given field type to the database

Specified by:

saveFieldType in interface FormService

Parameters:

fieldType - the field type to save

Returns:

the saved field type

Throws:

APIException - Should create new field type Should update existing field type

See Also:

FormService.saveFieldType(org.openmrs.FieldType)

mergeDuplicateFields

public int mergeDuplicateFields()
                         throws APIException

Description copied from interface: FormService

Audit form, consolidate similar fields

Specified by:

mergeDuplicateFields in interface FormService

Throws:

APIException - Should should merge fields with similar attributes

See Also:

FormService.mergeDuplicateFields()

getFormResource

@Transactional(readOnly=true)
public FormResource getFormResource(Integer formResourceId)
                                                           throws APIException

Description copied from interface: FormService

Finds a FormResource by its id

Specified by:

getFormResource in interface FormService

Parameters:

formResourceId - the id of the resource Should find a saved FormResource Should return null if no FormResource found

Throws:

APIException

See Also:

FormService.getFormResource(java.lang.Integer)

getFormResourceByUuid

@Transactional(readOnly=true)
public FormResource getFormResourceByUuid(String uuid)
                                                                 throws APIException

Description copied from interface: FormService

Finds a FormResource by its uuid

Specified by:

getFormResourceByUuid in interface FormService

Parameters:

uuid - the uuid of the resource

Throws:

APIException

See Also:

FormService.getFormResourceByUuid(java.lang.String)

getFormResource

@Transactional(readOnly=true)
public FormResource getFormResource(Form form,
                                                                  String name)
                                                           throws APIException

Description copied from interface: FormService

Finds a FormResource based on a given Form and name

Specified by:

getFormResource in interface FormService

Parameters:

form - the Form that the resource belongs to

name - the name of the resource

Throws:

APIException

See Also:

FormService.getFormResource(org.openmrs.Form, java.lang.String)

saveFormResource

public FormResource saveFormResource(FormResource formResource)
                              throws APIException

Description copied from interface: FormService

Saves or updates the given form resource

Specified by:

saveFormResource in interface FormService

Parameters:

formResource - the resource to be saved Should persist a FormResource Should overwrite an existing resource with same name Should be able to save an XSLT

Throws:

APIException

See Also:

FormService.saveFormResource(org.openmrs.FormResource)

purgeFormResource

public void purgeFormResource(FormResource formResource)
                       throws APIException

Description copied from interface: FormService

Purges a form resource

Specified by:

purgeFormResource in interface FormService

Parameters:

formResource - the resource to be purged Should delete a form resource

Throws:

APIException

See Also:

FormService.purgeFormResource(org.openmrs.FormResource)

getFormResourcesForForm

@Transactional(readOnly=true)
public Collection<FormResource> getFormResourcesForForm(Form form)
                                                                               throws APIException

Description copied from interface: FormService

Finds all FormResources tied to a given form

Specified by:

getFormResourcesForForm in interface FormService

Returns:

the resources attached to the form

Throws:

APIException

See Also:

FormService.getFormResourcesForForm(org.openmrs.Form)

checkIfFormsAreLocked

public void checkIfFormsAreLocked()

Description copied from interface: FormService

Checks if the forms are locked, and if they are throws an exception when saving or deleting a form

Specified by:

checkIfFormsAreLocked in interface FormService