cold_chain_equipment:configure_coldchain_app_on_desktop

20.03. Cold Chain App Notifications

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

If you have the mSupply ColdChain app, you can set up mSupply desktop to show notifications from the app, so you can keep an eye on your cold 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 stock location a sensor is monitoring.

mSupply uses the Alternate Server to receive data from the ColdChain app. To turn this on, go to File > Preferences and click on 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”.

The default HTTP Port number is 8081 and must be different from the prot number used by the mSupply server set on the Server tab (see the 16.01. General preferences page for details). If you inadvertantly try to set both servers to the same port, mSupply will warn you and prevent you from saving your settings.

Please note that setting either of the ports to 0 will turn off the alternate server for that protocol.

To match an mSupply desktop store to the ColdChain app on a tablet, you need to set up the store's credentials in the store settings. See the 25.08. Virtual stores page for details on doing that.

To see all sensors used in the system, choose Items > Vaccines > Sensors from the menus. This window will open, showing you a list of each sensor and whether it is active:

Double click the sensor name to view the sensor's details. This window will open:

If the sensor belongs to the store you are logged in to, you can change the active state of the sensor and assign a new location to it. If the sensor is located in a different store, all the details will be read-only.

  • Is active? checkbox: If checked the sensor's readings are recorded and usable in the system. If unchecked, the sensor is ignored and notifications will not be shown for it (unacknowledged, acknowledged, current or historical).
  • View location button: When clicked, will open a window containing the details of the location the sensor is assigned to.
  • Set location button: When clicked, will open a new window showing you all the locations in your store that do not have a sensor allocated to them already. Select one by double-clicking on it. This is not reversible so be careful!
    • When a location has been assigned the button's label will change to Unassign location. Clicking it then will remove the location from the sensor.

Choose Item > Vaccines > Temperature logs… from the menus and a window showing you the temperature logs for all locations assigned to sensors in the system will open:

The Temperature breach column will contain a description of the breach (e.g. Hot Consecutive or Cold consecutive) if the log represents a breach, otherwise the column will be empty. So an empty column is good news!

Use the filters in the top right to filter the logs by date.

Use the Location field in the top left to filter by location. Type the first few character's of the location's code and press the Tab key on the keyboard to select the location to view logs for from the list of all locations that have a sensor assigned and have a code starting with what you typed. Double-click a location to select it and the logs for the sensor attached to that location only will be displayed in the list.

Once the ColdChain app is set up with mSupply desktop as above, 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 remove a single notification by clicking on its close button or you can close the entire window. This does not change any notification's state to acknowledged - you can only acknowledge notifications (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: 2024/09/11 14:56
  • by Gary Willetts