Cada propietat d'un model té un tipus. El tipus decideix quina mena de valor s'hi guarda, com es veu l'editor del formulari i quines restriccions s'hi poden aplicar. Tria el tipus segons el que és el valor — no segons com vols que es mostri.

La llista completa

Text

Tipus Fes-lo servir quan
String Text pla — codis, slugs, URL, identificadors, etiquetes d'un sol idioma. Un valor per instància.
Localized String Text que llegeixen els usuaris i que ha de canviar amb l'idioma de la interfície — noms, títols, descripcions. Un valor per cada idioma admès. Vegeu Cadena localitzada.

Números

Tipus Fes-lo servir quan
Integer Nombres enters — recomptes, identificadors, puntuacions, anys. Combina'l amb una restricció d'enter per posar-hi límits o lligar-lo a una enumeració.
Decimal Nombres de precisió fixa — diners, quantitats, qualsevol cosa que no vulguis que s'arrodoneixi.
Float Nombres en coma flotant — mesures, raons, valors científics. Canvies precisió per rang.

Booleans i dates

Tipus Fes-lo servir quan
Boolean Indicadors cert/fals — isActive, archived, published.
Date Un dia del calendari, sense hora. Aniversaris, dates límit.
DateTime Un instant amb hora del dia. Esdeveniments, marques d'auditoria, terminis.

Referències

Les referències apunten a altres elements de la plataforma. Tria la classe segons què vols referenciar:

Tipus Apunta a Ús habitual
Model reference Una definició sencera de model "Aquesta propietat guarda regles sobre quin model cal aplicar."
Instance reference Una instància concreta d'un model La més habitual — Order.customer, Invoice.client.
Model property reference Una propietat concreta d'un model Configuració que ha de recordar "la propietat title del model Article".
Instance property reference Una propietat concreta d'una instància Poc habitual directament; apareix en patrons avançats.

Collection

Una col·lecció és una llista d'elements. No és un tipus de valor propi — embolcalla un dels tipus de més amunt. El tipus d'element es tria a la restricció de col·lecció: una llista de strings, una llista de referències a instàncies, etc. Vegeu Restriccions.

Tries entre tipus semblants

  • String vs Localized String — comença per String. Passa a Localized String només quan el camp sigui prosa que llegeix la gent i que ha de canviar amb l'idioma.
  • Integer vs Decimal vs Float — Integer per a recomptes, Decimal per a diners i quantitats, Float per a mesures que poden ser aproximades.
  • Date vs DateTime — si l'hora no importa, fes servir Date. T'estalvies sorpreses amb les zones horàries.
  • Instance reference vs col·lecció de referències — un objectiu → instance reference; múltiples → col·lecció d'instance references.

On es fixa el tipus

El tipus d'una propietat es tria quan l'afegeixes al model des de l'Explorador. El tipus forma part de l'estructura del model — canviar-lo més endavant és una operació versionada i pot caldre migrar dades existents.

Relacionats