Purpose

Obs To Obs Flowsheet is configured to view the observation data in tabular format. It will display the observation value vs multiple observation values. There is a provision to configure editing observations from this control.

Screenshot

Configuration

Sample Config

"Bacteriology Resultseriology Concept Set": {
    "translationKey": "DASHBOARD_TITLE_BACTERIOLOGY_RESULTS_KEY",
    "type": "obsToObsFlowSheet",
    "displayOrder" : 4,
    "displayType" : "Full-Page",
    "rotateInPrint" : false,
    "headingConceptSource" : "Abbreviation",
    "dataConceptSource" : "Abbreviation",
    "dashboardConfig": {
        "numberOfVisits": 1,
        "initialCount": 3,
        "latestCount": 4,
        "pivotOn": "column",
        "templateName": "BACTERIOLOGY CONCEPT SET",
        "groupByConcept": "Specimen Collection Date",
        "type": "DstExtension",
        "conceptNames": [
            "Specimen Id"
        ],
        "isEditable": true,
		"obsDelimiter": "\n"
    },
    "expandedViewConfig": {
        "templateName": "BACTERIOLOGY CONCEPT SET",
        "groupByConcept": "Specimen Collection Date"
    },
    "hideEmptyDisplayControl": false
}

Drug Susceptibility Test (DST) Control

This is an example of Obs To Obs FlowSheet Control. Below are different ways of configuring.

• pivotOn: row: Here all the headers on the columns and their values will be based on the rows. This is the default behavior.

• pivotOn: column- Here the headers are based on the first column and for each observation, there is a column. This behavior is configurable.

Sample Config

"dstResults": {
    "translationKey": "DST Results",
    "type": "obsToObsFlowSheet",
    "displayType": "Full-Page",
    "displayOrder": 9,
    "rotateInPrint" : true,
    "showOnlyInPrint" : true,
	"headingConceptSource":"Abbreviation",
	"dataConceptSource": "Abbreviation",
    "dashboardConfig": {
        "groupByConcept": "Specimen Collection Date",
        "name": "DstExtension",
		"pivotOn": "column",	
        "templateName": "BACTERIOLOGY CONCEPT SET",
        "conceptNames": [
            "Bacteriology, Isoniazid 0.2 µg/ml result",
            "Bacteriology, Isoniazid 1 µg/ml result",
            "Bacteriology, Rifampicin result",
            "Bacteriology, Ethambutol result",
            "Bacteriology, Pyrazinamide result"
        ]
    }
}

Key Field Table

Groovy Extensions

This control has an ability to configure custom Groovy extensions.

Some of the example scenarios where a groovy extension can be used in the context of obs to obs control are:

• Month Extension
• Displaying the Highest Observation Value

Month Extension

If you want the month column to be shown in chronicTreatmentChart, then add the following groovy extension.

Sample Groovy Code: TreatmentRegimenExtension.groovy (https://github.com/Bahmni/endtb-config/blob/master/openmrs/treatmentRegimenExtension/TreatmentRegimenExtension.groovy)

This file should copied into config under the /openmrs/treatmentRegimenExtension/ package.

Highest Observation Value

This is another example of a groovy extension that can be added to Obs to Obs Flowsheet Control. 

Use Case

Display highest value in the Obs to Obs FlowSheet Control. Assume the observation values are captured as text or strings (usually configured as answers for coded concept). So the order of values to identify the highest value is specified in the groovy file itself. In the below example, values are mentioned in descending order. In this case, the Obs To Obs Flowsheet control will display only the highest value among all the captured observation values for a concept. 

List<String> cultureResultObsValueInDescendingOrder = Arrays.asList("Positive for M. tuberculosis", "Negative for M. tuberculosis", "Contaminated",
                "Only positive for other mycobacterium", "Other")

List<String> cultureResultObsValueInDescendingOrder = Arrays.asList("Positive for M. tuberculosis", "Negative for M. tuberculosis", "Contaminated",
                "Only positive for other mycobacterium", "Other")
  
ArrayList<BahmniObservation> cultureResultObs = pivotRow.getColumns().get("Bacteriology, Culture results");
if(cultureResultObs != null && cultureResultObs.size() > 1) {
                Collections.sort(cultureResultObs, new obsValueComparator(cultureResultObsValueInDescendingOrder));
                pivotRow.getColumns().remove("Bacteriology, Culture results");
                pivotRow.addColumn("Bacteriology, Culture results", cultureResultObs.get(0));
}

Key Field Table