ArquitecturaSW Portal para el Desarrollo de Aplicaciones y Soporte Comunidad de Madrid ICM

Transcripción

1 ArquitecturaSW Portal para el Desarrollo de Aplicaciones y Soporte Comunidad de Madrid ICM Versión 1.0 Área de Integración y Arquitectura de Aplicaciones

2 Hoja de Control Título Documento de Referencia Responsable y Soporte Área de Aplicaciones Especiales y Arquitectura Software Versión 1.0 Fecha Versión 07/11/2013 Registro de Cambios Versión Causa del Cambio Responsable del Cambio Fecha del Cambio 1.0 Versión inicial del documento Área de Aplicaciones Especiales y Arquitectura Software 07/11/ Nuevo proyecto en mantis Área de Aplicaciones Especiales y para consultas a la Unidad de Arquitectura Software Calidad 07/11/2013 Página 2 de 22

3 Índice 1. PORTAL PARA EL DESARROLLO DE APLICACIONES NOTICIAS CONSULTAS ACCESO FUNCIONALIDADES BÁSICAS MENU SUPERIOR FLUJO DE LAS CONSULTAS REPORTAR CONSULTA (USUARIO) MONITORIZACION (USUARIO) AÑADIR USUARIOS A MONITORIZAR UNA CONSULTA MONITORIZAR UNA CONSULTA GESTION DE LA CONSULTA POR LA UNIDAD CORRESPONDIENTE ACEPTACION PEDIR MAS INFORMACIÓN/DATOS CERRAR APORTAR MAS INFORMACIÓN (USUARIO) CIERRE DE CONSULTAS (USUARIO) REABRIR CONSULTA (USUARIO) MI VISTA BUSQUEDA DE CONSULTAS RECORDAR PASSWORD Página 3 de 22

4 1. PORTAL PARA EL DESARROLLO DE APLICACIONES Toda la documentación y recursos necesarios para el desarrollo de aplicaciones de la Comunidad de Madrid para según las distintas tecnologías están disponibles en el portal ArquitecturaSW. Este portal está accesible en las siguientes urls Intranet: Internet: Dentro de este portal se puede encontrar la información organizada de la siguiente forma: Página principal: En esta página se encuentra una descripción de los contenidos del portal, un documento de introducción a la arquitectura de desarrollo, enlace a las consultas de soporte y las últimas noticias. Desarrollos Atlas: En esta sección se encuentra toda la información relacionada con el desarrollo de aplicaciones con el framework Atlas que es el framework vigente para el desarrollo de aplicaciones. Modelo de Datos: En esta sección se encuentra toda la información relacionado con la normativa de base de datos y los distintos catálogos comunes. Otras Tecnologías: En esta sección se encuentra información sobre otras tecnologías que complementan a las aplicaciones en necesidades específicas tales como la gestión de contenidos, business intelligent, reporting, etc. Portales: En esta sección se encuentra información sobre el desarrollo de portales. Tecnologías anteriores: En esta sección se encuentra toda la documentación de frameworks o tecnologías anteriores cuyo uso ya no está permitido en los nuevos desarrollos. Consultas: En esta sección se pueden enviar consultas a la Unidad de Arquitectura y Soporte de Aplicaciones sobre la utilización de los distintos frameworks. Página 4 de 22

5 2. NOTICIAS Este portal es el canal de comunicación de ICM hacia los proveedores para el desarrollo de aplicaciones. Cada vez que se publica algo en este portal se incluye una noticia indicando la actualización que se ha realizado. El proveedor por lo tanto tiene la responsabilidad de conectarse asiduamente a este portal para estar al corriente de las modificaciones. Las noticias aparecen en la parte derecha de la página principal del portal y además dentro de cada Sección se encuentra un apartado de Noticias. Página 5 de 22

6 3. CONSULTAS Dentro del portal se encuentra un apartado para Consultas. En este apartado se pueden abrir consultas para dos proyectos: PROYECTO ARQUITECTURA SOPORTE: Soporte al desarrollo a la Unidad de Arquitectura y Soporte de Aplicaciones. PROYECTO CALIDAD: Consultas a la Unidad de Calidad y Certificación ACCESO El acceso se puede hacer desde el portal arquitecturasw en la sección Contactar o directamente en las siguientes urls: Intranet: Intranet: El acceso a esta url es autenticado mediante usuario/password. El personal de ICM puede realizar un autoregistro en el portal, para más información ponerse en contacto con la Unidad de Arquitectura y Soporte de Aplicaciones. El personal externo que trabaje con ICM mediante un servicio CMMA O NOCMMA + tendrá una cuenta para cada coordinador técnico del servicio. El acceso a otros proveedores externos deberá ser solicitado por el jefe de proyecto de ICM a la Unidad de Arquitectura y Soporte de Aplicaciones a través de este mismo sistema abriendo una consulta en la categoría ACCESO. Página 6 de 22

7 3.2. FUNCIONALIDADES BÁSICAS MENU SUPERIOR A través del menú superior, la aplicación permite ir a las diferentes secciones y funcionalidades, al tiempo que ofrece cierta información y funcionalidades adicionales. Las distintas opciones de la aplicación: Mi Vista: Lista de incidencias a las que tiene acceso el usuario. Ver Incidencias: Ver y Buscar consultas. Reportar Incidencia: Abrir un consulta de soporte Mi Cuenta: Datos de la cuenta de acceso. Cerrar Sesión: Cierra la sesión actual. A la derecha del menú se encuentra una funcionalidad que permite introducir un número de consulta para que, al pulsar el enlace Ir a Incidencia, la aplicación acceda directamente al detalle de la misma. Arriba aparece los distintos proyectos en los que se pueden crear consultas. Actualmente: - ARQUITECTURA SOPORTE - CALIDAD FLUJO DE LAS CONSULTAS Una consulta se puede encontrar en los siguientes estados: Recibida: En el momento en que un usuario realiza una consulta en la aplicación, ésta quedará marcada con el estado de recibida. Las consultas recibidas están auto asignadas a alguna persona del equipo de soporte pero esto no quiere decir que ya haya comenzado a trabajar con ella. Aceptada: Este estado indica que el encargado de esta consulta ha comenzado su trabajo en ella. Se necesitan más datos: Si la persona que tiene asignada la consulta considera que la información que se ha introducido en la consulta es insuficiente o requiere de más información o pruebas a realizar la consulta se cambia a este estado describiendo la necesidad. Página 7 de 22

8 Cerrada: Una vez que soporte considera que la consulta se puede cerrar la cambiará a este estado indicando la respuesta o solución. Si el usuario que abrió la consulta no está de acuerdo con la solución o respuesta puede reabrir la consulta y esta pasará de nuevo al estado recibida. A continuación se muestra un flujo de estados de las consultas recibidas. USUARIO REPORTA CONSULTA USUARIO AÑADE USUARIOS DE ICM A MONITORIZAR RECIBIDA ESTA SIENDO MONITORIZADA POR ICM? NO SI SOPORTE ACEPTA LA CONSULTA ACEPTADA SOPORTE PEDIR MONITORIZACION SE NECESITAN MAS DATOS? SI SOPORTE PIDE LOS DATOS QUE NECESITA SE NECESITAN MAS DATOS USUARIO AÑADE UNA NOTA NO SOPORTE CIERRA LA CONSULTA CON LA RESPUESTA CERRADA USUARIO REABRE LA CONSULTA USUARIO CIERRA LA CONSULTA CON LA RESPUESTA Las cajas de color naranja son las operaciones que va a realizar el usuario que abre la consulta y las cajas azules son las operaciones que va a realizar el personal de soporte que tenga asignada la consulta. A continuación se describen las tareas a realizar por los usuarios. Página 8 de 22

9 3.3. REPORTAR CONSULTA (USUARIO) Para crear una consulta hay que acceder a la opción Reportar Incidencia. Al seleccionar esta opción se puede comportar distinto dependiendo de si hay un proyecto seleccionado o no: - Si no hay proyecto seleccionado, es decir en el combo de proyectos aparece Todos los proyectos (Comportamiento por defecto) se muestra una ventana para que selecciones el proyecto sobre el cual vamos a crear la consulta: Los proyectos son: ARQUITECTURA SOPORTE: Consulta de Soporte al desarrollo a la Unidad de Arquitectura y Soporte de Aplicaciones. CALIDAD: Consultas a la Unidad de Calidad y Certificación. Una vez seleccionado el proyecto se pasa a una ventana con un formulario para describir detalladamente la consulta/incidencia. Esta ventana se explicará más adelante. Si se ha seleccionado un proyecto seleccionado, es decir en el combo de proyectos aparece por ejemplo ARQUITECTURA SOPORTE se muestra directamente un formulario para describir detalladamente la consulta/incidencia y esta consulta se abrirá para este proyecto. Esta ventana se explicará más adelante. Página 9 de 22

10 Atención Es importante tener claro en que proyecto estamos abriendo la consulta para evitar que llegue a la Unidad equivocada. Si una consulta no se abre en el proyecto adecuado se tiene que cerrar y el usuario deberá abrirla de nuevo en el proyecto correcto. A continuación se muestra el formulario de alta de consulta y se explica como rellenarlo. Lo primero que hay que hacer es seleccionar la categoría a la que se va a asignar esta consulta. Dependiendo del proyecto las categorías van a ser distintas. Es muy importante que se elija adecuadamente la categoría ya que cada una es respondida por un grupo en concreto de personas de soporte. A continuación se muestra una tabla donde se describen las categorías para cada proyecto: CATEGORIAS PROYECTO ARQUITECTURA SOPORTE: Categoria Descripción ACCESO ACTIVEX ASF Solicitudes de acceso a esta herramienta de soporte para proveedores externos que no son servicios de cmma o nocmma. Se hará la solicitud indicando nombre de la empresa, nombre del proyecto y dirección de correo para asociar a la cuenta. Consultas sobre utilización de ActiveX comunes. Consultas sobre uso de la plataforma multipki ASF (firma digital y Página 10 de 22

11 certificados digitales) BASE DE DATOS BPM BUS BUSINESS OBJECTS DELPHI ENTORNOS FATWIRE CONTENT SERVER FORMS Consultas sobre normativa de base de datos y modelos comunes. Consultas sobre BPM Consultas sobre el desarrollo en el Oracle Service Bus Consultas sobre la plataforma de Business Objects Consultas sobre desarrollo y componentes Delphi de ICM Consultas relacionadas con el entorno de desarrollo. Consultas relacionadas con el desarrollo de portales con Fatwire Content Server. Consultas relacionadas con el desarrollo en Forms Developer FRAMEWORK 2 Consultas relacionadas con el desarrollo en Framework 2. FRAMEWORK ATLAS FRAMEWORK JUSTICIA GESTION DOCUMENTAL GESTOR (GEA) Consultas relacionadas con el desarrollo en Framework Atlas. Consultas relacionadas con el desarrollo en Framework de Justicia Consultas relacionadas con el desarrollo con el gestor documental Documentum Consultas relacionadas con el desarrollo con el Gestor expedientes GEA MIGRACION WEBLOGIC 11 Consultas relacionadas con migración a Weblogic 11 SEGURIDAD SUBVERSION Consultas relacionadas con la seguridad en las aplicaciones: autenticación y autorización, certificados digitales, auditoría de seguridad, firmas, etc. Consultas relacionadas con creación de repositorios de subversión y con asignación de usuarios a repositorios. Este tipo de solicitudes siempre han de venir por parte de un responsable de ICM. CATEGORIAS PROYECTO CALIDAD: Categoria CALIDAD BASE DE DATOS ERWIN 7 Descripción Consultas relacionadas sobre el resultado de análisis realizado con la herramienta SAVT sobre modelos de datos Erwin v7. Página 11 de 22

12 CALIDAD BASE DE DATOS ERWIN 4 CALIDAD FRAMEWORK 2 CALIDAD FRAMEWORK 2 + WEBLOGIC CALIDAD FRAMEWORK ATLAS CALIDAD FRAMEWORK JUSTICIA CALIDAD CONSULTAS SOBRE REVISIONES TECNICAS CALIDAD CONSULTAS SOBRE PRUEBAS DE RENDIMIENTO CALIDAD GESTIÓN DE USUARIOS EN SAVT Consultas relacionadas sobre el resultado de análisis realizado con la herramienta SAVT sobre modelos de datos Erwin v4. Consultas relacionadas sobre el resultado de análisis realizado con la herramienta SAVT sobre módulos técnicos con tecnología Framework2 Consultas relacionadas sobre el resultado de análisis realizado con la herramienta SAVT sobre módulos técnicos con tecnología Framework2 y Weblogic Consultas relacionadas sobre el resultado de análisis realizado con la herramienta SAVT sobre módulos técnicos con tecnología Framework Atlas. Consultas relacionadas sobre el resultado de análisis realizado con la herramienta SAVT sobre módulos técnicos con tecnología Framework Justicia. Consultas relacionadas sobre las revisión técnicas de módulos Consultas relacionadas sobre las pruebas de rendimiento de módulos técnicos. Solicitud de gestión de usuarios en SAVT. Página 12 de 22

13 A la hora de crear una nueva consulta encontrará los siguientes campos: Categoría(obligatorio): Desplegable que permite seleccionar la categoría a la que pertenece la consulta. Reproducibilidad: Desplegable para en el caso de comunicar un error que permite indicar en qué casos se produce el error. Resumen (obligatorio): Frase descriptiva de la consulta. Este texto no puede ser muy largo ya que aparece en todos los listados de consultas. Aquí se tiene que poner un texto resumen y en el campo descripción más detallado. Descripción (obligatorio): Descripción detallada de la consulta. Es muy importante describir con suficiente detalle la consulta/incidencia. Pasos para reproducirlo: En el caso de que se trate de un error se deben indicar los pasos para reproducirlo y usuario/password necesarios para poder acceder en el caso de que sea necesario. Información adicional: Campo que permite añadir más información al bug.. Módulo técnico(obligatorio): Nombre del módulo técnico. Subir Archivo: Permite subir un archivo que añada información sobre la consulta como, por ejemplo, una captura de pantalla explicativa o un documento con un texto a introducir, un fichero de configuración, un fichero de log. En este formulario se podrá subir un único archivo. Si desea subir más de un archivo a una misma consulta deberá guardarla y, a continuación, volver a acceder a la consulta para modificarla. Página 13 de 22

14 Continuar informando: Al marcar esta casilla y guardar la consulta, el sistema muestra de nuevo el formulario de reportar incidencia. Una vez rellenos los campos se pulsa el botón Enviar Reporte. Esta consulta quedará en estado recibida y podemos verla desde la opción Mi Vista. Cuando ya se ha dado de alta una consulta y para que los responsables de ICM del proyecto estén informados es necesario incluirlos en la monitorización de la incidencia. En el apartado Monitorizar se indica como incluir a usuarios que monitoricen esta incidencia. Importante Cada vez que se registré una nueva consulta hay que incluir al responsable de ICM del proyecto y otros interesados de ICM en la lista de usuarios que monitorizan la consulta. Cuando se reciba una consulta si esta no está monitorizará por alguien de ICM no será aceptada y se cambiará al estado se necesitan más datos informando de esta situación. Página 14 de 22

15 3.4. MONITORIZACION (USUARIO) Qué implica monitorizar una incidencia? Todas las personas que estén monitorizando una consulta recibirán un correo cada vez que haya un cambio en dicha consulta. El cambio puede ser: añadir una nota, cambio de estado, asignación, cierre de la consulta, etc. Toda consulta debe estar monitorizada por al menos un responsable de ICM. Esta persona ha de estar dada de alta en la web de consultas soportesw ya que la monitorización se realiza incluyendo el login de las personas que van a monitorizar la consulta AÑADIR USUARIOS A MONITORIZAR UNA CONSULTA La persona que da de alta la incidencia tiene que incluir a las personas de ICM que van a monitorizar esta consulta. Esto se hace entrando a editar una consulta y en el apartado Usuarios monitorizando esta Incidencia poner el login de la persona y pulsar Agregar. Los usuarios que se vayan añadiendo recibirán un correo avisando de que se les ha incluido en la monitorización de la consulta. La incidencia está ahora siendo monitorizada por el usuario bdr Reportada por: CMMA31_INDRA Asignada a: DGAAASOP Proyecto: SOPORTE ID de la incidencia: 1173 Categoría: BUSSINESS OBJECTS Reproducibilidad: no se ha intentado Severidad: menor Prioridad: normal Estado: asignada Aplicacion: EJPL_INTRA Fecha de Envío: :53 CEST Última Modificación: :56 CEST Página 15 de 22

16 Resumen: Problema con los informes de Crystal Reports Descripción: Estamos teniendo problemas con los informes de crystal reports despues de migrar a weblogic. Historial de la Incidencia Fecha de ModificaciónUsuario Campo Cambio :53 CMMA31_INDRA Nueva Incidencia :53 CMMA31_INDRA Estado nueva => asignada :53 CMMA31_INDRA Asignada a => DGAAASOP :56 CMMA31_INDRA Incidencia Monitorizada: bdr MONITORIZAR UNA CONSULTA Si alguien quiere incluirse en la monitorización de una incidencia también lo puede hacer editando la consulta y pulsando sobre el botón Monitorizar GESTION DE LA CONSULTA POR LA UNIDAD CORRESPONDIENTE ACEPTACION Cuando la persona asignada a la consulta comienza a trabajar con ella le cambia el estado a aceptada (siempre y cuando esté monitorizada por alguien de ICM). Este estado se puede comprobar en la opción de Mi Vista. Las consultas aceptadas aparecen en otro color PEDIR MAS INFORMACIÓN/DATOS Si necesita más información o pruebas a realizar entonces le cambia el estado a se necesitan más datos describiendo los datos que precisa. Esto provoca el envío de un correo al usuario que abrió la consulta y a los usuarios que la están monitorizando. A partir de este momento la consulta se queda pendiente del usuario. Aquí podemos ver un ejemplo de correo donde se requiere más información. Página 16 de 22

17 La siguiente incidencia requiere MAS INFORMACION (opinión). Reportada por: CMMA31_INDRA Asignada a: carlos Proyecto: SOPORTE ID de la incidencia: 1188 Categoría: SEGURIDAD Reproducibilidad: no se ha intentado Severidad: menor Prioridad: normal Estado: se necesitan más datos Módulo Técnico: EJPL_INTRA Fecha de Envío: :08 CEST Última Modificación: :16 CEST Resumen: Puedo acceder a las tablas de USUI desde mi aplicación Descripción: fdasf asdfsd ( ) CMMA31_INDRA (desarrollador) : Para que necesitáis acceder a estas tablas? Historial de la Incidencia Fecha de ModificaciónUsuario Campo Cambio :08 CMMA31_INDRA Nueva Incidencia :08 CMMA31_INDRA Asignada a => carlos :09 carlos Estado nueva => aceptada :09 carlos Estado aceptada => se necesitan más datos :10 CMMA31_INDRA Nota Añadida: :10 CMMA31_INDRA Estado se necesitan más datos => nueva :12 carlos Estado nueva => aceptada :13 carlos Estado aceptada => se necesitan más datos :13 CMMA31_INDRA Nota Añadida: :13 CMMA31_INDRA Estado se necesitan más datos => nueva :16 carlos Estado nueva => aceptada :16 carlos Estado aceptada => se necesitan más datos ARQUITECTURASW_INTRO CERRAR Si el equipo de soporte ya dispone de una respuesta o solución se cambia el estado a cerrada indicando dicha respuesta o solución. Esto envía un correo al usuario que abrió la consulta y a los usuarios que la están monitorizando. A continuación se muestra el contenido de un correo de cierre de consulta. La siguiente incidencia ha sido CERRADA Reportada por: CMMA31_INDRA Asignada a: e_rjs8 Página 17 de 22

18 Proyecto: SOPORTE ID de la incidencia: 1166 Categoría: ENTORNOS Reproducibilidad: no se ha intentado Severidad: menor Prioridad: normal Estado: cerrada Aplicacion: EJPL_INTRA Resolución: abierta Resuelta en versión: Fecha de Envío: :03 CEST Última Modificación: :25 CEST Resumen: Error de conexión a base de datos Descripción: Mi aplicación ejpl_intra que se encuentra desplegada en weblogic de framework 2 está teniendo problemas de acceso a base de datos. El error que se obtiene es "Too many cursors open". Pasos para Reproducir: Entrar en la ruta: e identificarse con el usuario ADMON/ADMON. En la primerá página ya aparece el error ( ) DGAAASOP (administrador) : Se añade una nota a la consulta ( ) DGAAASOP (administrador) : Se cierra por que se ha solucionado el problema técnico Historial de la Incidencia Fecha de ModificaciónUsuario Campo Cambio :03 CMMA31_INDRA Nueva Incidencia :03 CMMA31_INDRA Estado nueva => asignada :03 CMMA31_INDRA Asignada a => DGAAASOP :42 CMMA31_INDRA Incidencia Monitorizada: bdr :02 DGAAASOP Nota Añadida: :25 DGAAASOP Nota Añadida: :25 DGAAASOP Estado asignada => cerrada 3.6. APORTAR MAS INFORMACIÓN (USUARIO) En cualquier momento el usuario puede aportar más información a la consulta esto se hace accediendo al detalle de la misma y agregando notas. Para acceder a la consulta podemos hacerlo desde Mi Vista y pulsando sobre el número de la consulta. Una vez que estamos en el detalle de la consulta nos vamos al apartado Agregar nota y escribiendo en la caja de texto y pulsando el botón Agregar Nota la consulta ya se ha actualizado. Esto provoca el envío de un correo a los usuarios que están monitorizando la consulta. Página 18 de 22

19 Esto es lo mismo que se tiene que hacer cuando al usuario se le requiere más información. Cada vez que se añade una nota la consulta pasa a estado recibida para que la persona de soporte tenga conocimiento de que dicha consulta ha sido modificada CIERRE DE CONSULTAS (USUARIO) Ya hemos comentado que lo habitual es que el personal de soporte sea el que cierre la consulta con una respuesta/solución pero igualmente la persona que abrió la consulta puede cerrar la misma si lo considera oportuno. Para cerrar una consulta desde la vista de detalle de la consulta y se pulsa el botón Cambiar estado a (cerrada). Esto nos va a mostrar una pantalla para indicar el motivo del cierre. Este cierre igualmente enviará un correo a los interesados REABRIR CONSULTA (USUARIO) Si no se está de acuerdo con el cierre de la consulta es posible reabrirla. Para ello desde la Vista de Detalles de la consulta se debe pulsar sobre el botón Reabrir y agregar un nota sobre el motivo de la reapertura. Cuando se reabre una consulta igualmente se recibe un correo indicando esta actualización. Página 19 de 22

20 3.9. MI VISTA Desde la opción Mi Vista se tiene un lista de las distintas incidencias agrupadas en apartados según distintos criterios. Aquí podemos localizar fácilmente las incidencias que hemos abierto que estarían en el apartado Reportadas por mí. En esta pantalla se muestran todas las incidencias a las que tiene acceso el usuario. Salen en distintos apartados y las 10 primeras de cada uno de ellos. Todas las incidencias/consultas de soporte son públicas por lo tanto todos los usuarios tienen acceso a todas las consultas, no solo a las que ha creado él. A continuación se muestra una lista de los distintos apartados y la descripción de los mismos: No asignadas: Consultas pendientes de asignación. Resueltas: Consultas que ya se han resuelto/cerrado. Monitorizadas por mí: Aquellas consultas que el usuario actual está monitorizando. Reportadas por mí: Consultas que el usuario actual ha dado de alta. Modificadas recientemente: Aquellas consultas que se han actualizado recientemente. Si pulsamos en el número de la consulta se abre el detalle de la misma y se puede actualizar añadiendo notas. Además existe un código de colores que nos indica el estado de las consultas. Página 20 de 22

21 3.10. BUSQUEDA DE CONSULTAS Se puede buscar una consulta desde la opción Ver incidencias donde aparece una lista de filtros a aplicar y una vez indicados los filtros pulsamos sobre el botón Filtrar nos aparece la lista de consultas que cumplen con el filtro. Pulsando sobre el ID de la consulta accedemos a la vista de detalle de la consulta. Si se conoce el número de la consulta se puede acceder directamente indicando el número en la caja que aparece en la esquina superior derecha y pulsar sobre el botón Ir a incidencia. Página 21 de 22

22 Atención La busqueda tiene en cuenta el combo de proyectos. Si está seleccionado Todos los proyectos realiza la busqueda sobre todo y si se ha seleccionado un proyecto concreto realiza la búsqueda sobre este proyecto concreto RECORDAR PASSWORD En el caso de que una vez registrados no se recuerde la password, desde la ventana de autenticación pulsando sobre la opción Olvidó su contraseña? se muestra una pantalla para incluir los datos de usuario (login) y correo electrónico y mandará un correo a dicha dirección con un enlace para actualizar la contraseña. Página 22 de 22