Configure Custom Prints

Purpose and Benefits

Bahmni allows implementers to design their own Custom Display Controls. The Custom Display Control can be styled in a way to give requisite Custom Prints.  This is unlike other implementation specific Display Controls. Bahmni provides this functionality to avoid the hassle of multiple types of styling and because it is much easier to design a display control that can be used to display Custom Prints. Hence the terms Custom Display Controls and Custom prints are used interchangeably.

Steps

Consider configuring a "Birth Certificate" that is to be displayed in the Visit tab and that will be printed as a Custom Print. Similar steps can be used to configure other Custom Prints.

1) Configure "Birth certificate" as a Custom Display Control.

 "birthCertificate": {
    "title": "Birth Certificate",
    "printing": {
        "title": "Bahmni",
        "header": "Certificate",
        "logo": "../images/bahmniLogo.png"
    },
    "sections": {
        "Birth Certificate": {
            "type": "custom",
            "config": {
                "title": "Birth Certificate",
                "template": "<birth-certificate></birth-certificate>"
            }
        }
    }
}

The following configuration needs to be added in visit.json to display the custom display control in different visit tabs. Please refer to https://github.com/Bhamni/default-config/blob/master/openmrs/apps/clinical/visit.json for further information.

2) Bahmni provides the customDisplayControl module that will provide a basic connection between the application and configuration.

3) New directives can be added as per requirements in the "openmrs/apps/customDisplayControl/js/customControl.js" file. Ensure that new custom directives are created only in the existing file. Refer to https://github.com/Bhamni/default-    config/tree/master/openmrs/apps/customDisplayControl/js for further information. 

 4) New directives should be under the same module "bahmni.common.displaycontrol.custom". The scope of the new directive should have patient, visitUuid and config.

5) "birthCertificate" is added as new a directive in the following example:

'use strict';
angular.module('bahmni.common.displaycontrol.custom')
    .directive('birthCertificate', ['observationsService', 'appService', 'spinner', function (observationsService, appService, spinner) {
            var link = function ($scope) {
                var conceptNames = ["HEIGHT"];
                $scope.contentUrl = appService.configBaseUrl() + "/customDisplayControl/views/birthCertificate.html";
                spinner.forPromise(observationsService.fetch($scope.patient.uuid, conceptNames, "latest", undefined, $scope.visitUuid, undefined).then(function (response) {
                    $scope.observations = response.data;
                }));
            };
            return {
                restrict: 'E',
                template: '<ng-include src="contentUrl"/>',
                link: link
            }
    }])

In the above example, new concept names are configured in the variable conceptNames.

6) New templates can be created in the directive "openmrs/apps/customDisplayControl/views/". Refer to https://github.com/Bhamni/default-config/tree/master/openmrs/apps/customDisplayControl/views for further information.

Template birthCertificate.html is created in the following example:

<div>
 {{config.title}}
 <section class="dashboard-section">
 <ul class="form-field">
 <li ng-repeat="obsGroup in observations">
 <span class="obs-date"> {{obsGroup.conceptNameToDisplay }} </span>
 <span class="obs-date"> {{obsGroup.value}} </span>
 </li>
 </ul>
 </section>
</div>

Key Fields