使用 Zuora“查询对象”活动

使用 Zuora“查询对象”活动从 Zuora 应用程序中查询对象,例如产品、帐户或评级计划。 为该操作指定的查询字符串必须符合 Zuora 对象查询语言标准。

关于此任务

使用此任务从 Zuora 应用程序中查询对象。 对此活动的调用是同步调用,在此调用中会将输入数据发送到该活动以进行处理并将响应发送回编排。

要配置 Zuora“查询对象”活动,请完成以下步骤:

过程

  1. 在活动的编排中,打开活动选项卡,展开 Zuora 文件夹内容。
  2. 查询对象活动图标拖至编排上。 这样会显示 Zuora“查询对象”核对表
  3. 核对表中,单击摘要
  4. 查看活动名称字段内容,必要时进行所需更改。
  5. 核对表中,单击选取端点
  6. 单击浏览,然后使用 Project Explorer 对话框来选择相关的 Zuora 端点。
  7. 可选: 您可以通过单击新建并指定所需的连接详细信息来创建端点。单击测试连接以测试您已成功连接到 Zuora 应用程序。单击确定以保存并使用此配置的端点。
    注: 有关更多信息,请参阅创建和编辑 Zuora 端点
  8. 要对所选端点配置进行所需的更改,请单击编辑以在单独的窗口中访问相应选项。您所做出的任何更改都将全局影响端点在活动编排中的所有使用。
  9. 核对表中选择映射输入。 从查询对象活动的所选对象中生成的 XML 模式将显示为目标活动面板中请求输入参数下的节点。
  10. 创建活动的编排变量与输入参数之间的映射。
    注: 在运行时必须为输入结构的任何必要元素都提供值。可以通过为元素指定缺省值或通过将元素与输入节点链接来提供值。在运行时期间,如果没有为必需元素提供值,那么该活动将完成,并使用错误消息填充 queryResponse 的结果。通过审查活动的响应,您能够知道请求是失败还是成功。
  11. 核对表中选择映射输出。 为保存活动响应而生成的 XML 模式将显示为源活动面板中响应输出参数下的节点。
  12. 创建输出参数与编排变量之间的映射。
    注: “查询对象”活动的输出是具有通用结构的 queryResponse。 如果必须在后续活动中使用“查询对象”活动的输出,将无法执行直接映射。必须借助“应用 XSLT”活动从 queryResponse 中抽取数据。
    可用于抽取特定数据的样本 XSLT:
    <?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>

结果

您已配置 Zuora“查询对象”活动。



反馈 | 声明


http://pic.dhe.ibm.com/infocenter/wci/v7r0m0/topic/com.ibm.wci.doc/Zuora_QueryObjects_Activity.html