Etapa do analisador XML

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 3 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 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 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 XMLSuporta cargas úteis de até 10 MB. Para cargas úteis maiores, crie um Fluxo de dadosação. Para obter mais informações, consulte Paginação e ações de fluxo de dados.

    No momento do design, Etapa analisador de XMLcompatí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 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 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. Mais de um namespace em um arquivo XML não é compatível 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 em Destino campo. Elementos secundários para cada objeto são gerados automaticamente como tipo Cadeia de caracteres. Como alternativa, você pode criar manualmente seu objeto complexo de destino adicionando elementos em 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, 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, Array.String ou Array.Object. O elemento de nível superior deve ser um Objeto.
    • Obrigatório : Alterne para tornar o elemento necessá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. 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 terminar de fazer mudanças na estrutura da saída. Você pode selecionar o ícone Alternar entradas avançadas ( Ícone Alternar entradas avançadas) para exibir o. XPath opçã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 Exibição de carga E cole-o em um campo XPath de variável de dados complexa para garantir a hierarquia correta. Expressões XPath condicionais não são compatíveis.