Modificación de URL de conexión al WS CREDI ERP desde WS Aprecia

De Telstock Wiki
Saltar a: navegación, buscar

En ocasiones es necesario modificar la URL del web service de CREDI ERP, en casos tales como:

  • Levantamiento de nuevos ambientes del sistema TManager Aprecia
  • Ventanas de mantenimiento o actualización de dicho servicio web
  • Sesiones de pruebas solicitadas por el cliente
  • Incidencias donde el servidor actual del WS deja de estar disponible temporalmente


Cuando se recibe una solicitud de este tipo, el procedimiento a seguir depende del tipo de ambiente. A continuación se listan los escenarios posibles


Ambientes no productivos

  1. Abrir conexión vía VNC al servidor del ambiente donde se solicita el cambio (Desarrollo, QA, etc)
  2. Dentro del servidor, abrir una nueva ventana de Explorador de Windows y localizar la ruta E:\Aprecia-WS\WS_Aprecia. Si no se encuentra tal ruta, abrir el Administrador de IIS, y dentro del sitio llamado DefaultWebSite buscar la aplicación con nombre WS_Aprecia, 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 carpeta WS_Aprecia 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-WS, abrir la solución en Visual Studio y editar allí los archivos
    1. My Project\Settings.Designer.vb
    2. My Project\Settings.settings
    3. Web References\CrediReferenciaN\Reference.map
    4. Web References\CrediReferenciaN\Simulacion.disco
    5. Web References\CrediReferenciaN\Simulacion.wsdl
    6. Web.config
  4. En el archivo Web.config, localizar la sección appSettings, y dentro de ella la variable con nombre UrlWSCredi, copiando su valor al portapapeles
<add key="UrlWSCredi" value="https://apreciaws.sgs-credi-erp.com:562/wsFomepade/Fomepade/Simulacion.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 seis archivos abiertos, por la nueva URL solicitada
  2. Guardar cambios para los seis 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-WS 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-WS, 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 la opción Eliminar todos los archivos existentes antes de publicar
  6. Abrir conexión VNC con el servidor donde esté desplegado el 'WS Aprecia' para el ambiente productivo, y abrir el Administrador de IIS para localizar la ruta de despliegue de la aplicación WS_Aprecia, con click derecho sobre el nombre de aplicación -> Explorar. Por defecto es E:\Aprecia\WS_Aprecia
  7. En el equipo local, dentro del directorio donde fue clonado el repositorio, abrir la ruta \WS_Aprecia y copiar los elementos siguientes
    1. Carpetas bin y Web References
    2. Archivo WS_Aprecia.asmx
  8. Regresar a la conexión VNC con el servidor productivo y pegar los elementos previamente copiados en el directorio de despliegue del WS, 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 las variables siguientes con la nueva URL solicitada por el cliente
<add key="UrlWSCredi" value="https://apreciaws.sgs-credi-erp.com:562/wsFomepade/Fomepade/Simulacion.asmx"/>
<setting name="WS_Aprecia_CrediReferenciaN_Simulacion" serializeAs="String">
   <value>https://apreciaws.sgs-credi-erp.com:562/wsFomepade/Fomepade/Simulacion.asmx</value>
</setting>



Notas generales

  • En ambos escenarios, al finalizar las modificaciones es necesario validar que el servicio WS_Aprecia 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=Modificación_de_URL_de_conexión_al_WS_CREDI_ERP_desde_WS_Aprecia&oldid=5367»