¿Qué es un tablero principal y por qué es importante?

Recientemente, estuve trabajando con un cliente para optimizar y depurar la implementación de un panel. Como parte de esto, he detectado un problema recurrente con los paneles principales que podría necesitar una aclaración.

El término "panel" se usa indistintamente para referirse a un panel único o a un grupo de paneles que contiene varios paneles, la mayoría de los cuales están integrados en otros paneles, en mayor o menor medida. De hecho, al crear un solo panel, OneStream crea un componente de panel integrado basado en el panel que acaba de crear.

Este componente de panel integrado se agrega a otros paneles en la pestaña "Componentes de panel" de otros paneles a medida que se crea el grupo de paneles.

Existe el concepto de Panel Principal, o Panel de Marco, que contiene todos los demás paneles integrados. Es este Panel Principal el que se suele ejecutar, y que a su vez representa todos los demás paneles integrados como un todo cohesivo.

Técnicamente, el Panel Principal o de Marco es el Panel Principal. Los Paneles Integrados nunca lo son.

Importancia de la Propiedad de Acción en los Paneles Principales

¿Por qué es importante? La propiedad de Acción en la pestaña de Propiedades del Panel explica su importancia.

Tenga en cuenta que el grupo de propiedades está etiquetado como "Acción (Solo Panel Principal)". Esta propiedad ejecutará una regla de negocio si está configurada correctamente y se agrega al Panel Principal. He visto muchos casos en los que esto se ha configurado en un panel que no es el Panel Principal y, como resultado, la función "Extensor de Panel" nunca se ejecuta.

¿Por qué se configuraría en un panel no principal? Supongo que quien lo hizo simplemente no se dio cuenta de que no hace nada en un panel no principal.

Demostración de la funcionalidad del panel principal

Para comprobarlo y con fines demostrativos, he creado un grupo de paneles compuesto por tres paneles, dos de ellos integrados en el primero (panel principal).

Al ejecutar 00_Frame_PrimaryDashboard, se ve como en la captura de pantalla a continuación.

Luego configuré el panel principal (00_Frame_PrimaryDashboard) para ejecutar un extensor de panel.

El extensor de panel cuenta con una función añadida a la sección "Cargar caso de panel". Esta función escribe el valor del par nombre-valor en el registro de errores cuando se carga el panel, incluso si es el panel principal.

Errores comunes con la configuración del extensor del panel

Esto es lo que se ve en el registro de errores, como se esperaba, cuando se carga el panel principal.

Para comprobar que este extensor de panel no se ejecuta si se llama desde un panel integrado, configuré las propiedades de la tarea del servidor de acciones en uno de los paneles integrados para que ejecutara el mismo extensor de panel, pero pasé un valor diferente en los pares nombre-valor. A continuación, volví a cargar el panel principal.

Como era de esperar, no se escribió nada en el registro de errores al cargar este panel integrado.

Para comprobar que la sintaxis de la llamada a la función del panel es correcta, si ejecuto el panel 02_Content_PrimaryDashboard y reviso el registro de errores, veré el par nombre-valor que pasé desde este panel en el registro de errores.

Esta vez funciona porque el panel no se ejecutó desde su estado incrustado, sino como panel principal.

Espero que esto aclare cuándo se debe y cuándo no agregar una llamada a la función de extensión del panel a la propiedad "Cargar tarea del servidor del panel" en un panel.