org.openmrs.api

Interface PatientSetService

All Known Implementing Classes:

PatientSetServiceImpl

@Transactional
public interface PatientSetService

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	PatientSetService.BooleanOperator
static class	PatientSetService.GroupMethod
static class	PatientSetService.Modifier
static class	PatientSetService.PatientLocationMethod
static class	PatientSetService.TimeModifier

Method Summary

Modifier and Type	Method and Description
Cohort	convertPatientIdentifier(List<String> identifiers) TODO write something here
String	exportXml(Cohort ps) Export a set of patients to an XML
String	exportXml(Integer patientId)
Cohort	getAllPatients()
Map<Integer,Map<String,Object>>	getCharacteristics(Cohort patients) TODO write something here
Integer	getCountOfPatients()
Map<Integer,List<DrugOrder>>	getCurrentDrugOrders(Cohort ps, Concept drugSet)
Map<Integer,PatientProgram>	getCurrentPatientPrograms(Cohort ps, Program program)
Map<Integer,PatientState>	getCurrentStates(Cohort ps, ProgramWorkflow wf) Gets statistical information about current states of patients within given cohort for specific program workflow
Map<Integer,List<DrugOrder>>	getDrugOrders(Cohort ps, Concept drugSet)
Map<Integer,Object>	getEncounterAttrsByType(Cohort patients, List<EncounterType> encTypes, String attr) TODO write something here
Map<Integer,Encounter>	getEncounters(Cohort patients) This method returns a map of patients matched against their most recent encounters given a Cohort of patients, see EncounterService.getAllEncounters(Cohort) which gets a map of patient matched against lists of all their encounters.
List<Encounter>	getEncountersByForm(Cohort patients, List<Form> form) Gets a list of encounters associated with the given form, filtered by the given patient set.
Map<Integer,Encounter>	getEncountersByType(Cohort patients, EncounterType encType) TODO write something here
Map<Integer,Encounter>	getEncountersByType(Cohort patients, List<EncounterType> encType) TODO write something here
Map<Integer,Object>	getFirstEncounterAttrsByType(Cohort patients, List<EncounterType> encTypes, String attr) TODO write something here
Map<Integer,Encounter>	getFirstEncountersByType(Cohort patients, EncounterType encType) TODO write something here
Map<Integer,Encounter>	getFirstEncountersByType(Cohort patients, List<EncounterType> types) TODO write something here
Cohort	getInverseOfCohort(Cohort cohort) Equivalent to Cohort.subtract(PatientSetService.getAllPatients(), cohort) but may eventually perform faster by delegating to the database.
Map<Integer,List<Obs>>	getObservations(Cohort patients, Concept concept)
Map<Integer,List<Obs>>	getObservations(Cohort patients, Concept concept, Date fromDate, Date toDate) Date range is inclusive of both endpoints
Map<Integer,List<List<Object>>>	getObservationsValues(Cohort patients, Concept c) TODO write something here
Map<Integer,List<List<Object>>>	getObservationsValues(Cohort patients, Concept c, List<String> attributes) Deprecated. use getObservationsValues(Cohort, Concept, List, Integer, boolean) instead
Map<Integer,List<List<Object>>>	getObservationsValues(Cohort patients, Concept c, List<String> attributes, Integer limit, boolean showMostRecentFirst) Returns a mapping from patient id to obs for concept c
Map<Integer,Object>	getPatientAttributes(Cohort patients, String classNameDotProperty, boolean returnAll) TODO write something here
Map<Integer,Object>	getPatientAttributes(Cohort patients, String className, String property, boolean returnAll) TODO write something here
Map<Integer,PatientIdentifier>	getPatientIdentifiersByType(Cohort patients, PatientIdentifierType type) Deprecated. use method by same name that returns just the string instead of the whole object
Map<Integer,String>	getPatientIdentifierStringsByType(Cohort patients, PatientIdentifierType type) Gets a map of patient identifiers values by identifier type, indexed by patient primary key.
Map<Integer,PatientProgram>	getPatientPrograms(Cohort ps, Program program) Gets program enrollment data for the given cohort in the given program.
List<Patient>	getPatients(Collection<Integer> patientIds) TODO write something here
Cohort	getPatients(Integer start, Integer size) Get a batch of patients that are not voided in the database
Cohort	getPatientsByCharacteristics(String gender, Date minBirthdate, Date maxBirthdate)
Cohort	getPatientsByCharacteristics(String gender, Date minBirthdate, Date maxBirthdate, Integer minAge, Integer maxAge, Boolean aliveOnly, Boolean deadOnly) Get patients by specified gender, birthdate range, age range, and alive status (all optional)
Cohort	getPatientsByCharacteristics(String gender, Date minBirthdate, Date maxBirthdate, Integer minAge, Integer maxAge, Boolean aliveOnly, Boolean deadOnly, Date effectiveDate) Get patients by specified gender, birthdate range, age range, and alive status (all optional)
Cohort	getPatientsByProgramAndState(Program program, List<ProgramWorkflowState> stateList, Date fromDate, Date toDate) Gets patients who are enrolled in the given program or in the given state(s) at the specified time
Cohort	getPatientsHavingDateObs(Integer conceptId, Date startTime, Date endTime)
Cohort	getPatientsHavingDrugOrder(Collection<Integer> patientIds, Collection<Integer> takingIds, Date onDate) Returns a Cohort of patient who had drug orders for a set of drugs active on a certain date.
Cohort	getPatientsHavingDrugOrder(Collection<Integer> patientIds, Collection<Integer> drugIds, PatientSetService.GroupMethod groupMethod, Date fromDate, Date toDate) Returns a Cohort of patient who had drug orders for a set of drugs active between a pair of dates.
Cohort	getPatientsHavingDrugOrder(List<Drug> drug, List<Concept> drugConcept, Date startDateFrom, Date startDateTo, Date stopDateFrom, Date stopDateTo, Boolean discontinued, List<Concept> discontinuedReason)
Cohort	getPatientsHavingEncounters(EncounterType encounterType, Location location, Form form, Date fromDate, Date toDate, Integer minCount, Integer maxCount) Searches for patients who have encounters as described by the arguments to this method
Cohort	getPatientsHavingEncounters(List<EncounterType> encounterTypeList, Location location, Form form, Date fromDate, Date toDate, Integer minCount, Integer maxCount) Gets patients who have encounters as described by the parameters specified (all optional)
Cohort	getPatientsHavingLocation(Integer locationId)
Cohort	getPatientsHavingLocation(Integer locationId, PatientSetService.PatientLocationMethod method)
Cohort	getPatientsHavingLocation(Location loc)
Cohort	getPatientsHavingLocation(Location loc, PatientSetService.PatientLocationMethod method)
Cohort	getPatientsHavingNumericObs(Integer conceptId, PatientSetService.TimeModifier timeModifier, PatientSetService.Modifier modifier, Number value, Date fromDate, Date toDate)
Cohort	getPatientsHavingObs(Integer conceptId, PatientSetService.TimeModifier timeModifier, PatientSetService.Modifier modifier, Object value, Date fromDate, Date toDate) Searches for patients who have observations as described by the arguments to this method
Cohort	getPatientsHavingPersonAttribute(PersonAttributeType attribute, String value) At least one of attribute and value must be non-null
Cohort	getPatientsHavingTextObs(Concept concept, String value, PatientSetService.TimeModifier timeModifier)
Cohort	getPatientsHavingTextObs(Integer conceptId, String value, PatientSetService.TimeModifier timeModifier)
Cohort	getPatientsInProgram(Program program, Date fromDate, Date toDate)
Map<Integer,Object>	getPersonAttributes(Cohort patients, String attributeName, String joinClass, String joinProperty, String outputColumn, boolean returnAll)
Map<Integer,List<Relationship>>	getRelationships(Cohort ps, RelationshipType relType)
Map<Integer,List<Person>>	getRelatives(Cohort ps, RelationshipType relType, boolean forwards)
Map<Integer,String>	getShortPatientDescriptions(Collection<Integer> patientIds)
void	setPatientSetDAO(PatientSetDAO dao)

Method Detail

setPatientSetDAO

void setPatientSetDAO(PatientSetDAO dao)

exportXml

@Transactional(readOnly=true)
String exportXml(Cohort ps)

Export a set of patients to an XML

Parameters:

ps - The set you want to export as XML

Returns:

an XML representation of this patient-set, including patient characteristics, and observations

exportXml

@Transactional(readOnly=true)
String exportXml(Integer patientId)

getAllPatients

@Transactional(readOnly=true)
Cohort getAllPatients()
                                             throws DAOException

Throws:

DAOException

getPatientsByCharacteristics

@Transactional(readOnly=true)
Cohort getPatientsByCharacteristics(String gender,
                                                                  Date minBirthdate,
                                                                  Date maxBirthdate)
                                                           throws DAOException

Throws:

DAOException

getPatientsByCharacteristics

@Transactional(readOnly=true)
Cohort getPatientsByCharacteristics(String gender,
                                                                  Date minBirthdate,
                                                                  Date maxBirthdate,
                                                                  Integer minAge,
                                                                  Integer maxAge,
                                                                  Boolean aliveOnly,
                                                                  Boolean deadOnly)
                                                           throws DAOException

Get patients by specified gender, birthdate range, age range, and alive status (all optional)

Parameters:

gender -

minBirthdate -

maxBirthdate -

minAge -

maxAge -

aliveOnly -

deadOnly -

Returns:

Cohort with all matching patients

Throws:

DAOException

Should:

get all patients when no parameters given, get patients of given gender, get patients born before date, get patients born after date, get patients born between dates, get patients who are alive, get patients who are dead

getPatientsByCharacteristics

@Transactional(readOnly=true)
Cohort getPatientsByCharacteristics(String gender,
                                                                  Date minBirthdate,
                                                                  Date maxBirthdate,
                                                                  Integer minAge,
                                                                  Integer maxAge,
                                                                  Boolean aliveOnly,
                                                                  Boolean deadOnly,
                                                                  Date effectiveDate)
                                                           throws DAOException

Get patients by specified gender, birthdate range, age range, and alive status (all optional)

Parameters:

gender -

minBirthdate -

maxBirthdate -

minAge -

maxAge -

aliveOnly -

deadOnly -

effectiveDate -

Returns:

Cohort with all matching patients

Throws:

DAOException

Should:

get all patients when no parameters given, get patients of given gender, get patients born before date, get patients born after date, get patients born between dates, get patients who are alive, get patients who are dead, not get patients born after effectiveDate

getPatientsHavingNumericObs

@Transactional(readOnly=true)
Cohort getPatientsHavingNumericObs(Integer conceptId,
                                                                 PatientSetService.TimeModifier timeModifier,
                                                                 PatientSetService.Modifier modifier,
                                                                 Number value,
                                                                 Date fromDate,
                                                                 Date toDate)

getPatientsHavingObs

@Transactional(readOnly=true)
Cohort getPatientsHavingObs(Integer conceptId,
                                                          PatientSetService.TimeModifier timeModifier,
                                                          PatientSetService.Modifier modifier,
                                                          Object value,
                                                          Date fromDate,
                                                          Date toDate)

Searches for patients who have observations as described by the arguments to this method

Parameters:

conceptId -

timeModifier -

modifier -

value -

fromDate -

toDate -

Returns:

all patients with observations matching the arguments to this method

Should:

get patients by concept and true boolean value, get patients by concept and false boolean value

getPatientsHavingEncounters

@Transactional(readOnly=true)
Cohort getPatientsHavingEncounters(EncounterType encounterType,
                                                                 Location location,
                                                                 Form form,
                                                                 Date fromDate,
                                                                 Date toDate,
                                                                 Integer minCount,
                                                                 Integer maxCount)

Searches for patients who have encounters as described by the arguments to this method

Parameters:

encounterType -

location -

form -

fromDate -

toDate -

minCount -

maxCount -

Returns:

all patients with encounters matching the arguments to this method

Should:

get all patients with encounters when no parameters specified

getPatientsHavingEncounters

@Transactional(readOnly=true)
Cohort getPatientsHavingEncounters(List<EncounterType> encounterTypeList,
                                                                 Location location,
                                                                 Form form,
                                                                 Date fromDate,
                                                                 Date toDate,
                                                                 Integer minCount,
                                                                 Integer maxCount)

Gets patients who have encounters as described by the parameters specified (all optional)

Parameters:

encounterTypeList -

location -

form -

fromDate -

toDate -

minCount -

maxCount -

Returns:

Cohort with matching Patients

Should:

get all patients with encounters when no parameters specified, get patients with encounters of type, get patients with encounters of multiple types, get patients with encounters at location, get patients with encounters from form, get patients with encounters before date, get patients with encounters after date, get patients with encounters between dates, get patients with at least n encounters, get patients with at most n encounters, get all patients with encounters when passed an empty encounterTypeList

getPatientsByProgramAndState

@Transactional(readOnly=true)
Cohort getPatientsByProgramAndState(Program program,
                                                                  List<ProgramWorkflowState> stateList,
                                                                  Date fromDate,
                                                                  Date toDate)

Gets patients who are enrolled in the given program or in the given state(s) at the specified time

Parameters:

program -

stateList -

fromDate -

toDate -

Returns:

Cohort with matching Patients

Should:

get all patients in any program given null parameters, get patients in program, get patients in program from date, get patients in program to date, get patients in program between dates, get patients in state, get patients in states, get patients in state from date, get patients in state to date, get patients in state between dates

getPatientsInProgram

@Transactional(readOnly=true)
Cohort getPatientsInProgram(Program program,
                                                          Date fromDate,
                                                          Date toDate)

getPatientsHavingDateObs

@Transactional(readOnly=true)
Cohort getPatientsHavingDateObs(Integer conceptId,
                                                              Date startTime,
                                                              Date endTime)

getPatientsHavingTextObs

@Transactional(readOnly=true)
Cohort getPatientsHavingTextObs(Concept concept,
                                                              String value,
                                                              PatientSetService.TimeModifier timeModifier)

getPatientsHavingTextObs

@Transactional(readOnly=true)
Cohort getPatientsHavingTextObs(Integer conceptId,
                                                              String value,
                                                              PatientSetService.TimeModifier timeModifier)

getPatientsHavingLocation

@Transactional(readOnly=true)
Cohort getPatientsHavingLocation(Location loc)

getPatientsHavingLocation

@Transactional(readOnly=true)
Cohort getPatientsHavingLocation(Location loc,
                                                               PatientSetService.PatientLocationMethod method)

getPatientsHavingLocation

@Transactional(readOnly=true)
Cohort getPatientsHavingLocation(Integer locationId)

getPatientsHavingLocation

@Transactional(readOnly=true)
Cohort getPatientsHavingLocation(Integer locationId,
                                                               PatientSetService.PatientLocationMethod method)

getPatientsHavingDrugOrder

@Transactional(readOnly=true)
Cohort getPatientsHavingDrugOrder(Collection<Integer> patientIds,
                                                                Collection<Integer> takingIds,
                                                                Date onDate)

Returns a Cohort of patient who had drug orders for a set of drugs active on a certain date. Can also be used to find patient with no drug orders on that date.

Parameters:

patientIds - Collection of patientIds you're interested in. NULL means all patients.

takingIds - Collection of drugIds the patient is taking. (Or the empty set to mean "any drug" or NULL to mean "no drugs")

onDate - Which date to look at the patients' drug orders. (NULL defaults to now().)

getPatientsHavingDrugOrder

@Transactional(readOnly=true)
Cohort getPatientsHavingDrugOrder(Collection<Integer> patientIds,
                                                                Collection<Integer> drugIds,
                                                                PatientSetService.GroupMethod groupMethod,
                                                                Date fromDate,
                                                                Date toDate)

Returns a Cohort of patient who had drug orders for a set of drugs active between a pair of dates. Can also be used to find patient with no drug orders on that date.

Parameters:

patientIds - Collection of patientIds you're interested in. NULL means all patients.

drugIds - Collection of drugIds the patient is taking. (Or the empty set to mean "any drug" or NULL to mean "no drugs")

groupMethod - whether to do NONE, ALL, or ANY of the list of specified ids.

fromDate - Beginning of date range to look at (NULL defaults to toDate if that isn't null, or now() if it is.)

toDate - End of date range to look at (NULL defaults to fromDate if that isn't null, or now() if it is.)

Returns:

Cohort with matching Patients

Should:

get all patients with drug orders given null parameters, get patients with no drug orders, get patients with drug orders for drugs, get patients with no drug orders for drugs, get patients with drug orders from date, get patients with drug orders to date, get patients with drug order for drug between dates

getPatientsHavingDrugOrder

@Transactional(readOnly=true)
Cohort getPatientsHavingDrugOrder(List<Drug> drug,
                                                                List<Concept> drugConcept,
                                                                Date startDateFrom,
                                                                Date startDateTo,
                                                                Date stopDateFrom,
                                                                Date stopDateTo,
                                                                Boolean discontinued,
                                                                List<Concept> discontinuedReason)

Returns:

A Cohort of patients who had drug order for particular drugs or generics, with start dates within a range, with end dates within a range, and a reason for discontinuation.

getPatientsHavingPersonAttribute

@Transactional(readOnly=true)
Cohort getPatientsHavingPersonAttribute(PersonAttributeType attribute,
                                                                      String value)

At least one of attribute and value must be non-null

Parameters:

attribute - if not null, look for this attribute

value - if not null, look for this value

Returns:

Cohort of patients who have a person attribute (optionally) with attributeType of attribute and (optionally) value of value.

getShortPatientDescriptions

@Transactional(readOnly=true)
Map<Integer,String> getShortPatientDescriptions(Collection<Integer> patientIds)

getObservations

@Transactional(readOnly=true)
Map<Integer,List<Obs>> getObservations(Cohort patients,
                                                                     Concept concept)

getObservations

@Transactional(readOnly=true)
Map<Integer,List<Obs>> getObservations(Cohort patients,
                                                                     Concept concept,
                                                                     Date fromDate,
                                                                     Date toDate)

Date range is inclusive of both endpoints

getObservationsValues

@Transactional(readOnly=true)
Map<Integer,List<List<Object>>> getObservationsValues(Cohort patients,
                                                                                    Concept c)

TODO write something here

Parameters:

patients -

c -

Returns:

Map>

getObservationsValues

@Deprecated
 @Transactional(readOnly=true)
Map<Integer,List<List<Object>>> getObservationsValues(Cohort patients,
                                                                                                 Concept c,
                                                                                                 List<String> attributes)

Deprecated. use getObservationsValues(Cohort, Concept, List, Integer, boolean) instead

getObservationsValues

@Transactional(readOnly=true)
Map<Integer,List<List<Object>>> getObservationsValues(Cohort patients,
                                                                                    Concept c,
                                                                                    List<String> attributes,
                                                                                    Integer limit,
                                                                                    boolean showMostRecentFirst)

Returns a mapping from patient id to obs for concept c

The returned List< attribute value > is [obs value, attr value, attr value, attr value...] The returned List> represents the obs rows

Parameters:

patients - the cohort to restrict to. if null, then all patients are fetched

c - the concept to look for in obs.concept_id

attributes - list of attributes

limit - the number of patients to limit the results to. If null or less than zero, return all

showMostRecentFirst - if true, obs with the highest obsDatetime will be first in the List>

Returns:

Map>>

getEncountersByType

@Transactional(readOnly=true)
Map<Integer,Encounter> getEncountersByType(Cohort patients,
                                                                         EncounterType encType)

TODO write something here

Parameters:

patients - Cohort of patients to search

encType - the type of the encounter

Returns:

Map of patientId to encounters matching a specific type

getEncounterAttrsByType

Map<Integer,Object> getEncounterAttrsByType(Cohort patients,
                                            List<EncounterType> encTypes,
                                            String attr)

TODO write something here

Parameters:

patients - Cohort of patients to search

encTypes - List to include in the search

attr - String of attributes to get

Returns:

Map of encounter attributes

getEncountersByType

@Transactional(readOnly=true)
Map<Integer,Encounter> getEncountersByType(Cohort patients,
                                                                         List<EncounterType> encType)

TODO write something here

Parameters:

patients - Cohort of patients to search

encType - List to include in the search

Returns:

Map of patientId to encounters matching a specific type

getEncounters

@Transactional(readOnly=true)
Map<Integer,Encounter> getEncounters(Cohort patients)

This method returns a map of patients matched against their most recent encounters given a Cohort of patients, see EncounterService.getAllEncounters(Cohort) which gets a map of patient matched against lists of all their encounters.

Parameters:

patients - Cohort of patients to search

Returns:

Map of all encounters for specified patients.

See Also:

EncounterService.getAllEncounters(Cohort)

getFirstEncountersByType

@Transactional(readOnly=true)
Map<Integer,Encounter> getFirstEncountersByType(Cohort patients,
                                                                              EncounterType encType)

TODO write something here

Parameters:

patients - Cohort of patients to search

encType -

Returns:

Map of patientId to first encounters of specified patients, from a specific type

getFirstEncountersByType

@Transactional(readOnly=true)
Map<Integer,Encounter> getFirstEncountersByType(Cohort patients,
                                                                              List<EncounterType> types)

TODO write something here

Parameters:

patients - Cohort of patients to search

types - List to include in the search

Returns:

Map of patientId to first encounters of specified patients, from a specific list of types

getFirstEncounterAttrsByType

@Transactional(readOnly=true)
Map<Integer,Object> getFirstEncounterAttrsByType(Cohort patients,
                                                                               List<EncounterType> encTypes,
                                                                               String attr)

TODO write something here

Parameters:

patients - Cohort of patients to search

encTypes - List to include in the search

attr -

Returns:

Map of patientId to first encounters properties

getPatientAttributes

@Transactional(readOnly=true)
Map<Integer,Object> getPatientAttributes(Cohort patients,
                                                                       String className,
                                                                       String property,
                                                                       boolean returnAll)

TODO write something here

Parameters:

patients - Cohort of patients to search

className -

property -

returnAll -

Returns:

Map of patientId to patient properties

getPatientAttributes

@Transactional(readOnly=true)
Map<Integer,Object> getPatientAttributes(Cohort patients,
                                                                       String classNameDotProperty,
                                                                       boolean returnAll)

TODO write something here

Parameters:

patients -

classNameDotProperty -

returnAll -

Returns:

Map of patientId to patient properties

getPersonAttributes

@Transactional(readOnly=true)
Map<Integer,Object> getPersonAttributes(Cohort patients,
                                                                      String attributeName,
                                                                      String joinClass,
                                                                      String joinProperty,
                                                                      String outputColumn,
                                                                      boolean returnAll)

Parameters:

patients -

attributeName -

joinClass -

joinProperty -

outputColumn -

returnAll -

Returns:

Map of patientId to person properties

Should:

return person attributes of type Location

getCharacteristics

@Transactional(readOnly=true)
Map<Integer,Map<String,Object>> getCharacteristics(Cohort patients)

TODO write something here

Parameters:

patients - Cohort of patients to look up

Returns:

Map> with characteristics of specified patients

getPatientIdentifiersByType

@Deprecated
 @Transactional(readOnly=true)
Map<Integer,PatientIdentifier> getPatientIdentifiersByType(Cohort patients,
                                                                                                      PatientIdentifierType type)

Deprecated. use method by same name that returns just the string instead of the whole object

The PatientIdentifer object in the returned map now ONLY contains the identifier string, no other data is available

getPatientIdentifierStringsByType

@Transactional(readOnly=true)
Map<Integer,String> getPatientIdentifierStringsByType(Cohort patients,
                                                                                    PatientIdentifierType type)

Gets a map of patient identifiers values by identifier type, indexed by patient primary key.

Parameters:

patients - Cohort of patients to look up

type - PatientIdentifierType to retrieve

Returns:

Map of patient identifiers (strings) for all patients in the specified cohort

convertPatientIdentifier

@Transactional(readOnly=true)
Cohort convertPatientIdentifier(List<String> identifiers)

TODO write something here

Parameters:

identifiers - List of String patient identifiers

Returns:

Cohort of patients matching specified identifiers

getPatients

@Transactional(readOnly=true)
List<Patient> getPatients(Collection<Integer> patientIds)

TODO write something here

Parameters:

patientIds -

Returns:

List of matching patients

getCurrentStates

@Transactional(readOnly=true)
Map<Integer,PatientState> getCurrentStates(Cohort ps,
                                                                         ProgramWorkflow wf)

Gets statistical information about current states of patients within given cohort for specific program workflow

Parameters:

ps - the patient's cohort object

wf - the program workflow instance

Returns:

map containing statistic information about patient states in cohort

Should:

return an empty map if cohort is empty

getCurrentPatientPrograms

@Transactional(readOnly=true)
Map<Integer,PatientProgram> getCurrentPatientPrograms(Cohort ps,
                                                                                    Program program)

getPatientPrograms

@Transactional(readOnly=true)
Map<Integer,PatientProgram> getPatientPrograms(Cohort ps,
                                                                             Program program)

Gets program enrollment data for the given cohort in the given program. The behavior is not specified if a patient is enrolled in the same program twice simultaneously.

Parameters:

ps - the cohort to get data for

program - the program to look for enrollments in

Returns:

a Map from patientId to PatientProgram

Should:

get program enrollments for the given cohort

getRelationships

@Transactional(readOnly=true)
Map<Integer,List<Relationship>> getRelationships(Cohort ps,
                                                                               RelationshipType relType)

getRelatives

@Transactional(readOnly=true)
Map<Integer,List<Person>> getRelatives(Cohort ps,
                                                                     RelationshipType relType,
                                                                     boolean forwards)

getCurrentDrugOrders

@Transactional(readOnly=true)
Map<Integer,List<DrugOrder>> getCurrentDrugOrders(Cohort ps,
                                                                                Concept drugSet)

Returns:

all active drug orders whose drug concept is in the given set (or all drugs if that's null)

getDrugOrders

@Transactional(readOnly=true)
Map<Integer,List<DrugOrder>> getDrugOrders(Cohort ps,
                                                                         Concept drugSet)

Returns:

all active or finished drug orders whose drug concept is in the given set (or all drugs if that's null)

Should:

return an empty list if cohort is empty

getEncountersByForm

@Transactional(readOnly=true)
List<Encounter> getEncountersByForm(Cohort patients,
                                                                  List<Form> form)

Gets a list of encounters associated with the given form, filtered by the given patient set.

Parameters:

patients - Cohort of the patients to filter by (null will return all encounters for all patients)

form - List

of the forms to filter by

getInverseOfCohort

Cohort getInverseOfCohort(Cohort cohort)

Equivalent to Cohort.subtract(PatientSetService.getAllPatients(), cohort) but may eventually perform faster by delegating to the database. (The current implementation has *not* been optimized.)

Parameters:

cached -

Returns:

Since:

1.8

getCountOfPatients

Integer getCountOfPatients()

Returns:

number of unvoided patients in the database

Since:

1.8

getPatients

Cohort getPatients(Integer start,
                   Integer size)

Get a batch of patients that are not voided in the database

Parameters:

start - the starting index

size - the number of patients to get in this batch

Returns:

a Cohort with patient ids

Since:

1.8