Wiki

Has cargado una revisión vieja del documento! Si la guardas crearás una versión nueva con estos datos.

====== PBtoWS - Proceso - Backend: Creación de Proxy para consumo de servicios ======
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.

===== Pasos Previos =====
Antes de crear un proyecto PB ((PB: PowerBuilder)) 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.

==== Ejemplo ====
Directorio del Componente:
{{ :ada:tips:sicoferp:general:pbtows:procesos:0adirproxy.png?600 |}}

Ruta del Componente Proxy (Se replica la estrcutura del directorio del componente dentro del directorio Proxy)
{{ :ada:tips:sicoferp:general:pbtows:procesos:0bdirproxy.png?600 |}}

Crear Libreria para almancenar los Objetos del Proxy
{{ :ada:tips:sicoferp:general:pbtows:procesos:0cdirproxy.png?600 |}}

Verificar que el servicio es accesible desde el navegador
{{ :ada:tips:sicoferp:general:pbtows:procesos:0ddirproxy.png?600 |}}

===== Creación de Componente Proxy =====
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:

==== Paso 0: Seleccionar el Proyecto Proxies ====
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.
{{ :ada:tips:sicoferp:general:pbtows:procesos:01proyecto.png?600 |}}

==== Paso 1: Nuevo Target ====
  - Click derecho sobre la raíz del proyecto
  - Seleccionar la opción **New**
  - Desplazarse a la pestaña **Project**
  - Seleccionar el Proyecto **Web Service Proxy Wizard**

{{ :ada:tips:sicoferp:general:pbtows:procesos:02Crear Proyecto.png?600 |}}

==== Paso 2: Siga al paso siguiente  ====
{{ :ada:tips:sicoferp:general:pbtows:procesos:03Crear Proyecto.png?600 |}}

==== Paso 3: WSDL ====
Ingresar la url del servicio SOAP (Tener presente que url debe terminar con la siguiente estructura **?WSDL**).
{{ :ada:tips:sicoferp:general:pbtows:procesos:04Crear Proyecto.png?600 |}}

==== Paso 4: Seleccionar el Servicio ====
Si la url es accesible en este paso se listaran los servicios disponibles. Seleccione el servicio que va a soportar el componente.
{{ :ada:tips:sicoferp:general:pbtows:procesos:05Crear Proyecto.png?600 |}}

==== Paso 5: Seleccionar el Proxy para el Servicio ====
Powerbuilder identifica los proxy disponibles para el servicio procesado. Seleccione el Proxy que desea utilizar (En la mayoria de lso casos solo debe ser uno).
{{ :ada:tips:sicoferp:general:pbtows:procesos:06Crear Proyecto.png?600 |}}

==== Paso 6: Prefijo para el Proxy ====
Powerbuilder permite utilizar prefijos en la definición del Proxy. Sin embargo no se recomienda porque eso implica modificar la estructura estandar de configuración de componentes. Continue al paso siguiente.
{{ :ada:tips:sicoferp:general:pbtows:procesos:07Crear Proyecto.png?600 |}}

==== Paso 7: Libreria del Proyecto Proxy ====
Antes de iniciar la creación del componente proxy **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]**
{{ :ada:tips:sicoferp:general:pbtows:procesos:08Crear Proyecto.png?600 |}}

==== Paso 8: Libreria para almacenar los objetos del Proxy ====
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 ningun 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)
{{ :ada:tips:sicoferp:general:pbtows:procesos:09Crear Proyecto.png?600 |}}
{{ :ada:tips:sicoferp:general:pbtows:procesos:10Crear Proyecto.png?600 |}}

==== Paso 9: Referencias de APIs requeridas  ====
Ignorar este paso por el momento
{{ :ada:tips:sicoferp:general:pbtows:procesos:new_target_10.png?600 |}}

==== Paso 10: Configuración de despliegue  ====
Ingrese la información que indica la imagen
{{ :ada:tips:sicoferp:general:pbtows:procesos:new_target_11.png?600 |}}

==== Paso 11: Confirmar cambios  ====
Confirme la configuración para crear el proyecto
{{ :ada:tips:sicoferp:general:pbtows:procesos:new_target_12.png?600 |}}

==== Paso 12: Verificación  ====
Si realizó todos los pasos anteriores al confirmar los cambios verá el nuevo proyecto adiconado a su copia local
{{ :ada:tips:sicoferp:general:pbtows:procesos:proyecto_1.png?600 |}}

==== Paso 13: Librerias de Trabajo  ====
Cree las librerias básicas para el componente:
  * **Modelo**: Libreria utilizada para las definiciones de consultas y datawindows
  * **Controller**: Librerias que contendrán el código PB de los procesos del componente

{{ :ada:tips:sicoferp:general:pbtows:procesos:proyecto_2.png?600 |}}
{{ :ada:tips:sicoferp:general:pbtows:procesos:proyecto_3.png?600 |}}
{{ :ada:tips:sicoferp:general:pbtows:procesos:proyecto_4.png?600 |}}

==== Paso 14: Organización del Proyecto  ====
Ordene las libreria de la siguente forma como lo muestra la siguiente imagen
{{ :ada:tips:sicoferp:general:pbtows:procesos:proyecto_5.png?600 |}}

==== Paso 15: Clase de Invoación de Servicios  ====
Extienda la clase n_cst_service para crear la clase de invocación de servicios del componente.
{{ :ada:tips:sicoferp:general:pbtows:procesos:proyecto_6.png?600 |}}

==== Paso 16: Proyecto Configurado  ====
El objetivo de estos pasos es la creación del proyecto, organización estandar del proyecto y creación de la clase de invocación de los servicios. 
{{ :ada:tips:sicoferp:general:pbtows:procesos:proyecto_7.png?600 |}}

==== Paso 17: Subir los cambios   ====
Si el resultado de su configuración es similar a la imagen del **Paso 16**, el proyecto está listo para trabajar. El siguiente paso consistirá en subir los cambios a la ruta de la copia del repositorio manteniendo la misma estructura (La carga inicial se debe realziar manual, es decir se debe copiar la carpeta local en la ruta del repositorio local).
{{ :ada:tips:sicoferp:general:pbtows:procesos:proyecto_8.png?600 |}}
{{ :ada:tips:sicoferp:general:pbtows:procesos:proyecto_9.png?600 |}}

[[ada:tips:sicoferp:general:pbtows:procesos|←Volver atrás]]

Resumen de la edición

Wiki

Herramientas de usuario

Herramientas del sitio

Herramientas de la página