Las funciones más utilizadas en SAPUI5
1. Introducción
SAPUI5 provee una amplia gama de funciones y métodos predefinidos que facilitan el desarrollo de aplicaciones SAP Fiori.
Estas funciones permiten realizar tareas comunes como acceder a modelos, manipular vistas, manejar mensajes, navegar entre pantallas o trabajar con elementos de interfaz de usuario.
Conocer y aplicar correctamente estas funciones es clave para optimizar el código, mejorar la mantenibilidad y cumplir con los estándares del framework SAPUI5.
2. Funciones principales del framework SAPUI5
A continuación se resumen las funciones más utilizadas en el desarrollo de aplicaciones SAP Fiori con SAPUI5:
🔹
1. this.getView()
Devuelve la vista actual (View) del controlador.
Permite acceder a los controles, modelos o propiedades dentro de la vista.
var oInput = this.getView().byId("idCampo");
🔹
2. this.byId()
Permite obtener un control específico dentro de la vista, utilizando su identificador único (ID).
var oButton = this.byId("btnGuardar"); oButton.setEnabled(false);
🔹
3. this.getOwnerComponent()
Obtiene el componente principal (Component.js) de la aplicación, lo que permite acceder al router, modelos o configuraciones globales.
var oRouter = this.getOwnerComponent().getRouter();
🔹
4. this.getRouter()
Devuelve el enrutador (Router) de la aplicación, utilizado para controlar la navegación entre vistas.
this.getRouter().navTo("Detalle");
🔹
5. this.getModel() / this.setModel()
Permite acceder o asignar modelos de datos (JSON, OData, etc.) a una vista o al componente.
var oModel = this.getView().getModel("productos"); this.getView().setModel(oModel, "productos");
🔹
6. this.getResourceBundle()
Devuelve el archivo de internacionalización (i18n) para acceder a textos traducibles.
var oBundle = this.getOwnerComponent().getModel("i18n").getResourceBundle(); var texto = oBundle.getText("mensajeGuardado");
🔹
7. sap.m.MessageToast.show()
Muestra un mensaje emergente (notificación corta) en la parte inferior de la pantalla.
sap.m.MessageToast.show("Registro guardado correctamente");
🔹
8. sap.m.MessageBox
Permite mostrar mensajes modales con diferentes niveles de severidad (información, error, advertencia, etc.).
sap.m.MessageBox.error("Ha ocurrido un error al guardar los datos."); sap.m.MessageBox.information("Operación realizada con éxito.");
🔹
9. sap.ui.define()
Se utiliza para definir módulos en SAPUI5 y declarar dependencias entre ellos.
Es la base de la modularización del framework.
sap.ui.define([ "sap/ui/core/mvc/Controller" ], function(Controller) { "use strict"; return Controller.extend("mi.app.controller.Main", {}); });
🔹
10. sap.ui.require()
Carga módulos de forma asíncrona, sin bloquear la ejecución principal del programa.
sap.ui.require(["sap/m/MessageBox"], function(MessageBox) { MessageBox.success("Módulo cargado correctamente"); });
3. Otras funciones útiles
Función
Descripción breve
| this.getView().getModel() |
Accede al modelo de datos vinculado a la vista. |
| this.getView().getBindingContext() |
Devuelve el contexto de enlace actual del modelo. |
| this.getOwnerComponent().getModel("i18n") |
Accede al modelo de textos traducibles. |
| this.byId("control") |
Busca un control dentro de la vista actual. |
| sap.ui.getCore().byId("idGlobal") |
Busca un control en todo el core de la app (fuera del alcance de la vista). |
4. Buenas prácticas
-
Utilizar siempre this.getView() y this.byId() dentro de controladores para mantener el alcance local.
-
Centralizar los modelos en el Component.js, para mantenerlos accesibles desde toda la aplicación.
-
Mostrar mensajes al usuario mediante MessageToast o MessageBox, nunca con alert().
-
Usar sap.ui.define() para mantener el código modular y escalable.
-
Nombrar los modelos y vistas de forma clara y coherente.
5. Conclusión
Las funciones básicas de SAPUI5 constituyen la base de la interacción entre la lógica del controlador, la vista y el modelo.
Dominar su uso garantiza un desarrollo más ágil, estructurado y conforme a las mejores prácticas Fiori.
Preguntas de repaso
-
¿Qué función se utiliza para acceder al router de la aplicación?
✅ this.getRouter()
-
¿Qué diferencia hay entre sap.ui.define y sap.ui.require?
sap.ui.define define módulos y sus dependencias, mientras que sap.ui.require los carga de forma asíncrona.
-
¿Qué método se utiliza para mostrar mensajes breves al usuario?
✅ sap.m.MessageToast.show()
-
¿Qué método permite acceder al archivo i18n para textos traducibles?
✅ this.getResourceBundle()
-
¿Por qué es importante usar sap.ui.define en lugar de incluir scripts manualmente?
Porque garantiza la modularidad, evita conflictos y mejora la carga asíncrona de dependencias.