Muestra las diferencias entre dos versiones de la página.
Ambos lados, revisión anterior Revisión previa Próxima revisión | Revisión previa | ||
ada:tips:sicoferp:general:pbtows:procesos:createproxy [2019/09/02 19:35] 172.16.200.205 |
ada:tips:sicoferp:general:pbtows:procesos:createproxy [2019/09/02 20:08] (actual) 172.16.200.205 [PBtoWS - Proceso - Backend: Creación de Proxy para consumo de servicios] |
||
---|---|---|---|
Línea 1: | Línea 1: | ||
- | ====== PBtoWS - Proceso - Backend: Creación de Proxy para consumo de servicios ====== | + | ====== PBtoWS - Proceso - Backend: Creación Componente 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. | 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. | ||
Línea 28: | Línea 28: | ||
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. | 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 |}} | {{ :ada:tips:sicoferp:general:pbtows:procesos:01proyecto.png?600 |}} | ||
+ | {{ :ada:tips:sicoferp:general:pbtows:procesos:18Crear Proyecto.png?600 |}} | ||
==== Paso 1: Nuevo Target ==== | ==== Paso 1: Nuevo Target ==== | ||
Línea 41: | Línea 42: | ||
==== Paso 3: WSDL ==== | ==== Paso 3: WSDL ==== | ||
- | Ingresar la url del servicio SOAP (Tener presente que url debe terminar con la siguiente estructura **?WSDL**). | + | Ingresar la url del servicio SOAP (Tener presente que la url debe terminar con la siguiente estructura **?WSDL**). |
{{ :ada:tips:sicoferp:general:pbtows:procesos:04Crear Proyecto.png?600 |}} | {{ :ada:tips:sicoferp:general:pbtows:procesos:04Crear Proyecto.png?600 |}} | ||
==== Paso 4: Seleccionar el Servicio ==== | ==== 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. | + | Si la url es accesible en este paso se listarán los servicios disponibles. Seleccione el servicio que va a soportar el componente. |
{{ :ada:tips:sicoferp:general:pbtows:procesos:05Crear Proyecto.png?600 |}} | {{ :ada:tips:sicoferp:general:pbtows:procesos:05Crear Proyecto.png?600 |}} | ||
==== Paso 5: Seleccionar el Proxy para el Servicio ==== | ==== 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). | + | 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). |
{{ :ada:tips:sicoferp:general:pbtows:procesos:06Crear Proyecto.png?600 |}} | {{ :ada:tips:sicoferp:general:pbtows:procesos:06Crear Proyecto.png?600 |}} | ||
==== Paso 6: Prefijo para el Proxy ==== | ==== 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. | + | 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. |
{{ :ada:tips:sicoferp:general:pbtows:procesos:07Crear Proyecto.png?600 |}} | {{ :ada:tips:sicoferp:general:pbtows:procesos:07Crear Proyecto.png?600 |}} | ||
==== Paso 7: Libreria del Proyecto Proxy ==== | ==== 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]** | + | 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** |
{{ :ada:tips:sicoferp:general:pbtows:procesos:08Crear Proyecto.png?600 |}} | {{ :ada:tips:sicoferp:general:pbtows:procesos:08Crear Proyecto.png?600 |}} | ||
==== Paso 8: Libreria para almacenar los objetos del Proxy ==== | ==== 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) | + | 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) |
{{ :ada:tips:sicoferp:general:pbtows:procesos:09Crear Proyecto.png?600 |}} | {{ :ada:tips:sicoferp:general:pbtows:procesos:09Crear Proyecto.png?600 |}} | ||
{{ :ada:tips:sicoferp:general:pbtows:procesos:10Crear Proyecto.png?600 |}} | {{ :ada:tips:sicoferp:general:pbtows:procesos:10Crear Proyecto.png?600 |}} | ||
+ | {{ :ada:tips:sicoferp:general:pbtows:procesos:11Crear Proyecto.png?600 |}} | ||
- | ==== Paso 9: Referencias de APIs requeridas ==== | + | ==== Paso 9: Confirmación de Generación ==== |
- | Ignorar este paso por el momento | + | 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. |
- | {{ :ada:tips:sicoferp:general:pbtows:procesos:new_target_10.png?600 |}} | + | {{ :ada:tips:sicoferp:general:pbtows:procesos:12Crear Proyecto.png?600 |}} |
- | ==== Paso 10: Configuración de despliegue ==== | + | ==== Paso 10: Estructura del Proyecto Proxy ==== |
- | Ingrese la información que indica la imagen | + | Al confirmar la configuración se genera el objeto proyecto del proxy el cual puede administrase al seleccionarlo con doble click |
- | {{ :ada:tips:sicoferp:general:pbtows:procesos:new_target_11.png?600 |}} | + | {{ :ada:tips:sicoferp:general:pbtows:procesos:13Crear Proyecto.png?600 |}} |
- | ==== Paso 11: Confirmar cambios ==== | + | ==== Paso 11: Pestaña General ==== |
- | Confirme la configuración para crear el proyecto | + | El Proyecto esta organizado en 2 pestañas. La Pestaña general permite modificar las siguientes propiedades |
- | {{ :ada:tips:sicoferp:general:pbtows:procesos:new_target_12.png?600 |}} | + | * 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. | ||
+ | {{ :ada:tips:sicoferp:general:pbtows:procesos:13Crear Proyecto.png?600 |}} | ||
- | ==== Paso 12: Verificación ==== | + | ==== Paso 12: Pestaña Web Service ==== |
- | Si realizó todos los pasos anteriores al confirmar los cambios verá el nuevo proyecto adiconado a su copia local | + | En esta pestaña se pueden confuirar la siguientes propiedades: |
- | {{ :ada:tips:sicoferp:general:pbtows:procesos:proyecto_1.png?600 |}} | + | * 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** |
- | + | {{ :ada:tips:sicoferp:general:pbtows:procesos:14Crear Proyecto.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 |}} | + | |
+ | ==== Paso 12a: Pestaña Web Service: Services... ==== | ||
+ | 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. | ||
+ | {{ :ada:tips:sicoferp:general:pbtows:procesos:15Crear Proyecto.png?600 |}} | ||
+ | ==== Paso 12a: Pestaña Web Service: Otras propiedades ==== | ||
+ | * 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. | ||
+ | {{ :ada:tips:sicoferp:general:pbtows:procesos:14Crear Proyecto.png?600 |}} | ||
+ | ==== Paso 13: Generar Proyecto Proxy ==== | ||
+ | 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 | ||
+ | {{ :ada:tips:sicoferp:general:pbtows:procesos:16Crear Proyecto.png?600 |}} | ||
+ | ==== Paso 14: Organización del Proyecto ==== | ||
+ | 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 | ||
+ | {{ :ada:tips:sicoferp:general:pbtows:procesos:17Crear Proyecto.png?600 |}} | ||
[[ada:tips:sicoferp:general:pbtows:procesos|←Volver atrás]] | [[ada:tips:sicoferp:general:pbtows:procesos|←Volver atrás]] |