Test: Cold Chain - msupply-foundation/open-msupply GitHub Wiki
- To begin, enable the store preference for mobile: Uses Vaccine Module (see the store preferences documentation for how to do this).
- In the Vaccines section turn on
view sensor detailsandedit sensor location - The user should be default user to the store in which the temperature data will be saved
- The user must have the omSupply permission of
Cold chain API access - The default store assigned to the user should be the store which the temperature data will be associated with
- The store should be the part of the site that Open mSupply is synchronising with (The omSupply should include the correct store )
- After the setup the Open mSupply store should be ready to get all the information of Cold chain application if connection is made from the CCA app
- When clicking on the 'Chart' tab, you should see a graph with a summary of temperature logs from all the sensors you have connected.
- The chart can be interacted with, e.g. if you click on any area of a graph, you should see a tooltip pop up with the information at that point of time. The tooltip will include date, time, sensor name and the temperature.
- If there is an ongoing breach, you will see a red triangle mark with an exclamation sign, which you can tap on -> a tooltip will pop up with the information about the breach. You should be able to see the sensor name, type of breach, location, start and end (if ended), and a button 'View all breaches' which you can click on. When clicked on, it will take you to another window where all the breaches will be shown.
- In the top left corner, you should be able to filter the data display by Sensor name, Location, and Breach type. Sensor name and Location are search boxes, whereas Breach type is a dropdown -> all filter fields should work as expected.
- Date & Time picker should work as expected, you should be able to select Months, Years and Days as well as time in the second tab.
- When clicking on the 'Breaches' tab, you should see a list of all breaches, acknowledged and unacknowledged.
- Click on the arrow next to Breach start -> the breaches should be sorted from most recent to the oldest and vice versa.
- Click on the arrow next to Breach end -> the breaches should be sorted from most recent to the oldest and vice versa. Note: if the breach is ongoing, the breach end will be blank :)
- Next to the status, you will see either a red circle with an exclamation mark (that means the breach is unacknowledged), or a speech bubble icon (which means the breach has been acknowledged).
- Clicking on a red circle when the breach is ongoing should show the following message:
this breach is ongoing and cannot be acknowledged until it has ended. - Clicking on a red circle when the breach has ended should allow you to input a comment and click 'Ok' to acknowledge the breach.
- Clicking on a speech bubble icon should show a small tooltip, displaying you have acknowledged the breach and the comment you left.
- Clicking on a red circle when the breach is ongoing should show the following message:
- Show/hide columns should work as expected - removing/adding the columns depending on what you tick.
- In the top left corner, you should be able to filter the data display by Sensor name, Location, Date/Rime Range and Breach type. Sensor name and Location are search boxes, whereas Breach type is a dropdown -> all filter fields should work as expected. Date & Time picker should work as expected, you should be able to select Months, Years and Days as well as time in the second tab.
- Next to the filters, you can see a toggle option between 'Acknowledged' and 'Unacknowledged' breaches - toggling it will show you different entries.
- Rows per page in the bottom right corner should be clickable - e.g. click between different options of how to display records per page. You should be able to change between pages as well.
- Check the functionality of a breach notification - if there is an ongoing/unacknowledged breach, red notification should appear at the top of the screen, notifying user there has been a breach. If you are located under
Cold chain -> Monitoring, then you will just see a notification bar; if you are located anywhere else in Open mSupply, there will be a button 'View Details' which you can click and it will bring you to the exact breach. The breach notification should also show the total number of unacknowledged breaches -> check the number shown and the actual number match.
- When clicking on the 'Log' tab, you should see a list of all logs for all sensors you have connected to the store.
- Click on the arrow next to Date time -> the logs should be sorted from most recent to the oldest and vice versa.
- Click on the arrow next to Temperature -> the logs should be sorted from coolest to warmest and vice versa.
- In the top left corner, you should be able to filter the data display by Sensor name, Location and Breach type. Sensor name and Location are search boxes, whereas Breach type is a dropdown -> all filter fields should work as expected. Date & Time picker should work as expected, you should be able to select Months, Years and Days as well as time in the second tab.
- Rows per page in the bottom right corner should be clickable - e.g. click between different options of how to display records per page. You should be able to change between pages as well.
- In the top right corner, you can click a button 'Import Fridge-tag'. You should be able to import the data from Berlinger Fridge-tags into Open mSupply.
- Insert the USB of the Fridge-tag into computer and click
Import Fridge-tagbutton. - Click on the file and wait for the import to complete.
- The temperature logs should be shown in the Open mSupply.
- It should show the correct alert for the file which is being imported if the file is empty or contains not valid entry.
- To see a list of all sensors connected to the store, navigate to "Sensors" tab on the lefthand side. You will be presented with a full list of sensors connected.
- Click on the arrow next to Name -> the sensors should be sorted alphabetically from A-Z, and vice versa.
- Click on the arrow next to Serial Number -> the numbers should be sorted alphabetically from A-Z, and vice versa. The rest of the columns should not have sorting enabled.
- When clicking on a specific sensor, a window with more detailed view appears. In that window, no details should be editable with the exception of Location, which is a dropdown menu you can select an option from. You should be able to click 'OK' to save the changes.
- Show/hide columns should work as expected - removing/adding the columns depending on what you tick.
- Rows per page in the bottom right corner should be clickable - e.g. click between different options of how to display records per page. You should be able to change between pages as well.
- To view the Equipment connected to your store, navigate to Cold chain -> Equipment - a list of all connected items will appear on the main screen. If you don't have any, don't worry - you are probably just starting!
- Click on the arrow next to Serial Number -> the numbers should appear from smallest to largest and vice versa.
- Click on the arrow next to Installation date -> the dates should appear from oldest to most recent, and vice versa.
- At the top, the essential filters appear by default - Category, Type and Asset Number. Category and Type are the dropdown menus where you can select an option, and Asset Number is a search box - make sure they function as intended. Extra filters can be added, such as Non-catalogue, Installation date, Notes, Replacement date and a Serial Number.
- Pressing 'Remove all filters' clears the selections and removes the non-default filters.
- Show/hide columns should work as expected - removing/adding the columns depending on what you tick.
- In the top right corner, you can press 'New Asset' to add an entry to your store. A new window will pop-up -> you should be able to select Category & Catalogue Item from a dropdown menu, and then enter Asset Number & any notes.
- Once entered, you will see the newly added item appear on the main screen. You should be able to click into any item to see a detailed view, and fill out more details.
- Once clicked, you will see 5 areas - Asset Identification, Cold Chain, Functional Status, Properties and Additional Info under Summary.
- Category & Type should not be editable.
- Serial Number, Installation Date and Replacement Date should be editable.
- You should be able to assign Cold storage location from a pre-populated list.
- You should be able to update the Current Status by clicking the 'Update Status' button in the top right corner -> choose the new status -> choose reason to the change -> add any observations -> click OK & Next -> upload any files or click 'OK' to skip the step. You should be able to see the new status, with a date when it was last updated and reason populated. You should not be able to change those fields without updating the status.
- Energy Source & Storage Volume should not be editable.
- Additional Info section should be editable.
- Status Logs: you should see any updates to the current status displayed under this tab.
- Documents: under this tab, you should be able to download any existing documents as well as upload new ones.
- Log: Should display any updates to the asset.
- To help identify assets, you can print a QR code label for your asset. This can then be scanned to easily identify an asset in your system. You should be able to click the 'Print QR code' button and a QR code will be printed, if you have a label printer configured. To configure a label printer, refer to the Label Printing section of the administration pages. The label will show the code and serial number.
- You should also be able to press the X or Delete button to cancel the action or remove the asset permanently.
- This feature should be visible only if Open mSupply is running on the Tablet or Desktop. You will get an extra 'Scan' button on the main screen at the top of the menu bar, which you should be able to click.
- If you DO NOT have a Barcode Scanner configured, you will see a 'Scanner is not connected' message. On the tablet, you can use your camera.
- If everything is configured properly, and a match is found when you scan, you'll be taken to the detail page for that Cold chain equipment item. If not, you'll see a notification telling that no match was found.
- In the top right corner, you should click the 'Import' button. The expected behaviour is that a new window will pop up, where you are able to select a file and import it into Open mSupply. Then, you can review your file and add it to the application.
- Rows per page in the bottom right corner should be clickable - e.g. click between different options of how to display records per page. You should be able to change between pages as well.