XML
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
Você deve ter o seguinte acesso para usar a funcionalidade neste artigo:
Para saber que plano, tipo de licença ou acesso você tem, contate o administrador do Workfront.
Para obter informações sobre Adobe Workfront Fusion licenças, consulte Adobe Workfront Fusion licenças.
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.
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:
-
Clique no botão Adicionar.
-
Clique no botão Generator.
-
Copie e cole a amostra XML no campo Dados de amostra.
-
Clique em Salvar.
-
Verifique se a estrutura de dados foi gerada com êxito.
-
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 em Adobe Workfront Fusion.
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 em Adobe Workfront Fusion e Tipos de dados de item em Adobe Workfront Fusion.
-
Crie um novo cenário.
-
Inserir módulo HTTP > Obter um arquivo
-
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)
-
Clique em OK para salvar e fechar a configuração do módulo.
-
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 |
>
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 Você pode copiar e colar o código da fórmula no campo: Para obter mais informações sobre os tipos de dados Buffer e Texto, consulte Tipos de dados de item no Adobe Workfront Fusion.
|
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ó.
<root attr="1">
<node attr="ABC">Hello, World</node>
</root>
é convertido neste pacote:
Criar XML
O módulo XML > Criar XML converte um pacote em um texto XML formatado.
- 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.
- 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.
- Conecte o módulo XML > Criar XML após o módulo Agregador de Matriz.
- Clique no botão Gerador e cole sua amostra XML no campo Dados de amostra:
- Clique em Salvar. O campo Specification na estrutura Data agora contém a estrutura gerada.
- 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.
- Clique no botão Mapear ao lado do campo e mapeie o item
Array[]da saída do agregador de matriz para ele: - Clique em OK para fechar a configuração do módulo XML.
- 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.
- Clique em OK para fechar a configuração do módulo Agregador de Matriz.
- Execute o cenário.
- 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.
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"
}
]
}
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.