Представления - Odoo 10.0

Common Structure

View objects expose a number of fields, they are optional unless specified otherwise.

name (обязательный параметр)
only useful as a mnemonic/description of the view when looking for one in a list of some sort
model
the model linked to the view, if applicable (it doesn't for QWeb views)
priority

client programs can request views by id, or by (model, type). For the latter, all the views for the right type and model will be searched, and the one with the lowest priority number will be returned (it is the "default view").

priority also defines the order of application during view inheritance

arch
the description of the view's layout
groups_id
Many2many field to the groups allowed to view/use the current view
inherit_id
the current view's parent view, see Наследование., unset by default
mode
inheritance mode, see Наследование.. If inherit_id is unset the mode can only be primary. If inherit_id is set, extension by default but can be explicitly set to primary
application
website feature defining togglable views. By default, views are always applied

Наследование.

Соответствие представления

  • if a view is requested by (model, type), the view with the right model and type, mode=primary and the lowest priority is matched
  • when a view is requested by id, if its mode is not primary its closest parent with mode primary is matched

Разрешение представления

Разрешение генерирует финальный arch для запрошенного/совпадающего primary представления:

  1. если представление имеет предка и родительский элемент полностью опознан, тогда применяются спецификации наследования текущего представления

  2. Если у представления нет родителя, его arch используется как есть

  3. дочерние элементы текущего представления с режимом extension ищутся, и их спецификации наследования применяются сначала в глубину (применяется дочернее представление, затем его дочерние элементы, затем его родные элементы)

Результатом применения представлений дочерних элементов является финальный вариант arch

Определение наследования

Определение наследования состоит из элемента локатора, для поиска наследуемого элемента в родительском представлении и дочернего элемента, который будет использоваться для изменения унаследованного элемента.

Существует три типа локаторов для поиска целевого элемента:

  • директива xpath с атрибутом expr. expr - выражение XPath expression2 , примененное к текущему arch, первый узел, который он находит и является искомым

  • директива field с атрибутом name, находит первое вхождение field с тем же name. Все остальные атрибуты игнорируются при совпадении

  • любой другой элемент: первый элемент с тем же именем и идентичными атрибутами (игнорируются атрибуты position и version) и будет искомым

Определение наследования может иметь необязательный атрибут position, определяющий, каким образом должен быть найден нужный узел для дальнейшего изменения:

inside (по умолчанию)

содержимое определенного наследования добавляется к найденному узлу

replace

содержимое определенного наследования заменяет найденный узел. Любой текстовый узел, содержащий только $ 0 внутри содержимого спецификации, будет заменен полной копией найденного узла, эффективно обернув найденный узел.

after

содержимое определенного наследования добавляется к родительскому элементу найденного узла сразу после этого узла

before

Содержимое определения наследования добавляется к родительскому элементу найденного узла перед ним

attributes

в определении наследования должны быть элементы attribute с атрибутом name и содержимым, наличие которого не является обязательным:

  • если у элемента attribute есть содержимое, в найденном узле создается новый атрибут, после его name, с текстом элемента attribute как значением

  • если у элемента attribute нет тела, атрибут, указанный после его name, удаляется из найденного узла. Если такой атрибут отсутствует, возникает ошибка

Определения представления применяются последовательно.

Lists

Корневым элементом представления List является <tree>3. Корень представления может иметь следующие атрибуты:

editable

по умолчанию выбор строки представления списка открывает соответствующее представление Form. Атрибуты editable дают возможность редактировать данные прямо в представлении List.

Допустимыми значениями являются top и bottom, в результате чего новые записи появляются соответственно в верхней или нижней части списка.

Внутреннее устройство представление Form является производным представления List. Большинство атрибутов допустимы представлением Form, и точно таким же образом, кнопки принимаются представлениями List, хотя они могут не иметь никакого значения, если представление List недоступно для редактирования

default_order

overrides the ordering of the view, replacing the model's default order. The value is a comma-separated list of fields, postfixed by desc to sort in reverse order:

<tree default_order="sequence,name desc">
colors

Не рекомендуется, начиная с версии 9.0: replaced by decoration-{$name}

fonts

Не рекомендуется, начиная с версии 9.0: replaced by decoration-{$name}

decoration-{$name}

позволяют изменять стиль текста строки на основе атрибутов связанной записи.

Значения - это выражения Python. Для каждой записи выражение вычисляется по атрибутам записи как значениям контекста и если вычисление возвращает true, то соответствующий стиль применяется к строке. Другими значениями контекста являются uid (id текущего пользователя) и current_date (текущая дата в виде строки формы yyyy-MM-dd).

{$name} can be bf (font-weight: bold), it (font-style: italic), or any bootstrap contextual color (danger, info, muted, primary, success or warning).

create, edit, delete

непозволяет изменять соответствующее действие в представлении, устанавливая нужный атрибут на false

on_write

only makes sense on an editable list. Should be the name of a method on the list's model. The method will be called with the id of a record after having created or edited that record (in database).

The method should return a list of ids of other records to load or update.

string

alternative translatable label for the view

Не рекомендуется, начиная с версии 8.0: not displayed anymore

Допустимыми дочерними элементами представления List являются:

button

отображает кнопку в ячейке

icon

иконка для отображения кнопки

string
  • если icon отсутствует, текст кнопки

  • если есть icon, alt текст для иконки

type

тип кнопки, указывает, как это нажатие влияет на Odoo:

workflow (default)
sends a signal to a workflow. The button's name is the workflow signal, the row's record is passed as argument to the signal
object

вызывает метод в модели представления List. name кнопки - это метод, который вызывается с идентификатором записи текущей строки и текущим контекстом.

action

загружает и выполняет ir.actions, name кнопки - это id записи действия в базе данных. Контекст расширяется с помощью модели списка (как active_model), записи текущей строки (active_id) и всех записей, загружаемых в данный момент в списке (active_ids, может быть просто подмножеством записей базы данных, соответствующие текущему поиску)

name

см. type

args

см. type

attrs

динамические атрибуты, основанные на значениях записи.

Отображение атрибутов в доменах, домены вычисляются в контексте записи текущей строки, если True, соответствующий атрибут задан ячейке.

Допустимые атрибуты invisible (делает кнопку недоступной).

states

сокращение для invisible attrs: список состояний, разделенных запятой, требует, чтобы модель имела поле state и использовалась в представлении.

Делает кнопку invisible, если запись не в одном из перечисленных состояний

context

объединяется с контекстом представления при выполнении вызова функции Odoo при клике по кнопке

confirm
confirmation message to display (and for the user to accept) before performing the button's Odoo call
field

определяет столбец, в котором соответствующее поле должно отображаться для каждой записи. Может использовать следующие атрибуты:

name

имя поля в текущей модели для отображения . Данное имя может использоваться в представлении только один раз

string

заголовок столбца поля (по умолчанию используется параметр `` string`` поля модели)

invisible

загружает и сохраняет поле, но не отображает столбец в таблице. Необходимо для полей, которые не должны отображаться, но используются, например, @colors

groups

списки групп пользователей, которые могут видеть поле

widget

alternate representations for a field's display. Possible list view values are:

progressbar

отображает поля float как прогрессбар.

many2onebutton
replaces the m2o field's value by a checkmark if the field is filled, and a cross if it is not
handle
for sequence fields, instead of displaying the field's value just displays a drag&drop icon
sum, avg

отображает соответствующее объединение в нижней части столбца. Объединение вычисляется только по отображаемым в настоящее время записям. Операция объединения должна соответствовать [UNKNOWN NODE problematic]group_operator` соответствующего поля

attrs

динамические атрибуты, основанные на значениях записи. Воздействует только на текущее поле, так, например, invisible скроет поле, но оставит его видимым для других записей, и не будет прятать сам столбец

Forms

Представления Form используются для отображения данных одной записи. Их корневой элемент - <form>. Они состоит из обычного HTML с дополнительными структурными и семантическими компонентами.

Структурные компоненты

Структурные компоненты обеспечивают структуру или «визуальные» функции с небольшим количеством логики. Они используются как элементы или наборы элементов в представлениях Form.

notebook

определяет секцию с вкладками. Каждая вкладка определяется через дочерний элемент page. page элементы могут иметь следующие атрибуты:

string (обязательный параметр)
the title of the tab
accesskey
an HTML accesskey
attrs
standard dynamic attributes based on record values
group

используется для определения расположения столбцов в представлениях Form. По умолчанию группы определяют 2 столбца, а большинство прямых потомков групп занимают один столбец. Прямые прямые потомки field по умолчанию отображают значение label, а label и feild имеют colspan по 1 каждому.

Количество столбцов в group можно настроить с помощью атрибута col, количество столбцов, взятых элементом, можно настроить с помощью colspan.

Дочерние элементы располагаются горизонтально (пытаются заполнить следующий столбец перед сменой строки).

Группы могут иметь атрибут строка, который отображается как название группы

newline

полезен только внутри элементов group, рано заканчивает текущую строку и сразу переключается на новую строку (без предварительного заполнения любого оставшегося столбца)

separator

небольшой горизонтальный интервал с атрибутом string ведет себя как заголовок раздела

sheet

может использоваться в качестве прямого потомка для form придания представлению Form более компактный вид, превращая его как бы в бумажный лист

header

в сочетании с sheet, обеспечивает область во всю ширину над основным блоком, как правило, используется для отображения кнопок рабочего процесса и виджетов состояния

Семантические компоненты

Семантические компоненты выступают в качестве связующих звеньев и позволяют взаимодействовать с системой Odoo. Допустимыми семантическими компонентами являются:

button
call into the Odoo system, similar to list view buttons
field

renders (and allow edition of, possibly) a single field of the current record. Possible attributes are:

name (обязательный параметр)

имя отображаемого поля

widget

поля разный внешний вид по умолчанию в зависимости от их типа (например Char, Many2one). Атрибуты widget позволяют использовать другой метод визуализации и контекст.

options

Параметр конфигурации объекта JSON для виджета поля (включая виджеты по умолчанию)

class

Класс HTML для установки на сгенерированный элемент, классы field:

oe_inline

предотвратить обычный разрыв строки после полей

oe_left, oe_right

floats это свойство CSS будет применено к полю с соответствующим направлением

oe_read_only, oe_edit_only

отображает поле только в соответствующем режиме формы

oe_no_button
avoids displaying the navigation button in a Many2one
oe_avatar

для полей изображений, отображает изображения как аватары (имеет форму квадрата, максимальный размер 90x90 и некоторые декораторы)

groups

отображает поле только для определенных пользователей

on_change

вызывает указанный метод, когда значение этого поля редактируется, может генерировать обновления других полей или отображать предупреждения для пользователя

Не рекомендуется, начиная с версии 8.0: Используйте декоратор odoo.api.onchange() внутри самой модели

attrs

динамические мета-параметры, основанные на значениях записи

domain

только для реляционных полей, фильтры, применяемые при отображении существующих записей

context

только для реляционных полей, контекст для запроса возможных значений

readonly

Отображать поле как в режиме только для чтения, так и в режиме редактирования, но никогда не позволяет редактировать его самого

required

генерирует ошибку и предотвращает сохранение записи, если поле не имеет значения

nolabel

не отображать метку поля автоматически, имеет смысл только в том случае, если поле является прямым потомком элемента group

placeholder

показывает вспомогательное сообщение пустых полях. Может заменять метки полей в сложных формах. Не должны быть похожи на уже введенные данные , так как пользователи могут путать текст заполнитель с заполненными полями

mode

для One2many, режим отображения (тип представления) для использования связанных записей поля. Может иметь одно из следующих значений tree, form, kanban или graph. по умолчания tree (отображается в виде списка)

help

Подсказка, отображаемая для пользователей при наведении курсора на поле или его метку

filename

для полей с типом binary, имя поля, предоставляющего имя файла

password

указывает, что поле Char хранит пароль и что его данные не должны отображаться

Business Views guidelines

Business views are targeted at regular users, not advanced users. Examples are: Opportunities, Products, Partners, Tasks, Projects, etc.

In general, a business view is composed of

  1. a status bar on top (with technical or business flow),
  2. a sheet in the middle (the form itself),
  3. a bottom part with History and Comments.

Technically, the new form views are structured as follows in XML:

<form>
    <header> ... content of the status bar  ... </header>
    <sheet>  ... content of the sheet       ... </sheet>
    <div class="oe_chatter"> ... content of the bottom part ... </div>
</form>

The Status Bar

The purpose of the status bar is to show the status of the current record and the action buttons.

The Buttons

The order of buttons follows the business flow. For instance, in a sale order, the logical steps are:

  1. Send the quotation
  2. Confirm the quotation
  3. Create the final invoice
  4. Send the goods

Highlighted buttons (in red by default) emphasize the logical next step, to help the user. It is usually the first active button. On the other hand, cancel buttons must remain grey (normal). For instance, in Invoice the button Refund must never be red.

Technically, buttons are highlighted by adding the class "oe_highlight":

<button class="oe_highlight" name="..." type="..." states="..."/>
The Status

Uses the statusbar widget, and shows the current state in red. States common to all flows (for instance, a sale order begins as a quotation, then we send it, then it becomes a full sale order, and finally it is done) should be visible at all times but exceptions or states depending on particular sub-flow should only be visible when current.

The states are shown following the order used in the field (the list in a selection field, etc). States that are always visible are specified with the attribute statusbar_visible.

<field name="state" widget="statusbar"
    statusbar_visible="draft,sent,progress,invoiced,done" />

The Sheet

All business views should look like a printed sheet:

  1. Elements inside a <form> or <page> do not define groups, elements inside them are laid out according to normal HTML rules. They content can be explicitly grouped using <group> or regular <div> elements.
  2. By default, the element <group> defines two columns inside, unless an attribute col="n" is used. The columns have the same width (1/n th of the group's width). Use a <group> element to produce a column of fields.
  3. To give a title to a section, add a string attribute to a <group> element:

    <group string="Time-sensitive operations">
    

    this replaces the former use of <separator string="XXX"/>.

  4. The <field> element does not produce a label, except as direct children of a <group> element1. Use <label for="field_name> to produce a label of a field.
Sheet Headers

Some sheets have headers with one or more fields, and the labels of those fields are only shown in edit mode.

View modeEdit mode

Use HTML text, <div>, <h1>, <h2>… to produce nice headers, and <label> with the class oe_edit_only to only display the field's label in edit mode. The class oe_inline will make fields inline (instead of blocks): content following the field will be displayed on the same line rather than on the line below it. The form above is produced by the following XML:

<label for="name" class="oe_edit_only"/>
<h1><field name="name"/></h1>

<label for="planned_revenue" class="oe_edit_only"/>
<h2>
    <field name="planned_revenue" class="oe_inline"/>
    <field name="company_currency" class="oe_inline oe_edit_only"/> at
    <field name="probability" class="oe_inline"/> % success rate
</h2>
Button Box

Many relevant actions or links can be displayed in the form. For example, in Opportunity form, the actions "Schedule a Call" and "Schedule a Meeting" have an important place in the use of the CRM. Instead of placing them in the "More" menu, put them directly in the sheet as buttons (on the top) to make them more visible and more easily accessible.

Technically, the buttons are placed inside a <div> to group them as a block on the top of the sheet.

<div class="oe_button_box" name="button_box">
    <button string="Schedule/Log Call" name="..." type="action"/>
    <button string="Schedule Meeting" name="action_makeMeeting" type="object"/>
</div>
Groups and Titles

A column of fields is now produced with a <group> element, with an optional title.

<group string="Payment Options">
    <field name="writeoff_amount"/>
    <field name="payment_option"/>
</group>

It is recommended to have two columns of fields on the form. For this, simply put the <group> elements that contain the fields inside a top-level <group> element.

To make view extension simpler, it is recommended to put a name attribute on <group> elements, so new fields can easily be added at the right place.

Special Case: Subtotals

Some classes are defined to render subtotals like in invoice forms:

<group class="oe_subtotal_footer">
    <field name="amount_untaxed"/>
    <field name="amount_tax"/>
    <field name="amount_total" class="oe_subtotal_footer_separator"/>
    <field name="residual" style="margin-top: 10px"/>
</group>
Placeholders and Inline Fields

Sometimes field labels make the form too complex. One can omit field labels, and instead put a placeholder inside the field. The placeholder text is visible only when the field is empty. The placeholder should tell what to place inside the field, it must not be an example as they are often confused with filled data.

One can also group fields together by rendering them "inline" inside an explicit block element like <div>. This allows grouping semantically related fields as if they were a single (composite) fields.

The following example, taken from the Leads form, shows both placeholders and inline fields (zip and city).

Edit modeView mode
<group>
    <label for="street" string="Address"/>
    <div>
        <field name="street" placeholder="Street..."/>
        <field name="street2"/>
        <div>
            <field name="zip" class="oe_inline" placeholder="ZIP"/>
            <field name="city" class="oe_inline" placeholder="City"/>
        </div>
        <field name="state_id" placeholder="State"/>
        <field name="country_id" placeholder="Country"/>
    </div>
</group>
Images

Images, like avatars, should be displayed on the right of the sheet. The product form looks like:

The form above contains a <sheet> element that starts with:

<field name="product_image" widget="image" class="oe_avatar oe_right"/>
Tags

Most Many2many fields, like categories, are better rendered as a list of tags. Use the widget many2many_tags for this:

<field name="category_id" widget="many2many_tags"/>

Configuration forms guidelines

Examples of configuration forms: Stages, Leave Type, etc. This concerns all menu items under Configuration of each application (like Sales/Configuration).

  1. no header (because no state, no workflow, no button)
  2. no sheet

Dialog forms guidelines

Example: "Schedule a Call" from an opportunity.

  1. avoid separators (the title is already in the popup title bar, so another separator is not relevant)
  2. avoid cancel buttons (user generally close the popup window to get the same effect)
  3. action buttons must be highlighted (red)
  4. when there is a text area, use a placeholder instead of a label or a separator
  5. like in regular form views, put buttons in the <header> element

Configuration Wizards guidelines

Example: Settings / Configuration / Sales.

  1. always in line (no popup)
  2. no sheet
  3. keep the cancel button (users cannot close the window)
  4. the button "Apply" must be red

Graphs

Представление Graph используется для визуализации сводных данных по нескольким записям или группам записей. Его корневым элементом является [UNKNOWN NODE problematic]<graph> [UNKNOWN NODE problematic], который может принимать следующие атрибуты:

type

каждое из этих значений bar (по умолчанию), pie и line, это тип используемого графика

stacked

используется только для графика с типом bar. Если таковой тип присутствует установлен в True, то колонки будут объеденены в группы

Единственным допустимым элементом в представлении Graph является field, которое может иметь следующие атрибуты:

name (обязательный атрибут)
the name of a field to use in a graph view. If used for grouping (rather than aggregating)
type

указывает, должно ли поле использоваться как критерий группировки или как агрегированное значение внутри группы. Возможные значения:

row (по умолчанию)
groups by the specified field. All graph types support at least one level of grouping, some may support more. For pivot views, each group gets its own row.
col
only used by pivot tables, creates column-wise groups
measure

поле для агрегирования внутри группы

interval

применяется к date и datetime полям, группирует по указанным интервалам (day, week, month, quarter или year)вместо группировки по указанному времени (фиксированные значения секунд) или дате (фиксированные значения дней).

Pivots

Представление Pivot используется для визуализации объединенных данных как pivot таблицы. Его корневым элементом является <pivot>, который может принимать следующие атрибуты:

disable_linking

Установите True, чтобы удалить ссылки ячеек таблицы на представление List.

display_quantity

Установите true, чтобы отображать колонку количества по умолчанию.

The elements allowed within a pivot view are the same as for the graph view.

Kanban

Представление Kanban являет собой визуализацию канбан доску: она отображает записи как « карты», и призваны заполнить промежуточную нишу между представлением List и нередактируемым представлением Form. Записи могут быть сгруппированы в столбцы для использования для визуализации рабочего процесса или в его манипуляции (например для отображения задач или управления прогрессом работ) или не группироваться (используются просто для визуализации записей).

Корневым элементом представления Kanban является <kanban>, он может использовать следующие атрибуты:

default_group_by

указывает на то, следует ли группировать представление Kanban, если группировка не указана с помощью действия или текущего поиска. Должно быть именем поля, по которому нужно группировать, если никакая другая группировка не указана

default_order

порядок сортировки карточек, если пользователь еще не отсортировал записи (через представление List)

class

добавляет HTML-классы к корневому элементу HTML представления Kanban

group_create

определяет видим ли элемент "Добавить новую колонку". По умолчанию: true.

group_delete

определяет могут ли группы быть удалены через контекстное меню. По умолчанию: true.

group_edit

определяет могут ли группы быть отредактированы через контекстное меню. По умолчанию: true.

quick_create

whether it should be possible to create records without switching to the form view. By default, quick_create is enabled when the Kanban view is grouped, and disabled when not.

Установите true чтобы всегда разрешать, и false всегда отключать.

Допустимые дочерние элементы представления:

field

объявляет поля для агрегирования или для использования в kanban [UNKNOWN NODE problematic]логике [UNKNOWN NODE problematic]. Если поле просто отображается в представлении Kanban, его не нужно предварительно объявлять.

Допустимые атрибуты:

name (обязательный атрибут)

имя требуемого поля

templates

определяет список QWeb шаблонов. Определение карточек может быть разбито на несколько шаблонов для большей наглядности, но представления Kanban должны определять хотя бы один корневой шаблон kanban-box, который будет отображаться один раз для каждой записи.

Представление Kanban использует в основном javascript qweb и предоставляет следующие контекстные переменные:

instance
the current Web Client instance
widget

текущий класс KanbanRecord(), может быть испльзован для доступа к мета-информации. Эти методы так же доступны прямо из контекста шаблона и не требуют доступа через widget

record

объект со всеми запрошенными полями в качестве атрибутов. Каждое поле имеет два атрибута value и raw_value, первое форматируется в соответствии с текущими пользовательскими параметрами, второе является прямым значением из read() (кроме полей date и datetime которые форматируются на базе локали пользователя)

formats
the web.formats() module to manipulate and convert values
read_only_mode

название говорит само за себя

Кнопки и поля

Пока большинство Kanban шаблонов это стандартный QWeb, представление Kanban специальные элементы field, button и a:

  • by default fields are replaced by their formatted value, unless they match specific kanban view widgets
  • кнопки и ссылки с атрибутом type стали выполнять операции, связанные с Odoo, а не их стандартную функцию HTML. Возможные типы:

    action, object

    стандартное поведение для Odoo buttons, можно использовать большинство атрибутов, относящихся к стандартным кнопкам Odoo.

    open

    открывает запись карточки в представлении Form в режиме только для чтения

    edit

    открывает запись карты в представлении Form в редактируемом режиме

    delete

    удаляет запись карты и удаляет карту

API Javascript

class KanbanRecord()

Widget() handling the rendering of a single record to a card. Available within its own rendering as widget in the template context.

kanban_color(raw_value)

Converts a color segmentation value to a kanban color class oe_kanban_color_color_index. The built-in CSS provides classes up to a color_index of 9.

kanban_getcolor(raw_value)

Converts a color segmentation value to a color index (between 0 and 9 by default). Color segmentation values can be either numbers or strings.

kanban_image(model, field, id[, cache][, options])

Generates the URL to the specified field as an image access.

Аргументы
  • model (String) -- model hosting the image
  • field (String) -- name of the field holding the image data
  • id -- identifier of the record contaning the image to display
  • cache (Number) -- caching duration (in seconds) of the browser default should be overridden. 0 disables caching entirely
Результат
an image URL

Calendar

Представление Calendar записи как события в однодневном, недельном или месячном календарях. Его корневым элементом является <calendar>. Допустимыми атрибутами в представлении Calendar являются:

date_start (обязательный атрибут)

имя поля записи, содержащее дату начала события

date_stop

имя поля записи, содержащее дату окончания события, если указана date_stop, записи становятся подвижными (с помощью перетаскивания) непосредственно в представлении Calendar

date_delay
alternative to date_stop, provides the duration of the event instead of its end date
color
name of a record field to use for color segmentation. Records in the same color segment are allocated the same highlight color in the calendar, colors are allocated semi-randomly.
event_open_popup
opens the event in a dialog instead of switching to the form view, disabled by default
quick_add

включает быстрое создание событий при клике: запрашивает у пользователя name и пытается создать новое событие именно с тем временем, куда был произведен клик. Возвращается к вышеописанному диалоговому окну, если быстрое создание не удалось выполнить

display
format string for event display, field names should be within brackets [ and ]
all_day

имя поля типа Boolean, указывающее, отмечено ли соответствующее событие как занимающее целый день (продолжительность не имеет значения)

mode

Режим отображения по умолчанию при загрузке представления Calendar. Допустимые атрибуты: day, week, month

Gantt

Представления Gantt предназначены для формирования диаграмм Ганта (они, как правило, применяются для планирования).

Корневым элементом представлений Gantt является [UNKNOWN NODE problematic]<gantt /> [UNKNOWN NODE problematic], у него нет потомков, но он может принимать следующие атрибуты:

date_start (обязательный атрибут)

Имя поля, указывающего на дату начала события для каждой записи.

date_stop

name of the field providing the end duration of the event for each record. Can be replaced by date_delay. One (and only one) of date_stop and date_delay must be provided.

If the field is False for a record, it's assumed to be a "point event" and the end date will be set to the start date

date_delay
name of the field providing the duration of the event
duration_unit
one of minute, hour (default), day, week, month, year
default_group_by

имя поля для группировки задач

type

gantt classic gantt view (default)

consolidate values of the first children are consolidated in the gantt's task

planning children are displayed in the gantt's task

consolidation

имя поля для отображения значения консолидации в ячейке записи

consolidation_max

dictionary with the "group by" field as key and the maximum consolidation value that can be reached before displaying the cell in red (e.g. {"user_id": 100})

string
string to display next to the consolidation value, if not specified, the label of the consolidation field will be used
fold_last_level
If a value is set, the last grouping level is folded
round_dnd_dates
enables rounding the task's start and end dates to the nearest scale marks
drag_resize
resizing of the tasks, default is true

Diagram

Представление Diagram может использоваться для отображения ориентированных графов записей. Корневой элемент <diagram> и не имеет атрибутов.

Допустимые дочерние элементы представления Ddiagram:

node (обязательный параметр, 1)

Определяет узлы графа. Его атрибуты:

object

узел модели Odoo

shape

Условное сопоставление фигуры с цветами и шрифтами в the list view. Единственной допустимой фигурой является rectangle (фигура по умолчанию - элипс)

bgcolor

тоже что и shape, но условно сопостявляет фоновый цвет для узлов. По умолчанию цвет фона - белый, единственной допустимой альтернативой является grey.

arrow (обязательный параметр, 1)

Определяет направленные ребра графа. Его атрибуты:

object (обязательный параметр)

Модель Odoo в качестве ребра

source (обязательный параметр)

Many2one поле модели ребра которая указывает на запись, которая является начальной точкой ребра

destination (обязательный параметр)

Many2one поле модели ребра которая указывает на запись, которая является конечной точкой ребра

label

Список атрибутов Python (в виде цитируемых строк). Соответствующие значения атрибутов будут объединены и отображены как метка ребра

label

Примечание для диаграммы, атрибут string определяет содержание примечания. Каждая label выводится как параграф в заголовке диаграммы.

Значения Search по умолчанию

Search fields and filters can be configured through the action's context using search_default_name keys. For fields, the value should be the value to set in the field, for filters it's a boolean value. For instance, assuming foo is a field and bar is a filter an action context of:

{
  'search_default_foo': 'acro',
  'search_default_bar': 1
}

автоматически активирует фильтр bar и ищет поле foo для acro.

QWeb

QWeb views are standard QWeb templates inside a view's arch. They don't have a specific root element.

A QWeb view can only contain a single template4, and the template's name must match the view's complete (including module name) external id.

template should be used as a shortcut to define QWeb views.

[1] for backwards compatibility reasons
[2]

добавлена функция расширения для более простого поиска в представлениях QWeb: hasclass(*classes) узел будет попадать под выборку, если он узел имеет все указанные классы

[3]

По историческим причинам он имеет свое происхождение из древовидных представлений, позже переориентированных на отображение большего таблиц/списков

[4] or no template if it's an inherited view, then it should only contain xpath elements