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
- Na orquestração ativa, abra a guia Atividades e expanda o conteúdo da pasta Zuora.
- Arraste o ícone da atividade Consultar Objetos para
a orquestração. A Lista de Verificação Consultar Objetos do Zuora
será exibida.
- Na Lista de Verificação, clique em Resumo.
- Revise o conteúdo do campo Nome da Atividade e, se necessário, faça alterações.
- Na Lista de Verificação,
clique em Selecionar Terminal.
- Clique em Navegar e use a caixa de diálogo Explorador de Projetos para selecionar o terminal Zuora
relevante.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.