MitDesk docs
Using MitDesk

Dashboards

3 min read Odoo 20.0

Dashboards are boards of numbers, charts and lists about your business. Every number is read with the rights of the person who looks at it.

Who this is for: users who build or read dashboards.

You need: Edition: Pro and above (minddesk_dashboard). See Editions.

Open MitDesk ▸ Dashboards. The page lists your boards and the boards shared with you.

The Dashboards home: start from a question, your dashboards, and buttons to describe, use a template, start empty or import

Start a board

Button What it does
Start from a question Builds a board from a starter question.
Describe a dashboard You write a sentence. MitDesk builds the board.
From a template Copies a ready-made board.
Empty board Starts with no widgets.
Import Loads a board from a .json file.

Each board card has a menu to rename or delete it, to change who can see it, and to Pin to cockpit.

Work in a board

A dashboard with widgets, period buttons, Compare with previous and Ask AI to change this board

  • Add widget opens a gallery of ready-made widgets, grouped by app: Sales, CRM, Invoicing, Purchasing, Inventory, Projects, Activities, Contacts and MitDesk. Twenty widgets come with the product. You see only the widgets whose data you may read. You can also build a widget yourself.
  • The period buttons are All time, This month, This quarter, This year and Last 30 days. They filter on the creation date. Other filters let you narrow one model.
  • Compare with previous shows the change against the previous period.
  • Click a bar or a row in a chart or list to open those records in Odoo.

A board can have up to 50 widgets. Each widget shows up to 500 rows. If a widget is cut, the board tells you. If one widget fails, the others still work.

Describe a board with AI

Write what you want, for example "Open opportunities by stage, and what we invoiced this month". You can use up to 2,000 characters. You can have up to 100 boards.

Inside a board, Ask AI to change this board works in the same way for changes. The text is sent as a normal MitDesk request (dashboard_compose for a new board, dashboard_edit for a change). It goes through the consent engine and the audit trail. The result is one of four: it ran, it needs approval (see Decisions), it was denied, or it failed.

The AI can only use data models you may read, and MitDesk checks everything it proposes with your rights again.

The AI co-author needs a licence that includes it. Without it the request is refused with a clear message. Boards you already built keep working, and you can still build boards by hand.

What a widget can say

Text Meaning
A number or chart A real value.
No data The query found nothing, or the app is not installed.
No access Odoo access rules or a MitDesk rule refused the read. A lock shows. It never shows zero for a refusal.
Unavailable The widget failed to load, or the comparison could not be made.

Everyone sees their own numbers

A board saves the shape of a question, not the numbers. Each widget runs when you open the board, with your rights. So a shared board shows each person their own numbers.

Sharing

A board is Private by default. Choose Share with Odoo groups to give selected groups read-only access to the board. You can pick up to 50 groups. Only the owner can change sharing. The numbers are still read for each viewer.

One exception: a snapshot (a picture of the board) reads the data as the board's run as user, not as the viewer. Only the owner gets a snapshot. People with team access always get the live board with their own rights.

Pin to the cockpit

Use Pin to cockpit on a board. It then appears as a block in your cockpit and in its Dashboards view. You can pin several boards. If a board is unshared or deleted later, the block says it can no longer be opened.

Export and import

An export has the name, the widgets and the layout. It has no owner, no run-as user, no sharing. An import sets these from the person who imports.

If it does not work

If a tile says denied instead of a number, see Troubleshooting.