ADVISOR MODELO DE DESARROLLO C/. Nil Fabra, 34-36 – Entlº 2ªB – 08012 Barcelona – Tlf. 93 237 42 41 – www.aldeso.net 1 1 INDICE 1 ÍNDICE ............................................................................................................................................... 2 2 ENTORNO ......................................................................................................................................... 3 3 AREA DE TRABAJO DE LA APLICACION ................................................................................ 3 4 BARRA DE ESTADO ....................................................................................................................... 4 5 BARRA DE HERRAMIENTAS DE MENU ................................................................................... 4 6 MENU CONTEXTUAL .................................................................................................................... 6 7 MENU DE APLICACION ............................................................................................................... 6 8 MENU DE PROCESOS DE LA APLICACION ............................................................................ 9 9 VISTAS ............................................................................................................................................. 10 10 FILTROS Y EXPRESIONES ......................................................................................................... 14 11 VENTANAS DE CONSULTA ........................................................................................................ 15 12 VENTANAS DE CONSULTA CON EDICION DE DATOS ...................................................... 16 13 ELEMENTOS COMUNES ............................................................................................................. 17 14 DEFINIDOR AMBITO DE INSTALACION .............................................................................. 18 15 ENLACE DE FORMULARIOS ..................................................................................................... 19 16 SOPORTE DE DIVERSOS IDIOMAS ......................................................................................... 20 17 GENERADOR CONTROLES DE INTERFACE ........................................................................ 20 18 GENERADOR DE CLASES Y SCRIPTS ..................................................................................... 21 19 EJEMPLO DE CLASE GENERADA ........................................................................................... 22 20 BASE DE MODELO DE HERENCIAVISUAL ........................................................................... 22 21 BASE DE MODELO DE HERENCIA ELEMENTOS NO VISUALES Y DE CONFIGURACION ................................................................................................................................. 23 22 BASE DE DATOS............................................................................................................................ 24 C/. Nil Fabra, 34-36 – Entlº 2ªB – 08012 Barcelona – Tlf. 93 237 42 41 – www.aldeso.net 2 2 ENTORNO ADVISOR es un entorno de trabajo orientado a MDI (Multiple Document Interface), que comprende varios elementos: 3 Menú de aplicación Barra de herramientas de menú Área de trabajo de la aplicación Menú contextual Barra de estado Menú de procesos de la aplicación AREA DE TRABAJO DE LA APLICACION El área de trabajo de la aplicación es aquella zona destinada a la ventana hija, que es la que contiene las funcionalidades específicas del proceso o consulta. Existen varios tipos de ventanas hijas, diferenciadas en base a si permiten la edición o no directamente sobre la parrilla de datos. C/. Nil Fabra, 34-36 – Entlº 2ªB – 08012 Barcelona – Tlf. 93 237 42 41 – www.aldeso.net 3 4 BARRA DE ESTADO La barra de estado es la que aparece en la parte inferior de la aplicación y muestra datos de versión de la aplicación, grupo de usuarios, usuario activo y estado de conexión y recuperación de datos. La imagen muestra una representación de los datos de usuario 5 BARRA DE HERRAMIENTAS DE MENU Representa en formato gráfico las funciones principales del menú. Es un acceso inmediato a la opción de menú. En cada ventana hija que se abre, añade los ítems con representación gráfica. La imagen es una muestra de una barra de herramientas La imagen muestra un menú de trabajo de una ventana hija genérica. El resto de menús generados por el implantador en el momento de enlazar con los datos de cliente amplían o reducen la funcionalidad que se muestra en el menú genérico. Siempre representan opciones del menú de aplicación y en el caso que así se haya definido, opciones del menú contextual de la ventana hija activa. La barra de herramientas del menú puede variar conforme se activa o desactiva una ventana hija o ventana dependiente. A continuación se explican las opciones del menú genérico Ítem de Menú Descripción Selecciona todos los ítems de registro de datos de la parrilla de datos de la ventana hija activa. Deselecciona todos los ítems de registro de datos de la parrilla de datos de la ventana activa. Copia el contenido del objeto activo. Pega el contenido de texto del portapapeles en el objeto activo, si éste lo admite. C/. Nil Fabra, 34-36 – Entlº 2ªB – 08012 Barcelona – Tlf. 93 237 42 41 – www.aldeso.net 4 Si los datos representados en la parrilla de la ventana activa se han agrupado por una o varias columnas, expande la agrupación para mostrar todos los registros dependientes. Se mueve al primer registro de la colección. Se mueve al registro anterior de la colección. Se mueve al siguiente registro de la colección. Se mueve al último registro de la colección. Refresca los datos de la ventana activa. Permite la generación de un filtro de usuario. Esta opción abre un cuadro de diálogo en el que el usuario puede definir un filtro para acotar el conjunto de resultados que se muestran en la parrilla de datos de la ventana activa. La imagen muestra una representación de la ventana de filtro de usuario. El usuario selecciona la columna por la que filtra en la lista de la izquierda y escribe el tipo de filtro y el parámetro en las cajas combinadas y de texto de la derecha. Pulsando el tabulador puede abrir tantas cajas de filtro como se necesiten. C/. Nil Fabra, 34-36 – Entlº 2ªB – 08012 Barcelona – Tlf. 93 237 42 41 – www.aldeso.net 5 6 MENU CONTEXTUAL El menú contextual es el que se muestra cuando el usuario hace clic con el botón derecho del ratón sobre el control o formulario activo. El menú contextual está formado por las opciones principales del menú de aplicación. En todo caso, los ítems del menú contextual se definen por el administrador o implantador en el momento de la creación del menú y son modificables o ampliables según las necesidades. La imagen muestra un menú contextual genérico 7 MENU DE APLICACION Es el menú que aparece en la parte superior de la ventana ADVISOR, inmediatamente debajo del título. Este menú dispone de opciones genéricas disponibles para todas las aplicaciones. Este menú es el contenedor de los menús de las diferentes pantallas child (o ventana hija, que aparece dentro del contenedor, dentro del área de trabajo). C/. Nil Fabra, 34-36 – Entlº 2ªB – 08012 Barcelona – Tlf. 93 237 42 41 – www.aldeso.net 6 Ítem de menú Descripción Archivo Archivo – Exportar Archivo – Imprimir Pantalla Archivo – Salir Edición Ver Registro Herramientas Herramientas Opciones Menú contenedor de funciones básicas que se realizan sobre el entorno MDI. Permite exportar a Excel el contenido de una ventana hija. Esta opción se activa cuando se abre la ventana hija, siempre que ésta permita la exportación a Excel. Imprime la pantalla, creando un documento de Word y lo lanza sobre la impresora. Sale de la aplicación y cierra la sesión del usuario en ADVISOR. Contenedor de funciones de selección y copia. Inicialmente, no muestra ningún subítem. Contenedor de funciones de visualización. Contenedor de funciones aplicables a un registro de datos o a una selección de registros. Menú contenedor de Herramientas de configuración y accesorias. Gestión de opciones generales de la aplicación: Directorios de trabajo de la aplicación. Datos de conexión FTP para datos que se transmiten vía FTP. Datos de conexión a servicios Web. Para Datos que se transmiten vía Servicio Web. Comportamiento y estilos de las opciones del menú lateral de procesos. La imagen muestra una representación de la pantalla en cuestión. C/. Nil Fabra, 34-36 – Entlº 2ªB – 08012 Barcelona – Tlf. 93 237 42 41 – www.aldeso.net 7 Herramientas Contraseña Herramientas Conexiones Le permite al usuario modificar su clave de acceso. La imagen muestra una representación de la pantalla de Contraseña. Muestra la ventana de configuración de datos de conexión a las bases de datos de trabajo de la aplicación. En la figura se pueden ver las dos conexiones necesarias. La primera contra la base de datos de”Metadata”, que es la que contiene la configuración de seguridad y acceso de la aplicación. La Segunda corresponde a la conexión de enlace con los datos del cliente. Ayuda Contenedor del menú ayuda Ayuda - Índice Acceso al índice de la ayuda de la aplicación Acceso a la ventana de datos de información. Esta ventana además muestra los ensamblados y versiones de los que se compone la Ayuda – Acerca de … aplicación y da acceso a información genérica de sistema. La siguiente ventana muestra la imagen de cuadro “Acerca de …” C/. Nil Fabra, 34-36 – Entlº 2ªB – 08012 Barcelona – Tlf. 93 237 42 41 – www.aldeso.net 8 8 MENU DE PROCESOS DE LA APLICACION El menú de procesos de la aplicación lo conforma la ventana lateral que se muestra en la parte izquierda de la aplicación. En ella se localizan todos los procesos y consultas a las que puede acceder un usuario. Los ítems y subítems dependen de la implantación específica. Estos ítems son los que dan acceso a las ventanas hijas donde se implementa un proceso o funcionalidad concreto. Este menú es configurable por parte del administrador e incorpora procesos administrativos que tienen efecto sobre el propio ADVISOR. La imagen muestra una representación de un posible menú lateral de procesos C/. Nil Fabra, 34-36 – Entlº 2ªB – 08012 Barcelona – Tlf. 93 237 42 41 – www.aldeso.net 9 9 VISTAS Las vistas son los elementos que construyen la visualización final de los datos. Cada objeto de datos debe de tener como mínimo una vista. Por defecto, cuando se asocia un nuevo objeto de datos a ADVISOR, se genera una vista denominada “vista genérica automática”, que es de tipo global, es decir, está disponible para todos los usuarios. Existen en ADVISOR dos tipos de vistas: 1. Vistas globales Están disponibles para todos los usuarios del sistema. Una modificación en cualquiera de las características configurables está automáticamente a disposición del resto de los usuarios del sistema. 2. Vistas de usuario Vistas disponibles únicamente para el usuario que las ha creado. No están disponibles para el resto de los usuarios. La mayoría de los menús de la aplicación disponen del ítem de menú “vistas” que da acceso a la creación y gestión de las mismas. Todas las ventanas de presentación de datos y edición de datos sobre una parrilla de datos, tiene una vista activa, ya sea global o de usuario. El hecho de que el usuario disponga de diversas vistas, le permite tener diferentes puntos de vista de la información, mostrando en cada caso aquellos elementos imprescindibles para el estudio de la información. La imagen es una representación de un menú con las opciones de gestión de vistas. C/. Nil Fabra, 34-36 – Entlº 2ªB – 08012 Barcelona – Tlf. 93 237 42 41 – www.aldeso.net 10 Creación de una vista. Se accede a la creación de una vista haciendo clic sobre la opción de menú “nueva”. El cuadro de dialogo que se muestra requiere los datos que se indican a continuación Dato Descripción Nombre Número máximo de filas Nombre de la vista Ej. (Facturas año 2005) Número máximo de filas que se muestran. Sirve para acotar la cantidad de datos que se recuperan y así preservar los recursos disponibles. Si se quieren recuperar todas las disponibles se pondrá un cero, lo que recuperará todas las filas que cumplan con el filtro especificado. Indica si se trata de una consulta global o de usuario. Consulta global Activación de una vista. Se accede a la opción de activación haciendo clic sobre el ítem de menú “activar” del submenú de vistas. Sólo hay que hacer clic sobre la vista que se desea activar. Una vez activada la vista, se convierte en la vista por defecto que cargará cuando el usuario abra el proceso o la consulta. C/. Nil Fabra, 34-36 – Entlº 2ªB – 08012 Barcelona – Tlf. 93 237 42 41 – www.aldeso.net 11 Administración de la vista. Al hacer clic sobre la opción de menú “administrar”, se abre el cuadro de diálogo de administración de vistas. Este cuadro de diálogo muestra las vistas existentes para el proceso o consulta actual, previa selección de la vista a configurar, se cargan las características personalizables. Estas características están distribuidas en sendas carpetas que se explican a continuación: Visualización u ocultación de campos de la vista (ver) El usuario selecciona el o los campos que desea visualizar u ocultar y con los botones hace que pasen de la columna de “disponibles” a la columna “visible” Establecer el orden de recuperación y visualización de registros (orden). En este caso, se selecciona la columna de cuadro de la derecha, se establece el tipo de ordenación (ascendente o descendente) y se pulsa el botón que muestra la fecha hacia la derecha. Para quitar la ordenación, se selecciona el campo en la lista de la izquierda y se pulsa el botón que muestra la flecha hacia la izquierda. C/. Nil Fabra, 34-36 – Entlº 2ªB – 08012 Barcelona – Tlf. 93 237 42 41 – www.aldeso.net 12 Filtro de selección de registros (filtro). El usuario dispone de un entorno gráfico en el que puede generar las condiciones de selección de registros. Estos filtros (filtros de usuario) se aplican en el momento de la recuperación de datos junto con los filtros de nivel superior. Formateo de campos (formateo de campos). Mediante la selección de los campos en la lista de la izquierda se cargan los cuadros combinados de la derecha que permiten definir algunas características de visualización de los mismos, como pueden ser la alineación horizontal y vertical, el formato y sumatorio. Las opciones de formato y sumatorio solamente están disponibles para campos de tipo numérico. El formato además está disponible para datos de fecha. Acepta formatos del tipo: ###,##0 ###,##0.00 dd/MM/yyyy C/. Nil Fabra, 34-36 – Entlº 2ªB – 08012 Barcelona – Tlf. 93 237 42 41 – www.aldeso.net 13 10 FILTROS Y EXPRESIONES Existen cuatro tipos de filtro que se pueden definir en ADVISOR: 1. Filtro global. Filtro que afecta al binomio ventana / objeto de datos. Este filtro está definido normalmente por el administrador con la finalidad de preservar los recursos disponibles. 2. Filtro de búsqueda. Filtro definido globalmente por el administrador o implantador a nivel de objeto de datos y que actúa cuando se abre en ADVISOR una ventana de búsqueda de datos genérica. 3. Filtro de vista. Definido a nivel de vista de usuario. (ver vistas) 4. Filtro usuario/Filtro Exprés. Filtros definidos por el usuario utilizando el filtro exprés o el cuadro de diálogo de filtro. La expresión es el elemento que conforma junto con el parámetro el predicado o condición de selección de registros. Para consultas exprés, globales y de búsqueda están disponibles las siguientes expresiones: Expresión <Valor1>..<Valor 2> ><Valor> <<Valor> = <Valor> >= <Valor> <= <Valor> <><Valor> <Valor> Descripción Busca los registros que están entre <Valor1> y <Valor 2> Busca los registros más grandes que <Valor> Busca los registros más grandes que <valor> Condición de registros iguales a <Valor> Condición de valores más grandes o iguales a <Valor> Condición de valores más pequeños o iguales a <Valor> Condición de valores diferentes a <Valor> Condición de valores que contiene <Valor> por defecto. Este comportamiento se ve modificado por la definición global de expresión de filtro aplicado al binomio Formulario/Objeto de negocio. El comportamiento puede ser: Por defecto (Contiene) Igual que … Más grande que … Más grado o igual que … Empieza por … Termina con … Más pequeño que … Más pequeño o igual que … Estas opciones son modificadas por el administrador para un grupo de usuarios. En el caso de filtro de selección, la expresión de búsqueda se crea de forma gráfica. C/. Nil Fabra, 34-36 – Entlº 2ªB – 08012 Barcelona – Tlf. 93 237 42 41 – www.aldeso.net 14 11 VENTANAS DE CONSULTA Las ventanas de consulta muestran datos al usuario, pero no permiten la edición directa sobre la parrilla de datos. En este caso, la edición, en caso de que exista se realizará sobre cuadros de dialogo habilitados al uso que actúan como contenedores de los elementos de negocio y comprobaciones y validaciones. El filtro exprés en las ventanas de consulta siempre está activado. La recuperación de datos en las ventanas de consulta se realiza en segundo plano, lo que significa que mientras se está recuperando los datos de una consulta, el usuario puede seguir trabajando en otra ventana. La imagen muestra una ventana de consulta característica. C/. Nil Fabra, 34-36 – Entlº 2ªB – 08012 Barcelona – Tlf. 93 237 42 41 – www.aldeso.net 15 12 VENTANAS DE CONSULTA CON EDICION DE DATOS Muestra los datos recuperados al usuario, pero permiten la edición de registro. El filtro exprés está activo sólo cuando la parrilla se encuentra en modo “consulta”. Añade opciones genéricas de búsqueda, recuperación y actualización de datos. La lógica de negocio se encuentra en la base de datos o bien en el objeto de negocio asociado a la ventana. La validación del registro se realiza en dos pasos, en el momento de la escritura en el campo de la parrilla y una validación posterior en el momento de guardar el registro. Este tipo de ventana tiene dos modos de trabajo. Modo Consulta Descripción Representado por el icono azul de la parte superior derecha de la ventana hija. En modo consulta el filtro exprés está activado y le permite al usuario especificar opciones de filtro en las columnas del filtro exprés. C/. Nil Fabra, 34-36 – Entlº 2ªB – 08012 Barcelona – Tlf. 93 237 42 41 – www.aldeso.net 16 Edición Representado por el icono del lápiz de la parte superior derecha de la ventana hija. En modo de edición el filtro exprés se desactiva hasta que el usuario confirma o rechaza las modificaciones realizadas. El objeto entra en modo edición cuando el usuario hace modificaciones sobre alguno de los campos editables de la parrilla de datos, o bien cuando hace clic sobre el botón nuevo del menú. En el caso de la edición, el usuario puede añadir, borrar y modificar el conjunto de registros disponibles. Sólo cuando el usuario acepte las modificaciones se activará el proceso de modificación de los registros sobre la base de datos. En el caso de cancelar la edición, se cancelarán todas las modificaciones realizadas hasta el momento que no hayan sido salvadas con anterioridad. La Barra de Herramientas del menú contiene cuatro nuevos iconos: Modo Descripción Mostrar todo Representado por el icono. Permite al usuario visualizar los datos almacenados Representado por el icono. Permite al usuario crear un nuevo en la base de datos. Representado por el icono. Permite al usuario editar el contenido del registro seleccionado. Representado por el icono. Permite al usuario eliminar el registro seleccionado. Nuevo Editar Borrar 13 ELEMENTOS COMUNES El elemento común de la ventana es el filtro exprés. El filtro exprés es el elemento que le permite al usuario especificar una condición de selección de registros por cada una de las columnas que conforman el objeto de datos. Es una fila especial y diferenciada del resto de la parrilla de datos. El usuario puede definir en cada una de las columnas la condición de filtro y del parámetro del filtro. (Para más información ver filtros) C/. Nil Fabra, 34-36 – Entlº 2ªB – 08012 Barcelona – Tlf. 93 237 42 41 – www.aldeso.net 17 14 DEFINIDOR AMBITO DE INSTALACION Controlador de menús de la aplicación. Esto permite la generación del menú que posteriormente se asocia al formulario. La generación de los menús es dinámica y es posible cambiar textos, imágenes y comandos. C/. Nil Fabra, 34-36 – Entlº 2ªB – 08012 Barcelona – Tlf. 93 237 42 41 – www.aldeso.net 18 Definidor de permisos por grupo de usuarios. Se asocian los permisos a nivel de opción de menú de usuario. 15 ENLACE DE FORMULARIOS En esta parte se enlazan los formularios de trabajo de la aplicación con los objetos de datos y se asocian al modelo los formularios de edición. C/. Nil Fabra, 34-36 – Entlº 2ªB – 08012 Barcelona – Tlf. 93 237 42 41 – www.aldeso.net 19 16 SOPORTE DE DIVERSOS IDIOMAS Mediante la asociación de identificadores en lugar de nombres concretos se posibilita que la aplicación trabaje en diversos idiomas en función de la selección del usuario. 17 GENERADOR CONTROLES DE INTERFACE Permite la generación del código de la clase parcial de diseño. Mediante el uso del conjunto de controles personalizados, se posibilita el cambio dinámico de permisos y descripciones de los campos sin necesidad de recompilado.El conjunto de controles personalizados dispone de propiedades de validación en la entrada de usuarios mediante expresiones regulares. Genera código para la clase parcial Designer. C/. Nil Fabra, 34-36 – Entlº 2ªB – 08012 Barcelona – Tlf. 93 237 42 41 – www.aldeso.net 20 18 GENERADOR DE CLASES Y SCRIPTS Mediante el generador de clases y scripts se permite la creación de los objetos de negocio de la aplicación además de la generación de código de los formularios de lista y edición. El modelo utiliza la sobre escritura de la “Windows Procedure” para sacar el mayor partido posible al entorno de trabajo. Así mismo, en los formularios de vista se utilizan los trabajos en segundo plano para evitar la sensación de premura en la apertura de pantallas y la obtención de datos, provocando así una mayor fluidez del entorno. C/. Nil Fabra, 34-36 – Entlº 2ªB – 08012 Barcelona – Tlf. 93 237 42 41 – www.aldeso.net 21 19 EJEMPLO DE CLASE GENERADA Modelo de objeto de negocio distribuido en el modelo de vista y el modelo de datos. TTPrueba y TTPruebaDB. //************************************************************************************** ************** //***** TTPrueba ***** //************************************************************************************** ************** publicclassTTPrueba { #region 'Definición de delegados' public delegate void ExceptionHandler(object sender, LastErrorEventArgs e); public event ExceptionHandlerOnException; public delegate void StatusChanged(object sender, DataStatusChange e); public event StatusChangedOnDataStatusChanged; #endregion #region 'Variables privadas de Objeto' private Int32 il_id = -1; private decimal idec_value = 0; #endregion #region "Variables privadas de Clase" private string is_LastError = string.Empty; privateRegStatusii_Estado = RegStatus.Added; private string is_ConnectionString = string.Empty; privateboolib_Modified = false; #endregion 20 BASE DE MODELO DE HERENCIAVISUAL Herencia visual de ADVISOR. La estructura de objetos visuales que muestra la imagen es la que da lugar a los objetos visuales concretos de las aplicaciones. C/. Nil Fabra, 34-36 – Entlº 2ªB – 08012 Barcelona – Tlf. 93 237 42 41 – www.aldeso.net 22 21 BASE DE MODELO DE HERENCIA ELEMENTOS NO VISUALES Y DE CONFIGURACION C/. Nil Fabra, 34-36 – Entlº 2ªB – 08012 Barcelona – Tlf. 93 237 42 41 – www.aldeso.net 23 22 BASE DE DATOS SQLSERVER2008 R2 o superior. C/. Nil Fabra, 34-36 – Entlº 2ªB – 08012 Barcelona – Tlf. 93 237 42 41 – www.aldeso.net 24