Utilice la actividad Consultar objetos de Zuora para consultar objetos como
Product, Account o RatePlan en la aplicación Zuora.
La cadena de consulta que especifique para esta operación debe cumplir el estándar de
Zuora Object Query Language.
Acerca de esta tarea
Utilice esta tarea para consultar objetos en la aplicación Zuora.
La llamada a
esta actividad es una llamada síncrona en la que los datos de entrada se envían a la
actividad para ser procesados y la respuesta se devuelve a la orquestación.
Para configurar la actividad Consultar objetos de Zuora, complete los pasos
siguientes:
Procedimiento
- En una orquestación activa, abra el separador Actividades y
expanda el contenido de la carpeta Zuora.
- Arrastre el icono de la actividad Consultar objetos a la orquestación. Se muestra la Lista de comprobación de Consultar
objetos de Zuora.
- En la Lista de comprobación, pulse Resumen.
- Revise el contenido del campo Nombre de actividad y realice
los cambios necesarios.
- En la lista de comprobación, pulse Elegir punto final.
- Pulse Examinar y utilice el recuadro de diálogo
Explorador de proyectos para seleccionar el punto final de Zuora
correspondiente.
- Opcional: Puede crear el punto final pulsando Nuevo y especificando los detalles de conexión necesarios. Pulse Probar conexión para comprobar si se ha conectado
correctamente a la aplicación Zuora. Pulse Aceptar para guardar y utilizar el punto final para esta configuración.
- Para realizar los cambios que sean necesarios en la configuración de punto final seleccionada, pulse
Editar para acceder a las opciones en una ventana separada. Cualquier cambio que se realice afectará de forma global a todos los usos del punto final en las orquestaciones activas.
- Seleccione las Entradas de correlación en la Lista de comprobación.
Los esquemas XML generados a partir del objeto seleccionado de la actividad
Consultar objetos se muestran como nodos bajo el parámetro de
entrada de la solicitud en el panel A actividad.
- Cree una correlación entre las variables de orquestación y el parámetro de entrada de la actividad.
Nota: Los valores deben proporcionarse durante el tiempo de ejecución para todos los elementos obligatorios de la estructura de entrada. Se puede indicar un valor especificando un valor predeterminado para el elemento o enlazando el elemento con un nodo de entrada. En tiempo de ejecución, si no se proporciona ningún valor para un elemento obligatorio, la actividad se termina y el resultado de queryResponse se rellena con un mensaje de error. Si comprueba la respuesta de la actividad, puede saber si la solicitud
ha fallado o no.
- Seleccione las Salidas de correlación en la lista de comprobación.
El esquema XML generado para contener la respuesta de la actividad se muestra como nodos bajo el parámetro de salida en el panel Desde actividad.
- Cree una correlación entre los parámetros de salida y las variables de orquestación.
Nota: La salida de la actividad Consultar objetos es queryResponse, que tiene una estructura genérica.
Si la salida de la actividad Consultar objetos tiene que usarse en una actividad posterior, no podrá realizarse una correlación directa. Los datos deberán extraerse de queryResponse con la ayuda de la actividad Aplicar XSLT.
A continuación se muestra un ejemplo de XSLT que puede utilizarse para extraer determinados datos:
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:ns1="http://api.zuora.com/" xmlns:ns2="http://object.api.zuora.com/">
<xsl:template match="/ns1:queryResponse/ns1:result">
<xsl:element name="Products">
<xsl:apply-templates select="ns1:records" />
</xsl:element>
</xsl:template>
<xsl:template match="ns1:records">
<xsl:element name="Product">
<xsl:element name="Id">
<xsl:value-of select="ns2:Id"/>
</xsl:element >
<xsl:element name="Name">
<xsl:value-of select="ns2:Name"/>
</xsl:element >
<xsl:element name="SKU">
<xsl:value-of select="ns2:SKU"/>
</xsl:element >
<xsl:element name="EffectiveStartDate">
<xsl:value-of select="ns2:EffectiveStartDate"/>
</xsl:element >
<xsl:element name="EffectiveEndDate">
<xsl:value-of select="ns2:EffectiveEndDate"/>
</xsl:element >
<xsl:element name="Description">
<xsl:value-of select="ns2:Description"/>
</xsl:element >
</xsl:element>
</xsl:template>
</xsl:stylesheet>
Resultados
Ha configurado la actividad Consultar objetos de Zuora.