Etapa do analisador 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 .

Nota:

Esta etapa exige uma assinatura IntegrationHub. Para obter mais informações, consulte Cronogramas jurídicos - IntegrationHub visão geral . Depois que o plug-in necessário for ativado, a etapa ficará visível em Integrações.

Funções e disponibilidade

Disponível como uma etapa de ação de Workflow Studio. 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

Em tempo de execução, Etapa analisador de JSONSuporta cargas úteis de até 10 MB. Para cargas úteis maiores, crie um Fluxo de dadosação. Para obter mais informações sobre ações de fluxo de dados, consulte Paginação e ações de fluxo de dados.

Campos

Campo	Descrição
Origem	Em Dados de origem Selecione ou arraste uma cápsula de dados que contém a carga JSON de origem. Por exemplo, uma etapa REST Corpo da resposta cápsula de dados. 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 um exemplo de carga útil para gerar seu objeto complexo. Por exemplo, se estiver analisando a resposta de um Etapa REST Se retornar 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: Matrizes multidimensionais não são compatíveis. Hifens, pontos, espaços, dois pontos duplos e o símbolo em chaves JSON não são compatíveis. Sua carga de exemplo não pode exceder 2 MB.
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 em Destino Campo Manualmente, você pode 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 em Destino campo. Elementos secundários para cada objeto são gerados automaticamente como tipo Cadeia de caracteres. Como alternativa, você pode criar manualmente seu objeto complexo de destino adicionando elementos em Destino campo.
Meta	Exiba ou edite a estrutura de saída da carga JSON. Clique em para criar uma saída estruturada Gerar destino ou adicione elementos manualmente. Cada elemento contém as seguintes informações na exibição Editar objeto: Rótulo Rótulo da cápsula de dados. Por padrão, o sistema usa o nome da chave JSON. Nome Nome interno do elemento de saída. Nota: Pontos de exclamação, dois pontos, o símbolo a ou somente números não são valores válidos para o nome de um elemento. Tipo Tipo de dados, que deve ser Cadeia de caracteres, Objeto, Array.String ou Array.Object. O elemento de nível superior deve ser um Objeto. Obrigatório : Alterne para tornar o elemento necessário. Isso se aplica somente a elementos do tipo Cadeia de caracteres. Adicionar item secundário : Selecione o ícone adicionar item secundário ( ) para adicionar um elemento secundário aninhado. Os elementos do tipo Objeto contêm Salvar como modelo opção avançada, 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 comprimento máximo, dica e 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 Alternar entradas avançadas ( ) para exibir o. JSONPath opçã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ê poderá copiar o JSONPath de um nó na carga de exemplo e colá-lo nas opções avançadas de um elemento.

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 as etapas REST Response BodyE fornecem uma saída de objeto complexa que representa o esquema da tabela Problema [Problema]. Por fim, crie uma saída de ação do tipo Objeto nomeado Problems from Production. Solte o. rootCápsula de dados da etapa do analisador JSON para o campo de valor desta saída.

Figura 1. Analisar problemas da ação de produção

Em seguida, crie um novo fluxo chamado Sync New Problems, que é acionado diariamente à meia-noite. A primeira ação no fluxo é Parse Problems from Productionação. Em seguida, adicione um For Eachbloco de lógica de fluxo e solte o. Problemas de produção > resposta cápsula de dados no Item campo. Em Para cada um bloco, adicione um Ifbloco de lógica de fluxo 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.

Figura 2. Fluxo de Novos problemas de sincronização