JSON módulos

O aplicativo Adobe Workfront Fusion JSON fornece módulos para processar dados no formato JSON, de modo que o Adobe Workfront Fusion possa trabalhar ainda mais com o conteúdo de dados ou criar novo conteúdo JSON.

Requisitos de acesso

Expanda para visualizar os requisitos de acesso para a funcionalidade neste artigo.

Você deve ter o seguinte acesso para usar a funcionalidade neste artigo:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Pacote do Adobe Workfront Qualquer
Licença do Adobe Workfront

Novo: Padrão

Ou

Atual: trabalho ou superior

Licença do Adobe Workfront Fusion**

Atual: nenhum requisito de licença do Workfront Fusion

Ou

Herdados: Automação e integração do Workfront Fusion for Work

Produto

Novo menu:

  • Selecionar ou pacote do Prime Workfront: sua organização deve comprar o Adobe Workfront Fusion.
  • Pacote do Ultimate Workfront: o Workfront Fusion está incluído.

Ou

Atual: sua organização deve comprar o Adobe Workfront Fusion.

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

Para obter informações sobre licenças do Adobe Workfront Fusion, consulte licenças do Adobe Workfront Fusion.

Considerações ao analisar o JSON

Estrutura de dados

A estrutura de dados descreve como os dados JSON são organizados e permite o mapeamento de itens JSON individuais para outros módulos em seu cenário. Se você não fornecer a estrutura de dados, poderá executar o módulo manualmente e o Workfront Fusion criará a estrutura do JSON fornecido:

  1. Adicione o módulo Parse JSON a um cenário.
  2. No campo Cadeia de Caracteres JSON, digite o JSON a partir do qual deseja criar uma estrutura de dados.
  3. Não conecte outros módulos ao módulo Parse JSON ainda. Como o Workfront Fusion ainda não conhece a estrutura dos dados JSON, ainda não é possível mapear dados do módulo Analisar JSON para outros módulos em seu cenário.
  4. Execute o cenário manualmente. Isso permite que o módulo Analisar JSON identifique a estrutura JSON do JSON fornecido.
  5. Agora você pode conectar os seguintes módulos. Os itens do módulo JSON de análise agora estão disponíveis para mapeamento.

Para obter mais informações, consulte Estruturas de dados no Adobe Workfront Fusion.

Coleção versus array

Se o campo de cadeia de caracteres JSON contiver uma coleção { ... }, a saída será um único pacote contendo os itens da coleção.

recommendation-more-help

Exemplo:

{
    "name" : "Peter",

    "ID" : 1>}

Coleção JSON

Se o campo de cadeia de caracteres JSON contiver uma matriz [ ... ], a saída será uma série de pacotes. cada pacote contém um elemento da matriz.

Exemplo:

[
  {
    "name" : "Peter",
    "ID" : 1
  },

  {
    "name" : "Mike",
    "ID" : 2
  }
]

Matriz JSON

JSON módulos e seus campos

Ao configurar módulos do JSON, o Workfront Fusion exibe os campos listados abaixo. Junto com esses, campos JSON adicionais podem ser exibidos, dependendo de fatores como nível de acesso no aplicativo ou serviço. Um título em negrito em um módulo indica um campo obrigatório.

Se você vir o botão de mapa acima de um campo ou função, poderá usá-lo para definir variáveis e funções para esse campo. Para obter mais informações, consulte Mapear informações de um módulo para outro.

Alternância de mapa

Agregadores

Agregar para JSON

Esse módulo agregador agrega a saída de um módulo anterior no JSON.

módulo Source
Selecione o módulo que gera os dados que você deseja agregar ao JSON.
Estrutura de dados
Selecione a estrutura de dados que deseja usar para criar JSON. A estrutura de dados determina quais outros campos estão disponíveis nesse módulo. Para obter mais informações, consulte Estrutura de dados neste artigo.
Recuo
Selecione se deseja recuar o JSON usando tabulações, dois espaços ou quatro espaços.
Agrupar por
Defina uma expressão pela qual você deseja agrupar a saída agregada. Esta expressão pode conter um ou mais itens mapeados. Os dados agregados são, então, separados em grupos usando o valor dessa expressão. Cada grupo gera um pacote separado com uma chave (a expressão avaliada) e um valor (o texto agregado). Você pode usar a chave como um filtro nos módulos subsequentes.
Parar processamento após uma agregação vazia
Habilite essa opção para interromper o cenário quando não houver resultados.

Transformadores

Converter JSON em XML

Esse módulo de ação converte uma sequência de caracteres JSON em XML.

cadeia de caracteres JSON
Insira ou mapeie o JSON que você deseja converter em XML.

Criar JSON

Esse módulo de ação cria o JSON a partir de uma estrutura de dados.

Estrutura de dados
Selecione a estrutura de dados que deseja usar para criar JSON. Para obter mais informações, consulte Estrutura de dados neste artigo.
Recuo
Selecione o recuo que deseja usar para este JSON.

Analisar JSON

Esse módulo de ação analisa uma sequência JSON em uma estrutura de dados, que permite acessar os dados dentro da sequência JSON.

Estrutura de dados
Selecione a estrutura de dados que deseja usar para criar JSON. Para obter mais informações, consulte Estrutura de dados neste artigo.
cadeia de caracteres JSON
Insira ou mapeie o JSON que deseja analisar.

Transformar JSON

Esse módulo de ação transforma um objeto em uma sequência de caracteres json.

Recuo
Selecione o recuo que deseja usar para este JSON.
Objeto
Insira ou mapeie o objeto que deseja transformar em JSON.

Transformação de registros de dados em JSON

Exemplo: o exemplo a seguir mostra como transformar registros de dados de Google Sheets para o formato JSON:

  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 JSON > Criar módulo JSON após o módulo Agregador de Matriz. A configuração do módulo requer uma estrutura de dados que descreva o formato JSON. Clique em 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 JSON. Clique em Gerador e cole sua amostra JSON no campo Dados de amostra:

    Exemplo:

    code language-none
    {
    "books": [
    {
    "id": "ID",
    "title": "Title",
    "author": "Author"
    }
    ]
    }
    
  4. Clique em Salvar. O campo Especificação na estrutura de dados agora contém a estrutura gerada.

  5. 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.

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

  7. Clique em OK para fechar a configuração do módulo JSON.

  8. Abra a configuração do módulo Agregador de Matrizes. Altere a Estrutura de destino de Personalizada para o campo do módulo JSON correspondente ao atributo de matriz raiz. Mapeie itens do módulo Google Sheets para os campos apropriados.

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

  10. Execute o cenário.

    O módulo JSON gera o formato JSON correto.

  11. 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.

Solução de problemas

Não é possível mapear dados do módulo Parse JSON

Verifique se o conteúdo JSON está mapeado corretamente no módulo Analisar JSON e se a estrutura de dados está definida corretamente. Para obter mais informações, consulte Transformando registros de dados em JSON neste artigo.

O módulo falha ao usar declarações condicionais em JSON

Ao usar instruções condicionais como if em seu JSON, coloque as aspas fora da instrução condicional.

Exemplo:

Cotas em JSON

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