SubGerencia Corporativa de Sistemas Especificación de Requerimientos de Software (ERS) Proyecto Sitios WEB Control de Versiones: Versión Elaborado Por: Nombre 1.0 Luis González Revisado Por: Fecha 26-04-2010 Nombre Andrés González Versión 1.0 Junio del 2010 Aprobado Por: Fecha 13-05-2010 Nombre Fecha SubGerencia Corporativa de Sistemas ÍNDICE. 1 OBJETIVOS..............................................................................................................................4 2 ALCANCE.................................................................................................................................4 3 ANÁLISIS DE SITIOS SIMILARES..........................................................................................4 4 SITIO AGUAS NUEVAS...........................................................................................................5 5 6 4.1 Sitio Actual. .....................................................................................................................5 4.2 Opciones Generales. ......................................................................................................6 4.3 Inicio................................................................................................................................6 4.4 Nosotros..........................................................................................................................7 4.5 Empresas Regionales.....................................................................................................7 4.6 Empresa Comprometida.................................................................................................7 4.7 Plan de Inversiones. .......................................................................................................7 4.8 Memoria Anual................................................................................................................7 4.9 Accionistas e Inversionistas............................................................................................8 SITIO ENERNUEVAS...............................................................................................................9 5.1 Sitio Actual. .....................................................................................................................9 5.2 Opciones Generales. ......................................................................................................9 5.3 Inicio................................................................................................................................9 5.4 Proyectos. .....................................................................................................................10 5.5 Licitaciones. ..................................................................................................................10 5.6 Presentaciones. ............................................................................................................10 SITIOS REGIONALES............................................................................................................11 6.1 Sitio Actual. ...................................................................................................................11 6.2 Opciones Generales. ....................................................................................................12 6.3 Inicio..............................................................................................................................13 6.4 Módulo: Empresa..........................................................................................................13 6.5 Módulo: Proveedores....................................................................................................14 6.6 Módulo: Inmobiliarias y Contratistas.............................................................................14 6.7 Módulo: Comunidad y RSE. .........................................................................................15 6.8 Módulo: Educación y Videos. .......................................................................................17 6.9 Módulo: Mi Cuenta........................................................................................................19 6.10 Módulo: Atención de Clientes. ......................................................................................21 7 DEFINICIÓN DE TIPOS..........................................................................................................22 7.1 Link Texto. ....................................................................................................................22 7.2 Link Icono......................................................................................................................22 7.3 Link PDF Simple. ..........................................................................................................22 7.4 Link PDF + Imagen. ......................................................................................................22 _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 2 SubGerencia Corporativa de Sistemas 7.5 Tabla + Link. .................................................................................................................23 7.6 Tabla + Imagen.............................................................................................................23 7.7 Link Compuesto. ...........................................................................................................24 7.8 Imagen. .........................................................................................................................24 7.9 Texto. ............................................................................................................................24 7.10 Imagen + Texto.............................................................................................................25 7.11 Link Icono + Imagen. ....................................................................................................25 7.12 Link Video. ....................................................................................................................26 7.13 WS (Web Service). .......................................................................................................26 8 OTROS REQUERIMIENTOS. ................................................................................................26 9 ACCESO A BASES DE DATOS. ...........................................................................................26 10 PROPUESTA GRÁFICA. .......................................................................................................27 _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 3 SubGerencia Corporativa de Sistemas 1 OBJETIVOS. Levantar las funcionalidades contempladas en los sitios Web del Grupo Aguas Nuevas. 2 3 ALCANCE. # Sitio Descripción 1 Aguas Nuevas Sitio corporativo del Grupo Aguas Nuevas. Énfasis: Organismos reguladores e inversionistas. 2 Enernuevas Empresa de energía del Grupo Aguas Nuevas. Énfasis: Descarga de información. 3 Empresas Regionales Empresas regionales del Grupo Aguas Nuevas. Énfasis: Clientes. ANÁLISIS DE SITIOS SIMILARES. El proveedor deberá entregar un documento con un breve estudio respecto a sitios similares al producto que se espera implementar (benchmark), con el fin de revisar de qué manera se han abordado los mismos problemas que se desean resolver. Esta actividad comparativa permitirá llegar a las “buenas prácticas” que es posible adaptar a las necesidades de Aguas Nuevas, con el fin de asegurar métodos de funcionamiento y despliegue de contenidos, que sean coherentes con los objetivos que se han planteado. _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 4 SubGerencia Corporativa de Sistemas 4 SITIO AGUAS NUEVAS. 4.1 Sitio Actual. En términos generales los contenidos del sitio actual se mantienen, sólo se incorpora la funcionalidad “Accionistas e Inversionistas”. _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 5 SubGerencia Corporativa de Sistemas 4.2 Opciones Generales. # Opción de Menú Descripción 1 Inicio Página de inicio del sitio de Aguas Nuevas (HOME). 2 Nosotros Información relativa a la empresa Aguas Nuevas. 3 Empresas Regionales Información relativa a empresas del Grupo Aguas Nuevas. 4 Empresa Comprometida Responsabilidad social empresarial. 5 Plan de Inversiones Inversiones de las empresas regionales. 6 Memoria Anual Memorias de la empresa. 7 Accionistas e Inversionistas Contempla información financiera, orientada a accionistas, inversionistas y público en general. 4.3 Inicio. # Opciones 1 Funcionalidades Emisión de Bonos 2007 Emisión de bonos 2007 Misión y objetivos 2 Información Societaria Información interés del mercado Estatutos sociales Información de interés Estructura de propiedad 4 Licitaciones 3 5 Links ADM Contenidos Tipo Link PDF+ Imagen Imagen + Texto Link PDF + Imagen Link Compuesto Link Compuesto No No No No Si Estructura de propiedad Imagen No Licitaciones HOME Volver (Atrás) Portal proveedores ANDESS Email Aguas Altiplano Aguas Araucanía Aguas Magallanes Tabla+Link Link Icono Link Icono Link Icono Link Icono Link Texto Link Icono Link Icono Link Icono Si N/A N/A N/A N/A N/A N/A N/A N/A _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 6 SubGerencia Corporativa de Sistemas 4.4 Nosotros. # Opciones Funcionalidades Misión y objetivos. Información de interés del mercado. 1 Nosotros Estatutos sociales. Información de interés. 4.5 Funcionalidades Empresas Regionales Link 2 Indicadores 1 4.7 No No Si Si Empresas Regionales. Link a imagen con indicadores de empresas regionales. ADM Contenidos Tipo Imagen + Texto Link Ícono + Imagen No No Empresa Comprometida. # Opciones 1 Imagen + Texto Link PDF + Imagen Link Compuesto Link Compuesto Empresas Regionales. # Opciones 4.6 ADM Contenidos Tipo Cultura y educación Funcionalidades Tipo Cultura y educación. Tabla + Imagen ADM Contenidos Si Plan de Inversiones. # Opciones Funcionalidades Tipo ADM Contenidos 1 Inversiones Inversiones. Texto Si Funcionalidades Tipo ADM Contenidos Memoria anual. Link PDF + Imagen 4.8 Memoria Anual. # Opciones 1 Memoria anual Si _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 7 SubGerencia Corporativa de Sistemas 4.9 Accionistas e Inversionistas. # Opciones 1 Tipo ADM Contenidos Información financiera Imagen + Texto Si Composición accionaria Imagen + Texto Si Dividendos Imagen + Texto Si Hechos esenciales Imagen + Texto Si Registro de accionistas Imagen + Texto Si Opinión de analistas Imagen + Texto Si Emisión de bonos Imagen + Texto Si Noticias Imagen + Texto Si Funcionalidades Accionistas e inversionistas _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 8 SubGerencia Corporativa de Sistemas 5 SITIO ENERNUEVAS. 5.1 Sitio Actual. 5.2 Opciones Generales. A continuación se detallan las opciones generales del sitio Web de EnerNuevas, éstas se desplegarán en la parte superior de la página, a continuación del logo institucional de la empresa. # Módulo Descripción 1 Inicio Página de inicio del sitio (HOME). 2 Proyectos Proyectos en desarrollo. 3 Licitaciones Licitaciones. 4 Presentaciones Presentaciones. 5.3 Inicio. # Opciones 1 Vínculos Tipo ADM Contenido Inicio Link Icono No Volver Link Icono No Contacto Link Icono No Aguas Nuevas Link Texto No Aguas Altiplano Link Texto No Aguas Araucanía Link Texto No Aguas Magallanes Link Texto No Funcionalidades _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 9 SubGerencia Corporativa de Sistemas 5.4 Proyectos. # Opciones Funcionalidades 1 Proyectos Proyectos Tipo ADM Contenido Tabla + Link Si Tipo ADM Contenido Tabla + Link Si Tipo ADM Contenido Tabla + Link Si Ejemplo: 5.5 Licitaciones. # Opciones Funcionalidades 1 Licitaciones Licitaciones Ejemplo: 5.6 Presentaciones. # Opciones Funcionalidades 1 Presentaciones Presentaciones Ejemplo: _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 10 SubGerencia Corporativa de Sistemas 6 SITIOS REGIONALES. 6.1 Sitio Actual. En términos generales, los sitios regionales del Grupo Aguas Nuevas deben tener una clara orientación al cliente. Los tres sitios regionales, en cuanto a diseño y funcionalidades serán clones, por lo tanto la única diferencia estará dada por lo contenidos de cada uno. _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 11 SubGerencia Corporativa de Sistemas 6.2 Opciones Generales. # Opción Descripción 1 Inicio Página de inicio del sitio (HOME). 2 Empresa Información relativa a la empresa. 3 Proveedores Información y funcionalidades para proveedores. 4 Inmobiliarias y Contratistas Información y funcionalidades relativas a contratistas e inmobiliarias. 5 Comunidad y RSE Responsabilidad social empresarial y temas relativos a la comunidad donde opera la empresa. 6 Educación y Videos Sitio educacional (Se mantiene sitio vigente) y videos institucionales. 7 Atención de Clientes Información y funcionalidades orientadas al usuario. 8 Mi Cuenta Funcionalidades orientadas al cliente registrado. _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 12 SubGerencia Corporativa de Sistemas 6.3 Inicio. # Opciones Registro de Clientes Pague en 2 línea 3 Cortes 4 Contáctenos 1 5 Links Flash Bienvenida 7 Noticias 6 8 Accesos 6.4 ADM Contenidos Funcionalidades Tipo Registro Link Icono + Imagen N/A Pague en línea Link + Icono N/A Cortes de Suministro Contáctenos (Formulario de contacto) Línea 600 Emergencias Sucursales Contáctenos Mapa del sitio Términos de uso Privacidad Aguas 1 Aguas 2 Andes SISS Aguas Nuevas Link Texto Link + Icono Link Link Link Link Link Link Link Link Link Link Link Link Si No No No Si Si Si No No No No No No No Flash Bienvenida Imagen Si Noticias HOME Mi Cuenta Atención a Clientes Empresa Inmobiliarias Proveedores Comunidad Link + Texto Link + Icono Link + Icono Link + Icono Link + Icono Link + Icono Link + Icono Link + Icono Si No No No No No No No Módulo: Empresa. Este módulo no presenta innovaciones respecto a lo sitios vigentes. # Opciones Funcionalidades Tipo 1 Nosotros Misión Visión Valores Información de interés Estatutos sociales Memoria anual Texto Texto Texto Link PDF Link PDF Link PDF No No Si Si Si Si Nuestros clientes Tabla Si Plan de inversiones Texto Si Nuestros clientes 3 Inversiones 2 ADM Contenidos _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 13 SubGerencia Corporativa de Sistemas 4 Infraestructura 6.5 Nuestra Infraestructura Tabla Si ADM Contenidos Módulo: Proveedores. # Opciones Funcionalidades Tipo 1 Licitaciones Licitaciones Portal proveedores Políticas y calendario de pago Registro de proveedores WS Link Portal Link PDF Link PDF 2 Proveedores 6.6 N/A N/A No No Módulo: Inmobiliarias y Contratistas. # Opciones Funcionalidades 1 Inmobiliarias 1. Registro de inmobiliarias Se contempla que el usuario pueda bajar el registro de inmobiliarias que trabajan con cada empresa. Ejemplo: Tipo ADM Contenido Tabla + Link Si 2. Estado de solicitudes Se contempla la consulta de estados de: Link Portal factibilidades, proyectos, recepción de obras y otros. Esta opción levanta el portal SINC. 3. Formularios Se contempla que el usuario pueda bajar los distintos formularios de solicitudes, por ejemplo: factibilidades, inspecciones, recepción de obras, etc. Tabla + Ejemplo: Link No Si 4. Legislación sanitaria y otros Se contempla que el usuario pueda bajar documentos relativos a la legislación sanitaria, por ejemplo: Ley general 382, DS 1199, RIDAA, Manual AFR. Ejemplo: Tabla + Link Si 5. Estándares de obras Tabla + Si _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 14 SubGerencia Corporativa de Sistemas Se contempla que el usuario pueda bajar los estándares exigidos por la empresa, por ejemplo: estándares de dibujo, pauta de revisión, etc. Ejemplo: 6. Instaladores autorizados. Se contempla que el usuario pueda bajar los registros de contratistas autorizados por la SISS. Ejemplo: 2 Contratistas 6.7 Link Tabla + Link Si Tabla + Imagen Si 7. Etapas para la creación de un nuevo cliente Se requiere que el usuario pueda visualizar el esquema de creación de un nuevo cliente, asociando imágenes a cada etapa. Ejemplo: Módulo: Comunidad y RSE. # Opciones Funcionalidades 1 Comunidad y RSE 1. Quienes somos Se debe implementar un “Empresa”, opción “Nosotros”. 2. Certificaciones link al módulo Se requiere informar a los usuarios respecto a las certificaciones vigentes de la empresa: ISO, OHSAS, etc. Ejemplo: Tipo ADM Contenidos Link No Imagen + Texto No _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 15 SubGerencia Corporativa de Sistemas 3. Plan de inversión en ejecución Se debe implementar un link al módulo “Empresa”, opción “Inversiones”. 4. RSE Política de responsabilidad Social Empresarial del Grupo Aguas Nuevas. Ejemplo: Link No Imagen + Texto No Imagen + Texto No Tabla + Link Si 5. Políticas con la comunidad Políticas medioambientales de la Empresa. Ejemplo: 6. Medioambiente (RCA y DIA) Declaraciones de impacto ambiental y RCA. Ejemplo: _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 16 SubGerencia Corporativa de Sistemas 7. Noticias Noticias y comunicados de prensa asociados a la comunidad. Ejemplo: 6.8 Imagen + Texto Si Tipo ADM Contenidos Link No Imagen + Texto Si Módulo: Educación y Videos. # Opciones Funcionalidades Sitio educacional Sitio educacional orientado a estudiantes y niños en general. Se considera establecer un vínculo hacia los sitios actualmente existentes: http://www.aguasaraucania.cl/educacion/tpd/tpd.htm http://www.aguasdelaltiplano.cl/educacion/tpd/tpd.htm http://www.aguasmagallanes.cl/educacion/tpd/tpd.htm Ejemplo: 1 Educación Estudiantes Noticias y comunicados de prensa asociados a la comunidad. Ejemplo: _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 17 SubGerencia Corporativa de Sistemas Videos Videos educacionales, corporativos o de cualquier otra índole. Ejemplo 1: Link Video 2 Videos Si Ejemplo 2: _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 18 SubGerencia Corporativa de Sistemas 6.9 Módulo: Mi Cuenta. # Opciones Funcionalidades Autentificación Registrarse Cambiar clave Editar datos Mi cuenta Link: Cortes (definidos en información útil) Link: Tarifas (definida en información útil) Link: Pago en línea Estado de cuenta Bajar boleta (mostrar últimas 3) Mi estado de cuenta Histórico de pagos Histórico de consumos Emergencia Reclamo Requerimientos Consulta Solicitudes Asistente para creación de convenios Convenios Imprimir convenio Auto consulta: Comprobante de pago Auto consulta: Consulta de lectura y corte Auto consulta: Cartola de facturación Auto consulta: Histórico de consumos (Link) Auto consulta Comprobante pago: Pagar saldo anterior Comprobante pago: Pagar deuda total Comprobante pago: Histórico de pagos (Link) Cartola de facturación: Imprimir Consulta de fechas: Imprimir Servipag Web Pay Caja Vecina CMR Pago en línea Banco BCI Banco Estado Banco Corpbanca Sencillito UNIRED Información útil Centros de atención de clientes (CAC) Lugares de pago Otros servicios sanitarios (Bajar PDF) Riles (foto + comentario + fono contacto) 1 Acceso 2 3 4 5 6 7 8 Tipo WS WS Link WS WS Nota: Sistema SAR WS WS Link Nota: Sitios externos Tabla + Link Proyectos sanitarios (foto + comentario + fono _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 19 SubGerencia Corporativa de Sistemas contacto) 9 Solicitudes Cortes de agua potable programado Cortes de agua potable por emergencia Normativa Sanitaria: Leyes Sanitarias Normativa Sanitaria: RIDDA Normativa Sanitaria: Reglamentos y otros Tarifas Otra información útil: Áreas de concesión Otra información útil: Instaladores autorizados Otra información útil: Conceptos de la boleta Postulación subsidio Despacho postal PAT y PAC Agua pilón Certificado de deuda. WS Nota: Sistema SAR Link +Icono Nota: Se bajan PDF Imagen Link +Icono Nota: Se bajan formularios en PDF _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 20 SubGerencia Corporativa de Sistemas 6.10 Módulo: Atención de Clientes. # Opciones 1 Menú Principal Funcionalidades Tipo Registrarse Auto consulta Pago en línea Información útil Solicitudes Funcionalidad Link Además, se deben considerar las siguientes funcionalidades, especificadas en el módulo “Mi Cuenta”: Auto consulta. Pago en línea. Información útil. Solicitudes. _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 21 SubGerencia Corporativa de Sistemas 7 DEFINICIÓN DE TIPOS. 7.1 Link Texto. 7.2 Link Icono. 7.3 Link PDF Simple. Consiste en una interfaz que muestra los archivos PDF que el usuario subió a través del administrador de contenido. 7.4 Link PDF + Imagen. _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 22 SubGerencia Corporativa de Sistemas 7.5 Tabla + Link. 7.6 Tabla + Imagen. _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 23 SubGerencia Corporativa de Sistemas 7.7 Link Compuesto. 7.8 Imagen. 7.9 Texto. _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 24 SubGerencia Corporativa de Sistemas 7.10 Imagen + Texto. 7.11 Link Icono + Imagen. _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 25 SubGerencia Corporativa de Sistemas 7.12 Link Video. En este tipo de contenedor, normalmente contará con un administrador de contenidos, para subir y bajar videos o animaciones de acuerdo a las necesidades. En el se distinguen c elementos: 7.13 Imagen: Título: Descripción: Play: Relativa al video que se ejecutará. Título del video o animación. Breve descripción del vídeo o animación. Ejecuta el video o animación. WS (Web Service). Indica que se despliega información extraída a través de un Web Service. 8 OTROS REQUERIMIENTOS. Formulario de Contacto para envío de mensajes electrónicos. Formato de impresión de los contenidos. Mapa del Sitio. Se debe considerar un diseño que permita ser visualizado en celulares. Buscador interno del Sitio Web. Sistema de envío de noticias o avisos del sitio a usuarios registrados. Administración del Error 404. Política de privacidad, uso de información, etc. 9 ACCESO A BASES DE DATOS. Aguas Nuevas proveerá acceso a las bases de datos pertinentes a través de WEB SERVICES o acceso directos a funciones, procedimientos, vistas, etc. las que contendrán la lógica de negocio respectiva. _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 26 SubGerencia Corporativa de Sistemas 10 PROPUESTA GRÁFICA. _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 27 SubGerencia Corporativa de Sistemas _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 28 SubGerencia Corporativa de Sistemas _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 29 SubGerencia Corporativa de Sistemas _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 30 SubGerencia Corporativa de Sistemas _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 31 SubGerencia Corporativa de Sistemas _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 32 SubGerencia Corporativa de Sistemas _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 33 SubGerencia Corporativa de Sistemas _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 34 SubGerencia Corporativa de Sistemas _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 35 SubGerencia Corporativa de Sistemas _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 36 SubGerencia Corporativa de Sistemas _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 37 SubGerencia Corporativa de Sistemas _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 38 SubGerencia Corporativa de Sistemas _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 39 SubGerencia Corporativa de Sistemas _________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: ERS - Sitios WEB.doc Versión: 1.0 02-05-2010 Andrés González Nahum Página: 40 SubGerencia Corporativa de Sistemas Estándar de Requerimientos No Funcionales – Sitios WEB Control de Versiones: Versión Elaborado Por: Nombre 1.0 Luis González Revisado Por: Fecha 01-06-2010 Aprobado Por: Nombre Andrés González Fecha 23-06-2010 Versión 1.0 Junio del 2010 Nombre Fernando Valdés Fecha 30-06-2010 SubGerencia Corporativa de Sistemas INDICE 1 2 3 4 5 6 PLATAFORMA DE DESARROLLO.........................................................................................3 1.1 Programación..................................................................................................................3 1.2 Base de Datos. ...............................................................................................................3 METODOLOGÍA. ......................................................................................................................4 2.1 Mapa Funcional del Sitio. ...............................................................................................4 2.2 Diseño Estructural...........................................................................................................4 2.3 Diseño Visual. .................................................................................................................5 2.4 Prototipo o Maqueta WEB. .............................................................................................5 2.5 Entregas Incrementales..................................................................................................5 REQUERIMIENTOS GENERALES..........................................................................................6 3.1 Idioma. ............................................................................................................................6 3.2 Navegación. ....................................................................................................................6 3.3 Tamaño de la Página......................................................................................................6 3.4 Usuarios y Roles.............................................................................................................6 3.5 Parámetros. ....................................................................................................................6 3.6 Control de Errores...........................................................................................................6 3.7 Formularios. ....................................................................................................................7 3.8 Hojas de Estilo. ...............................................................................................................7 3.9 Accesibilidad. ..................................................................................................................7 3.10 Visualización. ..................................................................................................................8 3.11 Codificación de Caracteres.............................................................................................8 3.12 Certificaciones. ...............................................................................................................8 3.13 Archivo LOG. ..................................................................................................................8 3.14 Presencia del Sitio en Buscadores. ................................................................................9 PRODUCTOS REQUERIDOS................................................................................................10 4.1 Capacitación. ................................................................................................................10 4.2 Documentación. ............................................................................................................10 4.2.1 Manuales. .........................................................................................................10 4.2.2 Otros Documentos............................................................................................10 4.3 Estadísticas...................................................................................................................10 4.4 Administrador de Contenidos. ......................................................................................11 4.5 Código Fuente. .............................................................................................................11 4.6 Medios de Instalación. ..................................................................................................11 4.7 Sitio WEB Operativo. ....................................................................................................11 IMPLEMENTACIÓN. ..............................................................................................................12 5.1 Estructura de Carpetas.................................................................................................12 5.2 Archivo de Configuración WEB.CONFIG .....................................................................13 5.2.1 Encabezado. .....................................................................................................13 5.2.2 Parámetros de Entorno.....................................................................................13 5.2.3 Parámetros de Base de Datos..........................................................................14 5.3 Nomenclatura de Objetos ASP.NET............................................................................14 5.4 Objetos de Base de Datos............................................................................................15 5.4.1 Nomenclatura de Tablas...................................................................................15 5.4.2 Nomenclatura de Columnas. ............................................................................15 PRÁCTICAS RECOMENDADAS...........................................................................................16 __________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: Estándar de Requerimientos No Funcionales - Proyectos WEB.doc 01-06-2010 Andrés González Nahum Versión: 1.0 Página: 2 SubGerencia Corporativa de Sistemas 1 PLATAFORMA DE DESARROLLO. A continuación se especifica la plataforma de desarrollo a utilizar en la construcción de sitios WEB del Grupo Aguas Nuevas. 1.1 Programación. # Concepto Descripción 1 Programación .Net Æ C#. 2 Framework Versión 3.5. 3 HTML Estándar 4.01. 4 JavaScript 5 CSS 1.2 Todo código JavaScript debe ser incluido como un archivo externo al código HTML. Las páginas HTML deben ser diagramadas utilizando CSS (hojas de estilo en cascada). Al igual que el código JS, debe ser incluido como un archivo externo al código HTML. Base de Datos. Cuando la implementación de un sitio implique la creación de una base de datos, el proveedor deberá considerar lo siguiente: Se requerirá un modelo de datos normalizado, que consiste en aplicar una serie de reglas a las relaciones obtenidas tras el paso del modelo entidad-relación al modelo relacional, con el fin de eliminar redundancia e inconsistencia en las entidades de datos, facilitando el mantenimiento de los datos y evitando anomalías en las operaciones de manipulación de éstos. Se requerirá un modelo con integridad referencial, garantizando de esta forma, que una entidad (fila o registro) siempre se relacione con otras entidades válidas; es decir, que existen en la base de datos. Implica que en todo momento dichos datos sean correctos, sin repeticiones innecesarias, datos perdidos ni relaciones mal resueltas. Toda la actividad DML (Data Manipulation Language), debe estar contenida en packages, dentro de la Base de Datos Corporativa del Grupo Aguas Nuevas. La plataforma de Bases de Datos del Grupo Aguas Nuevas, está implementada en Oracle 10G. __________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: Estándar de Requerimientos No Funcionales - Proyectos WEB.doc 01-06-2010 Andrés González Nahum Versión: 1.0 Página: 3 SubGerencia Corporativa de Sistemas 2 METODOLOGÍA. A continuación se describe, en términos generales, la metodología de desarrollo que recomienda Aguas Nuevas. No obstante lo anterior, el proveedor podrá plantear una metodología distinta en la propuesta técnica. En caso de que este resulte adjudicado, deberá consensuar su propuesta metodológica con el jefe de proyecto de Aguas Nuevas. 2.1 Mapa Funcional del Sitio. Se debe elaborar un “árbol funcional de contenidos” en el que se muestre de manera práctica las secciones que considerará el sitio en desarrollo y cuántos niveles habrá dentro de cada uno. Cuando se usa la idea de crear un árbol, nos referimos a generar un diagrama que cuente con un tronco, ramas y hojas, para mostrar las zonas principales, secundarias y contenidos finales del sitio. Dado lo anterior, las recomendaciones para la generación de este “árbol” son las siguientes: Secciones: Se debe intentar que sean las menos posibles, con el fin de concentrar las acciones del usuario en pocas áreas; hay que considerar que cada una de las áreas a integrar en el árbol requerirá de mantenimiento posterior en contenidos, gráfica y funcionalidad. Dado lo anterior, se recomienda que las secciones se sitúen entre 5 y 7. Niveles: Se debe intentar que el usuario esté siempre a menos de tres clicks del contenido que desea obtener. Por ello no se deberían crear más de tres niveles de acceso. Contenidos relacionados: Se debe considerar que existirán funcionalidades que estén presentes en todo el sitio. Por ejemplo, elementos como: Buscador, Preguntas Frecuentes y Formularios de Contacto. Se recomienda que este tipo de elementos quede fuera del “árbol” y “floten” sobre éste, con el fin de indicar que desde todas las páginas habrá enlaces a ellos. Figura 1: Ejemplo mapa funcional del sitio. 2.2 Diseño Estructural. Se refiere a la estructura que tendrá el sitio en términos generales (wireframes), es decir, es una representación esquemática del sitio en la que se muestran contenidos y comportamiento de las páginas, con sus secciones, funcionalidades y sistemas de navegación. No considera ni __________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: Estándar de Requerimientos No Funcionales - Proyectos WEB.doc 01-06-2010 Andrés González Nahum Versión: 1.0 Página: 4 SubGerencia Corporativa de Sistemas incluye elementos gráficos (logotipos, viñetas, etc.). Nos estamos refiriendo básicamente a cuál será la “experiencia” que tendrá un usuario cuando accede al sitio. De esta manera podremos determinar dónde estarán ubicados los servicios interactivos, como: buscador, sistemas de encuestas, áreas de contenidos, etc. 2.3 Diseño Visual. Se refiere a la solución gráfica que se creará para el sitio, en la cual se muestran colores, logotipos, viñetas, y otros elementos de diseño que permiten identificar visualmente al sitio. La idea es que en esta etapa se trabaje con un software gráfico, para facilitar el proceso de corrección, ya que habitualmente se producen bastantes iteraciones con los usuarios. 2.4 Prototipo o Maqueta WEB. Una vez aprobado el diseño visual del sitio, se debe generar un sitio navegable, mediante el cual se pueda comprobar directamente la forma en que se desempeñarán las páginas, cuando se les aplica la tecnología HTML de construcción. La intención de este prototipo es usar el diseño visual que se ha creado, contando con enlaces reales que permitan ver la forma de usar sus atributos y revisar la forma en que se despliegan las páginas. El prototipo no considera las funcionalidades propias de cada página. 2.5 Entregas Incrementales. A partir de la aprobación del prototipo o maqueta WEB, se deben incorporar las funcionalidades a cada uno de los módulos considerados en el proyecto. La entrega se realizará por módulos, con la finalidad de parcializar la actividad de QA interno de Aguas Nuevas. __________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: Estándar de Requerimientos No Funcionales - Proyectos WEB.doc 01-06-2010 Andrés González Nahum Versión: 1.0 Página: 5 SubGerencia Corporativa de Sistemas 3 REQUERIMIENTOS GENERALES. 3.1 Idioma. El sitio deberá presentar todos los mensajes, ayudas y manejo de excepciones en idioma español; al igual que todas las pantallas, menús, reportes, etc. 3.2 Navegación. La navegación del sitio debe facilitar que el usuario encuentre los contenidos que necesita y recorra las páginas sin perder el contexto de dónde se encuentra, respecto a la estructura del sitio. La interacción con los menús de navegación debe ser claramente reconocible por los usuarios. 3.3 Tamaño de Página. Bajo la premisa de que las personas normalmente no usan el scroll, se diseñará el sitio (preferentemente) con páginas del tamaño de una pantalla. Muchas de las personas que navegan por Internet no consultan la parte inferior de las páginas, debido a que no saben que hay más información de interés. 3.4 Usuarios y Roles. El Sistema deberá proveer los mecanismos necesarios para la adecuada administración de la seguridad, a través de privilegios de acceso asociados a claves y perfiles de usuarios que permitan personalizar la utilización de los distintos módulos y procesos. La autentificación de los usuarios internos, debe ser contra la base de datos de usuarios del Grupo Aguas Nuevas, en el caso de una solución de desarrollo a medida. En el caso de una solución de mercado, se deben contemplar adecuaciones para integrar la solución con la base de datos señalada anteriormente. El método de autentificación es por usuario, cada uno de ellos tiene una cuenta basada en su RUT y digito verificador, ejemplo “12345678-9”. La creación, eliminación y mantención de usuarios, será de responsabilidad del administrador funcional del sistema, por lo tanto se deben considerar las respectivas aplicaciones que permitan realizar estas actividades. La definición de roles determinará el acceso a los distintos módulos o funcionalidades del sistema. 3.5 Parámetros. El sitio debe ser paramétrico, por lo tanto, no se deben incluir constantes en el código fuente. Además, se deberá disponer de una funcionalidad para la administración de la totalidad de los parámetros usados en el sitio. 3.6 Control de Errores. __________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: Estándar de Requerimientos No Funcionales - Proyectos WEB.doc 01-06-2010 Andrés González Nahum Versión: 1.0 Página: 6 SubGerencia Corporativa de Sistemas En general, el sitio deberá controlar todos los errores, impidiendo de ésta manera que detenga su funcionamiento. Lo anterior, bajo un esquema de control estructurado de excepciones. En particular, se requiere administración del Error 404. 3.7 Formularios. En la creación de los formularios para la generación de comunicaciones del sitio, es muy relevante cumplir con ciertas prácticas de usabilidad, que hagan más sencilla la operación de los formularios. Al menos se debe cumplir con las siguientes: Validación del RUT: Se refiere a incorporar la programación adecuada para que se valide inmediatamente el ingreso del Rol Único Tributario, de tal manera que tras escribir los datos en el campo el usuario pueda saber si está bien o no ingresado. Validación de campos obligatorios: Se refiere a que todos los campos en que sea obligatorio ingresar datos (que no serán todos los del formulario), estén marcados de alguna forma (puede ser un asterisco o señalar esos campos con un color diferente) de tal manera que los usuarios cumplan con ingresar los datos correspondientes. Adicionalmente, al pulsar el botón de acción (“Enviar”) al final del formulario, se debe indicar un alerta si llegaran a faltar datos de ese tipo. Validación del e-mail: Se refiere a usar la programación adecuada para validar que los datos que se ingresen en este campo, cumpla con la formalidad de estructura de un correo electrónico. Por ejemplo: existencia del caracter @. Valores por omisión: Se refiere a que si hay campos con menú “drop down” para elegir una, entre muchas opciones, siempre se ubicará en el primer lugar aquella que vaya a ser la más usada. Por ejemplo, si es el campo País, el primer registro debiera se “Chile”. Ejemplos de ingreso de contenidos: Se refiere a que, al costado de donde el usuario deba ingresar la información, debe aparecer escrita la forma en que se debe hacerse. Por ejemplo, al lado del campo RUT escribir un número de ejemplo, para que el usuario sepa si debe escribirlo con puntos y guión, sin puntos y guión o sin puntos ni guión. Claridad de botones: Los botones de acción, al final de los formularios, deben tener una palabra clara, que no deje lugar a dudas sobre la acción a realizar. Si se trata de un formulario para enviar información, debería tener la palabra “Enviar”. Si es para suscribirse a un servicio, deber decir “Suscribirse”. Asimismo, si se implementa un botón para borrar el formulario, debe quedar clara su función, con un texto adecuado que indique esa acción. Se debe indicar “Borrar Formulario” y evitar palabras ambiguas para esta función, tales como “Limpiar”, “Cancelar”, “Eliminar” o similares. 3.8 Hojas de Estilo. Toda la maquetación de las páginas se debe desarrollar utilizando hojas de estilo CSS, ya que facilitan la uniformidad del sitio y la aplicación de técnicas de accesibilidad tales como el cambio de tamaño del texto desde el propio navegador del usuario. 3.9 Accesibilidad. Los sitios se deberán visualizar y operar correctamente, al menos en los siguientes navegadores: Microsoft Explorer. __________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: Estándar de Requerimientos No Funcionales - Proyectos WEB.doc 01-06-2010 Andrés González Nahum Versión: 1.0 Página: 7 SubGerencia Corporativa de Sistemas Netscape Navigator. Mozilla Firefox. Safari. Opera. Google Chrome. 3.10 Visualización. Para visualizar correctamente el sitio se requiere una resolución de pantalla mínima de 800x600 con 256 colores. El diseño se realizará utilizando una resolución de 1024x768 y una calidad de colores de 32 bits. El proveedor podrá proponer otra configuración, en función de su experiencia con sitios de similares características. 3.11 Codificación de Caracteres. Para la codificación de caracteres se utilizará preferentemente UTF-8 (8 - BIT Unicode Transformation Format), en caso de que el proveedor desee usar otra codificación, lo debe rá consensuar con el jefe de proyecto de Aguas Nuevas. 3.12 Certificaciones. La tecnología WEB cuenta con un conjunto de estándares que deben ser respetados para obtener la certificación que acredita al sitio, respecto de su conformidad con ellos. La entidad encargada de estas certificaciones es el Word Wide Web Consortium (http://www.w3c.org/), que se encarga de velar por las mejoras en la tecnología y por hacer avanzar los estándares y que los programas visualizadores cumplan efectivamente, con mostrar lo que el lenguaje HTML permite construir. En este sentido Aguas Nuevas pretende cumplir con certificaciones, para al menos, los siguientes estándares: # Estándar Descripción Valida la sintaxis de una hoja de estilo en cascada o CSS (Cascade Style Sheet), mediante la cual se describe la forma de presentar contenidos en una página. Permite detectar errores en la forma de utilizar el lenguaje HTML y XML en la construcción de un sitio. 1 2 Nivel Doble-A de conformidad con las directrices de accesibilidad para el contenido Web 1.0 (WCAG 1). 3 En caso de que el proveedor cumpla con otros estándares internacionales, deberá señalarlo en la propuesta técnica. 3.13 Archivo LOG. El proveedor debe considerar la generación de un archivo de texto en el que se registren las operaciones relevantes que realiza un usuario en el sitio. Se deben considerar al menos los siguientes datos: Fecha. Hora. __________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: Estándar de Requerimientos No Funcionales - Proyectos WEB.doc 01-06-2010 Andrés González Nahum Versión: 1.0 Página: 8 SubGerencia Corporativa de Sistemas IP de origen. Páginas visitadas. Página desde la cual se llegó al sitio. Palabras que usaron el buscador (si existiera). Debido a que este archivo aumenta de tamaño a medida que hay más visitantes y conforme pasa el tiempo, es importante que se defina el mecanismo de extracción y análisis de los datos, con el fin de generar información que ayude a la gestión y a entender de que manera los usuarios están empleando el sitio. 3.14 Presencia del Sitio en Buscadores. El proveedor debe asegurar, al momento de implantar el proyecto, la presencia del sitio en los buscadores más populares, puesto que ellos son los que concentran el mayor tráfico y por lo tanto, que el sitio aparezca en ellos, garantizará que los usuarios que estén buscando a las empresas del Grupo Aguas Nuevas, las podrán encontrar. Los buscadores a considerar son: Google. Yahoo. Alta vista. __________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: Estándar de Requerimientos No Funcionales - Proyectos WEB.doc 01-06-2010 Andrés González Nahum Versión: 1.0 Página: 9 SubGerencia Corporativa de Sistemas PRODUCTOS REQUERIDOS. 4 Los productos que se señalan a continuación, serán necesarios para la “recepción conforme Final” de un proyecto WEB. 4.1 Capacitación. El proveedor deberá considerar realizar capacitaciones en al menos dos ámbitos: Capacitación Técnica: Es la que recibe el personal informático que entregará soporte al sitio y que le permitirá entender cómo ha sido construido el sitio y la forma de instalarlo, administrarlo, respaldarlo e incluso, mejorarlo. Deben recibir capacitación en estos tres aspectos, con el fin de que pueda operar de manera autónoma una vez que concluya la garantía que haya contemplado el proyecto. En términos prácticos se deben considerar a lo menos los siguientes procesos: - Administración técnica. Instalación (se debe realizar un simulacro). Respaldo y recuperación (cuando aplique). Capacitación Usuarios: Es la que reciben los usuarios que estarán a cargo de la administración funcional del sitio. La capacitación les permite familiarizarse con todos los elementos que se deban conocer para utilizar el sitio en toda su potencialidad. 4.2 Documentación. El proveedor deberá entregar, a lo menos, la documentación que se especifica a continuación. Los contenidos y el formato de la documentación señalada anteriormente se especifican en el documento: “Estándar de Manuales”. 4.2.1 Manuales. Manual de usuario. Manual del administrador. Manual técnico. Manual de operación. Manual de gráfica del sitio. 4.2.2 Otros Documentos. Documento de diseño. Plan de pruebas. Ejecución del plan de pruebas. 4.3 Estadísticas. Una de las características interesantes de un Sitio Web, es que ofrece información permanente de las actividades que están ocurriendo en su interior, lo que permite tener cifras que ayudan a evaluar la gestión. El proveedor deberá implementar la recuperación de a lo menos las siguientes estadísticas: __________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: Estándar de Requerimientos No Funcionales - Proyectos WEB.doc 01-06-2010 Andrés González Nahum Versión: 1.0 Página: 10 SubGerencia Corporativa de Sistemas Páginas Visitadas: Se refiere a la cantidad de páginas que han sido solicitadas por los usuarios al sitio; su uso más importante tiene que ver con la capacidad de establecer ranking internos, respecto de los contenidos y funcionalidades más vistos y usados. Sesiones de Usuario: Se refiere al número de personas que ha visitado el sitio, independiente de cuántas páginas hayan visto o solicitado durante su visita; esta métrica es la única que puede entregar información real en torno a la audiencia de un sitio. 4.4 Administrador de Contenidos. El proveedor debe considerar una plataforma de administración de contenidos, que entre otros permita: administrar usuarios, bloques de contenidos, menús, activar/desactivar los módulos del sitio, subir, editar y eliminar temas. 4.5 Código Fuente. El proveedor deberá entregar el código fuente de todas las aplicaciones implementadas. 4.6 Medios de Instalación. El proveedor deberá entregar los medios necesarios para la instalación del sistema (cuando aplique). Entre otros: Software de base de datos. Software de aplicación. Código fuente. Cualquier otro software que se requiera para el correcto funcionamiento. Estos conceptos serán aplicables tanto a la instalación de la aplicación servidor y/o aplicaciones cliente. Se debe considerar original y copia en medios ópticos. 4.7 Sitio WEB Operativo. El producto más importante que debe entregar el proveedor es un sitio WEB operativo, libre de errores y documentado. __________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: Estándar de Requerimientos No Funcionales - Proyectos WEB.doc 01-06-2010 Andrés González Nahum Versión: 1.0 Página: 11 SubGerencia Corporativa de Sistemas IMPLEMENTACIÓN. 5 Aguas Nuevas proporcionará un ambiente de desarrollo, para que el proveedor realice todas las tareas propias de esta actividad (desarrollo, parametrización, pruebas, etc.). El sitio en desarrollo se traspasará al ambiente de producción cuando el jefe de proyecto entregue su V°B°. 5.1 Estructura de Carpetas. Se debe considerar la siguiente estructura de carpetas: Figura 1: Estructura de carpetas. Donde: # Carpeta Descripción 1 Carpeta SIS_NombreProyecto Es la carpeta raíz del proyecto y contiene una o más subcarpetas referentes a proyectos de tipo asp.net. Su nombre está compuesto por los siguientes caracteres: “SIS” + “_” + “Nombre_Proyecto”. Ej.: SIS_Intranet 2 Carpeta WebService Carpeta contenedora del proyecto asp.net de tipo “Servicio Web”. 3 Carpeta WebSite Carpeta contenedora del proyecto asp.net de tipo “Sitio Web”. 4 Carpeta WindowService Carpeta contenedora del proyecto asp.net de tipo “Servicio Windows”. A continuación se muestra, a modo de ejemplo, la estructura de la carpeta “WebSite”. Contenido Carpeta WebSite: __________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: Estándar de Requerimientos No Funcionales - Proyectos WEB.doc 01-06-2010 Andrés González Nahum Versión: 1.0 Página: 12 SubGerencia Corporativa de Sistemas Figura 2: Ejemplo contenido de carpeta. Contenido de carpeta Recursos: Figura 3: Contenido carpeta Recursos. Contenido de carpeta UploadFiles: Figura 4: Contenido carpeta Recursos. 5.2 Archivo de Configuración WEB.CONFIG El archivo de configuración debe considerar al menos la siguiente estructura: 5.2.1 Encabezado. Proporciona información general del sistema y los datos de contacto del proveedor que desarrolló el sitio, como se muestra en la siguiente figura: Figura 5: Encabezado del archivo WEB.CONFIG. 5.2.2 Parámetros de Entorno. Son parámetros globales cuyos valores serán usados por el proyecto, los cuales se deben definir dentro de la etiqueta <appSettings>, a continuación se muestran las variable mínimas a definir: # Variable Descripción __________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: Estándar de Requerimientos No Funcionales - Proyectos WEB.doc 01-06-2010 Andrés González Nahum Versión: 1.0 Página: 13 SubGerencia Corporativa de Sistemas 1 smtpServer 2 ToEmailError 3 Sistema 4 5 6 7 8 Path_images Path_emails_templates Path_ Adjuntos Path_temporales URL_sitioWeb Variable que define la IP del servidor de correo SMTP. Variable que define dirección de e-mail, donde el sistema debe enviar los mensajes de error del sistema. Parámetro que define el código del sistema. Este dato se debe solicitar al jefe de proyecto del Aguas Nuevas. Especifica ruta física de carpeta de imágenes. Especifica ruta física de carpeta de plantillas de e-mail. Especifica ruta física de carpeta de archivos adjuntos. Especifica ruta física de carpeta de archivos temporales. Especifica URL del sitio del proyecto. A continuación se muestra un ejemplo de parámetros de entorno: Figura 6: Ejemplo parámetros de entorno. 5.2.3 Parámetros de Base de Datos. Son parámetros globales cuyos valores están relacionados con objetos de base de datos, los cuales se deben definir en la etiqueta <connectionStrings>, como se muestra en la siguiente figura: Figura 7: Parámetros de base de datos. 5.3 Nomenclatura de Objetos ASP.NET. En términos generales, los nombres de objetos deberán especificarse de la forma XXXNombre, donde “XXX” define el tipo de objeto ASP.NET y “Nombre” es el nombre del objeto en particular. A continuación se muestra, a modo de ejemplo, la definición de algunos objetos: # Nomenclatura Descripción 1 2 3 4 DgrnombreGrilla DdlnombreListaDesplegable TxtnombreCajaDeTexto LblnombreEtiqueta Nombre de objetos de tipo data grid (Grilla). Nombre de objetos de tipo dropdownlist (lista desplegable). Nombre de objetos de tipo texbox (cajas de texto). Nombre de objetos de tipo label (etiquetas). __________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: Estándar de Requerimientos No Funcionales - Proyectos WEB.doc 01-06-2010 Andrés González Nahum Versión: 1.0 Página: 14 SubGerencia Corporativa de Sistemas 5.4 Objetos de Base de Datos. Cuando la implementación de un sitio requiera crear una base de datos, se deberán tener en consideración algunas normas. No obstante lo anterior, la creación o mantención de todo objeto de base de datos será realizada por el DBA de Aguas Nuevas y las solicitudes serán canalizadas a través del jefe de proyecto asignado. 5.4.1 Nomenclatura de Tablas. Los nombres de las tablas de base de datos, deben componerse de la forma “XXX_Nombre”, donde “XXX” corresponde a las siglas representativas del nombre de la tabla y “Nombre” es el nombre característico de la tabla. Ejemplo: Para la tabla que posee el “Detalle de Presupuesto”, el nombre debería corresponder a DPT_DETALLE_PRESUPUESTO, como se muestra en la siguiente figura: Figura 8: Ejemplo de nomenclatura de tablas. 5.4.2 Nomenclatura de Columnas. Los nombres de las columnas o campos de las tablas de la base de datos deben definirse de la forma “XXX_Nombre”, donde “XXX” corresponde a la sigla de la tabla de origen y “Nombre” es el nombre característico de la columna, se debe considerar que si la columna es propia de otra tabla, se debe considerar además las siglas de la tabla de origen, como se muestra en la siguiente figura, donde el campo DTP_PPT_IP, es propio de la tabla presupuesto, cuyas siglas son PPT. Figura 9: Ejemplo de nomenclatura de columnas. __________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: Estándar de Requerimientos No Funcionales - Proyectos WEB.doc 01-06-2010 Andrés González Nahum Versión: 1.0 Página: 15 SubGerencia Corporativa de Sistemas 6 PRÁCTICAS RECOMENDADAS. La navegación debe facilitar el moverse en el sitio sin perder la noción de dónde se encuentra. La navegación permanente del sitio debe facilitar que el usuario encuentre los contenidos que necesita y recorra las páginas sin perder el contexto de dónde se encuentra respecto a la estructura del sitio. La interacción con los menús de navegación debe ser claramente reconocible por los usuarios. 1 La imagen muestra una estructura de navegación clara, que informa la ubicación de cada página en el contexto del sitio. 2 Deben existir accesos claramente marcados a la página principal. El usuario debe poder acceder a la portada del sitio de un modo evidente y consistente desde cualquier lugar del sitio. Las excepciones a esto deben ser justificadas por el uso de procesos de túnel como transacciones, pagos u otras situaciones que requieran de la eliminación de los elementos de salida estándar del proceso. 3 Este ejemplo presenta un acceso a la portada del sitio consistente y en una ubicación prominente. Durante el proceso de registro en el sitio, sólo se deben solicitar los datos mínimos. En los formularios en línea sólo se deben solicitar los datos mínimos necesarios para la tarea. Si el usuario ya ha ingresado información, no la solicite nuevamente, a menos que sea para confirmarla o para otros propósitos como verificación de identidad. En la medida que se presentan menos obstáculos para que un usuario complete una tarea, la probabilidad de que la finalice con éxito será mayor. Los datos que se solicitan para crear una cuenta en el ejemplo, son sólo los mínimos necesarios. El usuario puede completar los datos de su perfil más adelante si lo desea. __________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: Estándar de Requerimientos No Funcionales - Proyectos WEB.doc 01-06-2010 Andrés González Nahum Versión: 1.0 Página: 16 SubGerencia Corporativa de Sistemas 4 El proceso de registro debe ser simple y claro. En los sitios que requieren que los usuarios se registren para tener acceso a servicios especiales o a información personalizada, el proceso de registro debe ser simple y directo, pudiendo ser completado de modo rápido y claro por los usuarios. El proceso de registro en la imagen es claro, presenta información de apoyo y tiene una secuencia fácilmente identificable. 5 La secuencia de acciones de los trámites o servicios debe ser clara. Durante las interacciones en procesos, trámites o transacciones, el orden de ejecución de las acciones debe ser claramente informado a los usuarios. Si un proceso se divide en más de un paso, la secuencia debe ser evidente. El formulario en la imagen presenta una secuencia de acciones clara, destacando cada uno de los pasos que lo componen. Los usuarios deben encontrar fácilmente información de contacto con la institución para: consultas, quejas o comentarios. La información de contacto debe ser fácilmente visible en el sitio para que los usuarios puedan comunicarse con la institución cuando lo necesiten. Se deben informar los plazos y condiciones de las respuestas. 6 La información de contacto en la imagen de ejemplo, está ubicada permanentemente en la misma posición, en un lugar destacado de las páginas. __________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: Estándar de Requerimientos No Funcionales - Proyectos WEB.doc 01-06-2010 Andrés González Nahum Versión: 1.0 Página: 17 SubGerencia Corporativa de Sistemas Durante la realización de trámites o servicios, el usuario debe poder cancelar o suspender la operación en cualquier momento. En los procesos o transacciones que ubiquen al usuario en un flujo de interacción lineal, se debe proveer un mecanismo de salida o interrupción del proceso que le permita realizarlo o reanudarlo posteriormente. 7 La acción presentada en la imagen puede ser interrumpida por el usuario con el botón Cancelar. Esto le entrega control y permite una salida para situaciones de excepción. 8 Se debe informar permanentemente en qué lugar del sitio se encuentra el usuario. El usuario debe poder identificar en todo momento y sin dificultad en qué lugar del sitio se encuentra (a través del menú principal). Se debe considerar que en muchos casos los usuarios llegarán al sitio desde fuentes externas como vínculos en otros sitios o desde resultados de búsqueda en buscadores públicos. La navegación principal del sitio destaca claramente del sitio se encuentra la página actual. Se debe presentar información clara sobre los plazos de respuesta para la entrega o disponibilidad de los productos o servicios ofrecidos. Al ofrecer servicios en línea es importante informar con precisión a los usuarios la fecha o el plazo en que se entregarán los productos o servicios solicitados. Por ejemplo, los servicios de contacto deben informar el plazo en el que el usuario recibirá una respuesta a su consulta o solicitud y cumplirlo. 9 El mensaje del ejemplo informa de modo preciso el plazo de respuesta, en este caso, 48 horas. __________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: Estándar de Requerimientos No Funcionales - Proyectos WEB.doc 01-06-2010 Andrés González Nahum Versión: 1.0 Página: 18 SubGerencia Corporativa de Sistemas 10 Se debe facilitar el llenado de las tareas y servicios ofrecidos por el sitio. Muchos procesos pueden ser completados más fácilmente por los usuarios si se les presenta ayuda concreta. Por ejemplo, pre-llenando de los formularios con los datos que se conocen del usuario, ayudando en el ingreso de datos con formatos específicos como fechas, RUT, correos electrónicos, etc., solicitando sólo la información necesaria y presentando información de ayuda apropiada. El simulador del ejemplo facilita el llenado con información de ayuda, una clara división en bloques de datos similares y una organización orientada a simplificar el proceso. Se debe presentar más de una alternativa de pago desde el sitio para los servicios o productos que lo requieran. Cuando se presentan servicios en línea que requieren pago, como la compra de certificados o el pago de cuentas, se deben presentar alternativas que permitan que el mayor número posible de usuarios pueda pagar. Por ejemplo, incorporar la posibilidad de realizar transferencias bancarias en línea, pago con tarjetas de crédito, pago mediante Cuenta RUT u otros mecanismos como El ejemplo presenta múltiples alternativas para pagar, lo que facilita la elección de los medios de pago y permite que más tarjetas de prepago. usuarios puedan utilizar el servicio. 11 12 El contenido del sitio debe ser claro y actualizado. El contenido debe ser claro para el público al que está dirigido y actualizado frecuentemente, según las características del sitio. El contenido relevante, como noticias o información con relevancia temporal, debe indicar en qué fecha ha sido publicado de modo que el usuario pueda reconocer la vigencia de la información. El contenido de esta página muestra la fecha de publicación junto con título, esto permite entender el contexto y la actualidad de la información. __________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: Estándar de Requerimientos No Funcionales - Proyectos WEB.doc 01-06-2010 Andrés González Nahum Versión: 1.0 Página: 19 SubGerencia Corporativa de Sistemas 13 Siempre debe ser claro lo que está sucediendo en el sitio. Cuando existan funcionalidades o procesos en línea que tomen un tiempo prolongado en completarse (más de 3 segundos), asegúrese de mantener informado al usuario del progreso de la acción o de su estado de avance. La imagen muestra el modo en que se informa a los usuarios durante la carga de una fotografía. El usuario está informado del progreso de la acción y del tiempo aproximado que tomará la tarea. Se explicitan las medidas de protección de privacidad asociadas a los trámites o servicios ofrecidos por el sitio (es y parece seguro) El sitio debe informar acerca de la privacidad de los datos de sus usuarios para aumentar la confianza en el sitio web. Esta información debe ser fácilmente visible y accesible desde el contexto de los servicios en que el usuario debe entregar información personal o confidencial. 14 Este sitio informa de modo destacado sobre la seguridad de las transacciones, otorgando más confiabilidad a su servicio. __________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: Estándar de Requerimientos No Funcionales - Proyectos WEB.doc 01-06-2010 Andrés González Nahum Versión: 1.0 Página: 20 SubGerencia Corporativa de Sistemas 15 Se debe solicitar al usuario la confirmación de la operación. Antes de completar una tarea irreversible, o que resulta complejo revertir, solicite al usuario que verifique los datos que ha ingresado y permítale que los modifique si es necesario. Por ejemplo, antes de completar un proceso de compra en línea, o antes de finalizar una transferencia de dinero, permita al usuario revisar la información proporcionada. Esto dará más confianza al usuario y disminuirá la cantidad de errores. Antes de finalizar una compra en Amazon, se solicita al usuario confirmar todos los datos para verificar que la compra que realiza está correcta. 16 Se debe ofrecer retroalimentación al finalizar los procesos o trámites. Cuando se finaliza un proceso es importante que el usuario sepa el resultado y conozca cuáles son los pasos siguientes recomendados. Esto le dará seguridad respecto al proceso que ha completado y le dará alternativas para continuar en el sitio. Al finalizar la carga de una fotografía, se informa al resultado y se le sugieren acciones para continuar. El sitio debe tener información acerca de los productos y servicios que son parte de su oferta o negocio. El usuario debe encontrar información acerca de los productos y servicios en el sitio sin un esfuerzo importante. Esto es una señal de transparencia que reducirá viajes a las sucursales físicas y facilitará la auto-atención de los usuarios. 17 Este sitio de servicios para los ciudadanos presenta una organización clara y segmentada de su oferta. __________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: Estándar de Requerimientos No Funcionales - Proyectos WEB.doc 01-06-2010 Andrés González Nahum Versión: 1.0 Página: 21 SubGerencia Corporativa de Sistemas El sitio debe informar de los requisitos, limitaciones y restricciones que se aplican a sus productos. Se debe presentar la mayor información posible a los usuarios sobre los productos y servicios, incluyendo los requisitos para acceder a ellos y sus limitaciones y restricciones. Esto facilita la auto-atención de los usuarios y aumenta la confianza en el sitio web. 18 En el ejemplo se informa de los requisitos servicio que se detalla en la ficha. 19 El usuario debe poder identificar claramente el propósito y contenido del sitio. El usuario debe ser capaz de identificar rápidamente cuál es el propósito del sitio mediante las pautas visuales y elementos destacados en la portada y páginas principales. De este modo, podrá establecer expectativas correctas y determinar si cumple o no con sus necesidades. El primer pantallazo de este sitio presenta la información más relevante sobre los servicios más importantes del sitio, organizados en un modo que explica la oferta de un modo claro para los usuarios. 20 Se debe escribir en el lenguaje de los usuarios, no en jergas particulares. El sitio debe hablar el lenguaje de sus usuarios, evitando el uso de términos de uso interno en la institución y que no sean significativos para su público. __________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: Estándar de Requerimientos No Funcionales - Proyectos WEB.doc 01-06-2010 Andrés González Nahum Versión: 1.0 Página: 22 SubGerencia Corporativa de Sistemas El ejemplo presenta la información sin utilizar términos técnicos innecesarios en este contexto y con un vocabulario orientado a resolver las preguntas principales del usuario. 21 Los nombres de las secciones deben reflejar claramente su contenido o propósito. Los títulos de las categorías y páginas deben ser claros y consistentes, reflejando inequívocamente su contenido. Los títulos no deben causar dudas a los usuarios por su imprecisión o ambigüedad. Los títulos en este ejemplo son claros y descriptivos, sin dejar lugar a la duda o a la ambigüedad. El logo de la institución debe ubicarse en un lugar visible y consistente en todo el sitio. La imagen institucional debe ser clara y consistente entre las diferentes páginas del sitio, considerando que muchos usuarios ingresan directamente a páginas interiores sin pasar por la portada. La identidad de la institución aumenta la confianza en el sitio. 22 En este sitio la imagen de la institución es permanente y consistente en su ubicación, lo que otorga más confiabilidad a sus páginas. 23 Los tiempos de descarga de las páginas deben ser adecuados. Las páginas del sitio deben descargarse a una velocidad adecuada a sus características y las condiciones de navegación de su público. Las expectativas para los diferentes sitios variarán según sus funcionalidades y contenido, por ejemplo una página de fotografías o con recursos multimedia será razonable que tome más tiempo en descargar que una página de texto simple. La portada del ejemplo está construida con una cantidad mínima de recursos, sin sacrificar la estética, logrando así un tiempo de descarga mínimo. __________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: Estándar de Requerimientos No Funcionales - Proyectos WEB.doc 01-06-2010 Andrés González Nahum Versión: 1.0 Página: 23 SubGerencia Corporativa de Sistemas 24 El sitio debe tener un aspecto estéticamente profesional. El diseño visual debe ser un apoyo al propósito del sitio, contribuyendo a generar una experiencia positiva. El uso de colores, imágenes, tipografía y otros recursos debe considerar las características del sitio y de su público para apoyar a tal propósito. Este sitio tiene un diseño elegante, profesional, sin utilizar recursos excesivos. El diseño del sitio no debe contener elementos innecesarios o no relacionados con el objetivo de la tarea. Las tareas o acciones dentro del sitio deben realizarse con la menor cantidad de elementos distractores o innecesarios. Esto facilitará que los usuarios las finalicen correctamente. 25 Durante los procesos en túnel, Amazon simplifica sus páginas, eliminando todos los elementos que causen distracción. Esto facilita el que los usuarios finalicen el proceso. 26 El sitio debe presentar información de fácil acceso acerca de la institución La información acerca de la institución debe ser fácilmente visible y accesible para los usuarios. Contar con información institucional de calidad y fácil acceso aumenta la credibilidad y confianza en el sitio. Este sitio presenta un acceso destacado a la información sobre el sitio y la institución. __________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: Estándar de Requerimientos No Funcionales - Proyectos WEB.doc 01-06-2010 Andrés González Nahum Versión: 1.0 Página: 24 SubGerencia Corporativa de Sistemas 27 El sitio debe estar diseñado para requerir una mínima ayuda e instrucciones. Las interacciones y tareas del sitio deben diseñarse de un modo que sea fácil de usar y que requiera de la menor cantidad de información para su uso. Si es necesario ofrecer ayuda, procure que sea por las características del contenido y no por problemas en el diseño. Para minimizar la cantidad de instrucciones, este sitio presenta un ejemplo que ayuda al usuario a identificar el dato solicitado. 28 El sitio debe funcionar correctamente, sin la presencia de errores. El sitio debe operar sin errores técnicos como la presencia de vínculos rotos, errores de programación o de servidor. Esta es una página personalizada para el error 404, que ocurre cuando se solicitan páginas que no están disponibles. En este caso, se entrega un mensaje en un lenguaje claro, no técnico y se entregan alternativas para continuar la navegación en el sitio. __________________________________________________________________________________________________ Nombre Archivo: Fecha Docto. : Preparado Por: Estándar de Requerimientos No Funcionales - Proyectos WEB.doc 01-06-2010 Andrés González Nahum Versión: 1.0 Página: 25