Skip to main content

Creación de un conector SOAP

3 Tareas

30 minutos

Visible to: All users
Intermedio Pega Platform 8.7 Integración de datos Español

Escenario

Los socios comerciales del Departamento de Recursos Humanos (RR. HH.) usan una aplicación heredada para ubicar servicios con descuento disponibles para los empleados cerca de su lugar de residencia. Esta aplicación requiere un valor de longitud y latitud para encontrar los servicios con descuento. Para facilitar el uso de esta aplicación heredada, los socios comerciales de RR. HH. pidieron extender la funcionalidad de la aplicación HRApps para que se pueda identificar la longitud y latitud de un determinado código postal.

Cree una regla de integración SOAP y configure una página de datos para invocar el conector SOAP:

  • Cree una regla de integración SOAP para conectarse a un servicio de búsqueda de códigos postales.
  • Cree una regla de análisis en XML para extraer los valores de longitud y latitud a partir de la respuesta del conector SOAP.
  • Cree y configure una página de datos para invocar el conector SOAP.
  • Opcional: Cree y configure un tipo de caso de búsqueda de ubicación para invocar la página de datos.

La siguiente tabla incluye las credenciales que necesita para completar el ejercicio.

Función Nombre de usuario Contraseña
Senior System Architect SSA@TGB pega123!

    Debe iniciar su propia instancia de Pega para completar este Título del desafío.

    La inicialización puede demorar hasta 5 minutos. Le pedimos que tenga paciencia.

    Recorrido del Reto

    Tareas detalladas

    1 Crear una regla de integración SOAP para conectarse a un servicio de búsqueda de códigos postales

    1. En Dev Studio, haga clic en Configure > Integration > Connectors > Create SOAP Integration (Configurar > Integración > Conectores > Crear integración SOAP) para abrir el formulario New SOAP Integration (Nueva integración SOAP).

    2. En el formulario New SOAP Integration (Nueva integración SOAP), haga clic en Upload WSDL from URL (Cargar WSDL de URL) para habilitar la opción de conectarse a una URL.
    3. En el campo Upload WSDL from URL (Cargar WSDL de URL), escriba https://graphical.weather.gov/xml/SOAP_server/ndfdXMLserver.php?wsdl.

    4. Haga clic en Next (Siguiente) para avanzar al paso Select Operations (Seleccionar operaciones).
    5. Desmarque cualquier checkbox de operaciones marcado y seleccione LatLonListZipCode para habilitar la operación.

      Creating the SOAP connector
    6. Haga clic en Next (Siguiente) para avanzar al paso Review (Revisión).
    7. En el campo Nombre (Nombre), escriba LatLongLkp para indicar el nombre de la clase y el identificador del servicio.
    8. En el campo Parent class (Clase padre), confirme que el valor sea PegaHR-Int.
    9. Confirme que esté seleccionada la capa de la aplicación HRApps.
    10. En la sección Add to ruleset, haga clic en Existing (Existente) para habilitar las opciones de versión y nombre del ruleset.
    11. Seleccione la versión más alta disponible del ruleset HRAppsInt.
      review screen
    12. Haga clic en Create (Crear) para crear todas las reglas pertinentes para la nueva integración SOAP.

    2 Cree una regla de análisis de XML para extraer los valores de longitud y latitud a partir de la respuesta del conector SOAP.

    Tip: La regla XML ahora está lista para analizar la respuesta entrante en XML y puede extraer la información contenida entre < latLonList> y < /latLonList>.
    1. En Records Explorer, haga clic en Integration-Connectors > Connect SOAP (Conectores de integración > Conectar SOAP) para ver una lista de las instancias de la regla de conectores SOAP.

    2. Filtre la columna Service Name (Nombre del servicio) para ubicar y abrir el conector SOAP LatLonListZipCode recién creado.
    3. En la pestaña Request (Solicitar), debajo de Request parameters (Solicitar parámetros), verifique que el campo Map from Key (Mapear desde clave) esté configurado con la propiedad .LatLonListZipCodeZipCodeList
    4. En la pestaña Response (Respuesta), en la sección Response parameters (Parámetros de respuesta), en la lista Map to (Mapear a), seleccione XML Parse Rule (Regla de análisis de XML).

    5. En el campo Map to key (Mapear a clave), escriba ParseLatLongResponseXML para darle nombre a la nueva regla de análisis de XML.

      Response xml
       
    6. Haga clic en el ícono Open (Abrir) que está al lado del campo ParseLatLongResponseXML para crear un registro de análisis de XML.
    7. En el campo Root Element Name (Nombre del elemento raíz), escriba dwml para identificar el elemento raíz XML de la respuesta del servicio.
    8. Desde la lista Add to ruleset (Agregar al ruleset), seleccione HRAppsInt y la versión más alta disponible.
    9. Cree una regla de análisis de XML y ábrala.
    10. En la pestaña Mapping (Mapeo), seleccione dwml y haga clic en Add Element (Agregar elemento) para agregar un nuevo elemento secundario. 
      create-a-soap-connector-parse-xml
    11. Haga doble clic en el elemento _new_ para abrir el diálogo User Data (Datos del usuario) para el elemento.
    12. En el campo Node name (Nombre del nodo), escriba latLonList.
    13. En el campo Property (Propiedad), escriba o seleccione .LatLonListZipCodeListLatLonOut.
      create_a_soap_connector_nodename_details
    14. Guarde los cambios en la regla Parse XML.
    15. Vuelva a la pestaña de la regla Connect SOAP (Conectar SOAP) LatLonListZipCode.
    16. En la pestaña Response (Respuesta), en la sección Response parameters (Parámetros de respuesta), en el campo Map to key (Mapear a clave), seleccione ParseLatLongResponseXML dwml como el nuevo valor.
      response-parameters
    17. En la sección de advertencias, haga clic en Review/Edit (Revisar/Editar) para ver las advertencias de contención. 
      guardrail warnings
      Nota: Las advertencias de contención se abordan con las siguientes configuraciones de pasos.
    18. En la pestaña Service (Servicio), en la sección Connection , en el campo Service endpoint URL, escriba =D_pxGetApplicationSettingValue[OwningRuleset:PegaHR, Purpose:ServiceEndpointURL].pySettingValue.

      La regla D_pxGetApplicationSettingValue de la página de datos requiere dos parámetros: OwningRuleset y Purpose (Propósito).

    19. Repita el paso 18 para los campos Response timeout y Authentication profile usando los datos que aparecen en la siguiente tabla.
      OwningRuleset Propósito
      PegaHR ResponseTimeout
      PegaHR AuthenticationProfile
      guardrail-correction
    20. Guarde la regla del conector SOAP y verifique si desaparecen las advertencias.

    3 Cree y configure una página de datos para invocar el conector SOAP.

    1. En Dev Studio, haga clic en Create > Data Model > Data Page (Crear > Modelo de datos > Página de datos) para abrir el formulario Data Page Record Configuration (Configuración de registros de la página de datos).
    2. En el campo Label (Etiqueta), escriba LatLongLookup.
    3. En el campo Apply to (Aplicar a), escriba o seleccione PegaHR-Int-LatLongLkp-ndfdXML para crear la página de datos en el mismo contexto que el conector SOAP.
    4. Desde la lista Add to ruleset (Agregar al ruleset), seleccione HRAppsInt y la versión del ruleset más alta disponible.
    5. Cree una página de datos y ábrala.
    6. En la pestaña Definition (Definición), en la sección Data sources (Orígenes de datos), en la lista Type (Tipo), seleccione SOAP.
    7. En el campo Name (Nombre), escriba o seleccione LatLonListZipCode.
    8. En el campo Request Data Transform (Solicitar data transform), escriba LatLongRequest.
    9. Haga clic en el ícono Open  (Abrir) para crear un nuevo data transform.
      create_a_soap_connector_datapage_datasources
    10. Cree el data transform y ábralo.
    11. En la pestaña Definition (Definición), configure el paso 1 con los siguientes valores de propiedad.
      Nombre de la propiedad Valor
      Acción Establecer
      Destino .LatLonListZipCodeZipCodeList
      Relación igual a
      Origen Param.ZipCode
    12. Guarde los cambios en el data transform.
    13. Vuelva a la pestaña de la página de datosEdit: LatLongLookup.
    14. En la sección Data sources (Orígenes de datos), debajo del campo Request Data Transform (Solicitar data transform), haga clic en Parameters (Parámetros).
      create_a_soap_connector_datapage_datasources_parameters
    15. En el cuadro de diálogo Parameters for LatLongRequest (Parámetros para LatLongRequest), seleccione Pass current parameter page (Transferir página de parámetros actual) para habilitar los parámetros del data transform Request (Solicitar).
    16. Haga clic en Submit (Enviar).
    17. En la pestaña Parameters (Parámetros), agregue un parámetro nuevo que use la siguiente información:
      Campo Valor
      Nombre ZipCode
      Descripción Escriba un código postal para el que quiera buscar la y longitud y latitud
      Tipo de datos Cadena
      Obligatorio
      Inserción/Extracción Inserción
    18. En la pestaña Load Management (Gestión de carga), seleccione Limit to a single data page (Limitar a una sola página de datos).
    19. Guarde los cambios en la página de datos.

    Confirme su trabajo

    1.  Abra la página de datos D_LatLongLookup.
    2. Haga clic en Actions > Run (Acciones > Ejecutar) para ejecutar la página de datos.
    3. En la ventana Run (Ejecutar), en el campo Value (Valor), escriba como 02142 como valor para el parámetro ZipCode.
      Nota: Puede introducir cualquier código postal válido de los EE. UU. en el campo Value .
    4. Haga clic en Run (Ejecutar).
    5. Verifique que la propiedad LatLonListZipCodeListLatLonOut devuelva los valores de las coordenadas de latitud y longitud para el código postal indicado.
      create_a_soap_connector_datapage_runresults

    Opcional: Cree y configure un tipo de caso de búsqueda de ubicación para invocar la página de datos.

    1. Cree una nueva sección en la misma clase que la regla de análisis de XML y llámela Location (Ubicación).
      Tip: El nombre de clase de la regla de análisis de XML es PegaHR-Int-LatLongLkp-ndfdXML
    2. En la regla de sección Location  (Ubicación), agregue .LatLonListZipCodeListLatLonOut como propiedad de solo lectura.
       create_a_soap_connector_location_section_xmlfield_edited
       
    3. Cree un tipo de caso de ubicación y luego edite el nombre de la etapa Create (Crear) para que diga Location Details (Datos de ubicación).
    4. Configure el tipo de caso de ubicación de manera que se vea como en la siguiente imagen.
      location case type
    5. Agregue un campo ZipCode a la vista Location information (Información de ubicación).
    6. En la sección Check location details (Comprobar datos de ubicación), agregue un elemento de botón y configure la acción Refresh this section (Actualizar esta sección) para actualizar la sección y mostrar el valor de propiedad .LatLonListZipCodeListLatLonOut .
      Check location details section
    7. Embeba la sección Location (Ubicación) dentro de la sección Check location details (Comprobar datos de ubicación) y configure la sección embebida para que use una página de datos como el contexto de página para transferir la propiedad .ZipCode como valor de parámetro.
      Tip: Para embeber una sección, en la sección Check location details (Comprobar datos de ubicación), haga clic en Add new > Advanced > Embedded section (Agregar nuevo > Avanzado > Sección embebida).
      create_a_soap_connector_datapage_embeded_section
    8. Confirme su trabajo creando una instancia del tipo de caso de ubicación.
    9. En la página Location information (Información de ubicación), escriba un código postal y haga clic en Check (Comprobar) para actualizar la sección y mostrar el valor de propiedad LatLongListZipCodeListLatLonOut.

      create_a_soap_connector_datapage_verification

     


    Este Reto es para practicar lo aprendido en el siguiente Módulo:


    Disponible en la siguiente misión:

    If you are having problems with your training, please review the Pega Academy Support FAQs.

    ¿Le ha resultado útil este contenido?

    ¿Quiere ayudarnos a mejorar este contenido?

    We'd prefer it if you saw us at our best.

    Pega Academy has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

    Close Deprecation Notice