Ferramenta Análise XML

Versão:

2023.1

Last modified: January 23, 2023

Fluxo de trabalho de exemplo

A ferramenta Análise XML tem um fluxo de trabalho de exemplo. Visite Exemplos de fluxos de trabalho para saber como acessar esse e muitos outros exemplos diretamente do Alteryx Designer.

Use a ferramenta Análise XML para separar linguagem de marcação extensível (XML) em campos individuais. Visite Como é feita a leitura de XML para obter mais informações sobre como o Alteryx lê e analisa XML.

Se o XML incluir algum namespace, como w:document, ele é removido na saída e w:document é retornado.

Configurar a ferramenta

Selecione o Campo com dados XML que deseja analisar e separar. Selecione entre os campos de cadeia de caracteres incluídos em sua entrada.
Use a caixa de seleção Incluir na saída (marcada por padrão) para determinar se o campo analisado deve ou não ser passado para as etapas posteriores quando o fluxo de trabalho for executado.
Selecione o Elemento XML a ser analisado. As opções incluem...
- O elemento Raiz.
- Detectar filho automaticamente: analisa o elemento que é um filho do elemento nos dados de entrada — uma alternativa à especificação de qual elemento do XML deve ser analisado. O elemento que será analisado é aquele que tiver mais ocorrências em um mesmo nó pai.
- Nome do filho específico: permite que você informe o nome do elemento filho a ser analisado. O Alteryx diferencia maiúsculas de minúsculas no elemento XML.
Selecione estas opções adicionais:
- Retornar valores filhos: retorna o primeiro conjunto de valores filhos. Desmarque para deixar de fora os valores filhos.
- Retornar XML externo: retorna as tags XML externas. Isso cria um campo adicional para cada campo analisado com o sufixo _OuterXML. As tags são incluídas ao redor dos valores na tabela de dados.
- Ignorar erros de XML e continuar: quando essa caixa de seleção é marcada, qualquer erro gerado pelo XML é ignorado e a análise continua.

Como funciona a opção "Detectar filho automaticamente"

O elemento que será analisado é aquele que tiver mais ocorrências em um mesmo nó pai. Se nenhum elemento tiver mais de uma ocorrência, por padrão, o primeiro filho da raiz será selecionado.

Exemplo

No exemplo do código...

O elemento record é detectado automaticamente porque ocorre três vezes dentro de um único nó pai.
Os elementos root e firstchild aparecem uma vez cada.
Os elementos field1, field2 e field3 aparecem três vezes cada, mas não dentro de um mesmo nó pai (cada um deles ocorre uma vez por nó pai "record").

XML


    

            <root>
   <firstchild> 
       <record><field1/><field2/><field3/></record>
       <record><field1/><field2/><field3/></record>
       <record><field1/><field2/><field3/></record>
   </firstchild>
</root>

    <root>
   <firstchild> 
       <record><field1/><field2/><field3/></record>
       <record><field1/><field2/><field3/></record>
       <record><field1/><field2/><field3/></record>
   </firstchild>
</root>

A opção Detectar filho automaticamente só considera a primeira linha da entrada em vez de considerar todas as linhas. A guia "Mensagens" na saída da ferramenta Análise XML mostra uma mensagem indicando qual elemento foi detectado automaticamente como o padrão.