Desarrollo de sistema PuiPui

Transcripción

1 Desarrollo de sistema PuiPui El presente documento tiene como finalidad proporcionar una guía para que los desarrolladores del sistema PuiPui trabajen de manera estandarizada y siguiendo los patrones de diseño establecidos. Esta guía se presenta en las siguientes secciones: Configuración del entorno. Para el funcionamiento adecuado del esqueleto del sistema, se debe configurar el entorno siguiendo los siguientes pasos: Configuración del SQL Server 1) Abrir el SQL Server Configuration Manager e ir a las opciones SQL Server Network Configuration-> Protocols for MSSQLSERVER (buscar Configuration Manager en inicio para que aparezca allí en el menú)

2 2) En TCP/IP hacer click derecho y habilitarlo (Enable) y luego en Propiedades, en IP1, en el apartado dirección IP, escribir el IP de la maquina (abrir cmd y ejecutar el comando ipconfig para ver la dirección ip). 3) Luego pararse en SQL Server Services y hacer click derecho sobre SQL Server (MSSQLSERVER) y reiniciarlo (Restart).

3 4) Abrir SQL Server Management Studio y conectarse a la base de datos. 5) En el explorador de objetos, desplegar localhost, hacer click derecho en la carpeta Security y hacer click en new -> login.

4 6) Escribir PuiPui en el Login name. 7) Seleccionar SQL Server authentication. 8) Escribir la clave: ) Seleccionar, en default database, la base de datos creada a través de los scripts (puipuidbv1). 10) Hacer click en Ok.

5 11) Cambiar, en el archivo de Web.config de la aplicación PuiPuiCapaLogicaDeNegocios: escribir el ip de la computadora donde se encuentra alojada la base de datos en el parámetro de Data Source. NOTA: es posible que para la conexión remota a la base de datos deba desactivarse el firewall de Windows. Configuración de log4net 1) Modificar el archivo Web.config: cambiar la ruta de la configuración del Log4netConfigPath a la ruta donde se encuentra el archivo Log4netConfig.xml en la maquina local.

6 2) Modificar el archivo Log4netConfig.xml: cambiar la ruta del archivo de bitácora (log.txt) a la ruta deseada en la maquina local. Configuración de los servicios web (para el servidor de lógica) 1) En consola (ejecutada como administrador) escribir los siguientes comandos: 2) netsh http add urlacl url= de mi maquina:puerto/ user=everyone OJO: si la maquina esta en español, cambiar everyone por todos. 3) netsh advfirewall firewall add rule name="iisexpressweb" dir=in protocol=tcp localport=puerto profile=private remoteip=localsubnet action=allow 4) Buscar en Mis Documentos/IISExpress/config/applicationhost.config, en el apartado <Sites>, buscar el sitio PuiPuiLogicaDeNegocios y agregar el siguiente ítem entre los bindings: <binding protocol="http" bindinginformation="*:puerto:nombre de mi maquina" />

7 Estándares de programación. 1) Todas las clases abstractas empiezan por A y deben tener nombres descriptivos. Ejemplo: AEntidad 2) Todas las interfaces empiezan por I y deben tener nombres descriptivos. Ejemplo: IDAO 3) Los nombres de los atributos de las clases deben ser descriptivos, deben empezar por _ y deben implementar la notación camello a excepción de la primera letra. Ejemplo: _fechadereservacion; 4) Los métodos deben nombrarse como acciones (verbos en infinitivo). Ejemplo: ConsultarTodos(); 5) Todos los métodos y clases deben tener documentación XML. Ejemplo: 6) Ninguna línea de código de c# debe exceder los 80 caracteres. Ejemplo de longitud máxima:

8 7) En la implementación de los WebMethod sólo deben haber operaciones de comandos. Ejemplo: 8) En cuanto al retorno de los servicios web, debe retornarse siempre un string con formato XML. Ejemplo: 9) Siempre referirse a la clase más general posible al momento de hacer cualquier operación. Ejemplo:

9 Reglas del Repositorio. A continuación se listaran una serie de reglas para manejar el repositorio y los diferentes archivos que no podrán subirse al mismo, ya que podrá afectar las versiones locales de todos. Evitar subir archivos: obj/*, *.obj, *.dll, *.sln, *.exe, *.pdb, *.user, *.aps, *.pch, *.vspscc, *_i.c, *_p.c, *.ncb, *.suo, *.tlb, *.tlh, /*.bak.*, *.bak, *.cache, *.ilk, *.log, *.lib, *.sbr, *.scc, [Bb]in/*, [Db]ebug*/, obj/, [Rr]elease*/, _ReSharper*/, [Rr]esources/*, [Aa]ccounting/*, [Tt]est[Rr]esult*, [Bb]uild[Ll]og.*, *.[Pp]ublish.xml, [Tt]est[Rr]esults*/, ifix/content/productimages/*, [Rr]eports/*, thumbs.db, App_Data/*, tmp/, /*.user, /*.suo, /*.pidb, /*.userprefs, /*.usertasks, [Pp]roduct[Ii]mages/*, # NuGet, packages/, Web.config, Log4netConfig.xml.