StartFrame Net Framework
Contents
1. El esquema de seguridad est ndar del sistema debe analizarse desde diferentes aspectos 1 Acceso a la base de datos 2 Conexi n al sistema logueo 3 Uso de los componentes del sistema Acceso a la Base de Datos Lo primero que hay que aclarar es que existen dos tipos de usuarios diferentes e Usuario l gico e Usuario f sico El primero es el usuario que est utilizando el equipo el cual se logue al aplicativo Dicho usuario ser validado por el sistema seg n se explica m s adelante El segundo es el usuario con el cual se acceder al motor de base de datos Se recomienda utilizar seguridad integrada al sistema operativo siempre que sea posible Si no lo fuera el nombre de usuario y su clave deber n encriptarse y especificarse dentro de los archivos de configuraci n ver 3 Base de Datos para mayores detalles En el caso de la plantilla Web Application si decide utilizar la seguridad por forms de ASP NET ser necesaria la utilizaci n de una segunda base de datos provista por Microsoft que se utiliza para controlar la seguridad de la aplicaci n Web StartFrame se encarga de mantener sincronizada la seguridad entre ambas bases de datos ya que integr la base de Microsoft en la de StartFrame Por razones de performance los par metros de conexi n se almacenan en la propiedad ConnectionString del componente Common Env Esta propiedad es cargada reci n cuando un usuario se loguea correctamente al mismo tiempo que2. lt KeyInfo xmlns http www w3 org 2000 09 xmldsig gt lt EncryptedKey xmlns http www w3 org 2001 04 xmlenc gt lt EncryptionMethod Algorithm http ww w3 org 2001 04 xmlenctrsa 1_5 gt lt KeyInfo xmlns http www w3 org 2000 09 xmldsigH gt lt KeyName gt Rsa Key lt KeyName gt lt KeyInfo gt lt CipherData gt lt CipherValue gt NKJYZlonvR18uxohG3KamAVydjgw5gP7AxCMalIbEyIgSGblYgKVxLuDGA3F0BjnASN9b2i9dCZ q PNx Xsit1li615Wr1dykU09 iJJyVopqWi USSCVgLEQOCtOVXVwdnTt6ul1Y gtCwua400MfXOqeCRpAf5c94rb GF8BuN E lt CipherValue gt lt CipherData gt lt EncryptedKey gt lt KeyInfo gt lt CipherData gt lt CipherValue gt HNPhI3xxL2zkQ0d 0ipYiGhNyShnyujN ZdaoGLtibs9CPqkNO007U8YsPUnrQ9dmyDGubrP16p6 DZf1Vms5p4619p552g9Z4vyu6B7qgFz6vJIUZteE8yXCVTPGPHtXHDykdsfOHk01b00 6PXD1Mszx3cuYCXa6zThnqg NsamNEF9ENpacuiejFyT htaWAGoMfO3M0H62hs 7THoYthefdfb2ZKKRt3 4KuStC98knmTOLwWjKw8vcY3adGRP v NrohAcC7AoWpGvt kWizhXutNLTYohdAIGYqeLzFWnJGWI lt CipherValue gt lt CipherData gt lt EncryptedData gt lt connectionStrings gt Para lograr esto en primer lugar deber abrir la consola de Visual Studio buscar en Inicio Visual Studio Tools En dicha consola deber ejecutar la siguiente l nea para importar la CustomKey de forma tal de poder encriptar y desencriptar texto Aseg rese que las rutas sean las correctas y el archivo CustomKeys xml exista aspnet_regiis pi CustomKeys D XDesarrolloWNet 1IWebSitelSharedSo
3. Application Log de Windows Contiene una ruta absoluta a la aplicaci n servidora donde el sistema buscar el archivo de definici n de par metros de los stored procedures Ruta de red donde reside la ltima versi n del cliente del sistema y desde la cual se realizar n las actualizaciones autom ticamente ver Actualizaciones Estado de apertura de las plantillas del tipo abm y consultor en el m dulo desktop de StartFrame Indica el tipo de estilo a utilizar para las plantillas del tipo abm y consultor en el m dulo desktop de StartFrame Indica si la plantilla base del tipo abm para los formularios desktop realizar un resize autom tico de todas las grillas contenidas en el mismo Determina el estado inicial del formulario principal del m dulo desktop Determina el tama o del formulario MDI del m dulo desktop Determina la posici n inicial del formulario principal del m dulo desktop Direcci n de mail a la cual se dirigir n los informes de errores en el procesamiento Utilizado especialmente en la plantilla de servicios Windows de StartFrame Directorio f sico absoluto y ruta de red Posible contenido Cualquier usuario real del sistema operativo en may sculas y sin el dominio y que est registrado en el esquema interno de seguridad de StartFrame e True e False Cualquier ruta de red v lida o bien puede comentarse todo este tag para que busque dicho archivo en la carpeta donde se est ejecut
4. Visual Studio que le permitir acceder a toda la documentaci n de StartFrame agrega una serie de code snippets registra algunos controles para utilizar en formularios y le permitir utilizar este marco para crear nuevas aplicaciones a trav s de plantillas predise adas Para crear una nueva soluci n podr utilizar los templates de proyectos que se instalan en su equipo al agregar la extensi n antes mencionada A T A TE AE i Da A A A rP Cada plantilla de soluci n ofrece informaci n de la m xima importancia en un archivo t pico de cada instalaci n el cual rara vez es le do Leame txt ofrece informaci n elemental para configurar y ejecutar el sistema por primera vez 1 Puede solicitar soporte adicional en StartFrame Net 30 StartFrame Net Framework Manual T cnico net Framework versi n 1 10 2011 Procedimiento General de Instalaci n Independientemente del tipo de plantilla de soluci n que desee utilizar en general los pasos de instalaci n son los siguientes 1 Prerequisitos En primer lugar luego de crear el nuevo proyecto utilizando el template seleccionado deber verificar e instalar los prerequisitos de la plantilla elegida En general estos consisten en restaurar la base de datos modelo o instalar el runtime para los reportes de SAP Crystal Reports si aplica al entorno elegido La lista puntual de prerequisitos de cada plantilla est descripta en el archivo Leame txt 2 Plantilla d
5. EAEE A An EE aai A ADAE 13 REMOTOS inn E ana e aE Ee E p E E E E NE ERE 13 Conexio a la Base de Datos arca aE EAAS EE nia Eais 15 Procedimientos Almacenado S susarsan aea aSo cic tos 16 Aplicacion Multicultural setentas ea ae e EEE a aras 17 ARCNIVO de RECUS OS ita aio oasis 17 Sistema de Segunda cines ra 18 Acceso ala Base de DatOS siria naa 18 Conexi h al sistema lOgucO sas tias or 18 Utilizando BRdesde otras plantillas ii aora oi eines de 19 ACCESO OS COMPONENTES cercada ont dere none 20 NN 21 Control de Eroles us esanai aieiaa nani iaaa iii oa ADAN ESC ANAE a NoE aaa nee a isai RE 22 Esquema Multiempresa en entornos Desktop cccooioci nonnoninioninciicnain ninos ciencia in cnineia li 22 IM StartFrame Net Framework Manual T cnico net Framework versi n 1 10 2011 Esquema de Procesamiento Localiser s ina aae Ea ene aE aja dim cali 23 Esquema de Procesamiento Distribuido ociconinciocinenmocinccimeiicain insano cuele dance enana areas din aena Ea 24 test Driven Development TOD siars lidia ines 25 StartFrame Net Framework Manual T cnico net Framework versi n 1 10 2011 INSTALACI N Para instalar StartFrame en un entorno de desarrollo deber contar con Microsoft Visual Studio previamente instalado ya que StartFrame se agrega como extensi n del mismo Luego de descargar StartFrame desde su sitio oficial deber seguir las instrucciones de la Gu a de Instalaci n La mencionada extensi n agrega un nuevo men a su IDE de
6. RYPT End If Acceso a los Componentes Cada vez que un cliente front end intente instanciar un componente de las reglas de negocio lo primero que se verificar es si est cargada la propiedad ConnectionString del componente Common Env Dicha propiedad estar cargada nicamente si dicho cliente previamente se logue al sistema utilizando BR SCA Login ver el punto anterior para mayores detalles La seguridad de cada componente se verifica en su constructor por ello si existiera alg n problema de seguridad el componente no podr ser instanciado Paso seguido se verificar n los permisos establecidos en las tablas del sistema que dicho operador tenga asignados No se puede continuar con esta explicaci n sin describir el mecanismo de seguridad interno del sistema el cual se aprecia en el siguiente esquema Son miembros de Operadores Funcionalidades CE Tienen acceso a Los operadores si bien tienen ciertos atributos particulares usuario clave bloqueo lleva tracking etc no poseen una configuraci n de seguridad La seguridad se establece a nivel de grupo o rol La uni n de los operadores con los grupos queda establecida en la tabla de miembros wld_miembros_grupo Cada operador puede pertenecer a varios grupos El nivel de seguridad obtenido ser el m ximo posible dada la combinaci n de todos ellos A nivel de cada grupo existen ciertos privilegios de uso del sistema a saber e Administrado
7. STARTFRAME NET FRAMEWORK Manual T cnico El objetivo de este manual es describir toda la informaci n t cnica pertinente para un arquitecto analista o programador que desee utilizar el producto Podr encontrar dentro de este manual una descripci n de la arquitectura interna del sistema la estructura multicapas utilizada el manejo multicultural el sistema interno de seguridad el mecanismo de control de errores y el soporte para manejo multiempresa entre otros aspectos igualmente importantes Se destaca que el lector de este manual debe tener un perfil sist mico avanzado TSouth 8 CDT Consultores Versi n liberada el 01 10 2011 StSrFERNS StartFrame Net Framework Manual T cnico net Framework versi n 1 10 2011 STARTFRAME NET FRAMEWORK Manual T cnico NDICE GENERAL Contenido A O 1 Int a a a tattoos 3 Procedimiento General de Instalici seccion pros nace ion iden saaa nie a baei aaRS des 4 A acses a N A E EEE EES NSS 4 2 Plantilla de Solucion ote anat 4 3 BASADAS roosrossiisigs adiens eean i eii s abi Ea ia SaaS O ARES 4 A USO o ap E ad 4 5 Eontiguracion cial oda o anio ias 5 Configuraci n AVANZA dA iii E E A a ia adas 7 Actualizacion ins caca 9 A s eree ona a Ee a EO EEE EEO E EE Ea E EEE AEEA 11 Componentes POCA A A E E 11 Contenido delos COMPONENtES seserinis esee III iiO Ain ATENEO AEn 12 ESTRUCLUA FSICA pora 12 A sasina anae aa arai nEn ea TOn E A
8. a sin las Pm Mal comillas Dicha clave p blica se encuentra a olaveacosso compilada dentro de la aplicaci n en la propiedad Clave clavepublica KEY de la clase Common Env la cual podr ser modificada si lo desea Texto encriptado 242EhzsEk3idH20U 0gwS9I99IGBBS5qv Texto desencriptado elaveacceso Encriptar 50 5 E a F Eh i 5 AR e StartFrame Net Framework Manual T cnico Jl net Framework versi n 1 10 2011 Dependiendo del tipo de plantilla instalada es posible que el o los archivos de configuraci n posean atributos con rutas absolutas o relativas a ciertas carpetas del aplicativo Si este fuera el caso verifique las mencionadas rutas En caso de utilizar Remoting como medio de comunicaci n inter capas referirse al cap tulo Remoting para configurarlo apropiadamente En el caso de la plantilla Web App si desea utilizar la seguridad por forms deber tambi n establecer la cadena de conexi n con el modelo de seguridad interno de ASP Net el cual reside en el elemento SqiServices dentro de lt connectionStrings gt La forma de configurar dicha cadena de conexi n es est ndar y tiene la posibilidad de almacenarla en forma encriptada lt connectionStrings configProtectionProvider CustomProvider gt lt EncryptedData Type http www w3 org 2001 04 xmlencfElement xmlns http www w3 org 2001 04 xmlenc gt lt EncryptionMethod Algorithm http www w3 org 2001 04 xmlencttripledes cbc gt
9. a empresa a la cual se encuentra conectado puede visualizar la barra de estado del formulario principal de cada m dulo Para realizar la misma verificaci n pero del lado de la aplicaci n servidora puede utilizar los comandos Cnn o Bd Servidor E F I Sesi n 1 Terminal 1 Sesi n 1 e Sesi n 1 5 2 Sl e Sesi n 2 Sesi n 2 Base de Datos 1 Base de Datos 2 Terminal 2 e Sesi n 1 e Sesi n 2 El esquema anterior ilustra c mo cada terminal del usuario puede tener tantas sesiones del sistema como desee seg n se hayan previamente instalado y configurado cada una apuntando a una nica base de datos empresa siempre a trav s de la misma aplicaci n servidora de reglas del negocio aunque residan todas en un nico servidor de red sin posibilidad de modificar dicha condici n 240 StartFrame Net Framework Manual T cnico versi n 1 10 2011 met Framework TEST DRIVEN DEVELOPMENT TDD StartFrame permite el desarrollo orientado al testing TDD De hecho varios componentes del producto cuentan con completos test de unidad que garantizan su calidad y estabilidad ante cambios y actualizaciones de versiones En caso de que necesite levantar los objetos de negocios de StartFrame para loguearse y acceder al motor de base de datos o bien a las reglas del negocio deber seguir los siguientes pasos 1 Crear un nuevo proyecto de testing para la clase o librer a deseada 2 A
10. able del producto Pueden utilizarse code snippets para agregar nuevas entradas en este archivo lt configuration gt lt appSettings gt lt add key test value provider SOLOLEDB 1 data source SERVEROV database StartFrame user id pRWPb11d2U0 password 5SNDTwZBROFf1URc1N2x3jg gt lt lt add key spconfigpath value C lDesarrollo1NETAStartFramelAsemblies1ServerY gt gt lt add key serverusr value ADMINISTRADOR gt lt add key eventlog value true gt lt appSettings gt lt system runtime remoting gt lt application name Server gt lt channels gt lt channel ref E port m 1 gt lt channels gt lt service gt lt wellknown mode Singleton type StartFrame SqlHelper BR objectUri Sql gt lt wellknown mode Singleton type StartFrame BR Sca BR objectUri Sca gt lt wellknown mode Singleton type StartFrame BR Abm BR objectUri Abm gt lt service gt lt application gt lt system runtime remoting gt lt configuration gt b Server SPMCServer Estas aplicaciones hacen de HOST para los objetos de negocios La primera de ellas funciona como una aplicaci n de consola mientras que la segunda como un servicio Puede utilizarse cualquiera de las dos Ambas pueden ser reemplazadas por el uso de Internet Information Server IIS 2 P ss A it Gj Si el componente de negocios se levanta como servicio el archivo de configuraci n utilizado es SPMCServer exe c
11. adores para aquellos operadores de los cuales se desea llevar un registro de transacciones realizadas se puede decidir qu usuarios llevar n tracking y cu les no lo har n 3 Los objetos de negocios que lleven auditor a deber n configurar con el valor VERDADERO la propiedad Tracking De esta forma se puede decidir de qu objetos se llevar un tracking de su utilizaci n Cualquier cambio realizado en los par metros anteriores toma efecto al iniciar una nueva sesi n en el sistema Existe una funcionalidad en el m dulo de utilitarios de StartFrame en su interfaz de administraci n desktop que sirve para visualizar imprimir y depurar el tracking de transacciones Se recomienda consultar imprimir archivar y depurar esta informaci n con cierta periodicidad 210 StartFrame Net Framework Manual T cnico net Framework versi n 1 10 2011 CONTROL DE ERRORES El mecanismo de control de errores es est ndar en todas las plantillas de StartFrame Los mismos son manejados como excepciones de forma tal que un error no pueda pasar desapercibido ya que si no se intercepta la aplicaci n pincha Cada vez que se produce un error se utiliza el m todo LogError para registrar dicho suceso en el log de errores del sistema que no es otra cosa que la tabla wap_log_errrores y opcionalmente el visor de sucesos de Windows Los datos almacenados son e Fecha y hora del error ocurrido e C digo interno del proceso que lo gener sue
12. ando la aplicaci n Este par metro es obligatorio en los casos de aplicaciones que ejecutan con objetos residentes en carpetas temporales de Windows Cualquier ruta de red v lida o bien puede comentarse todo este tag para que no se actualice el sistema autom ticamente e Normal e Maximized e PorDefecto e Normal e Flat e Gris e FlatGris e True e False e 1 Maximized e 2 Normal Cualquier entero mayor a 800 600 y menor a la resoluci n m xima del monitor Cualquier entero que represente un par de coordenadas de pantalla Cualquier direcci n de mail v lida Cualquier ruta de red v lida con 70 StartFrame Net Framework Manual T cnico net Framework lt PathLogs gt lt Intervalo gt lt freeRegistration gt lt SqlServices gt asociada donde la aplicaci n dejar los logs de procesamiento Utilizado en las plantillas de ejecuci n de procesos del lado del servidor y de servicios Cantidad de minutos en la frecuencia de ejecuci n de los servicios Windows Indica si es o no posible crear nuevos usuarios sin estar previamente logueado a la aplicaci n utilizado en la plantilla Web Cadena de conexi n para el modelo de datos de seguridad interna por forms de ASP Net versi n 1 10 2011 permisos de escritura Cualquier entero mayor a 0 e On permite crear nuevos usuarios aunque no est logueado en la aplicaci n e Off s lo logue ndose a la aplicaci n se puede cre
13. ar un nuevo usuario Cadena de conexi n a la base de datos modelo 80 StartFrame Net Framework Manual T cnico met aran versi n 1 10 2011 Actualizaciones La distribuci n deployment de los componentes de una determinada soluci n creada con StartFrame depender de la arquitectura elegida Esto ltimo condiciona la forma en que dicha aplicaci n deber ser actualizada Para el caso de la arquitectura N Tiers en Windows Desktop el servidor deber bajarse ya sea en modo consola o servicio para poder actualizar las DLLs que utiliza El cliente en cambio puede ser actualizado en forma semiautom tica Esto se logra copiando a la carpeta referenciada por el par metro lt ActPath gt dentro del archivo de configuraci n local todos los archivos que deban ser actualizados El programa US loader exe se encargar de actualizar todos los archivos que sean m s nuevos que la versi n instalada en la terminal del cliente cuando vuelvan a ingresar al sistema Se recomienda tener cuidado con los archivos de configuraci n que poseen par metros que apuntan a otros equipos ya que cualquier cambio podr a hacer que la aplicaci n no funcione como se esperaba que apunte a otro servidor de reglas de negocio o a otro motor de base de datos Para los usuarios los mencionados procesos son transparentes Para el caso de la arquitectura Web App existen algunos archivos que podr an publicarse copiarse sin bajar el servidor Web pero para ot
14. car la soluci n en un IIS Internet Information Services correctamente configurado en un entorno de producci n En un entorno de desarrollo puede ejecutar la aplicaci n dentro de Visual Studio en su localhost 3 Base de Datos Como se explicar detalladamente en el cap tulo Conexi n a la Base de Datos StartFrame trae un modelo de datos para soportar el esquema de seguridad diccionario de datos y otras funcionalidades que requieren persistencia de almacenamiento Este paso de la instalaci n el cual est desarrollado en el archivo Leame txt consiste en implementar dicho modelo de datos Para instalar el mismo deber realizarse un restore de la base de datos modelo o bien correrse los scripts que provee el instalador de los prerequisitos de StartFrame 4 Usuario Dependiendo de la plantilla de soluci n a utilizar este paso podr a no ser necesario El mismo consiste en dar de alta un usuario dentro del esquema de seguridad de StartFrame para poder ejecutar la soluci n El archivo Leame txt brinda instrucciones a este respecto En el caso de la plantilla Web App la aplicaci n est configurada por defecto para permitir registrar nuevos usuarios sin estar logueado a la misma 40 E E a F Ef fi B AR a StartFrame Net Framework Manual T cnico versi n 1 10 2011 net Framework 5 Configuraci n Inicial Este ltimo paso consiste en modificar los archivos de configuraci n de la aplicaci n cuyo nombre y formato partic
15. detallado 1 US Servicios de usuario user services desktop Est conformado por una serie de elementos que posibilitan la interfaz con el usuario a trav s de plantillas base para crear diferentes tipos de interfaces con el usuario di logos personalizables y controles vinculados a datos 2 Web dem anterior pero aplicado a las interfaces Web del tipo ASP Net Contiene adem s todos los elementos del entorno para configurar la aplicaci n temas archivos de configuraci n p ginas maestras p ginas de administraci n p ginas del usuario librer as adicionales scripts etc 3 LnkControls Librer a de controles de usuario desktop WebParts Librer a de controles Web los cuales pueden adicionarse a cualquier p gina HTML 5 SystemFunctions Librer a de rutinas est ndares para manipulaci n de cadenas n meros fechas archivos mails etc 6 Common Componente com n para todas las capas de una soluci n conteniendo propiedades generales utilizables por toda la aplicaci n 7 BR Reglas del negocio business rules aplicables a cualquier modelo de soluci n corriendo del lado del servidor Contiene una serie de clases abstractas para crear diferentes tipos de objetos clases responsables de la seguridad interna del sistema funciones de auditor a diccionarios de datos utilidades varias 8 BR Web Objetos con las reglas del negocio vinculadas a las p ginas de la aplicaci n Web No se trata del code behing de cada p g
16. e Soluci n Al crear un nuevo proyecto basado en un template provisto por StartFrame se crea una soluci n conteniendo uno o m s proyectos adecuadamente configurados y que podr tomar como base para construir su aplicaci n sobre dicha estructura Si utiliz la plantilla de Servicio Windows deber configurarse para que inicie autom ticamente cuando arranque el servidor El servicio se puede instalar por medio de la aplicaci n InstallUtil exe que se encuentra en la carpeta C WINDOWS Microsoft NET Frameworklv donde la ltima carpeta depende de la versi n del Framework en ejecuci n La sintaxis para instalar el servicio es InstallUtil NombreServicio exe ejecutado desde el Command Prompt de Net Para desinstalarlo simplemente agregarle el par metro Yu al comando anterior Una vez instalado el servicio es prudente verificar su configuraci n cuenta utilizada tipo de inicio etc Cualquier error que genere el mencionado servicio podr verse en el visor de sucesos de la aplicaci n En caso de que se desee correr m s de un servicio en el mismo servidor debido a que existe m s de una instancia del sistema se deber recompilar este ejecutable cambiando las siguientes propiedades o Installer1 vb gt Servicelnstaller1 ServiceName nombreServicio o Installer1 vb gt Servicelnstaller1 DisplayName Descrip Del Servicio Por otro lado si la plantilla a utilizar fuera la aplicaci n Web podr publi
17. e de los diccionarios de datos del sistema 3 Men s por razones t cnicas no se utiliz el archivo de recursos para nominar las etiquetas de los men s sino que se utiliz un archivo XML asociado a cada men los cuales se encuentran en la carpeta SharedSources 4 Reportes por los mismos motivos que en el punto anterior los reportes deber n convertirse por separado Archivo de Recursos El archivo de recursos es un repositorio de im genes y textos Esto sirve para centralizar en un nico lugar toda la informaci n del tipo mencionado La cultura utilizada en cada equipo determina el nombre del archivo de recursos En un principio StartFrame posee un archivo de recursos para la cultura de idioma espa ol de Argentina es AR y otro para la cultura neutra El sistema maneja dos archivos de recursos diferentes e LNKfrmwrk lt cultura gt resources archivo de recursos utilizado por StartFrame el cual se encuentra embebido dentro del componente Common dl e App lt cultura gt resources archivo de recursos utilizado por las aplicaciones desarrolladas utilizando StartFrame Este archivo se encuentra en la misma ubicaci n que el anterior Es mediante estos archivos de recursos como se consigue personalizar la interfaz de StartFrame Puede utilizar los mismos como base para generar su om nimo en otras culturas 170 StrFSRNS StartFrame Net Framework Manual T cnico net Framework versi n 1 10 2011 SISTEMA DE SEGURIDAD
18. gregar a dicho proyecto un archivo de configuraci n App config que contenga las siguientes etiquetas lt configuration gt lt appSettings gt lt add key test value data source provider SQLOEEDS AL lt add key serverusr value lt add key spconfigpath value lt appSettings gt lt configuration gt SharedSources gt 3 Agregar la clase AppInit que se encuentra dentro del proyecto UT_DA dentro de nit vb en realidad basta con copiar ese archivo VB a la carpeta del proyecto e incluirlo Esta clase tiene un m todo para levantar StartFrame utilizando el operador indicado en el App config 4 Utilizar el m todo provisto por el test de unidad para inicializar el entorno de testing poniendo el siguiente c digo que llame al procedimiento anterior lt ClassInitialize gt _ Public Shared Sub MyClassInitialize ByVal testContext As TestContext Instancia el Fwrk logueando a un operador gen rico Dim init As New Applnit Init Inicializar End Sub 5 Utilizar el m todo provisto por el test de unidad para limpiar el entorno de testing ingresando lo siguiente lt ClassCleanup gt _ Public Shared Sub MyClassCleanup Dim sca As New StartFrame BR Sca sca Logout Common Env Operador sca Nothing End Sub 250
19. ina sino del componente de negocio en s 9 DA Acceso a datos data access Permite el acceso de lectura escritura a cualquier motor de base de datos a trav s de ADO Net Cada componente antes mencionado est formado por una o m s librer as Se unific la lista precedente a efectos de ganar en claridad Estructura F sica La estructura f sica de la aplicaci n est vinculada al tipo de soluci n implementada aplicando las mejores pr cticas en cada caso 120 5 E 9 F Ef i 5 AR e StartFrame Net Framework Manual T cnico net Framework versi n 1 10 2011 Comunicaci n Interna Al igual que la estructura l gica y f sica la modalidad interna de comunicaci n de los componentes de StartFrame depende de la arquitectura de la aplicaci n que lo consuma En un entorno LAN se utiliza Remoting por ser la opci n m s r pida para esta plataforma En una Aplicaci n Web del lado del servidor se instancian las clases en forma directa Si desea una mayor interoperabilidad deber crear un proyecto del tipo WCF para sus soluciones StartFrame soporta cualquier modelo de comunicaci n En un entorno Web la comunicaci n entre las p ginas html desplegado en el explorador y el c digo del lado del servidor es responsabilidad de la tecnolog a Web en general y la arquitectura de ASP est ndar en particular En cuanto a la comunicaci n del code behing con los componentes de negocios y las librer as de StartFrame se realiza e
20. jecutable del producto Pueden utilizarse code snippets para agregar nuevas entradas en este archivo lt configuration gt lt system runtime remoting gt lt application gt lt client url E6po IGESIMOSENIZad gt lt wellknown type StartFrame BR Interfaces ISql IBR url Sql 7 gt lt wellknown type StartFrame BR Interfaces ISca IBR url Bea gt lt wellknown type StartFrame BR Interfaces IAbm IBR url Abm gt lt client gt lt application gt lt system runtime remoting gt lt configuration gt b RemotingHelper Componente a trav s del cual se instancian todas las clases de la capa de negocios Internamente para obtener una referencia al objeto de negocios se 130 5 E 9 F Ef i 5 AR e StartFrame Net Framework Manual T cnico net Framework versi n 1 10 2011 basa en la informaci n de la interfaz definida en el archivo antes mencionado Pueden utilizarse code snippets que faciliten la escritura de este c digo Dim _Sql As ISql _Sgl CType RemotingHelper getObject Get Type ISq1 ISql 2 Elementos del lado del servidor a Server exe config Archivo XML similar al residente en el cliente pero conteniendo informaci n sobre el canal de comunicaci n utilizado por defecto TCP un puerto y la lista de interfaces objetos de negocios y forma de instanciarlos Este archivo se encuentra en la carpeta SharedSources y compila al mismo directorio que el ejecut
21. le ser el nombre del programa o el nombre de la clase m todo e Nombre de la terminal en que se produjo el error e C digo del operador que estaba logueado cuando se produjo el error e C digo interno del error interceptado seg n la codificaci n vigente en wap_errores e Descripci n adicional del error Luego de registrar el error en el log se propaga la excepci n a la capa superior la cual tratar al error de la misma forma antes descripta As se contin a hasta llegar a la capa de usuario Esta ltima utilizar el m todo ShowError en entornos desktop o la p gina GenericErrors en entornos Web para informar al usuario del error ocurrido con toda la informaci n adicional que pudiera reunir al respecto ESQUEMA MULTIEMPRESA EN ENTORNOS DESKTOP StartFrame brinda un mecanismo alternativo para soportar un manejo multiempresa en entornos desktop el cual podr o no ser adecuado seg n cada caso en particular Para implementar el mismo se asume que se utilizar una base de datos independiente por cada empresa Por ello cada vez que se decide cambiar de empresa activa esto implica modificar la conexi n a la base de datos previo al cierre de todas las conexiones en uso Este sistema est dise ado para soportar el manejo multiempresa de dos diferentes formas 1 Con procesamiento local 2 Con procesamiento distribuido Como ya se mencion la arquitectura b sica de la soluci n est formada por dos partes principales u
22. lista Char yl No _logico Bit 1 No 0 _memo Text 16 Si _nombre Varchar 50 Si _porcentaje Numeric 6 2 No 0 150 Star lrarnne StartFrame Net Framework Manual T cnico net Framework versi n 1 10 2011 Procedimientos Almacenados Existen varios m todos para ejecutar procedimientos almacenados dependiendo del tipo de resultado que el procedimiento arroje e Dataset e Datareader e Verdadero o falso e Par metros de salida El tipo de dato de los par metros de cada procedimiento se obtiene directamente del motor de base de datos 160 StartFrame Net Framework Manual T cnico net Framework versi n 1 10 2011 APLICACI N MULTICULTURAL Con la finalidad de poder migrar la aplicaci n a diferentes culturas se tomaron ciertos recaudos con respecto a cualquier mensaje del sistema hacia la interfaz del usuario De esta forma existen nicamente cuatro elementos que habr a que convertir si se desea migrar el sistema a otra cultura a saber 1 Archivo de Recursos ste responde a la cultura e idioma seleccionados en la configuraci n regional del panel de controles de Windows En dicho archivo se almacenan conos t tulos de formularios p ginas y grillas textos de etiquetas y botones mensajes al usuario tooltips etc En el caso de la arquitectura Web App esta informaci n est contenida en los temas con skins y Style Sheets 2 Documentaci n est formada por la documentaci n de ayuda en l nea provenient
23. mon Env Operador sNombreOperador Common Env Password sClaveAcceso Obtiene parametros y Carga las prop de Common Dim parametros As String EMPRESA APPNAME VERSION Dim param As New StartFrame BR Utilitarios Parametros Dim valores As String param getParametro parametros Split c Common Env Empresa valores 0 Common Env AppName valores 1 Common Env AppVersion valores 2 Logueo exitoso Return True Else Error en logueo Return False End If Else No existe el operador Return False End If Catch ex As Exception Error al intentar loguearse al Fwrk Return False End Try End Function 190 StartFrame Net Framework Manual T cnico met arnes versi n 1 10 2011 Opcionalmente en caso de que desee loguearse a StartFrame utilizando un usuario gen rico porque por ejemplo ya se valid al usuario logueado con su clave contra el modelo ASP NET o contra el Active Directory puede utilizarse este c digo para obtener la clave del mencionado usuario a pasarle al m todo EsUnOperadorValido antes demostrado Obtiene el password y lo desencripta porque ya se autentic en ASP NET sClaveAcceso CType Sql Search ConnectionString va clave acceso wad operadores cd operador SystemFunctions Strings StringToSql sNombreOperador String If sClaveAcceso lt gt Then sClaveAcceso SystemFunctions Strings EncryptString sClaveAcceso KEY SystemFunctions Strings Accion DEC
24. n forma local instanciando las clases directamente sin mediar ning n componente intermedio logrando una ptima velocidad de respuesta Con respecto a la comunicaci n con la base de datos se utiliza ADO Net con OLEDB provider para lograr una mayor flexibilidad En caso de optar por utilizar alg n motor de base de datos diferente a SQL Server la opci n por defecto tan solo deber modificar en la cadena de conexi n el nombre del OLEDB provider actual por el proveedor adecuado Esta acci n incluso puede realizarse en runtime sin necesidad de adaptar una sola l nea de c digo Remoting Como se dijo anteriormente por una decisi n de performance se opt por utilizar Remoting como medio de comunicaci n de los componentes en entornos LAN distribuidos cuando la l gica de negocios se encuentra corriendo en un equipo diferente al que contiene el ejecutable local de la interfaz del usuario Este esquema de comunicaci n cuenta con componentes del lado del cliente y del lado del servidor a saber 1 Elementos del lado del cliente a US ini exe config Archivo XML que contiene la informaci n sobre la configuraci n y la definici n de cada interfaz que utiliza con la ubicaci n del objeto de negocios que la implementa Este modelo de configuraci n permite redirigir en grandes redes las diferentes terminales a distintos servidores de negocios Este archivo se encuentra en la carpeta SharedSources y compila al mismo directorio que el e
25. na aplicaci n cliente conteniendo el front end del usuario y una aplicaci n servidora conteniendo las reglas del negocio y mecanismos de acceso a datos Los dos modelos multiempresa antes mencionados difieren por la forma en que se configuran y distribuyen las mencionadas aplicaciones dentro de la red 220 StartFrame Net Framework Manual T cnico net Framework versi n 1 10 2011 Esquema de Procesamiento Local Esto significa que tanto la aplicaci n cliente como la servidora deber n residir en la terminal del cliente Si bien los archivos de configuraci n deber n apuntar a una determinada base de datos por defecto con este esquema el usuario est en libertad de utilizar la funcionalidad Selectora de Empresa ofrecida dentro del men Archivo de cada m dulo para seleccionar la empresa con la cual desea trabajar Esto puede hacerlo cada vez que ingresa a un m dulo aunque todos los m dulos deben apuntar a la misma empresa Tenga presente que cada vez que seleccione una empresa diferente todos los m dulos se cerrar n Esto no incluye al Selector de M dulos el cual permanecer abierto Para verificar en la aplicaci n cliente la empresa a la cual se encuentra conectado puede verificar la barra de estado del formulario principal de cada m dulo Sin embargo note que esta barra de estado se carga cada vez que se carga el m dulo Para realizar la misma verificaci n pero del lado de la aplicaci n servidora puede utilizar los c
26. ngrese siempre una clave de acceso para reconocer la validez de un usuario Utilizando BR desde otras plantillas El siguiente estracto de c digo es un ejemplo de c mo instanciar las reglas de negocio de StartFrame en cualquier plantilla de soluci n Deber insertar el siguiente c digo en el primer evento que levante la aplicaci n Verifica si es un operador valido y lo registra en el Fwrk If Not EsUnOperadorValido sNombreOperador sClave Then MsgBox El usuario sNombreOperador _ no est correctamente habilitado para utilizar la aplicaci n MsgBoxStyle Critical MsgBoxStyle Ok0nly End If Toda la secuencia de control necesaria para validar el operador se encuentra en el siguiente m todo el cual es invocado por el c digo anterior M todo que e encarga de loguear a un operador dentro de StartFrame NombreOperador Operador a loguear seg n se haya registrado en StartFrame Clave Clave de acceso de NombreOperador seg n se haya registrado en StartFrame Private Function EsUnOperadorValido ByVal NombreOperador As String _ ByVal Clave As String As Boolean Dim sNombreOperador As String NombreOperador Dim sClaveAcceso As String Clave Componente de seguridad Dim sca As New TEY Verifica si existe el operador dentro del sistema If sca ExisteOperador sNombreOperador Then Verifica si es un usuario v lido If 5ca Login sNombreOperador sClaveAcceso Then Propiedades de la Common Com
27. omandos Cnn o Bd Existe una tabla wap_empresas en cada base de datos que es la que contiene el nombre de cada empresa y la conexi n a utilizar Esto es lo que le permitir navegar entre empresas erminal Semidonmes Sesi n nica y Sase de Datos 1 Terminal Servidor 2 Pals Base de Datos 2 El esquema anterior ilustra c mo cada terminal del usuario y servidor al mismo tiempo puede tener una nica sesi n abierta del sistema al mismo tiempo y esta apunta a una nica base de datos empresa pero en cualquier momento puede cambiar de base de datos 230 StartFrame Net Framework Manual T cnico net Framework versi n 1 10 2011 Esquema de Procesamiento Distribuido Esto significa que aunque la aplicaci n cliente resida en cada terminal la aplicaci n servidora se encontrar en un determinado servidor de red La diferencia est en que podr n existir tantas aplicaciones cliente como empresas vayan a utilizarse quedando sin efecto el anteriormente mencionado Selector de Empresas debido a que cada aplicaci n cliente apuntar a una determinada base de datos y a una determinada aplicaci n servidora mediante el uso de sus archivos de configuraci n Es decir que tambi n en el servidor de red existir n tantas aplicaciones servidoras como empresas se deseen utilizar Esto es posible debido a la modalidad de configuraci n de Remoting utilizando un puerto para cada sesi n Para verificar en la aplicaci n cliente l
28. onfig 140 StrFSRNS StartFrame Net Framework Manual T cnico net Framework versi n 1 10 2011 CONEXI N A LA BASE DE DATOS Si bien StartFrame puede conectarse a cualquier DBMS est ndar el mismo trae un modelo de datos elemental para soportar el esquema de seguridad interno la personalizaci n de la interfaz y el diccionario de datos El motor de base de datos utilizado para la versi n est ndar es SQL Server Express Edition por considerarse no s lo un est ndar gratuito y de f cil utilizaci n sino que tambi n posee una muy buena performance potencia y escalabilidad hacia ambientes corporativos m s robustos Si desea prescindir de dicho motor empleando otro DBMS deber migrar el mencionado modelo elemental de StartFrame tablas ndices y procedimientos almacenados Podr solicitar soporte en StartFrame Net para este tipo de conversiones Nuestro equipo de desarrollo ha probado con xito el producto con los siguientes motores Oracle PostgreSQL MySQL Para el caso de las tablas deber tener en cuenta que se utilizaron tipos de datos definidos por el usuario para estandarizar la estructura de las mismas a saber Nombre Tipo B sico Longitud Nulos Valor Predet _autonumerico Numeric ONO No _cantidad Numeric 123 No 0 _codigo Char 10 No _codigo_largo Char 20 No _descripcion Varchar 250 Si _entero Int 4 No 0 _fechahora Datetime 8 Si GetDate _imagen Image 16 Si _importe Numeric 16 6 No 0 _
29. os que determinan informaci n general la cadena de conexi n etc Cuando un desarrollador utiliza StartFrame como herramienta de desarrollo deber agregar todas las entradas necesarias para el uso de los componentes v a Remoting Es necesario respetar siempre la estructura general del archivo establecida por StartFrame El desarrollador deber agregar toda la informaci n necesaria sin alterar ni eliminar la informaci n existente Common Este proyecto es parte integral de StartFrame y la v a de comunicaci n del mismo con la aplicaci n generada El mismo se instala y referencia a nivel proyecto incluido en la soluci n porque es necesario que el desarrollador pueda modificar e App resources archivo de recursos de la aplicaci n el cual puede ser tocado libremente 90 StartFrame Net Framework Manual T cnico net Framework versi n 1 10 2011 e Common Start contiene eventos que pueden ser interceptados en la soluci n cada vez que se inicia un m dulo se cierra el mismo o se selecciona una opci n del men No deber tocarse el resto del proyecto 100 gerre StartFrame Net Framework Manual T cnico net Framework versi n 1 10 2011 ARQUITECTURA La arquitectura interna del producto responde a la base tecnol gica establecida por la aplicaci n de las mejores pr cticas sobre la plataforma Microsoft dotNet B sicamente StartFrame ofrece una serie de componentes reutilizables combinados en diferentes modelo
30. r puede entrar a cualquier funcionalidad del sistema incluso a la configuraci n de la seguridad interna e Supervisor puede realizar cualquier tarea que no tenga que ver con la administraci n del sistema en s 200 StartFrame Net Framework Manual T cnico net Framework versi n 1 10 2011 e Modificaci n de datos puede dar altas bajas y modificaciones de datos en cualquier objeto del sistema e Consulta de informaci n puede consultar informaci n por pantalla impresora o exportarla Por otro lado existen una serie de programas o clases que no son otra cosa que funcionalidades ofrecidas por el sistema en forma de clases con m todos propiedades y eventos Dichos programas o clases se combinan con los grupos para establecer una tabla de accesos wld_acceso_programas Los accesos se constituyen en la forma de permisos de cuatro diferentes clases e Ingreso tiene permitido instanciar el componente pero no ejecutar ninguna funcionalidad del mismo salvo consultar informaci n e Alta Ejecuci n puede ingresar nuevos registros s lo aplicable a los abms e Baja puede eliminar registros s lo aplicable a los abms e Modificaci n puede realizar modificaciones de registros s lo aplicable a los abms Ahora bien una vez que un usuario se registr apropiadamente en el sistema e instanci el componente deseado se verificar si el mismo posee privilegio para ingresar al tipo de programa o funcionalidad que desea in
31. ros ser necesario detener el mismo Esto depende m s de IIS y la arquitectura de ASP Net que StartFrame en s Con respecto a las actualizaciones del producto StartFrame al ser una extensi n de Visual Studio la misma se actualiza autom ticamente Esto incluye no s lo la documentaci n code snippets y dem s funcionalidades de StartFrame sino tambi n los templates para crear nuevas soluciones Ahora bien las soluciones ya construidas con versiones anteriores de StartFrame podr n ser actualizadas mediante Service Packs conteniendo instrucciones detalladas que deber n seguirse Por lo general bastar con ejecutar el Service Pack para copiar los nuevos componentes de StartFrame a las correspondientes carpetas SharedSources y SharedBinaries y luego recompilar la soluci n Sin embargo hay que tener en cuenta que StartFrame est formado por algunos archivos adicionales de soporte que se encargan de tareas de configuraci n config menu xml Algunos de ellos pueden ser sobreescritos directamente ya que el desarrollador nunca debe modificarlos En tanto que otros componentes deber n ser tratados con sumo cuidado debido a que los mismos podr n ser modificados tanto en StartFrame como en la aplicaci n desarrollada en base al mismo a saber Componente Observaciones config Estos archivos de configuraci n contienen las entradas necesarias para la configuraci n de Remoting para las arquitecturas N Tiers adem s de varios par metr
32. s de soluci n a saber Cada arquitectura antes mencionada admite una o m s plantillas diferentes Por ejemplo para la arquitectura desktop pueden utilizarse plantillas para crear una aplicaci n WinForms o Silverligth para la arquitectura Web puede utilizarse la plantilla de aplicaci n ASP o Silverlight para los servicios pueden ser Win Services o Web Services Los diferentes modelos de soluci n pueden implementarse a trav s del uso de plantillas dise adas a tal fin La estructura f sica y l gica de cada modelo est ntimamente relacionada al dise o de dicha plantilla Sin embargo los componentes que lo conforman se mantienen en forma constante independientemente de la arquitectura de la soluci n Componentes por Capa Si bien la cantidad de capas de una soluci n depende de la arquitectura de la misma podemos clasificar en forma gen rica sin ser tan estrictos los componentes en tres capas bien diferenciadas Cliente Servidor Datos US Web LnkControls WebParts System Functions System Functions Common Common 110 StartFrame Net Framework Manual T cnico net Framework versi n 1 10 2011 Contenido de los Componentes Se describe a continuaci n en forma gen rica el contenido de cada componente antes mencionado Podr encontrar una completa descripci n de cada elemento de StartFrame en los diagramas de clase en el modelo UML de StartFrame y en las especificaciones de dise o
33. se cargan las propiedades Operador y Password Por otro lado la propiedad Connection de la clase SQL del componente DA retorna siempre un nuevo objeto del tipo OLEDBconnection Conexi n al Sistema logueo En una arquitectura desktop StartFrame levanta el operador desde el sistema operativo y su clave de acceso desde la base de datos del sistema Con esos datos instancia el m todo Login de las reglas del negocio miembro del componente BR SCA Este se encarga de validar al usuario dentro de las tablas de seguridad wad_operadores y wld_miembros_grupo de la base de datos del sistema Si todo est en orden el acceso es permitido En tal caso carga las propiedades Operador y Password dentro del componente Common Env Si por el contrario se encuentra alg n problema o inconsistencia el acceso es denegado Si en lugar de utilizar el front end desktop del sistema se utiliza uno diferente web servicio etc debe llamarse al m todo Login anteriormente mencionado pas ndole como par metros el operador que intenta conectarse al sistema y su clave de acceso A partir de aqu el procedimiento es igual al 180 5 E a F Eh i 5 AR e StartFrame Net Framework Manual T cnico versi n 1 10 2011 net Framework anteriormente descripto Dado que el sistema es una aplicaci n multicapas las reglas de negocio donde reside el mecanismo de seguridad son independientes del front end utilizado en cada caso Por ello es necesario que se i
34. stanciar Si se pasa este control se verificar si dicho usuario tiene permiso para acceder al programa o funcionalidad en particular Si este control es superado se contin a normalmente Caso contrario no se permite instanciar el objeto Una vez instanciada exitosamente la clase programa cuando se intente ejecutar alg n m todo de la misma se verificar si el usuario tiene permiso para realizar dicha operaci n Auditor a El sistema de auditor a interna consiste en la generaci n de un tracking o pistas de auditor a que se graban en una tabla interna tipo log wap_tracking de todas las altas bajas y modificaciones de registros ejecuciones de procesos accesos a funcionalidades consultas realizadas etc que el operador realice En dicha tabla se graban datos tales como la fecha y hora de la operaci n el operador el nombre del programa y tabla utilizados el tipo de operaci n realizada y los datos afectados Dado que el uso del tracking ocasiona una merma aunque menor en la performance del sistema y un notable incremento en el volumen de datos del mismo existe la posibilidad de habilitar el tracking total O parcialmente mediante los siguientes par metros de configuraci n 1 Configurando el par metro TRACKING de la tabla wap parametros se logra habilitar o inhabilitar el trancking en forma global para todos los operadores del sistema 2 Asignando el valor VERDADERO al campo st_tracking de la tabla wad_oper
35. ular var a seg n el tipo de plantilla de soluci n utilizada pero siempre se trata de uno o m s archivos XML con extensi n config B sicamente encontrar en los mencionados archivos un tag similar al siguiente lt configuration gt lt appSettings gt lt add key cnnkey value sqlcnn gt lt add key sqlcnn value provider SQLOLEDB 1 lt appSettings gt lt configuration gt En el primer tag cnnkey se indicar el tag que contendr la cadena de conexi n a utilizar Dentro del segundo deber modificar e El nombre del OLEDB Provider para conectarse al motor de base de datos por defecto incluye el provider para SQL Server e El nombre del host o servidor NombreHost donde est instalada la base de datos e Elnombre de la base de datos en s NombreBase e El nombre del usuario con acceso a dicha base por defecto es sa encriptado e La clave de acceso de dicho usuario por defecto es admin encriptado En caso de desea utilizar una conexi n con seguridad integrada al sistema operativo deber realizar los siguientes cambios en el tag antes mencionado lt configuration gt lt appSettings gt lt add key sqlcnn value provider SQLOLEDB 1 data source NombreHost database NombreBase lt appSettings gt lt configuration gt Para encriptar o desencriptar texto podr utilizar la aplicaci n provista en el men StartFrame utilizando la clave p blica cualquier
36. urcesYCustomKeys xml A continuaci n para desencriptar la cadena de conexi n deber ejecutar la siguiente l nea en la misma consola de Visual Studio El primer par metro luego del modificador indica la secci n del archivo Web config a desencriptar el segundo es la ruta de dicho archivo aspnet_regiis pdf connectionStrings D ADesarrolloWNetl lFuentesWebSite Luego de modificar la cadena de conexi n como ya se explic deber volver a encriptar dicha secci n dentro del web config ejecutando lo siguiente aspnet_regiis pef connectionStrings D ADesarrolloWWNetl 1FuentesWebSite prov CustomProvider 60 Miatiranne net Framework Configuraci n Avanzada Existen algunos tags en los archivos de configuraci n dentro de la secci n appSettings que podr a StartFrame Net Framework Manual T cnico versi n 1 10 2011 modificar para lograr personalizar la aplicaci n algunos tags son aplicables s lo a ciertas arquitecturas de soluci n a saber Tag lt serverusr gt lt eventlog gt lt spconfigpath gt lt ActPath gt lt EstadoAbms gt lt EstiloAbms gt lt ResizeGrillas gt lt WPMain Estado gt lt WPMain Largo gt lt WPMain Alto gt lt WPMain X gt lt WPMain Y gt lt MailErrores gt lt DirLogs gt Descripci n Nombre del usuario con el cual se levantar la aplicaci n en el server Indica si deber n registrarse sucesos en el
Download Pdf Manuals
Related Search