Diferencias

Muestra las diferencias entre dos versiones de la página.

--- ada:tips:sicoferp:general:pbtows:procesos:createproxy [2019/09/02 19:18]
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.
@@ Línea 26: / Línea 26: @@
 ==== Paso 0: Seleccionar el Proyecto Proxies ====
-Abrir el Workspace de migración y ubicarse en la raíz del Target ws00_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 |}}
+{{ :ada:tips:sicoferp:general:pbtows:procesos:18Crear Proyecto.png?600 |}}
 ==== Paso 1: Nuevo Target ====
@@ Línea 38: / Línea 39: @@
 ==== Paso 2: Siga al paso siguiente  ====
-{{ :ada:tips:sicoferp:general:pbtows:procesos:new_target_2.png?600 |}}
+{{ :ada:tips:sicoferp:general:pbtows:procesos:03Crear Proyecto.png?600 |}}
-==== Paso 3: Estructura Limpia ====
+==== Paso 3: WSDL ====
-Definir que se creará un proyecto desde Cero (estructura limpia)
+Ingresar la url del servicio SOAP (Tener presente que la url debe terminar con la siguiente estructura **?WSDL**).
-{{ :ada:tips:sicoferp:general:pbtows:procesos:new_target_3.png?600 |}}
+{{ :ada:tips:sicoferp:general:pbtows:procesos:04Crear Proyecto.png?600 |}}
-==== Paso 4: Definición de Nombre ====
+==== Paso 4: Seleccionar el Servicio ====
-Ingrese un nombre del proyecto (Basado en la Nomenclatura estandar) seleccionando como directorio raíz el nuevo directorio creado en los pasos previos.
+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:new_target_4.png?600 |}}
+{{ :ada:tips:sicoferp:general:pbtows:procesos:05Crear Proyecto.png?600 |}}
-==== Paso 5: Incluir Librerias Core ====
+==== Paso 5: Seleccionar el Proxy para el Servicio ====
-Adicione las librerias del Core al nuevo componente las cuales estaran en la copia local en la ruta: ADA\SICOF**\SICOF PBtoWS\Local\Branches\branches 12.5.2.5.0\Core**
+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:new_target_5.png?600 |}}
+{{ :ada:tips:sicoferp:general:pbtows:procesos:06Crear Proyecto.png?600 |}}
-{{ :ada:tips:sicoferp:general:pbtows:procesos:new_target_6.png?600 |}}
-==== Paso 6: Objeto Lanzador de Servicios ====
+==== Paso 6: Prefijo para el Proxy ====
-Ingrse el nombre de la clase lanzadora de los servicios, recuerde que este nombre debe ser igual al de la definición del proyecto respetando la nomenclatura estandar. No olvide ingresar una descripción.
+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:new_target_7.png?600 |}}
+{{ :ada:tips:sicoferp:general:pbtows:procesos:07Crear Proyecto.png?600 |}}
-==== Paso 7: Directorio Virtual del Web Service ====
+==== Paso 7: Libreria del Proyecto Proxy ====
-Similar al paso anterior ingrese el nombre del directorio virtual para el web service del componente, recuerde que este nombre debe igual al de la definición del proyecto respetando la nomenclatura estandar.
+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:new_target_8.png?600 |}}
+{{ :ada:tips:sicoferp:general:pbtows:procesos:08Crear Proyecto.png?600 |}}
-==== Paso 8: Recursos Locales para el Proyecto ====
+==== Paso 8: Libreria para almacenar los objetos del Proxy ====
-Ignorar este paso por el momento
+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:new_target_9.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: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]]

Wiki

Herramientas de usuario

Herramientas del sitio

Diferencias

Herramientas de la página