Etapa analisador de XML

Identifique dados estruturados de uma carga XML sem precisar gravar script. Mapeie elementos XML de entrada para uma saída de objeto complexo que você pode usar em outras etapas ou ações. No tempo de execução, os valores de uma carga XML preenchem a saída do objeto complexo.

Para saber mais sobre objetos complexos, consulte Dados complexos.

Nota:

Esta etapa exige uma assinatura IntegrationHub. Para obter mais informações, consulte Programações jurídicas - Visão geral do IntegrationHub. Depois que o plug-in necessário for ativado, a etapa ficará visível em Integrações.

Funções e disponibilidade

Disponível como uma etapa de ação de Designer de ações. Usuários com a função action_designer podem criar uma ação personalizada com uma ou mais etapas de ação.

Limite de tamanho da carga

No tempo de execução, Etapa analisador de XML oferece suporte a cargas úteis de até 10 MB. Para cargas úteis maiores, crie uma ação Fluxo de dados. Para obter mais informações, consulte Ações de fluxo de dados e paginação.

Em tempo de design, Etapa analisador de XML oferece suporte a cargas de amostra de até 64.000 caracteres.

Campos

Campo	Descrição
Origem	No campo Dados de origem, selecione ou arraste uma cápsula de dados que contenha os dados XML de origem. Por exemplo, uma cápsula de dados do corpo da resposta da etapa REST. No tempo de execução, os valores da fonte de dados preenchem a saída do objeto complexo. Em Dados de origem e na janela de script, insira uma carga de exemplo para gerar um objeto complexo. Por exemplo, se estiver analisando a resposta de uma etapa de REST API que retorna uma lista de usuários, insira o XML esperado para um único usuário. Este campo aceita XML com as seguintes limitações: Os namespaces XML não são aplicados ao objeto complexo. Não há suporte para mais de um namespace em um arquivo XML e isso gera uma mensagem de erro. Matrizes multidimensionais não são compatíveis. Alguns caracteres especiais não são compatíveis, como hífen e ponto final. Dois pontos (::) não são compatíveis com valores de atributo. Cargas maiores que 2 MB não podem ser salvas e geram uma mensagem de erro. No entanto, se estiver trabalhando com um exemplo grande, você poderá gerar o objeto complexo e excluir a carga de exemplo antes de salvar a etapa.
Exibição de Carga Estruturada	Selecione uma exibição para a carga de exemplo. Bruto (modo de edição): exibe o XML editável. Estruturado: exibe o XML em uma exibição em árvore. Clique em um elemento na árvore para copiar o elemento XPath. Se estiver criando dados complexos no campo Destino manualmente, você poderá colar o XPath no campo XPath de destino.
Gerar Destino	Selecione Gerar destino para criar a estrutura de saída da etapa a partir da carga de exemplo. Sua estrutura de dados de saída aparece no campo Destino. Os elementos secundários de cada objeto são gerados automaticamente como tipo Cadeia de caracteres. Como alternativa, você pode criar manualmente seu objeto complexo de destino adicionando elementos no campo Destino.
Meta	Exiba ou edite a estrutura de saída da carga XML. Crie uma saída estruturada clicando em Gerar destinoou adicione elementos manualmente. Cada elemento contém as seguintes informações na exibição Editar objeto: Rótulo: rótulo de cápsula de dados. Por padrão, o sistema usa o nome do elemento XML. Nome: nome interno do elemento de saída. Nota: Exclamação, dois pontos duplos, o símbolo @ ou somente números não são valores válidos para o nome de um elemento. Tipo: tipo de dados, que deve ser Cadeia de caracteres, Objeto, Array.String ou Array.Object. O elemento de nível superior deve ser um Objeto. Obrigatório: alterne para tornar o elemento obrigatório. Isso se aplica somente a elementos do tipo Cadeia de caracteres. Adicionar item secundário: selecione o ícone adicionar item secundário (ícone ) para adicionar um elemento secundário aninhado. Elementos do tipo Objeto contêm a opção avançada Salvar como modelo, que permite salvar a estrutura do objeto como um modelo de objeto complexo. Você pode usar este modelo para definir o esquema de uma saída de Objeto para sua ação. Para elementos do tipo Cadeia de caracteres, você também pode adicionar um tamanho máximo, uma dica e um valor padrão como opções avançadas. No cabeçalho Destino, selecione Sair do modo de edição quando terminar de fazer mudanças na estrutura da saída. Você pode selecionar o ícone de alternância de de entradas avançadas ) para exibir a opção XPath. O XPath é o caminho para o elemento. Modifique o XPath para mudar como os elementos de dados de origem são mapeados para variáveis de dados complexas. Se estiver adicionando manualmente variáveis de dados complexas, você poderá copiar o XPath do campo de exibição Carga e colá-lo em um campo XPath de variável de dados complexos para garantir a hierarquia correta. Expressões XPath condicionais não são compatíveis.