Skip to content
Tutorials Center
My learning

Topics

Lesson 4 of 39 ยท Getting Started

Exploring the Odoo Interface

Tour the Odoo web client as a developer: apps menu, list, form and kanban views, search filters, the chatter and how each screen maps to a model and a view.

Odoo is easier to program once you know what users see. Every screen in the web client is built from three ingredients: a menu that opens an action, which shows a model through one or more views. If you can name these ingredients while clicking around, you can find almost any piece of code later.

This lesson is a guided tour. You do not need to install anything to follow it, but if you already have a database open, try each step. The following lessons install Odoo for real.

The main screen

After you log in you see the app menu (a grid of icons) and, once inside an app, a top bar with the app's menus. Click Sales: the top bar shows Orders, To Invoice, Products and Reporting. Each entry is a menu item. A menu item either contains submenus or points to an action.

An action says: "open model sale.order, show these view types, apply this default filter". So the chain is:

flowchart LR
    M["Menu item<br/>Sales / Orders"] --> A["Action<br/>ir.actions.act_window"]
    A --> MOD["Model<br/>sale.order"]
    A --> V["Views<br/>list, form, kanban..."]

Menus, actions and views are themselves records stored in the database, defined by XML data files in modules.

View types

The same records can be displayed in several ways. The common view types are:

  • List (a table): good for scanning many rows. You can sort by clicking a header and edit some fields inline.
  • Form: one record in detail, with fields, tabs, buttons and a status bar.
  • Kanban: cards grouped in columns, for example CRM opportunities by stage. Dragging a card changes its stage field.
  • Calendar, Gantt, Map, Pivot and Graph: for dates, planning, places and reports. Gantt, Map and some others are Enterprise only; the others are in Community.
  • Search: not shown as a screen, but it defines the search bar's fields, filters and group-by options.

The buttons at the top right of the control panel switch between the available view types of the current action.

The strip above the records is the control panel. It holds the breadcrumbs, the action buttons (Create, Import) and the search bar. The search bar understands:

  • Free text: type azure and pick "Search Customer for: azure".
  • Filters: predefined conditions such as "My Orders" or "Quotations". Each is a domain (a list of conditions) stored in the search view.
  • Group by: buckets, for example by salesperson or by month.
  • Favourites: your own saved searches.

You will write domains in Python later in this course. The same syntax is behind the "Custom Filter" option, which opens a small domain editor.

The form view in detail

A typical sales order form contains:

  1. Header with buttons (Confirm, Send by Email) and a statusbar showing the record's stage.
  2. Sheet: the white card with fields in groups and tabs, such as Order Lines.
  3. Chatter (at the bottom or right): the log of messages, notes and scheduled activities for the record. It is added to a model by inheriting mail.thread.

Fields come in types you will meet again in chapter 4: text, number, date, checkbox, selection, many-to-one drop-down, and one-to-many lists such as order lines.

Developer mode

Odoo has a hidden developer mode (also called debug mode) that turns on technical features. You activate it in Settings (the "Activate the developer mode" link) or by adding ?debug=1 to the URL. It gives you:

  • a bug icon in the top bar,
  • the field tooltip with the technical name and type,
  • "Edit View", "Edit Action" and "View Metadata" in the debug menu,
  • the Technical menu under Settings, listing models, fields, views, actions and access rules.

Developer mode is a developer's microscope. When you wonder "which model and view is this?", open the debug menu and look.

A runnable stand-in: menu, action, view

To see how the pieces refer to each other, here is a tiny Python model of the chain. Menus point to actions by id, actions point to a model and view types. It is a teaching model, not Odoo's real data format.

Python Stand-in: menu, action and views as plain data

Press Run (or Ctrl + Enter) to see the result here.

Program input ยท what you'd type while the program runs

Type the answers before you press Run, one per line. Each time the program reads a line (with input()), it gets the next line from this box.

In real Odoo these three structures are rows in the tables ir_ui_menu, ir_act_window and ir_ui_view. A module creates them with XML files, which chapters 3 and 5 explain.

A second stand-in: a search domain

The search bar filters records with a list of conditions. A minimal evaluator shows the idea; the real domain engine in Odoo supports many more operators.

Python Stand-in: filtering records like a search bar

Press Run (or Ctrl + Enter) to see the result here.

Program input ยท what you'd type while the program runs

Type the answers before you press Run, one per line. Each time the program reads a line (with input()), it gets the next line from this box.

Check your understanding

Quick check ยท 4 questions

of 4 answered You scored / 4 ยท perfect!

  1. 1. What does a menu item usually point to?

    Menu items reference actions (ir.actions.act_window), and the action names the model and view types.
  2. 2. Which view type shows cards grouped in columns, for example CRM stages?

    Kanban views display cards in columns and are ideal for pipelines.
  3. 3. How can you switch on developer mode quickly?

    The debug parameter (or the link in Settings) activates technical menus and tooltips.
  4. 4. Which model mixin gives a form its chatter?

    Inheriting mail.thread adds messaging and logging, and the form view then includes the chatter.

Summary

  • A screen is built from a menu, an action, a model and one or more views.
  • Common views are list, form, kanban, calendar, pivot and graph; the search view defines the search bar.
  • The control panel offers search, filters, group by and favourites, all based on domains.
  • The chatter comes from the mail.thread mixin.
  • Developer mode reveals technical names and the Technical menu.

Next: Installing Odoo from Source and Docker