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:

Formularis

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"

Llistes

Els formularis compliran les següents característiques:

• Sempre que sigui possible, es mostrarà primer la columna acronym seguida de name.

Exemple: