Diferencia entre revisiones de «Wizards en Odoo»
Sin resumen de edición |
|||
Línea 219: | Línea 219: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== Alertes == | |||
És possible notificar a l'usuari de varies maneres. En cas de que s'equivoque en un field, podem afegir un label amb vista condicional: | |||
<syntaxhighlight lang="xml" style="font-family:monospace"> | |||
<field name="oil_required" /> | |||
<field name="not_oil" invisible="1" /> | |||
<label colspan="2" | |||
for="oil_available" | |||
string="Not sufficient Oil" | |||
attrs="{'invisible': [('not_oil','=', False)]}" | |||
style="background-color:yellow;"/> | |||
<field name="oil_available" /> | |||
</syntaxhighlight> | |||
També es pot mostrar un error en una finestra emergent. La manera més senzilla és: | També es pot mostrar un error en una finestra emergent. La manera més senzilla és: | ||
Línea 242: | Línea 257: | ||
Pot ser de molts tipus i no tanca el wizard, per tant, es pot continuar. | Pot ser de molts tipus i no tanca el wizard, per tant, es pot continuar. | ||
== Exemple Complet de Wizards == | == Exemple Complet de Wizards == |
Revisión del 20:43 3 feb 2022
Els wizards d'Odoo permeten fer un asistent interactiu per a que l'usuari complete una tasca. Com que no ha d'agafar les dades dirèctament en un formulari, si no que el va ajundant a completar-ho, no pot ser guardat en la base de dades fins al final.
Els wizards en Odoo són models que estenen la classe TransientModel en compte de Model. Aquesta classe és molt pareguda, però:
- Les dades no són persistents, encara que es guarden temporalment en la base de dades.
- A partir de odoo 14 necessiten permisos
- Els records dels wizards poden tindre referències Many2one o Many2many amb el records dels models normals, però no al contrari.
- Els records dels models normals poden tindre One2many a Wizards, però cada cert tems s'eliminen.
En realitat, no estem fent res molt diferent al que fem en Odoo a exepció del TransientModel. Es tracta de crear formularis i accions igual que podem crear-los per a altres propòsits. Un Wizard és un conjunt de tècniques que s'utilitzen conjuntament sovint. Així, el cicle de vida d'un wizard serà el següent:
- Un botó o el menú de dalt de la vista crida a un action que mostrarà el wizard. Por ser cridat de 4 maneres:
- Per un action ja preexistent en la base de dades amb %()d i un botó de tipus action.
- Per un action ja preexistent que tinga binding_model i per tant ixca en el menú de dalt d'una vista en eixe model.
- Per un action generat per Python i retornat per una funció. (En Odoo totes les funcions cridades desde la vista poden retornar un action que després el client executa).
- La més exòtica és per un action preexistent però obtingut en una funció Python i retornat per aquesta. No és molt freqüent, però pot ser l'única opció si la funció pot o no retornar un wizard i la cridada al mateix es vol definir una vegada només.
- Eixe action, en els wizards, sol obrir una finestra modal (target="new") on es mostren alguns fields del TransientModel.
- La finestra conté un formulari que sol tindre un botó per a enviar, crear o el que es necessite i un especial Cancel que té la seua sintaxi específica.
- Els wizards solen ser assistents que tenen botos de next, back per exemple. Eixe comportament s'implementa amb:
- Un field de tipus selection anomenat state (és important el nom).
- Un header en el formulari amb un widget statusbar per mostrar el progrés.
- Els botons anterior i següent que criden a funcions del TransientModel.
- Aquestes funcions canvien el field state i retornen un action del mateix wizard per refrescar-lo i que no es tanque.
- El formulari té groups o field que es mostren o s'oculten en funció del field state amb una etiqueta específica del XML anomenada states=.
- En cas de tindre un wizard complex en el que omplir Many2many o One2many, tal vegada es necessiten més transientModels per fer relacions. No es poden fer relacions amb models normals.
- Finalment, el wizard acabarà creant o modificant alguns models permanent de la base de dades. Això es fa en una funció. Eixa funció pot retornar un action per mostrar les instàncies creades o per refrescar la vista que l'ha cridat.
Wizard bàsic
A continuació anem a veure un exemple de wizard que sols mostra un formulari i crea una instància d'un model a partir de les dades del formulari:
class wizard(models.TransientModel):
_name = 'mmog.wizard'
def _default_attacker(self):
return self.env['mmog.fortress'].browse(self._context.get('active_id')) # El context conté, entre altre coses,
#el active_id del model que està obert.
fortress_attacker = fields.Many2one('mmog.fortress',default=_default_attacker)
fortress_target = fields.Many2one('mmog.fortress')
soldiers_sent = fields.Integer(default=1)
@api.multi
def launch(self):
if self.fortress_attacker.soldiers >= self.soldiers_sent:
self.env['mmog.attack'].create({'fortress_attacking':self.fortress_attacker.id,
'fortress_defender':self.fortress_target.id,
'data':fields.datetime.now(),'soldiers_sent':self.soldiers_sent})
return {}
En el python cal observar la classe de la que hereta, el default, que extrau el active_id del form que a llançat el wizard i el mètode que és cridat pel botó de la vista.
<record model="ir.ui.view" id="wizard_mmog_fortress_view">
<field name="name">wizard.mmog.fortress</field>
<field name="model">mmog.wizard</field>
<field name="arch" type="xml">
<form string="Select fortress">
<group>
<field name="fortress_attacker"/>
<field name="fortress_target"/>
<field name="soldiers_sent"/>
</group>
<footer>
<button name="launch" type="object"
string="Launch" class="oe_highlight"/>
or
<button special="cancel" string="Cancel"/>
</footer>
</form>
</field>
</record>
<record id="launch_mmog_fortress_wizard" model="ir.actions.act_window">
<field name="name">Launch attack</field>
<field name="res_model">mmog.wizard</field>
<field name="view_mode">form</field>
<field name="target">new</field>
<field name="binding_model_id" ref="model_mmog_fortress"/>
En la vista, tenim creat un form normal amb dos botons. Un d'ells és especial per a cancel·lar el wizard. L'altre crida al mètode. També s'ha creat un action indicant el src_model sobre el que treballa i el model del wizard que utilitza. Els action que criden a wizard tenen l'atribut target a new per a que llance una finestra emergent.
<button name="%(launch_mmog_fortress_wizard)d" type="action" string="Launch attack" class="oe_highlight" />
Si volem, podem ficar un botó que cride al action del wizard. Observem la sintaxi del name, que és igual sempre que el button siga de tipus action, ja que és l'anomenat XML id.
Wizard amb assistent
En aquest exemple anem a fer un wizard amb assistent. Per començar, cal crear un camp state amb varis valors possibles:
state = fields.Selection([
('pelis', "Movie Selection"),
('dia', "Day Selection"),
], default='pelis')
@api.multi
def action_pelis(self):
self.state = 'pelis'
return {
'type': 'ir.actions.act_window',
'res_model': self._name,
'res_id': self.id,
'view_mode': 'form',
'target': 'new',
}
@api.multi
def action_dia(self):
self.state = 'dia'
return {
'type': 'ir.actions.act_window',
'res_model': self._name,
'res_id': self.id,
'view_mode': 'form',
'target': 'new',
}
I uns botons que van fent que passe d'un estar a un altre:
<header>
<button name="action_pelis" type="object"
string="Reset to movie selection"
states="dia"/>
<button name="action_dia" type="object"
string="Select dia" states="pelis"
class="oe_highlight"/>
<field name="state" widget="statusbar"/>
</header>
<group states="pelis">
<field name="cine"/>
<field name="pelicules"/>
</group>
<group states="dia">
<field name="dia"/>
</group>
Després es pot fer que el formulari tinga un aspecte diferent depèn del valor de state
Els wizards poden tornar a recarregar la vista des de la que són cridats:
return {
'name': 'Reserves',
'view_type': 'form',
'view_mode': 'form', # Pot ser form, tree, kanban...
'res_model': 'wizards.reserves', # El model de destí
'res_id': reserva.id, # El id concret per obrir el form
# 'view_id': self.ref('wizards.reserves_form') # Opcional si hi ha més d'una vista posible.
'context': self._context, # El context es pot ampliar per afegir opcions
'type': 'ir.actions.act_window',
'target': 'current', # Si ho fem en current, canvia la finestra actual.
}
L'exemple anterior és la manera llarga i completa de cridar a una vista en concret, però si sols necessitem refrescar la vista cridada, podem afegir:
return {
'type': 'ir.actions.client',
'tag': 'reload',
}
Wizard amb dades per context
En ocasions, necessitem que el wizard obtinga informació de qui l'ha cridat. En els exemples hem vist que obtenim el active_id, és a di, el registre del que ha sigut cridat, amb:
self._context.get('active_id')
El traguem del context perquè s'envia automàticament per Odoo. Però pot ser que necessitem altres coses, com el parent.id o el valor d'un altre field, per exemple. Per a enviar informació extra al wizard, podem afegir coses al context en el action o en el botó que el crida.
<button name="%(negocity.travel_wizard_action)d"ç
type="action" string="Create Travel"
context="{'player_context': parent.id, 'city_context': active_id}"
class="oe_highlight"
/>
Eixa informació pot ser llegida amb aquestes instruccions:
player = self.env.context.get('player_context')
city = self.env.context.get('city_context')
Onchange en Wizards
En principi els Onchange funcionen igual que sempre. És a dir, poden modificar el valor dels fields o retornar un domain o un warning. No obstant, cal indicar que Onchange funciona sobre un record virtual còpia del record real en el que treballa el wizard. Així, quan fa un canvi, sols afecta a la vista. Això no és cap problema quan fem un formulari normal, però els wizards tenen varis estats (next, state...) i el canvi d'estat provoca recrear la vista de nou per mitjà d'un action. Eixos canvis desapareixen. Si volem que Onchange modifique realment el record del wizard i eixe canvi es quede, cal utilitzar self._origin. Observem aquest codi:
@api.onchange('destiny')
def _onchange_destiny(self):
if len(self.destiny)>0:
road_available = self.origin.roads & self.destiny.roads
self._origin.write({'road': road_available.id})
self.road = road_available.id
return {}
El primer write escriu sobre el registre real del wizard i el segon sobre el virtual per a veure el canvi.
Una altra cosa a tindre en compte és que el domain que retornen sols es vàlid per a la vista actual. Al ser refrescada, es perd. Per això, cal enviar-lo per context en la funció del botó next i aprofitar-ho en la vista:
# En el action del return de next:
'context': dict(self._context, cities_available_context= (self.cities_available.city).ids, origin_context = self.origin.id),
<!-- En la vista: -->
<field name="destiny" domain = "[('id','in',context.get('cities_available_context',[]))]" />
Alertes
És possible notificar a l'usuari de varies maneres. En cas de que s'equivoque en un field, podem afegir un label amb vista condicional:
<field name="oil_required" />
<field name="not_oil" invisible="1" />
<label colspan="2"
for="oil_available"
string="Not sufficient Oil"
attrs="{'invisible': [('not_oil','=', False)]}"
style="background-color:yellow;"/>
<field name="oil_available" />
També es pot mostrar un error en una finestra emergent. La manera més senzilla és:
from odoo.exceptions import UserError
....
raise UserError('Not Sufficient Oil for the travel')
En cas de necessitar una finestra més completa es pot fer un model, una vista form i cridar a un action que la mostre.
Si volem notificar sense molestar massa, es pot cridar a una action.client específica que mostra una notificació:
return {
'type': 'ir.actions.client',
'tag': 'display_notification',
'params': {
'message': 'Not sufficient Oil, vehicle or driver',
'type': 'danger', #types: success,warning,danger,info
'sticky': False,
}
Pot ser de molts tipus i no tanca el wizard, per tant, es pot continuar.