Interconexión Back Office - Web Service Aprecia

De Telstock Wiki
Saltar a: navegación, buscar

Los componentes Back Office y Web Service del sistema TManager Aprecia se encuentran interconectados entre sí de forma unidireccional, en el sentido BO -> WS. Es decir, el BO de un ambiente TM Aprecia contiene una referencia de servicio que apunta al WS del mismo ambiente y consume varios de los endpoints (métodos) con los que cuenta dicho WS, en específico para funcionalidades que involucran interacción entre el BO y el WS CREDI ERP como los módulos Simulador de Crédito o Solicitud de Crédito del menú Prospectos

En algunas situaciones es necesario modificar la URL del WS Aprecia, en casos especiales como:

  • Levantamiento de nuevos ambientes del sistema TManager Aprecia
  • Ventanas de mantenimiento o actualización


En este caso, el procedimiento a seguir para actualizar la referencia al WS depende del tipo de ambiente, como se detalla a continuación


Ambientes no productivos

  1. Abrir conexión vía VNC al servidor del ambiente donde se solicita el cambio (Desarrollo, QA, HotFixes, Preproductivo, etc)
  2. Dentro del servidor, abrir una nueva ventana de Explorador de Windows y localizar la ruta E:\Aprecia-FE (también puede encontrarse como E:\Aprecia). Si no se encuentra tal ruta, abrir el Administrador de IIS, y dentro del sitio llamado DefaultWebSite buscar la aplicación con nombre Aprecia o Aprecia-FE, hacer clic derecho sobre el nombre de aplicación y seleccionar la opción Explorar, lo cual nos llevará a la ruta física actual de la aplicación
  3. Una vez encontrado el directorio de aplicación, ingresar a la ruta App_WebReferences\WSAprecia y abrir los archivos ubicados en las rutas siguientes dentro del mismo en un editor de texto. Si se encuentra en su equipo local y se cuenta con el acceso al repositorio Aprecia-FE, abrir la solución en Visual Studio y editar allí los mismos archivos
    1. WS_Aprecia.disco
    2. WS_Aprecia.discomap
    3. WS_Aprecia.wsdl
    4. Así como el archivo Web.config ubicado en la carpeta raíz del proyecto
  4. En el archivo Web.config, localizar la sección appSettings, y dentro de ella la variable con nombre WSAprecia.WS_Aprecia, copiando su valor al portapapeles
<add key="WSAprecia.WS_Aprecia" value="https://aprecia.tmanager.com.mx/WS_Aprecia/WS_Aprecia.asmx" />
  1. Con ayuda del editor de texto seleccionado, buscar la URL copiada durante el paso anterior y reemplazar todas las coincidencias encontradas en los otros tres archivos abiertos, por la nueva URL
  2. Guardar cambios para los cuatro archivos


Si fuera necesario, solicitar apoyo al Coordinador de Desarrollo para copiar la nueva URL del WS al portapapeles del servidor


Producción

  1. Clonar el repositorio de nombre Aprecia-FE a un directorio en el equipo local, y hacer check out a la rama master
  2. Abrir el proyecto en Visual Studio
  3. Repetir los pasos 3 a 6 descritos en la sección anterior para cambiar la URL del WS, esta vez sobre la carpeta local en donde se clonó el repositorio Aprecia-FE, con excepción de la edición del archivo Web.config (éste será editado en un paso posterior, directamente en el servidor)
  4. Una vez guardados los cambios, ejecutar la tarea Recompilar solución, validando que la compilación se complete sin errores
  5. Compilar y publicar los archivos del proyecto por medio de la opción Publicar aplicación web de Visual Studio, siguiendo los pasos a continuación:
    1. Método de publicación: Sistema de archivos
    2. Ubicación de destino: Seleccionar una carpeta de destino propia y separada del directorio donde se ubica el código fuente del proyecto
    3. Configuración: Debug
    4. Opciones de publiación de archivos: Marcar las opciones Precompilar durante publicación y Eliminar todos los archivos existentes antes de publicar
  6. Abrir conexión VNC con el servidor donde esté desplegado el BO Aprecia para el ambiente productivo, y abrir el Administrador de IIS para localizar la ruta de despliegue de la aplicación Aprecia, con click derecho sobre el nombre de aplicación -> Explorar. Por defecto es E:\Aprecia
  7. En el equipo local, dentro del directorio donde fue publicado el proyecto copiar los elementos siguientes
    1. Carpetas bin y Errores (NO INCLUIR NINGUNA OTRA CARPETA, especial cuidado con NO copiar la carpeta images que no debe ser reemplazada en el ambiente productivo por ningún motivo)
    2. Todos los archivos sueltos en la carpeta raíz del proyecto (extensiones .aspx, .html, .dll, .config), con excepción de Web.config
  8. Regresar a la conexión VNC con el servidor productivo y pegar los elementos previamente copiados en el directorio de despliegue del BO, con la opción de Reemplazar los archivos en el destino
  9. Abrir el archivo Web.config del ambiente productivo y modificar el valor de la variable siguiente con la nueva URL del WS
<add key="WSAprecia.WS_Aprecia" value="https://aprecia.tmanager.com.mx/WS_Aprecia/WS_Aprecia.asmx" />



Notas generales

  • En ambos escenarios, al finalizar las modificaciones es necesario validar que el sitio web para el Back Office se encuentra accesible, ingresando a su URL correspondiente en un navegador y verificando que se muestra correctamente la lista de métodos disponibles
  • No es necesario reiniciar el DefaultWebSite en el Administrador IIS del servidor para que se reflejen los cambios, al momento de guardar o reemplazar los archivos modificados la aplicación se recompila automáticamente incluyendo el cambio de URL
Obtenido de «http://mantisbt.tmanager.com.mx/mediawiki/index.php?title=Interconexión_Back_Office_-_Web_Service_Aprecia&oldid=5371»