Las validaciones y los mensajes
1. Introducción
En toda aplicación SAPUI5, es esencial validar los datos ingresados por el usuario antes de enviarlos al backend y mostrar mensajes claros y uniformes.
Las validaciones aseguran la integridad de los datos, mientras que los mensajes comunican el estado de la aplicación (errores, advertencias, confirmaciones o información).
SAPUI5 incluye un conjunto de componentes estándar para manejar ambas funcionalidades, garantizando una experiencia de usuario consistente con las directrices SAP Fiori.
2. Tipos de validaciones
Las validaciones en SAPUI5 pueden realizarse en dos niveles:
🔹
Validaciones en frontend (cliente)
-
Se ejecutan directamente en la interfaz SAPUI5.
-
Permiten detectar errores antes de enviar datos al backend.
-
Mejoran el rendimiento y la experiencia del usuario.
Ejemplos comunes:
-
Campos obligatorios no completados.
-
Formatos de datos incorrectos (fecha, correo, número).
-
Rango de valores no permitido.
🔹
Validaciones en backend (servidor)
💡 Recomendación: combinar ambos tipos de validación.
Primero validar en frontend para evitar llamadas innecesarias, y luego validar en backend por integridad.
3. Validaciones en SAPUI5
SAPUI5 proporciona varios mecanismos para realizar validaciones en la capa de presentación:
a) Propiedad “required” en controles
Indica que un campo es obligatorio.
<Input id="inputName" required="true" value="{/nombre}" />
Permite controlar reglas específicas mediante eventos como onChange o onSave.
onSave: function () { var sName = this.byId("inputName").getValue(); if (!sName) { MessageBox.error("El campo Nombre es obligatorio."); return; } // continuar con la lógica de guardado }
Los tipos de datos de SAPUI5 permiten validar formato y longitud automáticamente.
<Input value="{ path: '/email', type: 'sap.ui.model.type.String', constraints: { minLength: 5, maxLength: 50 } }" />
4. Validaciones en backend (ABAP / OData)
En la clase DPC_EXT del servicio OData, pueden implementarse validaciones adicionales antes de procesar los datos.
Ejemplo:
METHOD salesorder_create_entity. IF is_data-order_total < 0. RAISE EXCEPTION TYPE /iwbep/cx_mgw_busi_exception EXPORTING textid = /iwbep/cx_mgw_busi_exception=>business_error message = 'El total del pedido no puede ser negativo.'. ENDIF. ENDMETHOD.
💡 Estas validaciones aseguran que los datos cumplan con las reglas de negocio incluso si la validación del frontend falla.
5. Manejo de mensajes en SAPUI5
Los mensajes son esenciales para informar al usuario sobre el resultado de una acción.
SAPUI5 ofrece varios tipos de mensajes a través de las clases sap.m.MessageToast, sap.m.MessageBox y el MessageManager.
a) sap.m.MessageToast
Se utiliza para mensajes informativos o de confirmación rápida.
MessageToast.show("Datos guardados correctamente");
b) sap.m.MessageBox
Se utiliza para mensajes de interacción que requieren confirmación o muestran errores importantes.
MessageBox.error("Error al guardar los datos."); MessageBox.warning("¿Desea eliminar este registro?"); MessageBox.success("Operación completada con éxito.");
📘 Tipos de mensaje disponibles:
-
MessageBox.error()
-
MessageBox.warning()
-
MessageBox.information()
-
MessageBox.success()
-
MessageBox.confirm()
c) sap.ui.core.message.MessageManager
Es el mecanismo más completo para gestionar y mostrar mensajes asociados a campos específicos en formularios.
Se integra con el MessagePopover de Fiori para mostrar los mensajes de manera centralizada.
Configuración básica:
var oMessageManager = sap.ui.getCore().getMessageManager(); this.getView().setModel(oMessageManager.getMessageModel(), "message");
💡 Permite mostrar múltiples mensajes con severidades diferentes (Error, Warning, Information, Success) en una lista emergente o panel lateral.
6. Tipos de mensajes
Tipo
Clase utilizada
Propósito
| Éxito |
MessageToast / MessageBox.success |
Confirma una acción correcta. |
| Error |
MessageBox.error |
Notifica una falla crítica. |
| Advertencia |
MessageBox.warning |
Advierte antes de ejecutar una acción. |
| Información |
MessageBox.information |
Comunica datos generales. |
7. Integración de validaciones y mensajes
Una validación bien diseñada debe estar acompañada de un mensaje claro.
Por ejemplo:
if (sMonto <= 0) { MessageBox.warning("El monto debe ser mayor que cero."); return; }
Esto garantiza una experiencia de usuario fluida y profesional.
8. Buenas prácticas
-
Validar primero en el frontend, luego en el backend.
-
Mostrar mensajes claros, concisos y localizados (uso de i18n).
-
Evitar mostrar mensajes técnicos del sistema al usuario final.
-
Usar MessageToast solo para mensajes informativos rápidos.
-
Centralizar los mensajes en el MessageManager para aplicaciones complejas.
-
Definir severidades coherentes: Error → bloqueante, Warning → preventiva.
9. Conclusión
Las validaciones y los mensajes son componentes fundamentales en la calidad de una aplicación SAPUI5.
Permiten garantizar la integridad de los datos, mejorar la experiencia del usuario y mantener la coherencia con el estándar SAP Fiori UX.
Un buen manejo de ambos asegura aplicaciones más seguras, consistentes y fáciles de usar.
Preguntas de repaso
-
¿En qué clase se implementan validaciones del lado del backend en un servicio OData?
→ En la clase DPC_EXT.
-
¿Qué componente se usa para mostrar mensajes informativos breves en pantalla?
→ sap.m.MessageToast.
-
¿Qué clase se utiliza para mostrar mensajes de error o advertencia que requieren interacción del usuario?
→ sap.m.MessageBox.
-
¿Cuál es el mecanismo de SAPUI5 que gestiona mensajes centralizados asociados a campos del formulario?
→ sap.ui.core.message.MessageManager.
-
¿Qué validación se recomienda realizar primero, la del frontend o la del backend?
→ La del frontend, para evitar llamadas innecesarias al servidor.