19.02. Setting up Cold Chain App Notifications

This functionality is only available in v5.1 and above.

If you have the mSupply ColdChain app, you can set mSupply desktop up to show notifications from the app, so you can keep an eye on your cool stores while sitting at your desk. mSupply will show a temperature log for each sensor, alert you to any hot or cold breaches, and allow you to change the location of a sensor.

Setting up

1. Turn on the Alternate Server

mSupply uses the Alternate Server to receive data from the ColdChain app. To turn this on, go to the Preferences window and navigate to the Alternate Server tab.

Server parameter Description
Log level 0: No logging, 1: Log only 500 responses, 2: Log all responses, 3: Log all responses and requests.

These server parameters must be set up before turning on the alternate server (contact mSupply Support if you need help setting this up!) Once the server is turned on, the parameters cannot be edited.

If you would like this server to start up every time mSupply is started, turn on the preference “Start web server on this computer when mSupply starts”.

2. Set up user credentials

To match up a mSupply desktop store with the ColdChain app tablet, we need to set up a store credential. In the Special tab, navigate to Stores, and select the store in which the tablet is used. You must be logged into the store that you want to edit before you can set up credentials.

Check “Use store credentials” to start setting up a store, and enter a username and password. The username will be set to the first three letters of the store's code by default. The password must be at least 3 symbols but not more than 30 symbols, and can contain letters and numbers. You can click the “Show password” button (next to password field) will show the password). These credentials will be saved after clicking “OK” in the “Edit store” window.

Unchecking the checkbox “Use store credentials” deletes the store credentials. Please be careful before deleting store credentials.

Viewing sensors and assigning locations

To see all sensors used in the system, go to Items > Vaccines > Sensors in the menu bar. This will show a list of each sensor and whether it is active in the system.

Double click the sensor name to view sensor details. If the sensor is located in the store you are logged in to, you can change the active state of the sensor and assign a new location to a sensor. If the sensor is located in a different store, the following details will be read-only.

To assign a location to a sensor click “Set Location” button. This will open a new window with a list of available locations that have no sensors assigned.

Please be careful when assigning a location as all the temperature logs for that sensor will be moved to this location. This is non-reversible!

Viewing sensor temperature logs

The temperature log window (accessed through the menu bar Item > Vaccines > Temperature logs…)shows all temperature logs for all sensors in the system/

Any breaches associated with the temperature logs they will be shown in the last columnm, with the text showing “Hot Consecutive” or “Cold consecutive” depending on the type of breach. For logs where there was no breach, this column will be left empty.

You can filter the logs by date in the top right section, and filter by location in the top left. To change the location you are viewing, follow the usual rules of location input windows - put cursor in the location input window, enter “@” and click “tab”. This will open a window showing all the available locations that have a sensor assigned.

Viewing breach notifications

Once the ColdChain app is set up with mSupply desktop, you will start receiving notifications about any unacknowledged temperature breaches. This window will open automatically on startup or when mSupply receives data from the tablet, and show up to the right of your mSupply Desktop app.

You can close each notification by clicking the close button to remove each notification individually, or you can close the entire window. This is only a notification, so closing it will not change the breach's state to acknowledged - you can only acknowledge breaches in the ColdChain app itself.

The notification window will show the sensor's location and name, the date, time, and duration of the breach, and whether it was a cold or hot consecutive breach by displaying the “Lowest” or “Highest” temperature respectively.



  • Last modified: 2021/04/12 14:18
  • by Gary Willetts