Usando a Atividade Consultar Objetos do Zuora

Use a atividade Consultar Objetos do Zuora para consultar objetos, tais como Produto, Conta ou RatePlan do aplicativo Zuora. A sequência de consultas especificada para essa operação deve seguir o padrão Linguagem de Consulta do Objeto do Zuora.

Sobre Esta Tarefa

Use esta tarefa para consultar objetos do aplicativo Zuora . A chamada para esta atividade é uma chamada síncrona em que os dados de entrada são enviados à atividade para processamento e a resposta é retornada à orquestração.

Para configurar a atividade Consultar Objetos do Zuora, conclua as seguintes etapas:

Procedimento

  1. Na orquestração ativa, abra a guia Atividades e expanda o conteúdo da pasta Zuora.
  2. Arraste o ícone da atividade Consultar Objetos para a orquestração. A Lista de Verificação Consultar Objetos do Zuora será exibida.
  3. Na Lista de Verificação, clique em Resumo.
  4. Revise o conteúdo do campo Nome da Atividade e, se necessário, faça alterações.
  5. Na Lista de Verificação, clique em Selecionar Terminal.
  6. Clique em Navegar e use a caixa de diálogo Explorador de Projetos para selecionar o terminal Zuora relevante.
  7. Opcional: É possível criar o terminal clicando em Novo e especificando os detalhes necessários da conexão. Clique em Testar Conexão para testar se foi conectado com êxito no aplicativo Zuora. Clique em OK para salvar e usar o terminal para essa configuração.
    Nota: Para obter informações adicionais, consulte Criando e Editando um Terminal do Zuora.
  8. Para fazer as alterações necessárias na configuração do terminal selecionado, clique em Editar para acessar as opções em uma janela separada. Todas as mudanças feitas globalmente afetam todos os usos do terminal em orquestrações ativas.
  9. Selecione Mapear Entradas na Lista de Verificação. Os esquemas XML gerados a partir do objeto selecionado da atividade Consultar Objetos são exibidos como nós sob o parâmetro de entrada da solicitação no painel Atividade de Destino.
  10. Crie um mapa entre as variáveis de orquestração e o parâmetro de entrada da atividade.
    Nota: Os valores devem ser fornecidos no tempo de execução para qualquer elemento compulsório da estrutura de entrada. Um valor pode ser fornecido ao especificar um valor padrão para o elemento ou ao vincular o elemento a um nó de entrada. Durante o tempo de execução, se nenhum valor for fornecido para um elemento obrigatório, a atividade será concluída e o resultado de queryResponse será preenchido com uma mensagem de erro. Ao revisar a resposta da atividade, é possível saber se a solicitação falhou ou se foi bem-sucedida.
  11. Selecione Mapear Saídas na Lista de Verificação. O esquema XML gerado para reter a resposta da atividade é exibido como nós sob o parâmetro de saída de resposta no painel Atividade de Partida.
  12. Crie um mapa entre os parâmetros de saída e as variáveis de orquestração.
    Nota: A saída da atividade Consultar Objetos é queryResponse, que tem uma estrutura genérica. Se a saída da atividade Consultar Objetos tiver que ser usada em uma atividade posterior, o mapeamento direto não poderá ser feito. Os dados deverão ser extraídos de queryResponse com a ajuda da atividade Aplicar XSLT.
    O XSLT de amostra pode ser usado para extrair dados específicos:
    <?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

Você configurou a atividade Consultar Objetos do Zuora.