Control Preferences

Control Preferences es un módulo básico y sencillo para mantener las preferencias por usuario sobre los controles de GXUI que se utilicen, particularmente la grilla de los Trabajar con.

Simplemente se debe importar dicho módulo a la kb para que quede en funcionamiento.

El control principal de este módulo ya viene integrado con las APIs de PXTools por lo cual con el solo hecho de importar el xpz podrá en funcionamiento la funcionalidad sin necesidad de realizar programación adicional.

Los elementos que componen este módulo son:

  1. Web Component CmControlPreferences: Objeto componente que se integra a las masterpages del sistema para almacenar todas las preferencias relacionadas con los controles generados por la GXUI.

    1. Contiene el User Control gxuiSettings que es el soportado para:

    2. Declarar el WebProc a través de la propiedad SaveURL que será ejecutado cada vez que el usuario realice una modificación el algún control de la GXUI.

    3. Obtener los valores previamente salvados para la pantalla activa. Esto se realiza invocando el DataProvider ControlPreferencesInitState.

  2. Transacción ControlPreferences. Está definida únicamente para representar la base de datos que guardará las preferencias de los UserControls.

  3. DataProvider ControlPreferencesInitState: Obtiene de la base de datos las preferencias almacenadas de los controles definidos en una pantalla (instanciada por la variable &ControlPreferenceSystemObjectName) por un usuario dado (instanciado por la variable &ControlPreferenceTargetId) y lo devuelve en un SDT ControlPreferencesState que será utilizado por el User Control gxuiSettings.

  4. Procedimiento ControlPreferencesSaveState: Web Proc encargado de almacenar los cambios establecidos por un usuario en una pantalla al realizar una modificación el algún user control de la GXUI. Este Web Proc es invocado nativamente por los controles de la GXUI luego de que es declarado por el User Control gxuiSettings que se encuentra en el CmControlPreferences.

  5. SDT ControlPreferencesState: Formato de la estructura que necesita la GXUI para recuperar las preferencias almacenadas de los UserControls.

Para que funcione correctamente se debe:

  1. Chequear que en la rutina PDeCtx01(llamada desde CmControlPreferences) se asigna por contexto correctamente el usuario.

  2. Que el CmControlPreferences esté invocado en todas las MasterPages que se utilicen en el sistema y en el HWbWkW01.