====== PBtoWS - Despliegue Servicios SOAP ======
Este capitulo contiene información relacionada con el proceso de despligue de los componentes generados

===== Pasos Previos =====
Los despliegues deben realizarse en un servidor IIS el cual puede ser de ambito local (PC Desarrollador) ó en el servidor de pruebas de Desarrollo el cual esta en la IP 10.1.40.170 y ya esta configurado con las librerias requeridas((Para acceder a este equipo debe solicitar acceso por RDP al administrador ó área de TI)).

===== Configuración del Proyecto =====
Cada componente que vaya a ser desplegado debe tener una configuración de librerias segun el alcance de la funcionalidad estas librerias hacen parte del core de la versión de powerbuilder y del servidor web por lo tanto  no es necesario realizar instalaciones complementarias. Sin embargo para procesos de validación asegurese que el proyecto tiene configurados los siguientes componentes en la maquina donde realizará el despliegue:

  * Servidor Web IIS((Internet Information Server)) 7.5 o posterior.
  * Framework .Net 4.02 o posterior
  * Powerbuilder 12.5 o posterior
  * Plugin PBSCC Proxy
  * Driver Nativo Oracle Client 11gR2 o posterior
  * Usuario Windows con permisos de lectura y escritura en las rutas del proyecto y del servidor web
  * Tnsnames con las conexiones configuradas de la base de datos de configuración y al menos una base de datos de prueba.

===== Listado de Librerias: funcionalidades soportadas por los Servicios SOAP Powerbuilder =====
El siguiente listado contiene las funcionalidades que se soportan en los componentes que pueden ser expuestos en servicios SOAP.

==== All ====
  * pbshr120.dll
  * Sybase.PowerBuilder.ADO.dll
  * Sybase.PowerBuilder.Common.dll
  * Sybase.PowerBuilder.Core.dll
  * Sybase.PowerBuilder.Interop.dll
  * Sybase.PowerBuilder.Web.dll
  * Sybase.PowerBuilder.Win.dll

==== .NET Web Forms and ADO.NET ====
  * pbrth120.dll

==== Datawindows and Datastores ====
  * pbdwm120.dll
  * Sybase.PowerBuilder.Datawindow.Web.dll
  * Sybase.PowerBuilder.DataWindow.Win.dll
  * Sybase.PowerBuilder.Datawindow.Interop.dll

==== XML export and import  ====
  * PBXerces120.dll
  * xerces-c_2_6.dll
  * xerces-depdom_2_6.dll

==== Web service Datawindows ====
  * Sybase.PowerBuilder.WebService.Runtime.dll
  * Sybase.PowerBuilder.WebService.RuntimeRemoteLoader.dll 

==== Web service clients ====
  * ExPat120.dll
  * libeay32.dll
  * ssleay32.dll
  * xerces-c_2_6.dll
  * xerces-depdom_2_6.dll
  * EasySoap120.dll
  * pbnetwsruntime120.dll
  * pbsoapclient120.pbx
  * pbwsclient120.pbx
  * Sybase.PowerBuilder.WebService.Runtime.dll
  * Sybase.PowerBuilder.WebService.RuntimeRemoteLoader.dll 

==== Database connection tracing (opcional) ====
  * pbtra120.dll
  * pbtrs120.dll

==== Database connectivity runtime files for .NET targets  ====
  * **Informix I-Net 9 native interface** pbin9120.dll 
  * **Oracle8i native interface** pbo84120.dll  
  * **Oracle9i native interface** pbo90120.dll  
  * **Oracle 10g native interface** pbo10120.dll  
  * **SQL Native Client for Microsoft SQL Server native interface** pbsnc120.dll  
  * **Sybase DirectConnect™ native interface** pbdir120.dll  
  * **Sybase Adaptive Server® Enterprise native interface (Version 15 and later)** pbase120.dll  
  * **Sybase Adaptive Server Enterprise native interface** pbsyc120.dll  
  * **ADO.NET standard interface** pbado120.dll, pbrth120.dll, Sybase.PowerBuilder.Db.dll, Sybase.PowerBuilder.DbExt.dll
  * **JDBC standard interface** pbjvm120.dll, pbjdb120.dll, pbjdbc12120.jar
  * **ODBC standard interface** pbodb120.dll, pbodb120.ini 
  * **OLE DB standard interface** pbole120.dll, pbodb120.ini

===== Listado genérico de Librerias: Componente Powerbuilder SICOF ERP =====
El siguiente listado corresponde a la confiuración básica que deben tener los proyectos powerbuilder de los componentes migrados de SICOF ERP. Por temas de simplificación se omiten las rutas absolutas de las librerias:

  * ..\..\..\..\..\..\..\..\..\oraclexe\app\oracle\product\11.2.0\server\odp.net\bin\2.x\Oracle.DataAccess.dll
  * ..\..\..\..\..\..\..\..\..\Program Files (x86)\Sybase\PowerBuilder 12.5\DotNET\bin\Sybase.PowerBuilder.Common.dll
  * ..\..\..\..\..\..\..\..\..\Program Files (x86)\Sybase\PowerBuilder 12.5\DotNET\bin\Sybase.PowerBuilder.Core.dll
  * ..\..\..\..\..\..\..\..\..\Program Files (x86)\Sybase\PowerBuilder 12.5\DotNET\bin\Sybase.PowerBuilder.ADO.dll
  * ..\..\..\..\..\..\..\..\..\Program Files (x86)\Sybase\PowerBuilder 12.5\DotNET\bin\Sybase.PowerBuilder.DataWindow.Interop.dll
  * ..\..\..\..\..\..\..\..\..\Program Files (x86)\Sybase\PowerBuilder 12.5\DotNET\bin\Sybase.PowerBuilder.DataWindow.Web.dll
  * ..\..\..\..\..\..\..\..\..\Program Files (x86)\Sybase\PowerBuilder 12.5\DotNET\bin\Sybase.PowerBuilder.DataWindow.Win.dll
  * ..\..\..\..\..\..\..\..\..\Program Files (x86)\Sybase\PowerBuilder 12.5\DotNET\bin\Sybase.PowerBuilder.Db.dll
  * ..\..\..\..\..\..\..\..\..\Program Files (x86)\Sybase\PowerBuilder 12.5\DotNET\bin\Sybase.PowerBuilder.DbExt.dll
  * ..\..\..\..\..\..\..\..\..\Program Files (x86)\Sybase\PowerBuilder 12.5\DotNET\bin\Sybase.PowerBuilder.Interop.dll
  * ..\..\..\..\..\..\..\..\..\Program Files (x86)\Sybase\PowerBuilder 12.5\DotNET\bin\Sybase.PowerBuilder.Web.dll
  * ..\..\..\..\..\..\..\..\..\Program Files (x86)\Sybase\PowerBuilder 12.5\DotNET\bin\Sybase.PowerBuilder.Web.WebService.dll
  * ..\..\..\..\..\..\..\..\..\Program Files (x86)\Sybase\PowerBuilder 12.5\DotNET\bin\Sybase.Powerbuilder.WebService.Runtime.dll
  * ..\..\..\..\..\..\..\..\..\Program Files (x86)\Sybase\PowerBuilder 12.5\DotNET\bin\Sybase.PowerBuilder.WebService.RuntimeRemoteLoader.dll
  * ..\..\..\..\..\..\..\..\..\Program Files (x86)\Sybase\PowerBuilder 12.5\DotNET\bin\Sybase.PowerBuilder.WebService.WSDL.dll
  * ..\..\..\..\..\..\..\..\..\Program Files (x86)\Sybase\PowerBuilder 12.5\DotNET\bin\Sybase.PowerBuilder.WebService.WSDLRemoteLoader.dll
  * ..\..\..\..\..\..\..\..\..\Program Files (x86)\Sybase\PowerBuilder 12.5\DotNET\bin\Sybase.PowerBuilder.Win.dll
  * ..\..\..\..\..\..\..\..\..\Program Files (x86)\Sybase\Shared\PowerBuilder\PBDWM125.DLL
  * ..\..\..\..\..\..\..\..\..\Program Files (x86)\Sybase\Shared\PowerBuilder\pbo10125.dll
  * ..\..\..\..\..\..\..\..\..\Program Files (x86)\Sybase\Shared\PowerBuilder\PBODB125.DLL
  * ..\..\..\..\..\..\..\..\..\Program Files (x86)\Sybase\Shared\PowerBuilder\pbora125.dll
  * ..\..\..\..\..\..\..\..\..\Program Files (x86)\Sybase\Shared\PowerBuilder\PBSHR125.DLL
  * ..\..\..\..\..\..\..\..\..\Program Files (x86)\Sybase\Shared\PowerBuilder\PBVM125.DLL
===== Proceso de despliegue: Componente Powerbuilder SICOF ERP =====

==== Paso 1: Acceder al Servidor ====
Ingrese al servidor, abra powerbuilder y ubique el proyecto del componente

==== Paso 2: Actualizar proyecto ====
Seleccione la raíz del proyecto y realice la actualización del componente para tomar los cambios realizados. esto se logra ejecutando el comando **Get Lastest Versión...**  

=== Notas ===
  * En algunos casos no se actualiza correctamente la estructura del proyecto. En esos casos debe actualizar directamente la copia svn de su directorio y copiarlo a la copia local gestionada por powerbuilder.


==== Paso 3: Validar las librerias requeridas para el despliegue ====
Teniendo presente las funcionlaidades soportadas por el componente verifique que el proyecto tiene las librerias powerbuilder necesarias para el correcto funcionamiento.

=== Notas ===
Debe tener presente las funcionalidades soportadas del servicio a desplegar para incluir el listado de librerias necesarias para el correcto funcionamiento esos listados pueden ser consultados desde [[#Listado de Librerias: funcionalidades soportadas por los Servicios SOAP Powerbuilder|Listado de Librerias: funcionalidades soportadas por los Servicios SOAP Powerbuilder]]. Sin embargo en la mayortia de los casos basta con agregar el listado genérico el cual puede ser consultado desde [[#Listado genérico de Librerias: Componente Powerbuilder SICOF ERP|Listado genérico de Librerias: Componente Powerbuilder SICOF ERP]].

==== Paso 4: Seleccione las operaciones a desplegar y actualice el Target Namespace ====
Identifique las clases lanzadoras y seleccione las operaciones que se publicarán en el despliegue. Ademas asegurese de modificar la propiedad **Target Namespace** de la pestaña **Object** reemplazando el valor por defecto http://tempurl.org por http://ada.sicoferp.backend.ws.co

==== Paso 5: Mantener la configuración de despliegue en el servidor ====
Este paso es opcional pero se recomienda en el proceso de despliegue. Siempre mantenga el objeto proyecto bloqueado en el servidor de despliegue para mantener actualizada la configuración y evitar cambios por los desarrolladores.

==== Paso 6: Desplegar ====
Una vez validada toda la configuración y seleccionado las operaciones a publicar. Proceda con el deploy del proyecto.

==== Paso 7: Validar Servicios ====
Al finalizar el despliegue valide que las operaciones fueron publicadas correctamente. Para esto apoyese de herramientas de testing como SOAP-UI