Etapa analisador de JSON
Identifique dados estruturados de uma carga JSON sem precisar gravar um script. Mapeie elementos JSON 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 JSON preenchem a saída do objeto complexo.
Para saber mais sobre objetos complexos, consulte Dados complexos.
Funções e disponibilidade
Disponível como uma etapa de ação de Designer de ações. 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
No tempo de execução, Etapa analisador de JSON oferece suporte a cargas úteis de até 10 MB. Para cargas úteis maiores, crie uma ação Fluxo de dados. Para obter mais informações sobre ações de Fluxo de dados, consulte Ações de fluxo de dados e paginação.
Campos
| Campo | Descrição |
|---|---|
| Origem | No campo Dados de origem, selecione ou arraste uma cápsula de dados que contenha a carga útil JSON de origem. Por exemplo, uma cápsula de dados do corpo da resposta da etapa REST. 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 seu objeto complexo. Por exemplo, se estiver analisando a resposta de uma etapa REST que retorna uma lista de usuários, insira o objeto JSON esperado para um único usuário. Você pode criar qualquer exemplo de carga JSON com as seguintes limitações:
|
| Exibição de Carga Estruturada | Exiba sua carga de exemplo como JSON regular ou alterne Exibição de Carga Estruturada para exibir a carga em uma árvore de nós estruturada. Selecione um nó na árvore para copiar o JSONPath do elemento. Se você adicionar novos elementos no campo Destino manualmente, poderá colar este JSONPath nas opções avançadas de um elemento. |
| 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 no campo Destino. Os elementos secundários de cada objeto são gerados automaticamente como tipo Cadeia de caracteres. Como alternativa, você pode criar manualmente seu objeto complexo de destino adicionando elementos no campo Destino. |
| Meta | Exiba ou edite a estrutura de saída da carga JSON. Crie uma saída estruturada clicando em Gerar destinoou adicione elementos manualmente. Cada elemento contém as seguintes informações na exibição Editar objeto:
Elementos do tipo Objeto contêm a opção avançada Salvar como modelo, 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 tamanho máximo, uma dica e um 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 de alternância de O JSONPath é o caminho para o elemento. Modifique o JSONPath para mudar como os elementos de dados de origem são mapeados para elementos na saída. Se estiver adicionando elementos manualmente, você pode copiar o JSONPath de um nó na carga de exemplo e colá-lo nas opções avançadas de um elemento. |
) para adicionar um elemento secundário aninhado.
de entradas avançadas ) para exibir a opção Exemplo de etapa do analisador JSON
Este exemplo rastreia problemas recém-criados de uma instância de produção como defeitos em uma instância de teste. Primeiro, crie uma nova ação chamada Parse Problems from Production. Adicione uma etapa REST para recuperar uma lista de problemas da instância de produção. Em seguida, adicione a etapa do analisador JSON para analisar o Response Body da etapa REST e forneça uma saída de objeto complexo que represente o esquema da tabela Problema [problema]. Por fim, crie uma saída de ação do tipo Objeto chamado Problems from Production. Solte a cápsula de dados root da etapa do analisador JSON no campo de valor desta saída.
Em seguida, crie um novo fluxo chamado Sync New Problems, que é acionado diariamente à meia-noite. A primeira ação no fluxo é a ação Parse Problems from Production. Em seguida, adicione um bloco de lógica de fluxo For Each e solte o cápsula de dados no campo Item. No bloco Para cada, adicione um bloco de lógica de fluxo If que verifica se o estado de cada problema é novo e cria um registro de defeito na instância de teste cujo grupo de atribuição e descrição resumida são mapeados para cada novo problema da instância de produção.