Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
cold_chain_equipment:configure [2022/12/08 06:05] – [Set up vaccine vial monitor (VVM) statuses] Mark Glover | cold_chain_equipment:configure [2023/08/08 23:21] (current) – [20.01. Vaccine Vial Monitoring (VVM)] Mark Glover | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== 20.01. | + | ====== 20.01. Vaccine |
- | There are a few configuration steps needed in mSupply desktop for setting up the Vaccine module | + | |
+ | * As of August 2023, WHO has published a [[https:// | ||
- | To set up the vaccine module correctly, you need to: | + | ===== Configuration ===== |
- | * Enable the vaccine module for the mobile store, | + | There are a few configuration steps needed |
- | * Set up vaccine vial monitor | + | |
- | * Set up sensors, and | + | |
- | * Set up temperature breach configurations | + | |
- | ===== Enable the vaccine module for the mobile store ===== | + | ==== Set up vaccine vial monitor (VVM) statuses ==== |
- | First of all, in mSupply desktop login to the store you want to turn on the vaccine module for. Then, from the menus, choose //Special > Show Stores//, double-click on the store you are logged into and then click on the // | + | |
- | + | ||
- | {{ : | + | |
- | + | ||
- | Check the **mobile: Uses Vaccine module** checkbox in the //Store preference// | + | |
- | + | ||
- | + | ||
- | ===== Set up vaccine vial monitor (VVM) statuses | + | |
To configure VVM status options, you need to have permission in the system to edit vaccine vial monitoring statuses. | To configure VVM status options, you need to have permission in the system to edit vaccine vial monitoring statuses. | ||
Line 25: | Line 15: | ||
The window will show you a list of all the current vaccine vial monitor statuses that have been setup. To edit one, simply double-click on it in the list. This will open the same window as when adding a new status (see below) but populated with the status' | The window will show you a list of all the current vaccine vial monitor statuses that have been setup. To edit one, simply double-click on it in the list. This will open the same window as when adding a new status (see below) but populated with the status' | ||
- | ==== Adding a VVM status | + | === Adding a VVM status === |
Click the **New** button. This window opens: | Click the **New** button. This window opens: | ||
Line 37: | Line 27: | ||
Click on the **OK** button to save your changes or the **Cancel** button to cancel them. | Click on the **OK** button to save your changes or the **Cancel** button to cancel them. | ||
- | ==== Deleting a VVM status | + | === Deleting a VVM status === |
You can only delete a status that you have just created. Once this list of VVM statuses has been closed, you cannot delete the status any more. If there is one that you wish to delete but can't then edit it and uncheck its **Is active** checkbox (as described above). That will effectively delete it because it will no longer be selectable in any mSupply mobile functionality (but it will mean the status is still available for historical records). | You can only delete a status that you have just created. Once this list of VVM statuses has been closed, you cannot delete the status any more. If there is one that you wish to delete but can't then edit it and uncheck its **Is active** checkbox (as described above). That will effectively delete it because it will no longer be selectable in any mSupply mobile functionality (but it will mean the status is still available for historical records). | ||
Line 47: | Line 37: | ||
{{ : | {{ : | ||
- | ===== Viewing sensor details ===== | + | ==== Tell mSupply which items are vaccines |
- | Temperature sensors | + | Tell mSupply which items are vaccines |
- | First of all, you need to have permission | + | ==== Turn on preferences ==== |
- | See the [[admin:managing_users|23.15. Managing users]] page for details | + | Finally, you need to turn on some preferences so that VVM status is exposed |
+ | * The // | ||
+ | * The //Sort available batches by VVM status rather than Expiry// store preference if you want the VVM status of the stock to be included when deciding what order to offer stock for selection. See the [[other_stuff: | ||
- | To see the current sensors go to //Item > Vaccines > Sensors...// | ||
- | This window will appear: | + | ===== Using VVM status ===== |
- | {{ : | + | ==== Enter the VVM status of vaccines when they are received ==== |
+ | When the //Able to specify VVM status when receiving items// store preference is turned on (see above) you can enter the VVM status of vaccines when they are received into a store on a supplier invoice. See the [[receiving_goods: | ||
- | The window will show you a list of all the current sensors that have been set up. If there are many in the list, you can type something in the search bar and only those containing what you types will show in the list. To view the details of one, simply double-click on it in the list. This will open a window populated with the sensor' | ||
- | You cannot add a sensor or edit any of the sensor details. This can only be done in mSupply mobile (see the [[https:// | + | ==== Update the VVM status |
+ | When you check the status of the VVM labels | ||
- | ===== Viewing temperature breach configurations ===== | + | You can get to this window two ways: |
- | Temperature breaches occur when the temperature detected by a temperature sensor exceeds a certain value for a certain amount | + | - On the //Item// tab of the Navigator, click on the //Stock// icon then double-click on the line of stock you are interested in. |
+ | - Search for items, double click on an item to open its details window, click on the //Stock// tab to show the item's current stock and then double-clikc on the stock line you are interested | ||
- | First of all, you need to have permission in the system to configure temperature breaches. | + | Whichever way you choose, this window will open: |
- | See the [[admin:managing_users|23.15. Managing users]] page for details on how to set user permissions. You need to turn on the //View temperature breach configuration// | + | {{ :cold_chain_equipment: |
- | To see the current temperature breaches go to //Item > Vaccines > Show temperature breach configuration...// | + | Click on the Status tab: |
- | This window will appear: | + | {{ :cold_chain_equipment: |
- | {{ : | + | The table shows you the history of VVM status measurements for this stock line. |
- | The window will show you a list of all the current temperature breach configurations that have been set up. If there are many in the list, you can type something in the search bar and only those containing what you types will show in the list. To view the details of one, simply double-click on it in the list. This will open a window (see below) populated with the breach' | + | To add a new entry, click on the **New** button and this window |
- | You cannot add, edit or delete a temperature breach configuration, | + | {{ :cold_chain_equipment:pasted:20230512-103003.png?400 |}} |
- | ==== To view the details | + | * **Date:** The date of the entry. This is set to the current date and is read only - you can only enter logs on the current day. |
- | When you double-click a temperature breach configuration, this window will open, pre-populated with the configuration' | + | * **Time:** The time of the log entry. Edit as required in 24 hour format. |
+ | * **VVM status:** Select one of the active VVM statuses | ||
+ | * **Entered by:** The name of the user making the entry. Read only, set to the currently logged in user. | ||
+ | * **Comment:** Enter anything that you want to remember about this reading (who took it, how it was done, anything unusual etc.). | ||
- | {{ : | + | Click on the **OK** button to save the entry and it will be displayed in the table. If the VVM status of the stock line has changed then its current VVM status will be automatically updated to match what has been entered. |
- | * **Description: | + | If you enter a VVM status that means the stock is unusable, we recommend that you also check the **Hold** checkbox |
- | * **Minimum temperature: | + | on the //General// tab (shown above) so that the stock is not issued. |
- | | + | |
- | * **Duration hours and minutes:** The length of time the temperature must be below the minimum or above the maximum temperatures for a cumulative breach to occur. | + | |
- | * **Type:** The breach configuration type, see [[https://docs.msupply.foundation/en: | + | |
- | * **Location type:** The location type this breach belongs to. See the [[items: | + | |
- | * **Is active?:** If checked then this breach configuration will be used in cold chain monitoring. If unchecked, it won't. | + | |
- | Click on the **OK** button to close the window. | ||
+ | ==== Check the VVM status of stock when issuing ==== | ||
+ | When the //Able to specify VVM status when receiving items// store preference is turned on (see the [[https:// | ||
\\ | \\ | ||
\\ | \\ |