@openmrs/esm-dispensing-app 1.0.1-pre.218 → 1.0.1-pre.220

package/README.md

@@ -5,6 +5,30 @@
 This repository is for the OpenMRS Dispensing App. For more information, please see the
 [Design Documentation](https://wiki.openmrs.org/display/projects/Dispensing+Design+Components).
 
+## Required Configuration
+
+The Dispensing ESM requires the "HL7-MedicationDispenseStatus" concept source and FHIR concept source, as well as "Medication Dispense Status" value/concept set, to be installed in your OpenMRS instance to properly map dispensing statuses.
+
+References to the Iniz files that install these concept sources can be found here:
+
+https://github.com/openmrs/openmrs-distro-referenceapplication/blob/main/distro/configuration/conceptsources/conceptsources-core_data.csv#L24
+
+https://openmrs.slack.com/archives/C02P790SM7X/p1692380047339679?thread_ts=1692338258.965499&cid=C02P790SM7X
+
+The Medication Dispense Status value set can be found here:
+
+https://app.openconceptlab.org/#/search/?q=medication+dispense+status
+
+It also is bundled in the "DrugDispense" OCL package provided by the Reference Application:
+
+https://github.com/openmrs/openmrs-distro-referenceapplication/tree/main/distro/configuration/ocl
+
+The "DrugDispense" also provides the default value sets for the "Substitution Type", "Substitution Reason", and "Medication Dispense Status Reason".
+
+The "Substitution Type" and "Substitution Reason" value sets define the valid answers for both the equivalent questions when substituting a drug.  The "Medication Dispense Status Reason" provides the default answers for both the "Reason for Pause" and "Reason for Close" questions.
+
+All of these can be customized via the config-schema, see: https://github.com/openmrs/openmrs-esm-dispensing-app/blob/main/src/config-schema.ts
+
 ## Required privileges
 
 Note that following privileges need to be installed and assigned to roles:

package/dist/153.js

@@ -1 +1 @@
-(globalThis.webpackChunk_openmrs_esm_dispensing_app=globalThis.webpackChunk_openmrs_esm_dispensing_app||[]).push([[153],{9153:(e,t,n)=>{"use strict";n.r(t),n.d(t,{dispensing:()=>l,dispensingDashboard:()=>u,dispensingLink:()=>p,importTranslation:()=>a,startupApp:()=>d});var i=n(1132),o={appName:{_type:i.Type.String,_default:"Pharmacy"},actionButtons:{pauseButton:{enabled:{_type:i.Type.Boolean,_description:"Enabled/Disable including a Pause button in the button action bar",_default:!0}},closeButton:{enabled:{_type:i.Type.Boolean,_description:"Enabled/Disable including a Close button in the button action bar",_default:!0}}},dispenseBehavior:{allowModifyingPrescription:{_type:i.Type.Boolean,_description:"Enable/Disable editing the prescription. If Disabled, Quantity will be he only editable field on prescription form",_default:!1},restrictTotalQuantityDispensed:{_type:i.Type.Boolean,_description:"Enable/Disable restricting dispensing quantity greater than total quantity ordered. Marks prescription as complete when total quantity dispensed. If true, allowModifyingPrescription *must* be false, as this functionality relies solely on numeric quantity and assumes no change in formulation, dosage, unit, etc",_default:!1}},medicationRequestExpirationPeriodInDays:{_type:i.Type.Number,_description:"Medication Requests older that this will be considered expired",_default:90},locationBehavior:{locationColumn:{enabled:{_type:i.Type.Boolean,_description:"Enabled/Disable including a Location column in the main prescriptions table showing ordering location",_default:!1}},locationFilter:{enabled:{_type:i.Type.Boolean,_description:"Enable/Disable Location filter on main prescriptions page",_default:!1},tag:{_type:i.Type.String,_description:"Name of the location tag to use when fetching locations to populate filter",_default:"Login Location"}}},valueSets:{reasonForPause:{uuid:{_type:i.Type.UUID,_description:"UUID for the Value Set of valid answers to the 'Reason for Pause' question.",_default:""}},reasonForClose:{uuid:{_type:i.Type.UUID,_description:"UUID for the Value Set of valid answers to the 'Reason for Close' question.",_default:""}},substitutionReason:{uuid:{_type:i.Type.UUID,_description:"UUID for the Value Set of valid answers to the 'Reason for Substitution' question. Sample CIEL concept: https://app.openconceptlab.org/#/orgs/CIEL/sources/CIEL/concepts/167862/",_default:""}},substitutionType:{uuid:{_type:i.Type.UUID,_description:"UUID for the Value Set of valid answers to the 'Type of Substitution' question. Sample CIEL concept: https://app.openconceptlab.org/#/orgs/CIEL/sources/CIEL/concepts/167859/",_default:""}}}},a=n(3979),s="@openmrs/esm-dispensing-app",r={featureName:"dispensing",moduleName:s},l=(0,i.getAsyncLifecycle)((function(){return Promise.all([n.e(672),n.e(49)]).then(n.bind(n,1049))}),r),p=(0,i.getAsyncLifecycle)((function(){return Promise.all([n.e(672),n.e(397),n.e(641)]).then(n.bind(n,9641))}),r),u=(0,i.getAsyncLifecycle)((function(){return Promise.all([n.e(361),n.e(672),n.e(397),n.e(771)]).then(n.bind(n,2291))}),r);function d(){(0,i.defineConfigSchema)(s,o)}},3979:(e,t,n)=>{var i={"./en.json":[3574,574],"./fr.json":[2757,757]};function o(e){if(!n.o(i,e))return Promise.resolve().then((()=>{var t=new Error("Cannot find module '"+e+"'");throw t.code="MODULE_NOT_FOUND",t}));var t=i[e],o=t[0];return n.e(t[1]).then((()=>n(o)))}o.keys=()=>Object.keys(i),o.id=3979,e.exports=o}}]);
+(globalThis.webpackChunk_openmrs_esm_dispensing_app=globalThis.webpackChunk_openmrs_esm_dispensing_app||[]).push([[153],{9153:(e,t,n)=>{"use strict";n.r(t),n.d(t,{dispensing:()=>l,dispensingDashboard:()=>u,dispensingLink:()=>p,importTranslation:()=>a,startupApp:()=>c});var o=n(1132),i={appName:{_type:o.Type.String,_default:"Pharmacy"},actionButtons:{pauseButton:{enabled:{_type:o.Type.Boolean,_description:"Enabled/Disable including a Pause button in the button action bar",_default:!0}},closeButton:{enabled:{_type:o.Type.Boolean,_description:"Enabled/Disable including a Close button in the button action bar",_default:!0}}},dispenseBehavior:{allowModifyingPrescription:{_type:o.Type.Boolean,_description:"Enable/Disable editing the prescription. If Disabled, Quantity will be he only editable field on prescription form",_default:!1},restrictTotalQuantityDispensed:{_type:o.Type.Boolean,_description:"Enable/Disable restricting dispensing quantity greater than total quantity ordered. Marks prescription as complete when total quantity dispensed. If true, allowModifyingPrescription *must* be false, as this functionality relies solely on numeric quantity and assumes no change in formulation, dosage, unit, etc",_default:!0}},medicationRequestExpirationPeriodInDays:{_type:o.Type.Number,_description:"Medication Requests older that this will be considered expired",_default:90},locationBehavior:{locationColumn:{enabled:{_type:o.Type.Boolean,_description:"Enabled/Disable including a Location column in the main prescriptions table showing ordering location",_default:!1}},locationFilter:{enabled:{_type:o.Type.Boolean,_description:"Enable/Disable Location filter on main prescriptions page",_default:!1},tag:{_type:o.Type.String,_description:"Name of the location tag to use when fetching locations to populate filter",_default:"Login Location"}}},valueSets:{reasonForPause:{uuid:{_type:o.Type.UUID,_description:"UUID for the Value Set of valid answers to the 'Reason for Pause' question. Defaults to CIEL value set: https://app.openconceptlab.org/#/orgs/CIEL/sources/CIEL/concepts/168099/",_default:"2462a9d7-61fb-4bf5-9359-aedecb8d03cb"}},reasonForClose:{uuid:{_type:o.Type.UUID,_description:"UUID for the Value Set of valid answers to the 'Reason for Close' question. Defaults to CIEL value set: https://app.openconceptlab.org/#/orgs/CIEL/sources/CIEL/concepts/168099/",_default:"2462a9d7-61fb-4bf5-9359-aedecb8d03cb"}},substitutionReason:{uuid:{_type:o.Type.UUID,_description:"UUID for the Value Set of valid answers to the 'Reason for Substitution' question. Defaults to CIEL value set: https://app.openconceptlab.org/#/orgs/CIEL/sources/CIEL/concepts/167862/",_default:"2de6e1be-f2dd-4ba0-9516-8a611aa2af9b"}},substitutionType:{uuid:{_type:o.Type.UUID,_description:"UUID for the Value Set of valid answers to the 'Type of Substitution' question. Defaults to CIEL value set: https://app.openconceptlab.org/#/orgs/CIEL/sources/CIEL/concepts/167859/",_default:"b9c5bca0-d026-4245-a4d2-e4c0a8999082"}}}},a=n(3979),s="@openmrs/esm-dispensing-app",r={featureName:"dispensing",moduleName:s},l=(0,o.getAsyncLifecycle)((function(){return Promise.all([n.e(672),n.e(49)]).then(n.bind(n,1049))}),r),p=(0,o.getAsyncLifecycle)((function(){return Promise.all([n.e(672),n.e(397),n.e(641)]).then(n.bind(n,9641))}),r),u=(0,o.getAsyncLifecycle)((function(){return Promise.all([n.e(361),n.e(672),n.e(397),n.e(771)]).then(n.bind(n,2291))}),r);function c(){(0,o.defineConfigSchema)(s,i)}},3979:(e,t,n)=>{var o={"./en.json":[3574,574],"./fr.json":[2757,757]};function i(e){if(!n.o(o,e))return Promise.resolve().then((()=>{var t=new Error("Cannot find module '"+e+"'");throw t.code="MODULE_NOT_FOUND",t}));var t=o[e],i=t[0];return n.e(t[1]).then((()=>n(i)))}i.keys=()=>Object.keys(o),i.id=3979,e.exports=i}}]);

package/dist/153.js.map

@@ -1 +1 @@
-{"version":3,"file":"153.js","mappings":"4RAsBaA,EAAe,CAC1BC,QAAS,CACPC,MAAOC,EAAAA,KAAKC,OACZC,SAAU,YAEZC,cAAe,CACbC,YAAa,CACXC,QAAS,CACPN,MAAOC,EAAAA,KAAKM,QACZC,aACE,oEACFL,UAAU,IAGdM,YAAa,CACXH,QAAS,CACPN,MAAOC,EAAAA,KAAKM,QACZC,aACE,oEACFL,UAAU,KAIhBO,iBAAkB,CAChBC,2BAA4B,CAC1BX,MAAOC,EAAAA,KAAKM,QACZC,aACE,qHACFL,UAAU,GAEZS,+BAAgC,CAC9BZ,MAAOC,EAAAA,KAAKM,QACZC,aACE,yTACFL,UAAU,IAGdU,wCAAyC,CACvCb,MAAOC,EAAAA,KAAKa,OACZN,aACE,iEACFL,SAAU,IAEZY,iBAAkB,CAChBC,eAAgB,CACdV,QAAS,CACPN,MAAOC,EAAAA,KAAKM,QACZC,aACE,wGACFL,UAAU,IAGdc,eAAgB,CACdX,QAAS,CACPN,MAAOC,EAAAA,KAAKM,QACZC,aACE,4DACFL,UAAU,GAEZe,IAAK,CACHlB,MAAOC,EAAAA,KAAKC,OACZM,aACE,6EACFL,SAAU,oBAIhBgB,UAAW,CACTC,eAAgB,CACdC,KAAM,CACJrB,MAAOC,EAAAA,KAAKqB,KACZd,aACE,8EACFL,SAAU,KAGdoB,eAAgB,CACdF,KAAM,CACJrB,MAAOC,EAAAA,KAAKqB,KACZd,aACE,8EACFL,SAAU,KAGdqB,mBAAoB,CAClBH,KAAM,CACJrB,MAAOC,EAAAA,KAAKqB,KACZd,aACE,mLACFL,SAAU,KAGdsB,iBAAkB,CAChBJ,KAAM,CACJrB,MAAOC,EAAAA,KAAKqB,KACZd,aACE,gLACFL,SAAU,OCpHLuB,EAAoBC,EAAAA,MAO3BC,EAAa,8BAEbC,EAAU,CACdC,YAAa,aACbF,WAAAA,GAGWG,GAAaC,EAAAA,EAAAA,oBACxB,W,OAAM,oD,GACNH,GAGWI,GAAiBD,EAAAA,EAAAA,oBAC5B,W,OAAM,8D,GACNH,GAGWK,GAAsBF,EAAAA,EAAAA,oBACjC,W,OAAM,uE,GACNH,GAGK,SAASM,KACdC,EAAAA,EAAAA,oBAAmBR,EAAY9B,EACjC,C,iBClCA,IAAIuC,EAAM,CACT,YAAa,CACZ,KACA,KAED,YAAa,CACZ,KACA,MAGF,SAASC,EAAoBC,GAC5B,IAAIC,EAAoBC,EAAEJ,EAAKE,GAC9B,OAAOG,QAAQC,UAAUC,MAAK,KAC7B,IAAIC,EAAI,IAAIC,MAAM,uBAAyBP,EAAM,KAEjD,MADAM,EAAEE,KAAO,mBACHF,CAAC,IAIT,IAAIG,EAAMX,EAAIE,GAAMU,EAAKD,EAAI,GAC7B,OAAOR,EAAoBK,EAAEG,EAAI,IAAIJ,MAAK,IAClCJ,EAAoBS,IAE7B,CACAX,EAAoBY,KAAO,IAAOC,OAAOD,KAAKb,GAC9CC,EAAoBW,GAAK,KACzBG,EAAOC,QAAUf,C","sources":["webpack://@openmrs/esm-dispensing-app/./src/config-schema.ts","webpack://@openmrs/esm-dispensing-app/./src/index.ts","webpack://@openmrs/esm-dispensing-app/./translations/ lazy nonrecursive .json$"],"names":["configSchema","appName","_type","Type","String","_default","actionButtons","pauseButton","enabled","Boolean","_description","closeButton","dispenseBehavior","allowModifyingPrescription","restrictTotalQuantityDispensed","medicationRequestExpirationPeriodInDays","Number","locationBehavior","locationColumn","locationFilter","tag","valueSets","reasonForPause","uuid","UUID","reasonForClose","substitutionReason","substitutionType","importTranslation","require","moduleName","options","featureName","dispensing","getAsyncLifecycle","dispensingLink","dispensingDashboard","startupApp","defineConfigSchema","map","webpackAsyncContext","req","__webpack_require__","o","Promise","resolve","then","e","Error","code","ids","id","keys","Object","module","exports"],"sourceRoot":""}
+{"version":3,"file":"153.js","mappings":"4RAsBaA,EAAe,CAC1BC,QAAS,CACPC,MAAOC,EAAAA,KAAKC,OACZC,SAAU,YAEZC,cAAe,CACbC,YAAa,CACXC,QAAS,CACPN,MAAOC,EAAAA,KAAKM,QACZC,aACE,oEACFL,UAAU,IAGdM,YAAa,CACXH,QAAS,CACPN,MAAOC,EAAAA,KAAKM,QACZC,aACE,oEACFL,UAAU,KAIhBO,iBAAkB,CAChBC,2BAA4B,CAC1BX,MAAOC,EAAAA,KAAKM,QACZC,aACE,qHACFL,UAAU,GAEZS,+BAAgC,CAC9BZ,MAAOC,EAAAA,KAAKM,QACZC,aACE,yTACFL,UAAU,IAGdU,wCAAyC,CACvCb,MAAOC,EAAAA,KAAKa,OACZN,aACE,iEACFL,SAAU,IAEZY,iBAAkB,CAChBC,eAAgB,CACdV,QAAS,CACPN,MAAOC,EAAAA,KAAKM,QACZC,aACE,wGACFL,UAAU,IAGdc,eAAgB,CACdX,QAAS,CACPN,MAAOC,EAAAA,KAAKM,QACZC,aACE,4DACFL,UAAU,GAEZe,IAAK,CACHlB,MAAOC,EAAAA,KAAKC,OACZM,aACE,6EACFL,SAAU,oBAIhBgB,UAAW,CACTC,eAAgB,CACdC,KAAM,CACJrB,MAAOC,EAAAA,KAAKqB,KACZd,aACE,mLACFL,SAAU,yCAGdoB,eAAgB,CACdF,KAAM,CACJrB,MAAOC,EAAAA,KAAKqB,KACZd,aACE,mLACFL,SAAU,yCAGdqB,mBAAoB,CAClBH,KAAM,CACJrB,MAAOC,EAAAA,KAAKqB,KACZd,aACE,0LACFL,SAAU,yCAGdsB,iBAAkB,CAChBJ,KAAM,CACJrB,MAAOC,EAAAA,KAAKqB,KACZd,aACE,uLACFL,SAAU,2CCpHLuB,EAAoBC,EAAAA,MAO3BC,EAAa,8BAEbC,EAAU,CACdC,YAAa,aACbF,WAAAA,GAGWG,GAAaC,EAAAA,EAAAA,oBACxB,W,OAAM,oD,GACNH,GAGWI,GAAiBD,EAAAA,EAAAA,oBAC5B,W,OAAM,8D,GACNH,GAGWK,GAAsBF,EAAAA,EAAAA,oBACjC,W,OAAM,uE,GACNH,GAGK,SAASM,KACdC,EAAAA,EAAAA,oBAAmBR,EAAY9B,EACjC,C,iBClCA,IAAIuC,EAAM,CACT,YAAa,CACZ,KACA,KAED,YAAa,CACZ,KACA,MAGF,SAASC,EAAoBC,GAC5B,IAAIC,EAAoBC,EAAEJ,EAAKE,GAC9B,OAAOG,QAAQC,UAAUC,MAAK,KAC7B,IAAIC,EAAI,IAAIC,MAAM,uBAAyBP,EAAM,KAEjD,MADAM,EAAEE,KAAO,mBACHF,CAAC,IAIT,IAAIG,EAAMX,EAAIE,GAAMU,EAAKD,EAAI,GAC7B,OAAOR,EAAoBK,EAAEG,EAAI,IAAIJ,MAAK,IAClCJ,EAAoBS,IAE7B,CACAX,EAAoBY,KAAO,IAAOC,OAAOD,KAAKb,GAC9CC,EAAoBW,GAAK,KACzBG,EAAOC,QAAUf,C","sources":["webpack://@openmrs/esm-dispensing-app/./src/config-schema.ts","webpack://@openmrs/esm-dispensing-app/./src/index.ts","webpack://@openmrs/esm-dispensing-app/./translations/ lazy nonrecursive .json$"],"names":["configSchema","appName","_type","Type","String","_default","actionButtons","pauseButton","enabled","Boolean","_description","closeButton","dispenseBehavior","allowModifyingPrescription","restrictTotalQuantityDispensed","medicationRequestExpirationPeriodInDays","Number","locationBehavior","locationColumn","locationFilter","tag","valueSets","reasonForPause","uuid","UUID","reasonForClose","substitutionReason","substitutionType","importTranslation","require","moduleName","options","featureName","dispensing","getAsyncLifecycle","dispensingLink","dispensingDashboard","startupApp","defineConfigSchema","map","webpackAsyncContext","req","__webpack_require__","o","Promise","resolve","then","e","Error","code","ids","id","keys","Object","module","exports"],"sourceRoot":""}

package/dist/openmrs-esm-dispensing-app.js.buildmanifest.json

@@ -29,10 +29,10 @@
       "initial": false,
       "entry": false,
       "recorded": false,
-      "size": 5375,
+      "size": 5734,
       "sizes": {
         "consume-shared": 42,
-        "javascript": 5333
+        "javascript": 5692
       },
       "names": [],
       "idHints": [],
@@ -45,7 +45,7 @@
       "auxiliaryFiles": [
         "153.js.map"
       ],
-      "hash": "3c5fb939e21e3c84",
+      "hash": "52bf5e83e0d985d7",
       "childrenByOrder": {}
     },
     {
@@ -53,10 +53,10 @@
       "initial": true,
       "entry": true,
       "recorded": false,
-      "size": 25897,
+      "size": 26256,
       "sizes": {
         "consume-shared": 42,
-        "javascript": 5333,
+        "javascript": 5692,
         "share-init": 210,
         "runtime": 20312
       },
@@ -73,7 +73,7 @@
       "auxiliaryFiles": [
         "main.js.map"
       ],
-      "hash": "fe2c95d2a8cd2cf9",
+      "hash": "ca9bfe542a581621",
       "childrenByOrder": {}
     },
     {

package/dist/routes.json

@@ -1 +1 @@
-{"backendDependencies":{"fhir2":"^1.2.0","webservices.rest":"^2.2.0"},"pages":[{"component":"dispensing","route":"dispensing","online":true,"offline":true}],"extensions":[{"name":"dispensing-link","slot":"app-menu-slot","component":"dispensingLink","online":true,"offline":true},{"name":"dispensing-dashboard","slot":"dispensing-dashboard-slot","component":"dispensingDashboard","online":true,"offline":true}],"version":"1.0.1-pre.218"}
+{"backendDependencies":{"fhir2":"^1.2.0","webservices.rest":"^2.2.0"},"pages":[{"component":"dispensing","route":"dispensing","online":true,"offline":true}],"extensions":[{"name":"dispensing-link","slot":"app-menu-slot","component":"dispensingLink","online":true,"offline":true},{"name":"dispensing-dashboard","slot":"dispensing-dashboard-slot","component":"dispensingDashboard","online":true,"offline":true}],"version":"1.0.1-pre.220"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openmrs/esm-dispensing-app",
-  "version": "1.0.1-pre.218",
+  "version": "1.0.1-pre.220",
   "license": "MPL-2.0",
   "description": "Medication dispensing application",
   "browser": "dist/openmrs-esm-dispensing-app.js",

package/src/config-schema.ts

@@ -54,7 +54,7 @@ export const configSchema = {
       _type: Type.Boolean,
       _description:
         "Enable/Disable restricting dispensing quantity greater than total quantity ordered. Marks prescription as complete when total quantity dispensed. If true, allowModifyingPrescription *must* be false, as this functionality relies solely on numeric quantity and assumes no change in formulation, dosage, unit, etc",
-      _default: false,
+      _default: true,
     },
   },
   medicationRequestExpirationPeriodInDays: {
@@ -92,32 +92,32 @@ export const configSchema = {
       uuid: {
         _type: Type.UUID,
         _description:
-          "UUID for the Value Set of valid answers to the 'Reason for Pause' question.",
-        _default: "",
+          "UUID for the Value Set of valid answers to the 'Reason for Pause' question. Defaults to CIEL value set: https://app.openconceptlab.org/#/orgs/CIEL/sources/CIEL/concepts/168099/",
+        _default: "2462a9d7-61fb-4bf5-9359-aedecb8d03cb",
       },
     },
     reasonForClose: {
       uuid: {
         _type: Type.UUID,
         _description:
-          "UUID for the Value Set of valid answers to the 'Reason for Close' question.",
-        _default: "",
+          "UUID for the Value Set of valid answers to the 'Reason for Close' question. Defaults to CIEL value set: https://app.openconceptlab.org/#/orgs/CIEL/sources/CIEL/concepts/168099/",
+        _default: "2462a9d7-61fb-4bf5-9359-aedecb8d03cb",
       },
     },
     substitutionReason: {
       uuid: {
         _type: Type.UUID,
         _description:
-          "UUID for the Value Set of valid answers to the 'Reason for Substitution' question. Sample CIEL concept: https://app.openconceptlab.org/#/orgs/CIEL/sources/CIEL/concepts/167862/",
-        _default: "",
+          "UUID for the Value Set of valid answers to the 'Reason for Substitution' question. Defaults to CIEL value set: https://app.openconceptlab.org/#/orgs/CIEL/sources/CIEL/concepts/167862/",
+        _default: "2de6e1be-f2dd-4ba0-9516-8a611aa2af9b",
       },
     },
     substitutionType: {
       uuid: {
         _type: Type.UUID,
         _description:
-          "UUID for the Value Set of valid answers to the 'Type of Substitution' question. Sample CIEL concept: https://app.openconceptlab.org/#/orgs/CIEL/sources/CIEL/concepts/167859/",
-        _default: "",
+          "UUID for the Value Set of valid answers to the 'Type of Substitution' question. Defaults to CIEL value set: https://app.openconceptlab.org/#/orgs/CIEL/sources/CIEL/concepts/167859/",
+        _default: "b9c5bca0-d026-4245-a4d2-e4c0a8999082",
       },
     },
   },