A continuación se explicará el proceso de creación de proyectos PB para los proxy de consumo interno de los servicios expuestos por los componentes de la migración.

Antes de crear un proyecto PB ¹⁾ debe realizar los siguientes pasos (se deben replicar en la carpeta local):

• Tener presente la Nomenclatura de Componentes
• Crear Directorio raíz: Todos los proyectos deben generarse en la ruta raíz: http://adacsc.co:1443/svn/repository/ADA/SICOF/SICOF%20PBtoWS/Branches/Backend/branches%2012.5.2.5.0/Proxy y deben respetar la estructura del componente al cual se le va a generar el Proxy Ej: Estructura Componente Login: http://adacsc.co:1443/svn/repository/ADA/SICOF/SICOF%20PBtoWS/Branches/Backend/branches%2012.5.2.5.0/00_Main/login Estructura Componente Proxy: http://adacsc.co:1443/svn/repository/ADA/SICOF/SICOF%20PBtoWS/Branches/Backend/branches%2012.5.2.5.0/Proxy/00_Main/Login
• Crear Libreria para el Componente Proxy la cual debe tener la estructura sf[número aplicación]proxy_[nombre componente] Ej: sf00proxy_login
• Disponer de un archivo WSDL del componente al cual se le va a generar un Proxy. Ademas debe asegurarse que la url sea alcanzable por el proxy en el desarrollo y la publicación del servicio.

Directorio del Componente:

Ruta del Componente Proxy (Se replica la estrcutura del directorio del componente dentro del directorio Proxy)

Crear Libreria para almancenar los Objetos del Proxy

Verificar que el servicio es accesible desde el navegador

Abra el proyecto de migración PBtoWS (copia Local) y siga los siguientes pasos como se ilustra en las siguientes imagenes teniendo presente las observaciones de cada paso:

Abrir el Workspace de migración y ubicarse en la raíz del Target ws00_proxies y adicione la nueva libreria solicitada en el paso previo.

1. Click derecho sobre la raíz del proyecto
2. Seleccionar la opción New
3. Desplazarse a la pestaña Project
4. Seleccionar el Proyecto Web Service Proxy Wizard

Ingresar la url del servicio SOAP (Tener presente que la url debe terminar con la siguiente estructura ?WSDL).

Si la url es accesible en este paso se listarán los servicios disponibles. Seleccione el servicio que va a soportar el componente.

Powerbuilder identifica los proxies disponibles para el servicio procesado. Seleccione el Proxy que desea utilizar (En la mayoria de los casos solo debe ser uno).

Powerbuilder permite utilizar prefijos en la definición del Proxy. Sin embargo no se recomienda utilizar prefijos porque eso implica modificar la estructura estandar de configuración de componentes. Continue al paso siguiente.

Antes de iniciar la creación del Componente Proxy. En el Paso 0 se solicitó la creación de una libreria powerbuildr (pbl). En este paso por favor seleccione esa libreria e ingrese el nombre del Proyecto el cual debe tener la siguiente estructura p_ws[código de la aplicación]_proxy_[nombre del componente] Ej p_ws00_proxy_login

En este paso se debe seleccionar la libreria donde se almacenarán los objetos generados por el proxy. Debe ser la misma que se seleccionó en el paso anterior y por ningún motivo se deben utilizar otras librerias ya que eso causará conflictos en la generación y actualización futura de los WSDL (Ejemplo: Incorporación del ESB)

Al seleccionar la libreria, nombre del proyecto, y libreria de almacenamiento de objetos solo resta confirmar la selección la cual debe realizarse en este paso.

Al confirmar la configuración se genera el objeto proyecto del proxy el cual puede administrase al seleccionarlo con doble click

El Proyecto esta organizado en 2 pestañas. La Pestaña general permite modificar las siguientes propiedades

• Deployment PBL: Libreria de despliegue
• Library comments: Comentario de libreria
• Clear deployment PBL on project build: Limpiar proyecto antes de generar. No debe utilizar esta opción ya que borrará todo el proyecto.
• Confirm before removing objects from deployment PBL: Confirmación de Borrado. No debe utilizar esta opción ya que borrará todo el proyecto.
• Proxy name prefix: Prefijo para el nombre del proxy. No debe utilizar prefijos.

En esta pestaña se pueden confuirar la siguientes propiedades:

• WSDL location: Dirección del WSDL. En esta opción se puede actualizar la url del WSDL la cuál será útil en la incorporación del ESB

Se crea un paso especiales para analizar esta propiedad ya que por medio de esta opción se puede modificar la representación, soporte y alcance el Proxy. Siempre se recomienda seleccionar todos los check box de la estructura WSDL como lo muestra la imagen a continuación para no cambiar ese comportamiento.

• WSDL Engine: Motor de generación de los objetos del Proxy. Esta opción siempre debe ser EasySoap para asegurar la utilización del Powerbuilder Classic y facilitar la portabilidad a otras plataformas futuras como Java.
• Firewall settings: Por defecto los servicios son alcanzavles en los ambientes de trabajo. Utilice esta opción cuando existan reestricciones de red.

Pro último solo falta generar los objectos del Proxy en base a la configuración realizada. Para realizar este paso presione el boton que se resalta en la imagen

Si la configuración fue realizada correctamente al finalizar la generación del proyecto se agregarán los objetos que requiere el proxy para consumir los servicios

←Volver atrás