Wiki Spaces

Documentation
Projects
Resources

Get Help from Others

Q&A: Ask OpenMRS
Discussion: OpenMRS Talk
Real-Time: IRC Chat | Slack

Documentation

Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 18 Next »

 

How to access the cohort builder:

  • Click on the cohort-builder button on the homepage of the OpenMRS application.

    Screen Shot 2017-08-02 at 7.01.25 PM.png

About the OpenMRS cohort-builder OWA

The OpenMRS cohort-builder OWA is used to make search queries against a dataset of patients with different query options, the cohort-builder currently has 6 active tabs each offering the user with different option and parameters to make search queries, there are currently 6 active tabs namely:

  1. The Concept / Observation tab

  2. The Patient Attribute tab

  3. The Encounter tab

  4. The Program enrollment tab

  5. The Composition tab

  6. The Saved  tab

The Concept / Observation tab

This tab gives the user the option to search via concepts or observations existing in the system. Examples of concepts are blood and malaria.

  Screen Shot 2017-08-02 at 7.17.24 PM.pngScreen Shot 2017-08-02 at 7.17.48 PM.png

The Patient Attribute tab

This tab gives the user the option to search via demographics and a person attributes

    1. Search by demographicThis allows you search for patients in a particular sector of a population. There are 5 search options namely
      1. Gender allows you to select and search by gender i. e Male or Female
      2. Age allows you to filter between ages i.e. 0-14
      3. Birthdate allows you to filter between birth dates
      4. Alive only allows you to search for alive patients
      5. Dead only allows you to search for dead patients
      6. Search is the tab or button for the search
    2. Search by person attribute: This allows you search for patients with a specific attribute. There are numerous search options namely

      1. Birthplace allows you to to filter by place of birth

      2. Citizenship allows you to to filter by country of origin

      3. Civil Status

      4. Health Center allows you to to filter by similar health centers

      5. Health District allows you to to filter by similar health districts

      6. Mother’s Name allows you to to filter by similar mother’s name

      7. Race allows you to to filter by similar races

      8. Telephone number allows you to to filter by similar phone numbers

      9. Unknown patient

      10. Test patient

 Screen Shot 2017-08-02 at 7.19.17 PM.png

The Encounter tab

This tab gives the user the option to search via patients encounter and location

    1. Search by Encounter: This allows you search for patients with specific type of activity or encounter, example of encounters are check in, checkout, transfer, admission e.t.c. There are numerous search options namely

      1. Of Type allows you to to filter by the type of the encounter

      2. Location allows you to to filter by the location of the encounter

      3. At least this many allows you to to filter by the minimum encounter count

      4. Upto this many allows you to to filter by the maximum encounter type

      5. From - To allows you to to filter by the date range in which the encounter(s) occurred.

    2. Search by Location: This allows you search for patients by the encounter location e.t.c Amani hospital, inpatient ward, isolation ward e.t.c. There are numerous search options namely

      1. Patient belonging to allows you to to filter by the location the encounter belongs to.

      2. According to method allows you to to filter by the timeline of the encounter

 Screen Shot 2017-08-02 at 8.31.18 PM.png

The Program enrollment tab

This tab gives the user the option to search via the programmes the patient is enrolled in and the patient's status in the programme.  There are numerous search options namely

    1. Program allows you to to filter by the type of the program.

    2. Workflow allows you to filter by

    3. State allows you to to filter by the location of the program

    4. In the programme allows you to to filter by the timeline the user was in the programme.

    5. Enrolled in the programme allows you to to filter by the timeline in which the user was enrolled into the program.

    6. Completed the programme allows you to to filter by the timeline in which the user completed the program.

  Screen Shot 2017-08-02 at 9.07.50 PM.png

The Composition tab

This tab gives the user the option to search for patient via a series of set operations and relations usually between different search histories indexes, example of the operation that can be performed are

    1. And / Union

    2. Or

    3. Not

    4. Intersection

    5. !

    6. +

 There are two input boxes on this tab  namely

  1. Composition: This is where the operations are entered e.g (1 and 2) or not 3

  2. Description: This is a name or description for the search composition that is being created

 Screen Shot 2017-08-02 at 9.20.33 PM.png

The Saved tab

 This tab gives the user the option to search for a saved cohort or definition, it has two fields namely

    1. Search Saved Definitions allows the user search for a saved definition by it’s name

    2. Search Saved Cohort allows the user search for a saved cohort by it’s name

  Screen Shot 2017-08-02 at 9.41.08 PM.png

  • The Search history: This is where an history of executed searches are saved and displayed to the user, each search can be saved either as a cohort or as a definition. There are numerous fields under this component, namely

    1. Query: This is where the name or description of the query is displayed

    2. Query Definition Options

      1. Save: This saves a definition to the database

      2. Delete: This removes a definition from the search history

    3. Results: This contains a list of all the patients contained in the search result

    4. Query Definition Options

      1. Save: This saves a cohort to the database

      2. Delete: This removes a definition from the search history

  Screen Shot 2017-08-02 at 6.31.56 PM.png

To contribute or setup this open web app please visit this Link.

Frequently asked questions:

  • Is there a limit to the number of cohorts and definitions that can be saved?

    • No there is no limit to the amount of  cohorts and definitions that can be save.

  • No labels