EMS

Technical Reference: `ems.level`

Overview

ems.level is a configuration model at the top of the EMS curriculum hierarchy. It represents a study level (e.g., Secondary Education, VET, Baccalaureate) and groups related studies under a common classification. It has no custom business logic beyond a computed display_name.

Module file: models/curriculum/level.py

Data Model

Fields

Field	Type	Required	Stored	Description
`acronym`	`Char`	Yes	Yes	Short code (e.g., `BTX`, `CFGM`)
`name`	`Char`	Yes	Yes	Full descriptive name
`study_ids`	`One2many → ems.study`	No	No	Studies at this level (inverse of `study.level_id`)
`notes`	`Text`	No	Yes	Free-form administrative notes
`display_name`	`Char` (computed)	—	No	Format: `ACRONYM: Name`

Curriculum Hierarchy

graph TD
    L["ems.level (e.g. CFGM)"]
    S["ems.study (e.g. DAM)"]
    G["ems.group (e.g. DAM-1)"]
    ST["Students (res.partner)"]

    L --> S
    S --> G
    G --> ST

`display_name` Computation

Triggered by @api.depends('acronym', 'name').

flowchart LR
    A["acronym"] --> C["display_name = 'acronym: name'"]
    B["name"] --> C

CRUD Operations

Create

flowchart TD
    A([Admin user]) --> B[Community → Config → Curriculum → Levels]
    B --> C[Click New]
    C --> D[Fill acronym + name]
    D --> E[Save]
    E --> F{ORM / DB validation}
    F -- missing required field --> G[Error: required field constraint]
    F -- valid --> H[(INSERT INTO ems_level)]
    H --> I([Record created])

Read

flowchart TD
    A([Any user with read access]) --> B[Community → Config → Curriculum → Levels]
    B --> C[List view: sorted by acronym ASC]
    C --> D[Click record]
    D --> E[Form view: acronym + name · Studies tab · Notes tab]

Update

flowchart TD
    A([Admin user]) --> B[Open level record]
    B --> C[Edit fields]
    C --> D[Save]
    D --> E{Validation}
    E -- required field cleared --> F[Error: required field constraint]
    E -- valid --> G[(UPDATE ems_level SET ...)]
    G --> H([display_name recomputed])

Delete

flowchart TD
    A([Admin user]) --> B[Select level in list]
    B --> C[Action ⚙ → Delete]
    C --> D[Confirm dialog]
    D --> E{Linked studies?}
    E -- Yes --> F[DB integrity error: cannot delete]
    E -- No --> G[(DELETE FROM ems_level WHERE id = ...)]
    G --> H([Record removed])

Access Control

Defined in security/ir.model.access.csv (lines 34–36, 205).

Role	Create	Read	Write	Delete	Group XML ID
Administrator	✓	✓	✓	✓	`ems.group_academic_admin`
Teacher	—	✓	—	—	`ems.group_teacher`
Secretary	—	✓	—	—	`ems.group_secretary`
Portal	—	✓	—	—	`base.group_portal`

No record-level rules exist for this model.

Integration Map

ems.level is referenced by the following models:

Model	Field	Relation	Description
`ems.study`	`level_id`	Many2one	Each study belongs to one level
`ems.group`	`level_id`	Many2one (required)	Each group belongs to one level
`res.partner` (`ems.contact`)	`level_id`	Many2one (view field)	Cascades to filter available studies
`ems.attendance_template`	`level_id`	Many2one (required)	Attendance scheduling requires a level
`ems.attendance_session_header`	`level_id`	Computed from template	Inherited from the attendance template
`ems.limesurvey_recipient`	`level_id`	Many2one	Survey targeting by level
`ems.limesurvey_header`	`ems_level_ids`	Many2many	Surveys can target multiple levels
`ems.authorization.template`	`ems_level_ids`	Many2many	Authorizations apply to specific levels
`ems.enrollment_product_extension`	(via product.template)	Many2many	Products restricted to certain levels
`sale.order` / `ems.enrollment`	`ems_level_id`	Related from `study.level_id`	Enrollment level derived from study
Report wizards (3 models)	`level_id`	Many2one	Filter field in attendance report wizards

Views

View	File	Notes
List	`views/community/level/list.xml`	Columns: acronym (25%), name; sorted by acronym
Form	`views/community/level/form.xml`	Main group + notebook (Studies tab, Notes tab)
Action + Menu	`views/community/level/menu.xml`	Under Community → Configuration → Curriculum (sequence 1)

Data Files

File	Purpose
`data/cat/ems.level.csv`	Production catalog: 7 Catalan educational levels (ESO, BTX, CFGM, CFGS, EFPS, CFGB, PFI)
`demo/curriculum/level.xml`	Demo data: 4 generic levels for development environments

Key Migrations

Version	Change	File
18.0.0.6.2	Renamed CFPB → CFGB; updated external ID and `acronym` value in DB	`migrations/18.0.0.6.2/pre-migrate.py`

This site is open source. Improve this page.

EMS

Technical Reference: ems.level