Intercambio de datos a través de Pega Web Mashup
Al agregar Pega Web Mashup a una página web, puede configurar el gadget de mashup para leer datos de una página web y enviar los datos a la página de alojamiento u otro gadget de mashup. La transferencia de datos de esta manera crea una experiencia fluida para los usuarios.
Por ejemplo, un banco con un proceso de resolución de disputas que se implementa en Pega Platform™ tiene clientes que podrían querer cuestionar una transacción reciente que ven en el sitio web del banco desde una lista de la actividad del estado de cuenta (almacenada en un sistema de registro y a la que se accede a través de la página web de la banca en línea). Los detalles de la transacción se transfieren a la aplicación de Pega Platform a través del mashup. El mashup devuelve un Id. de caso al usuario para referencia futura.
Intercambio de datos a través de Pega Web Mashup
Pega Web Mashup admite tres opciones para la transferencia de datos hacia o desde una aplicación de Pega Platform:
- Utilice el atributo data-pega-event-onpagedata para especificar el valor predeterminado para el gadget.
- Utilice la función de Javascript doAction() para establecer o leer los valores de datos desde la página web que aloja el gadget, como al hacer clic en un botón. Invoque la función doAction() con la sintaxis: pega.web.api.doAction([gadgetname],[action],[parameters]).
- Utilice un objeto de acción para ejecutar acciones adicionales en un gadget de web mashup o configure el gadget para que interactúe con otro gadget. Configure un objeto de acción como un script en la etiqueta DIV del gadget y especifique los atributos y parámetros según sea necesario para ejecutar la acción.
Referencia de atributo de Pega Web Mashup
Los valores de los atributos de mashup y los parámetros específicos de acción pueden ver valores literales, referencias de propiedad, referencias a las funciones en la página JavaScript o referencias a los elementos de entrada en la página JavaScript (elementos del Modelo de Objetos del Documento (DOM)). Además, un objeto de parámetro que contiene pares de nombre/valor para los parámetros personalizados se utiliza como entrada para varias acciones.
Al especificar valores no literales como un atributo o parámetros, utilice la sintaxis en la siguiente tabla.
| Valor de un elemento DOM | [page/id/elementID] |
| Valor devuelto por una función en la página JavaScript | [page/function/token] |
| Referencia de propiedad en la página JavaScript | [gadget/gadgetName/property] |
| Referencia de propiedad como el valor de un atributo o parámetro de gadget |
Attribute/parameter = [propertyReference] o [gadget/gadgetName/propertyReference] |
El valor de un elemento DOM
Para utilizar el valor de un elemento desde la página JavaScript como el valor de un atributo de gadget o un parámetro de acción, utilice [page/id/elementID], donde elementID es el nombre del elemento DOM.
En la siguiente imagen, haga clic en los íconos + para obtener más información sobre cómo usar el valor de un elemento DOM.
Valor devuelto por una función en la página JavaScript
Para utilizar el valor devuelto por una función en la página JavaScript como el valor de un atributo de mashup o parámetro de acción, utilice la sintaxis [page/function/token], donde token es una cadena que tiene significado para la función. Especifique la función utilizada para recuperar el valor mediante el atributo data-pega-event-onpagedata.
En la siguiente imagen, haga clic en los íconos + para obtener más información sobre cómo usar el valor devuelto por una función en el JavaScript de una página.
Referencia de propiedad en la página JavaScript
Utilice las acciones getGadgetData y setGadgetData para leer y establecer los valores de propiedad en un gadget de mashup. La acción getGadgetData utiliza la sintaxis [gadget/gadgetName/property] para hacer referencia a la referencia de propiedad donde gadgetName es el nombre del mashup y property es el nombre de la propiedad utilizada en una aplicación de Pega Platform, como .pyID, pyWorkPage.pyID y .pyWorkParty(operator).pyUserName. La acción getGadgetData requiere el gadget de palabra clave.
| Acción | Sintaxis | Ejemplo |
|---|---|---|
| getGadgetData |
pega.web.api.doAction("gadgetName", "getGadgetData", "[gadget/gadgetName/property]") |
Para mostrar el valor de la propiedad pyID en la página del host, utilice la función doAction para invocar la acción getGadgetData con la sintaxis pega.web.api.doAction("gadgetName", "getGadgetData", "[gadget/gadgetName/.pyID]") |
| setGadgetData | pega.web.api.doAction("gadgetName", "setGadgetData", "propertyReference", strValue) | Establezca el valor de la propiedad .QuoteType con la acción setGadgetData: pega.web.api.doAction("gadgetName", "setGadgetData", "pyWorkPage.QuoteType", "Auto") |
Referencia de propiedad como el valor de un atributo o parámetro de gadget
Para ejecutar una acción en un gadget con los datos del gadget, cree un objeto de acción para el gadget. Si la propiedad que necesita utilizar está en el mismo gadget que la referencia, utilice la sintaxis Attribute/parameter = [propertyReference].
Si la propiedad que necesita utilizar está en un gadget de mashup diferente, utilice la sintaxis [gadget/gadgetName/propertyReference] para identificar el gadget que incluye la propiedad. Esta sintaxis es la misma sintaxis que utiliza en una referencia de propiedad desde la página JavaScript.
En la siguiente imagen, haga clic en los íconos + para obtener más información sobre el uso de una referencia de propiedad.
Notación literal de objetos para conservar los nombres de atributos y parámetros
Muchas propiedades y parámetros del sistema tienen nombres con mayúsculas y minúsculas combinadas. Por ejemplo, al visualizar una página no XHTML, el navegador Firefox convierte los nombres de atributos a todas letras en minúscula. Para evitar esta conversión, especifique los pares de nombre/valor de parámetro con la notación literal de objetos.
Por ejemplo, para establecer el valor del atributo data-pega-parameters en la definición del mashup con la notación literal de objetos: data-pega-parameters="{Customer:'[page/id/Account]', Level:'gold'}"
En la siguiente imagen, haga clic en los íconos + para obtener más información sobre el uso de la notación literal de objetos.
Compruebe sus conocimientos con la siguiente actividad:
This Topic is available in the following Module:
¿Quiere ayudarnos a mejorar este contenido?