Etapa analisador de XML

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 4 min. de leitura
  • Identifique dados estruturados de uma carga XML sem precisar gravar script. Mapeie elementos XML de entrada para uma saída de objeto complexa 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 de objeto complexo.

    Para saber mais sobre objetos complexos, consulte Dados complexos .

    Nota:
    Esta etapa exige uma assinatura IntegrationHub. Para obter mais informações, consulte Cronogramas jurídicos - IntegrationHub visão geral . 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 Workflow Studio. 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

    Em tempo de execução, Etapa analisador de XML Suporta cargas úteis de até 10 MB. Para cargas maiores, crie um Fluxo de Dados ação. Para obter mais informações, consulte Paginação e ações de fluxo de dados.

    No momento do design, Etapa analisador de XML compatível com cargas de amostra de até 64 000 caracteres.

    Campos

    Campo Descrição
    Origem Em Dados de origem Selecione ou arraste uma cápsula de dados que contém os dados XML de origem. Por exemplo, uma etapa REST Corpo da resposta cápsula de dados. No tempo de execução, os valores da fonte de dados preenchem a saída de objeto complexo.

    Em Dados de origem e na janela de script, insira uma carga de exemplo para gerar um objeto complexo. Por exemplo, se analisar a resposta de uma etapa da 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:

    • Namespaces XML não são aplicados ao objeto complexo. Não há suporte para mais de um namespace em um arquivo XML e 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. Dois pontos duplos (::) não são compatíveis com valores de atributo.
    • Cargas maiores que 2 MB não podem ser salvas e gerar 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.
    • Raw (modo de edição) : Exibe XML editável.
    • Estruturado : Exibe XML em uma exibição em árvore. Clique em um elemento na árvore para copiar o elemento XPath. Se estiver criando dados complexos no Destino Campo Manualmente, você pode 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 Destino campo. Os elementos secundários de cada objeto são gerados automaticamente como o tipo Cadeia de caracteres. Como alternativa, você pode criar manualmente seu objeto complexo de destino adicionando elementos no Destino campo.
    Meta

    Exiba ou edite a estrutura de saída da carga XML. Clique em para criar uma saída estruturada Gerar destino , ou adicione elementos manualmente.

    Cada elemento contém as seguintes informações na exibição Editar objeto:

    • Rótulo Rótulo da cápsula de dados. Por padrão, o sistema usa o nome do elemento XML.
    • Nome : Nome interno do elemento de saída.
      Nota:
      Pontos de exclamação, dois pontos duplos, o símbolo a 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, Matriz.Cadeia de caracteres ou Matriz.Objeto. 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 Adicionar item secundário) para adicionar um elemento secundário aninhado.

    Os elementos do tipo Objeto contêm Salvar como modelo opção avançada, que permite salvar a estrutura do objeto como um modelo de objeto complexo. Em seguida, 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 comprimento máximo, dica e valor padrão como opções avançadas.

    No cabeçalho Destino, selecione Sair do modo de edição quando você terminar de fazer mudanças na estrutura da saída. Em seguida, você pode selecionar o ícone Alternar entradas avançadas ( Ícone Alternar entradas avançadas) para exibir o. XPath opção.

    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 adicionar manualmente variáveis de dados complexas, você poderá copiar o XPath do Exibição de carga E cole-o em um campo XPath de variável de dados complexos para garantir a hierarquia correta. Expressões condicionais XPath não são compatíveis.