Utilización de la actividad Consultar objetos de Zuora

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

  1. En una orquestación activa, abra el separador Actividades y expanda el contenido de la carpeta Zuora.
  2. Arrastre el icono de la actividad Consultar objetos a la orquestación. Se muestra la Lista de comprobación de Consultar objetos de Zuora.
  3. En la Lista de comprobación, pulse Resumen.
  4. Revise el contenido del campo Nombre de actividad y realice los cambios necesarios.
  5. En la lista de comprobación, pulse Elegir punto final.
  6. Pulse Examinar y utilice el recuadro de diálogo Explorador de proyectos para seleccionar el punto final de Zuora correspondiente.
  7. 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.
    Nota: Para obtener más información, consulte Creación y edición de un punto final de Zuora.
  8. 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.
  9. 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.
  10. 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.
  11. 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 de respuesta en el panel Desde actividad.
  12. 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.