Cómo mejorar la UX en Oracle APEX usando APEX_APPLICATION.HELP
Brindar ayuda contextual en aplicaciones empresariales es clave para que los usuarios comprendan rápidamente qué acciones realizar y cómo interactuar con cada pantalla. En Oracle APEX, una herramienta poderosa y poco explotada para esto es el procedimiento APEX_APPLICATION.HELP. En este artículo, aprenderás cómo utilizarlo.
¿Por qué la ayuda contextual importa?
En aplicaciones empresariales, los usuarios necesitan orientación clara sin depender de manuales externos. Aquí es donde entra la ayuda contextual: proporciona información útil justo en el momento que se necesita, mejorando la eficiencia y reduciendo errores.
Como uso APEX_APPLICATION.HELP
Creamos una nueva pagina en blanco en el “Page Mode” usamos “Modal Dialog“.
A esta pagina le agregamos una nueva region.
Le ponemos un nombre representativo y en el “Type“ usamos “Dynamic Content”.
En la seccion "Appearance” utilizamos el Template Standard, y en el “Template Opcion” ocultamos el Header con la propiedad Hidden
En la seccion de “source”
Agregamos el siguiente codigo.
APEX_APPLICATION.HELP( p_flow_id => :APP_ID,
p_flow_step_id => :REQUEST);
return '';
Con este ultimo cambio, guardamos la pagina y vamos al &App_id>Shared_Components>Lists>”Navigation Bar” y creamos un nuevo “List Entry” asi.
Image/Class: fa-question-circle
List Entry Label: Ayuda
Target type: Page in this Application
Page: Aqui colocamos el id de la pagina que acabamos de crear
Request: &APP_PAGE_ID.
Despues de guardar esta nueva “List Entry” al ejecutar la aplicación tendriamos de esta manega el menu bar.
Con este procedimiento, APEX muestra automáticamente la información de ayuda configurada para esa página. Es ideal para guiar al usuario en formularios, reportes o procesos complejos sin recargar la interfaz.
Para probar la pagina de ayuda prepare una pagina de prueba que en su seccion de “Help” añadi el texto “Esta pagina la cree para probar los textos de ayuda“
Al ejecutar la pagina y dar clic en el boton de ayuda del Navigation Bar, nos desplegara la pagina de ayuda.
Beneficios de usar APEX_APPLICATION.HELP
Mejora la experiencia del usuario: proporciona asistencia en el contexto exacto.
Reduce errores y consultas al soporte: los usuarios entienden mejor los pasos a seguir.
Centraliza la gestión de la ayuda: toda la información se controla desde APEX, sin necesidad de documentación externa.
APEX_APPLICATION.HELP es una herramienta sencilla pero poderosa para ofrecer ayuda contextual en Oracle APEX. Permite guiar a tus usuarios de manera efectiva, mejorando la experiencia y reduciendo la curva de aprendizaje de tu aplicación.
Si te resultó útil este artículo, comparte tus experiencias aplicando ayuda contextual en tus proyectos APEX y muestra cómo los usuarios disfrutan de aplicaciones más intuitivas.
