Configurar la visibilidad administrativa de un botón de panel de OneStream
Un botón de panel de OneStream puede proteger acciones sensibles sin crear paneles separados para cada función. En este ejemplo, el botón Guardar permanece disponible para el grupo Administradores y oculto para los demás usuarios.
La solución combina una regla Dashboard XFBR con BRapi.Security.Authorization.IsUserInAdminGroup. La función evalúa al usuario conectado y devuelve un booleano que la propiedad isVisible puede consumir directamente.
En el panel de abajo quiero ocultar el botón Guardar para cualquier persona que no pertenezca al grupo de seguridad de Administradores.
La visibilidad de un botón en un panel está controlada por la propiedad del componente de formato de visualización.
isVisible = False El botón no será visible.
isVisible = True El botón será visible.
Lo que queremos hacer es alternar el valor isVisible entre True o False para este botón, según si un usuario pertenece al grupo de seguridad de Administradores. Esto activará o desactivará la visibilidad del botón según los derechos de seguridad del usuario.
Crear la comprobación de seguridad XFBR
Una forma es mediante el uso de una Dashboard XFBR y la función BRapi.Security.Authorization.IsUserInAdminGroup. Esta función devuelve un valor booleano True o False cuando se le pasa un UserName.
- 1. El primer paso es crear una función dentro de una regla de negocio Dashboard XFBR.
- 2. Dé a la función un nombre que se utilizará en la llamada XFBR desde el botón. En el ejemplo de abajo la llamé “AdminGroupCheck”.
- 3. En esta función personalizada, llame a BRapi.Security.Authorization.IsUserInAdminGroup. Deberá pasar el nombre de usuario del usuario que ha iniciado sesión. Esto puede lograrse utilizando la función de OneStream si.UserName, que recupera dinámicamente el nombre del usuario conectado como una cadena. Haga que la función devuelva su valor booleano a una variable booleana. En el ejemplo de abajo, la estoy devolviendo a blIsAdmin.
- 4. Configure el valor de retorno de la función en la variable booleana (Return blIsAdmin en el ejemplo de abajo). Una captura de pantalla de código informático
- El paso final es llamar a esta XFBR en la propiedad de formato de visualización isVisible del botón. (no olvide guardar el cambio)
Ahora, si un usuario que no es Administrador navega a este panel, no verá el botón Guardar.
Lista de comprobación del botón de panel de OneStream
Pruebe el botón de panel de OneStream con una cuenta administradora y otra cuenta estándar. Confirme que la regla devuelve True solo para el grupo previsto y que el botón oculto no deja espacios ni instrucciones confusas.
Mantenga la lógica de autorización en una función claramente nombrada. Documente el nombre de la regla, el componente que la llama y el responsable del grupo de seguridad. Este registro ayuda a revisar cambios y a resolver incidencias.
Ocultar el control mejora la experiencia, pero no sustituye la seguridad del proceso. Valide también permisos, flujos de trabajo y operaciones del servidor. El botón de panel de OneStream debe ser una capa de presentación coherente con esos controles.
Antes de publicar, guarde la regla, actualice el panel y pruebe en una sesión nueva. Revise mayúsculas, parámetros y sintaxis de la llamada XFBR. Después de una actualización, vuelva a comprobar el botón de panel de OneStream con ambos perfiles.
Incluya esta prueba en la validación de cada entorno. Compare desarrollo, pruebas y producción para confirmar que los nombres de grupos y reglas coinciden. Registre el resultado, la cuenta utilizada y la fecha. Así, el equipo conserva evidencia clara sin depender de una comprobación visual informal.
Continúe con estas guías: crear un usuario no administrador en OneStream, configurar un botón emergente del panel, agregar un botón de ayuda al panel, controlar la entrada de datos con una regla financiera, crear una copia de seguridad de la aplicación. Consulte también la documentación oficial de OneStream para confirmar el comportamiento de su versión.
