Web Form Banner

• Vaya a Ajustes \> Técnico \> Interfaz de usuario \> Form Banner Rules y cree una regla.
• Elija Model, seleccione Trigger Fields (opcional), establezca Default Severity, seleccione Views (opcional), actualice Target XPath (punto de inserción) y Position, y configure el mensaje.
• Guarde. Abra cualquier registro de formulario que coincida: el banner aparecerá y se actualizará automáticamente tras cargar/guardar/recargar.

Uso de los campos de mensaje:

• Message (message): Texto mostrado en el banner. Admite \${placeholders} rellenados con los valores devueltos por message_value_code. Se ignora si message_value_code devuelve un valor html.
• HTML (message_is_html): Si está habilitado, la cadena del mensaje se renderiza como HTML; de lo contrario, se trata como texto plano.
• Message Value Code (message_value_code): Expresión Python segura evaluada por registro. Devuelva un dict como {"visible": True, "severity": "warning", "values": {"name": record.name}}. Use message o html (desde este código), no ambos. Hay varias variables de contexto de evaluación disponibles.

Variables de contexto de evaluación disponibles en Message Value Code:

• env: Entorno de Odoo para acceso ORM.
• user: Usuario actual (env.user).
• ctx: Copia del contexto actual (dict(env.context)).
• record: Registro actual (el registro del formulario).
• draft: Los valores de campo persistidos del registro ORM (antes de aplicar los cambios sin guardar del formulario actual) + los cambios sin guardar actuales en los campos trigger. Debe usarse en lugar de record cuando su regla se active dinámicamente por una actualización de un campo trigger. No incluye ningún valor de campos complejos (one2many/reference, etc).
• record_id: Id entero del registro que se está editando, o False si el formulario está creando un registro nuevo.
• model: Atajo al modelo actual (env[record._name]).
• url_for(obj): Helper that returns a backend form URL forobj.
• context_today(ts=None): "Hoy" en la zona horaria del usuario (date) para comparaciones de fechas fiables.
• time, datetime: Módulos estándar de Python time/datetime.
• dateutil: { "parser": dateutil.parser, "relativedelta": dateutil.relativedelta }
• timezone: pytz.timezone para el manejo de zonas horarias.
• float_compare, float_is_zero, float_round: Utilidades float de Odoo para comparaciones/redondeos con precisión segura.

Todo lo anterior es inyectado por el módulo en los locals de safe_eval.

Trigger Fields

Trigger Fields es una lista opcional de campos del modelo que, cuando se modifican en el formulario abierto, provocan que el banner se recalcule en vivo. Si se deja vacía, el banner no se actualiza automáticamente mientras el usuario edita el formulario.

Cuando se dispara un trigger, el módulo envía los valores borrador actuales al servidor, los sanea, construye un registro de evaluación y vuelve a ejecutar su message_value_code.

Debe usar draft en lugar de record para acceder a los valores actuales del formulario si su regla se activa en función de una actualización de un campo trigger.

Ejemplos de configuración de mensajes:

A) Falta el email en el contacto (warning)

• Model: res.partner
• Message: This contact has no email.
• Message Value Code:

{"visible": not bool(record.email)}

B) Mostrar el comentario del partner si está disponible

• Model: purchase.order
• Message: Vendor Comments: \${comment}
• Message Value Code (expresión única):

{
  "visible": bool(record.partner_id.comment),
  "values": {"comment": record.partner_id.comment},
}

También es posible usar "convenience placeholders" sin una clave values explícita:

{
  "visible": bool(record.partner_id.comment),
  "comment": record.partner_id.comment,
}

C) Pedido de venta de alto valor (severidad dinámica)

• Model: sale.order
• Message: High-value order: \${amount_total}
• Message Value Code:

{
  "visible": record.amount_total >= 30000,
  "severity": "danger" if record.amount_total >= 100000 else "warning",
  "values": {"amount_total": record.amount_total},
}

D) Presupuesto con fecha de validez superada

• Model: sale.order
• Message: This quotation is past its validity date (\${validity_date}).
• Message Value Code:

{
  "visible": bool(record.validity_date and context_today() > record.validity_date and record.state in ["draft", "sent"]),
  "values": {"validity_date": record.validity_date},
}

E) Actividades pendientes en una tarea (usa env)

• Model: project.task
• Message: There are \${cnt} pending activities.
• Message Value Code (multilínea con resultado):

cnt = env["mail.activity"].search_count([("res_model","=",record._name),("res_id","=",record.id)])
result = {"visible": cnt > 0, "values": {"cnt": cnt}}

F) Al producto le falta la referencia interna (usa trigger fields)

• Model: product.template
• Trigger Fields: default_code
• Message: Make sure to set an internal reference!
• Message Value Code:

{"visible": not bool(draft.default_code)}

G) Banner HTML con enlace al último pedido de venta del cliente (usa trigger fields)

• Model: sale.order
• Trigger Fields: partner_id
• Message: (dejar en blanco; html proporcionado por Message Value Code)
• Message Value Code (multilínea con resultado):

domain = [("partner_id", "=", draft.partner_id.id)]
if record_id:
  domain += [("id", "<", record_id)]
last = model.search(domain, order="date_order desc, id desc", limit=1)
if last:
  html = "<strong>Previous order:</strong> <a href='%s'>%s</a>" % (url_for(last), last.name)
  result = {"visible": True, "html": html}
else:
  result = {"visible": False}

Si configuramos las reglas para un registro de partner como se muestra a continuación:

Los banners se mostrarán en la vista de formulario del partner:

Una vez que se rellenen los valores, los banners desaparecerán: