DocumentaçãoWorkfrontAdobe Workfront Fusion

XML

Last update: Mon Nov 03 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

O aplicativo XML permite analisar um texto XML formatado por meio do módulo XML > Analisar XML e convertê-lo em um pacote para disponibilizar os dados para outros módulos. Você também pode converter um pacote em um texto formatado XML por meio do módulo XML > Criar XML

Requisitos de acesso

Expanda para visualizar os requisitos de acesso para a funcionalidade neste artigo.
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Pacote do Adobe Workfront

Qualquer pacote de fluxo de trabalho do Adobe Workfront e qualquer pacote de Automação e Integração do Adobe Workfront

Workfront Ultimate

Workfront Prime e pacotes Select, com uma compra adicional do Workfront Fusion.
Licenças do Adobe Workfront

Standard

Trabalhar ou superior
Produto Se sua organização tiver um pacote Select ou Prime Workfront que não inclua a Automação e Integração do Workfront, ela deverá comprar o Adobe Workfront Fusion.

Para obter mais detalhes sobre as informações nesta tabela, consulte Requisitos de acesso na documentação.

Criar XML

O módulo XML > Criar XML converte um pacote em um texto XML formatado.

Estrutura de dados

A estrutura de dados descreve a estrutura do XML resultante. Se você tiver uma amostra do XML que deseja criar, poderá usá-la para gerar a estrutura de dados:

  1. Clique no botão Adicionar.
  2. Clique no botão Generator.
  3. Copie e cole a amostra XML no campo Dados de amostra.
  4. Clique no botão Salvar.
  5. Verifique se a estrutura de dados foi gerada com êxito.
  6. Clique em Salvar para salvar a estrutura de dados.
Nome do elemento raiz
Insira o nome do elemento raiz do XML. O valor padrão é root.
IDENTIFICAÇÃO DO SISTEMA Doctype
Insira o nome de arquivo a ser usado na declaração !DOCTYPE SYSTEM
Doctype ID PÚBLICA
Insira o nome de arquivo a ser usado na declaração !DOCTYPE PUBLIC
Remover Declaração Xml
Habilite esta opção para remover a Declaração XML <?xml ... ?> e <!DOCTYPE ... > e deixar apenas o elemento raiz XML e seu conteúdo.
recommendation-more-help

Exemplo:

Um caso de uso típico é transformar dados de uma planilha Google em XML.

  1. Coloque o módulo Google Sheets > Selecionar linhas no cenário para buscar os dados. Configure o módulo para recuperar linhas da planilha Google. Defina o​Número máximo de linhas retornadas para um número pequeno, porém maior que um para fins de teste (Exemplo, três). Execute o módulo Google Sheets clicando com o botão direito do mouse nele e escolhendo "Executar este módulo somente." Verifique a saída do módulo.

  2. Conecte o módulo Agregador de Matriz após o módulo Google Sheets. Na configuração do módulo, escolha o módulo Google Sheets no campo nó do Source. Deixe os outros campos como estão para o momento.

  3. Conecte o módulo XML > Criar XML após o módulo Agregador de Matriz.

    A configuração do módulo requer uma estrutura de dados que descreva a estrutura da saída XML. Clique no botão Adicionar para abrir a configuração da estrutura de dados. A maneira mais fácil de criar essa estrutura de dados é gerá-la automaticamente a partir de uma amostra XML.

  4. Clique no botão Gerador e cole sua amostra XML no campo Dados de amostra:

    Campo de dados de exemplo

  5. Clique em Salvar.

    O campo Specification na estrutura Data agora contém a estrutura gerada.

  6. Altere o nome da estrutura de dados para algo mais específico e clique em Salvar.

    Um campo correspondente ao atributo de matriz raiz aparece como um campo mapeável na configuração do módulo JSON.

  7. Clique no botão Mapear ao lado do campo e mapeie o item Array[] da saída do agregador de matriz para ele:

  8. Clique em OK para fechar a configuração do módulo XML.

  9. Abra a configuração do módulo Agregador de Matrizes. Altere a Estrutura de destino do campo Personalizado para um campo do módulo XML correspondente ao elemento XML pai.Mapeie os itens do módulo Google Sheets para os campos apropriados.

  10. Clique em OK para fechar a configuração do módulo Agregador de Matriz.

  11. Execute o cenário.

    O módulo XML gera o arquivo XML correto.

  12. Abra a configuração do módulo Google Sheets e aumente o número Máximo de linhas retornadas para um número maior que o número de linhas em sua planilha para processar todos os dados.

    O XML resultante pode ser salvo em Dropbox, enviado como um anexo por email, carregado via FTP em um servidor e assim por diante.

style
shade-box

Adição de atributos XML

Se quiser adicionar atributos a um nó complexo (um nó que conterá outros nós), adicione uma coleção com o nome _attributes para a observação complexa na estrutura de dados personalizada. Esta coleção será mapeada para atributos de nó. Se quiser adicionar atributos a um nó de texto (por exemplo: <node attr="1">abc</node>), você deve adicionar uma coleção _attributes para atributos e uma propriedade de texto _value para o valor do nó para esse nó na estrutura de dados personalizada.

{
   "name": "node",
   "type": "collection",
   "spec": [
      {
         "name": "_attributes",
         "type": "collection"
         "spec": [
            {
               "name": "attr1",
               "type": "text"
            }
         ]
      },
      {
         "name": "_value",
         "type": "text"
      }
   ]
}

Analisar XML

O módulo XML > Parse XML analisa um texto XML formatado e gera um único pacote contendo todas as informações extraídas do XML.

Estrutura de dados

A estrutura de dados descreve a estrutura do XML para disponibilizar a saída do módulo no painel de mapeamento dos seguintes módulos.

Se você tiver uma amostra do XML que deseja analisar, poderá usá-la para gerar a estrutura de dados:

  1. Clique no botão Adicionar.

  2. Clique no botão Generator.

  3. Copie e cole a amostra XML no campo Dados de amostra.

  4. Clique em Salvar.

  5. Verifique se a estrutura de dados foi gerada com êxito.

  6. Clique no botão Salvar para salvar a estrutura de dados.

    É possível ignorar as etapas 2 a 5 para fornecer uma estrutura de dados vazia. Se a estrutura de dados estiver vazia, a saída do módulo não estará disponível no painel de mapeamento até que o módulo tenha sido executado pelo menos uma vez.

Para obter mais informações, consulte Estruturas de dados.

Preservar números como texto
Habilite essa opção para garantir que os números permaneçam como valores de texto (sequência de caracteres). Caso contrário, os números serão convertidos em valores numéricos.
XML

Insira ou mapeie o texto XML formatado que deseja analisar.

Se você usar uma fórmula, verifique se o tipo de valor do resultado é (ou pode ser forçado automaticamente a) o tipo de dados Text.

Se o tipo de valor do resultado for Buffer (dados binários), use a função toString() para convertê-lo no tipo de dados Text. Para obter mais informações, consulte Coerção de tipo e Tipos de dados de item.

Exemplo:

Para baixar um arquivo XML de um URL e analisar seu conteúdo:

  1. Crie um novo cenário.

  2. Adicionar o módulo HTTP > Obter um arquivo

  3. Abra a configuração do módulo e configure-o da seguinte maneira:

    URL: URL do arquivo XML (por exemplo, https://siftrss.com/f/rqLy05ayMBJ)

    URL do exemplo de arquivo XML

  4. Clique em OK para salvar e fechar a configuração do módulo.

  5. Adicionar o módulo XML > Parse XML, conectá-lo após o módulo HTTP > Obter um arquivo e configurá-lo da seguinte maneira:

    table 0-row-2 1-row-2 layout-auto html-authored no-header
    Estrutura de dados
    1. Clique no botão Adicionar.
    2. Clique no botão Generator.
    3. No navegador da Web, abra uma nova guia ou janela.
    4. Coloque o URL usado na terceira etapa na barra de endereços e busque o arquivo XML.
    5. Selecione todo o texto XML e copie-o para a área de transferência.
    6. Feche a guia ou janela e retorne ao seu cenário.
    7. Cole o texto XML copiado no campo Dados de amostra.
    8. Clique em Salvar.
    9. Verifique se a estrutura de dados foi gerada com êxito.
    10. Clique em Salvar para salvar a estrutura de dados.

    Você pode pular as etapas de 2 a 9 para fornecer uma estrutura de dados vazia. Se a estrutura de dados estiver vazia, a saída do módulo não estará disponível no painel de mapeamento até que o módulo tenha sido executado pelo menos uma vez.
    XML

    Mapeie o Data item da saída do módulo HTTP > Obter um arquivo para o campo. Use a função toString() para converter seu valor do tipo de dados Buffer (dados binários) no tipo de dados Text.

    Você pode copiar e colar o código da fórmula no campo: {{toString(1.data)}}

    Para obter mais informações sobre os tipos de dados Buffer e Text, consulte Tipos de dados de item.
style
shade-box

Analisando atributos XML

Por padrão, o módulo XML > Parse XML coloca atributos em uma coleção especial _attributes como filho do nó que tem esses atributos. Se o nó for um nó de texto e tiver atributos, duas propriedades especiais serão adicionadas: _attributes para atributos e _value para o conteúdo de texto do nó.

Exemplo: Este XML:

<root attr="1">
<node attr="ABC">Hello, World</node>
</root>

é convertido neste pacote:

XML convertido em pacote

style
shade-box

Solução de problemas: não é possível mapear dados do módulo Parse XML

Verifique se a estrutura de dados está definida corretamente. Como alternativa, você pode usar uma estrutura de dados vazia e executar o módulo pelo menos uma vez para processar uma entrada XML.

7e1891ad-4d59-4355-88ab-a2e62ed7d1a3