org.openmrs

Interface Retireable

All Superinterfaces:

OpenmrsObject

All Known Subinterfaces:

AttributeType<OwningType>, OpenmrsMetadata

All Known Implementing Classes:

BaseAttributeType, BaseChangeableOpenmrsMetadata, BaseCustomizableMetadata, BaseOpenmrsMetadata, CareSetting, Concept, ConceptAttributeType, ConceptClass, ConceptComplex, ConceptDatatype, ConceptMapType, ConceptNumeric, ConceptReferenceTerm, ConceptSource, DiagnosisAttributeType, Drug, EncounterRole, EncounterType, Field, FieldType, Form, FormField, HL7Source, Location, LocationAttributeType, LocationTag, OrderAttributeType, OrderFrequency, OrderGroupAttributeType, OrderSet, OrderSetAttributeType, OrderSetMember, OrderType, PatientIdentifierType, PersonAttributeType, Privilege, Program, ProgramAttributeType, ProgramWorkflow, ProgramWorkflowState, Provider, ProviderAttributeType, RelationshipType, Role, SerializedObject, TaskDefinition, User, VisitAttributeType, VisitType

public interface Retireable
extends OpenmrsObject

In OpenMRS, data are rarely fully deleted (purged) from the system; rather, they are either voided or retired. When existing data remain valid but should no longer be used for new entries, they are retired. Typically this applies to metadata (see OpenmrsMetadata). For example, an encounter form type or a patient attribute type may no longer be valid but cannot be removed because there are (and may be in perpetuity) data previously collected using these metadata. Making these metadata Retirable allows them to be retired, meaning that existing references remain valid but future references are not allowed.

Since:

1.5

See Also:

OpenmrsMetadata, Voidable

Method Summary

Modifier and Type	Method and Description
Date	getDateRetired()
Boolean	getRetired()
User	getRetiredBy()
String	getRetireReason()
Boolean	isRetired() Deprecated. as of 2.0, use getRetired()
void	setDateRetired(Date dateRetired)
void	setRetired(Boolean retired)
void	setRetiredBy(User retiredBy)
void	setRetireReason(String retireReason)

Methods inherited from interface org.openmrs.OpenmrsObject

getId, getUuid, setId, setUuid

Method Detail

isRetired

@Deprecated
Boolean isRetired()

Deprecated. as of 2.0, use getRetired()

Returns:

Boolean - whether of not this object is retired

getRetired

Boolean getRetired()

setRetired

void setRetired(Boolean retired)

Parameters:

retired - - whether of not this object is retired

getRetiredBy

User getRetiredBy()

Returns:

User - the user who retired the object

setRetiredBy

void setRetiredBy(User retiredBy)

Parameters:

retiredBy - - the user who retired the object

getDateRetired

Date getDateRetired()

Returns:

Date - the date the object was retired

setDateRetired

void setDateRetired(Date dateRetired)

Parameters:

dateRetired - - the date the object was retired

getRetireReason

String getRetireReason()

Returns:

String - the reason the object was retired

setRetireReason

void setRetireReason(String retireReason)

Parameters:

retireReason - - the reason the object was retired