2.5 Guia d'estil

Models

Per als models de dades (fitxers Python) es proposa el següent:

General:
- Fer servir cometes dobles " per a delimitar els strings.
- Tots els paràmetres apareixeran definits dins els mètodes.
- Hi haurà una separació entre atributs interns, atributs del model i atributs de clau forana.
Atributs interns d'Odoo:
- Els dos primers camps sempre seran _name i _description.
- El camp code sempre serà el tercer (si existeix).
Atributs del model de dades:
- El camp acronym sempre serà el primer (si existeix).
- El camp name sempre serà el segon (si existeix).
- El camp notes sempre serà l'últim (si existeix, però es recomana que tots els elements permetin afegir notes).
- Per a tots els atributs, el primer paràmetre serà sempre string i l'últim serà required (només si required="true", altrament no es defineix).

Exemple:

Els formularis compliran les següents característiques:

Sempre que sigui possible es faran servir 4 columnes.
L'atribut code (si existeix) apareixerà a l'esquerra del tot ocupant una única columna, la resta poden fer colspan per a ocupar tota la resta si cal.
Els atributs de clau forana sempre aniran dins una pestanya.
L'atribut notes sempre anirà dins una pestanya i serà l'última.

Exemple: En aquest exemple, el camp Study fa colspan="4", mentre que name fa colspan="2"