Differences

This shows you the differences between two versions of the page.

--- en:mobile:user_guide:mobile_dashboard [2020/07/31 02:49] – [mSupply Desktop Configuration] Mark Prins
+++ en:mobile:user_guide:mobile_dashboard [2021/07/01 22:52] (current) – Mark Prins
@@ Line 3: / Line 3: @@
 ----
 ===== The Mobile Dashboard =====
-To access the Mobile Dashboard feature it will first need to be set up for your store by your management (see [[#msupply_desktop_configuration|below]] for configuration details).  Once it has been enabled you will be able to see the icon on the mSupply Mobile Menu page.
- {{  :en:mobile:user_guide:pasted:20200124-050333.png?700  }}
+<WRAP center round alert 60%>
-\\ \\
+The Mobile app dashboard is completely different to the [[en:dashboard|mSupply Grafana web dashboard]] and is configured in a different manner.
-The Mobile Dashboard feature allows you to view visualisations (graphs) of the reports available.
+</WRAP>
- {{  :en:mobile:user_guide:pasted:20200128-023834.png?700  }}
-Various reports are available for display in mobile. For example:
+<WRAP center round info 60%>
+Dashboard reports will be visible in the mSupply Mobile dashboard provided that on the mSupply central server:
+  * The **mobile: Uses dashboard module** [[https://docs.msupply.org.nz/other_stuff:virtual_stores#preferences_tab|store preference]] is turned on for the store
+  * The report has been [[https://docs.msupply.foundation/en:mobile:setup:server_side:dashboard#mobile_specific_dashboard_configuration|configured for display on mSupply Mobile stores]]
+</WRAP>
+Once it has been enabled you will be able to see the Dashboard icon on the mSupply Mobile Menu page.
+{{  :en:mobile:user_guide:20200124-050333.png  }}
-**VEN items in stock**\\
-Shows stock on hand of each items that belongs to the VEN (Vital, Essential, Necessary) category
 \\ \\
-**Items Issued This Month**\\
+The Mobile Dashboard feature allows you to view visualisation 'reports' (tables, charts, graphs, etc.).
-Shows items issued by the facility within the last 30 days
+\\
+**line chart**
+ {{  :en:mobile:user_guide:pasted:20200128-023834.png?700  }}
 \\ \\
-**Total stock value**\\
+**bar chart** \\
-A single figure in your default currency, showing the total value of the stock you have in the store you are viewing the dashboard for
+ {{  :en:mobile:user_guide:bar-chart.png?700  }}
 \\ \\
-**This month's transactions**\\
+**pie chart** \\
-Shows a bar chart of the number of purchase orders, goods receipts, supplier and customer invoices created this month
+ {{  :en:mobile:user_guide:pie-chart.png?700  }}
 \\ \\
-**Expiring stock**\\
+**table** \\
-Shows the cumulative and monthly number of all items expiring within the year, split into columns by month of expiry
+ {{  :en:mobile:user_guide:table.png?700  }}
 \\ \\
-**Top facilities supplied**\\
+Refer to the list [[https://docs.msupply.org.nz/web_interface:dashboard_setup#available_dashboard_reports|available dashboard reports]].
-The 10 customers in your store to which you have sent the greatest value of stock in the past 90 days. Shows the value of stock for each customer
 \\ \\
-**Transactions per store**\\
-Shows a table of all transactions per store within the past 7 and 30 days
-\\ \\
-**Vital items in stock**\\
-Shows a bar graph of the percentage of medicines of the chosen category in stock at each facility
-\\ \\
-**Sync sites last connection date**\\
-Shows the last connection date and current mSupply version of each sync site
-\\ \\
-**Sync sites sent and received statistics**\\
-Shows number of records sent and received by each syc site within the last day
-\\ \\
-**Trends in critical stock**\\
-Shows the historical stock on hand using parameters to filter store and/or items. Will show the current percentage, and percentages from the last day of each month for the prior six months.
-\\ \\
-**Reports Monthly Transactions**\\
-Shows how many transactions of each type the chose store has processed this month
-\\ \\
-**Stock each item in each store**\\
-Shows a table of items in rows and stores in columns, with the stock on hand for that item in that store in each cell.
-\\ \\
-**Unfinalised Stock Transfers**\\
-Table of unfinalised stock transfers (between mSupply stores) for each facility
-\\
-\\
-The list of reports can be found on the [[https://docs.msupply.org.nz/preferences:dashboard#what_the_dashboards_show_and_what_can_be_edited|mSupply documentation site]]
-\\
-==== mSupply Desktop Configuration ====
-This section describes the configuration of reports on the mSupply central server, which will need to be done in order to have dashboard reports show on mSupply Mobile. The mSupply central server generates reports on a schedule, and if configured correctly, will generate versions for mobile sites which will be synced to mobile stores tablets. Here's how!
-Dashboard reports need the following properties added to them in order for them to show in the mSupply mobile stores.
-^ Property ^ Values ^ Description ^
-| isMobile | **True** or **False** | The is the important one! Enable or disable sending this to your mobile sites |
-| mobileReportType | **table** **bar** **line** or **pie** | The display type |
-| [any property] | #[field on store table] | This is the tricky one! it allows you to replace properties with a value which is store specific. Use with care! For example, the property *store_name* can have a value of *#name*, in which case the *store_name* is replaced with the *name* of the store |
-{{:en:mobile:user_guide:pasted:20200730-031930.png?400}}
-\\
-\\
-**Note:**
-  * Existing reports can be used and the properties currently configured are used to generate the information. In this situation, the report shows in **both** the existing web dashboard //and// in mSupply mobile.
-  * The mobile dashboard data - in particular the //mobileReportType// and the store specific data - are only sent to stores which are configured as mobile stores
-\\
-\\
 |  //Previous:  **[[en:mobile:user_guide:stocktakes_program|]]** | | Next:  **[[en:mobile:user_guide:indicators|]]**//  |