-
PT
-
ES
-
AO
-
CV
-
MZ
-
ST
-
GW
-
Professional
-
Executive
-
Public Sector
-
Omnia
-
Evolution
Los Paneles de Información relacionada son paneles ejecutados automáticamente durante operaciones concretas del ERP, como, por ejemplo, un F4 en una entidad.
Estos paneles se destinan a ofrecer información relevante para el contexto activo, como por ejemplo, el resumen de las ventas de un determinado cliente al introducirlo en un editor ERP.
Crear controles de información
Para crear uno o más controles de información relacionada, es necesario crear un nuevo proyecto del tipo "Class Library" en C# o VB.NET, utilizando la .NET Framework 4.7.1. Es necesario añadir referencias a StdBE y StdPlatBE en este proyecto.
En este proyecto deben ser añadidos los User Controls necesarios y, posteriormente, deben ser marcados como publicpara que puedan ser utilizados fuera del propio proyecto.
En cada control, se debe implementar la interfaz IStdBEInfRelacionada que define los métodos estándar que deberá crear posteriormente.
Como parte de esta interfaz, es necesario crear dos propiedades para recibir la interfaz pública de la plataforma (Plataforma) y para recibir el motor de la aplicación (MotorAplicación). Estos motores permiten el acceso a cualquier funcionalidad expuesta.
También es necesario crear propiedades para recibir los objetos CategoryInfo (BECategoryInfo) y la ventana de contexto (FormContexto), permitiendo acceder al XML de configuración de controlo y a la ventana desde onde se pidió el panel de información relacionada.
Por último, es necesario implementar 3 métodos:
- AñadeClave - Método que permite al control saber la entidad editada en el ERP y cuál es su valor (por ejemplo: Nombre = Cliente, Valor = SOFRIO). De esta forma, el control podrá adaptarse para presentar los detalles relevantes o para, eventualmente, presentar otra entidad (por ejemplo: proveedores, funcionarios, etc);
- Actualiza - Método utilizado por el ERP para cargar el controlo. En este método deben ser desencadenadas todas las operaciones que permiten cargar el contenido que deseas presentar para el control;
- Borra - Método utilizado por el ERP cuando el campo clave es borrado y para remover la información del control. Todas las operaciones que borren la entidad actual del control deben ser desencadenadas, de modo a colocarlo en el estado inicial.
En estos métodos se debe utilizar el motor de la plataforma y del ERP para efectuar el cargamento, ya que permiten acceder fácilmente a un grande conjunto de información. Estos motores también permiten efectuar consultas SQL a la empresa abierta en el contexto.
Nota: Para estas funciones se puede obtener cualquier tipo de datos de cualquier tipo de fuente, en estos casos se debe implementar el código necesario.
Visualizar paneles
En el panel de información relacionada, pueden estar visibles los detalles de las diversas entidades en simultáneo y es posible navegar entre ellas de una de las siguientes maneras:
- Poner en primer plan en la tela el editor de la entidad deseado. Por ejemplo, si el panel fue abierto después de un F4 en la ficha de clientes, deberá selecciona la ficha del cliente. La información relevante es presentada automáticamente;
- Seleccionar en el propio panel la entidad deseada. Por ejemplo, en la opción anterior seleccionar la conexión Cliente en el propio panel.
Para cada entidad también es posible visualizar diversos tipos de información relacionada. Esta información se encuentra separada por grupos que pueden ser expandidos o minimizados individualmente, si necesario.
Es posible activar/desactivar la apertura automática de paneles de información relacionada a través de la opción del menú de configuraciones rápidas del ERP: Contexto | Información Relacionada. El cierre manual del panel desactiva la opción.
Distribuir control de información
Para que se cargue el control de información relacionada, es necesario:
- Copiar la DLL creada para la carpeta APL de todas las máquinas de rede;
- Registrar el control en la base de datos de las empresas que pretende acceder.
El registro en la base de datos se hace a través de la introducción de información en dos tablas:
InformacionRelacionada
En la tabla "InformacionRelacionada", deben ser introducidos los siguientes elementos:
- Campo Id - Identificador único (Guid) que sirve de clave extranjera (IdCategoría) en la tabla ContextosInformacionRelacionada;
- Campo Categoría - Categoría de información de la lista. Este campo se puede consultar a través del panel de diagnósticos del ERP. En el panel de diagnósticos deberá hacer clic en F4 en el local donde deseas abrir el control de información relacionada y podrás ver el siguiente registro Acceso a la categoría:. Esta es la categoría que registrar en este campo;
- Campo Config - Campo en formato XML que define el contexto de la instancia del control por categoría de F4. Ejemplo: InfoRelacionada.CI_Prototipo Prototipo Descripción del control 1 0
Notas:
- Los campos del XML definen propiedades como el nombre, descripción y título del control, así como la visibilidad de la descripción y la altura máxima del control;
- El campo TypeClassName es el namespace completo del control. El ERP utiliza esta información para mostrar los detalles;
- Este XML puede ser ampliado de la forma más conveniente, desde que el mismo mantenga esta estructura mínima.
ContextosInformacionRelacionada
En la tabla "ContextosInformacionRelacionada", deben ser introducidos los siguientes elementos por cada formulario en el que se desea presentar el control:
- Campo IdCategoría - Identificador único (Guid) introducido en el paso anterior en la tabla InformacionRelacionada;
- Campo Contexto - Nombre del formulario al que debe ser asociado el control. Este campo se puede consultar a través del panel de diagnósticos del ERP. En el panel de diagnósticos deberás abrir el formulario deseado y podrás ver el siguiente registro Formulario abierto:. Este es el valor que registrar en este campo;
- Campo Orden - Orden por la que este control aparecerá en el panel de información relacionada, caso exista más que uno para la misma categoría y formulario;
- Campo Params - Campo en formato XML que amplía el contexto del control por F4 por formulario. Ejemplo: 1
El elemento General (en cursiva) tiene como objetivo definir si cuando se abre el control, este debe ser presentado de forma ampliada o contraída. Nota: Este elemento es obligatorio.
Los restantes elementos son opcionales y se destinan a demonstrar la posibilidad de transferencia de parámetros diferentes entre un formulario y otro para la misma categoría, permitiendo el uso del control en una multitud de escenarios diferentes.
Como en el caso anterior, este XML puede ampliarse libremente desde que la sección en cursiva se mantenga.
Detalles de Implementación
En GitHub hay un proyecto estándar que muestra cómo crear un control de información relacionada:
- Los campos en XML referidos anteriormente pueden ser consultados en el objeto StdBECategoryInfo (propiedades .Contexto y .Params, respectivamente), pasado a través de la propiedad BECategoryInfo referida; Nota: Podrás utilizar la API de XML de la plataforma para consultarlo;
- La utilización de controles de otros fabricantes y la respectiva licencia son de la exclusiva responsabilidad del implementador. Deberás garantizar que las licencias necesarias para efectuar el control están presentes en la máquina donde el mismo será ejecutado;
- El tratamiento de errores en las funciones y propiedades de la implementación del control es fundamental, una vez que, en caso de error, el control de información relacionada no es cargado. Se existen errores, podrás verificarlos a través del panel de diagnósticos del ERP;
- Se pueden cargar diversos controles para cada F4/formulario. Los controles serán presentados en áreas contraídas presentadas en el estado definido en el XML anteriores en la propiedad Expanded (1 u 0). De esta forma, se pueden añadir controles de información relacionada a un F4/formulario, mismo que en ese F4/formulario ya existan controles;
- La interfaz pública de la plataforma es del tipo StdBSInterfPub y el motor de la aplicación es del tipo ErpBS y se encuentran, respectivamente, en las dlls StdPlatBS y ErpBS. A pesar de que sea más accesible utilizar referencias y objetos con tipo definido, se recomienda utilizar dynamic/object para estos tipos, de modo a hacer el control menos susceptible a cambios de compatibilidad que puedan ocurrir entre Service Releases.