A ação Validar no pacote JSON permite que você valide o conteúdo de uma fonte de dados JSON. Você pode usar essa ação para validar a sintaxe, a estrutura e o esquema de qualquer fonte JSON.

Visão geral

A ação Validar permite que você verifique possíveis erros na fonte de dados JSON antes de enviá-la para quaisquer ações subsequentes. Essa ação melhora a confiabilidade da automação ao prevenir falhas em tempo de execução e reduzir o tempo de depuração. Você pode especificar a fonte de dados JSON, definir os níveis de validação e salvar os resultados da validação em várias variáveis ou em uma única variável de dicionário.

A ação Validar é compatível com a transmissão de arquivos. Você pode usar quaisquer ações compatíveis com transmissão de arquivo para criar uma variável que contenha a transmissão de arquivo e usar essa variável como a fonte de dados JSON.

Níveis de validação

Os seguintes níveis de validação estão disponíveis nesta ação:

Formato
A opção Formatar valida a fonte de dados JSON quanto às regras de sintaxe, como formato e gramática. Essa opção permite verificar o uso correto das regras de sintaxe do JSON, como chaves {}, colchetes [], dois-pontos :, vírgulas ,, aspas duplas e literais do JSON como true, false e null.
Esse nível de validação não está disponível quando você seleciona uma variável de Dicionário como fonte de dados.
Nó
A opção Nó valida a fonte de dados JSON quanto às regras de estrutura, como a existência de um nó específico e seu tipo de dado correto. Essa opção permite que você verifique a existência de um nó especificando sua chave ou caminho. Você também deve especificar o tipo de dado esperado do nó especificado no menu suspenso Tipo de valor.
Esquema
A opção Esquema valida se a fonte de dados JSON segue a definição de esquema especificada. Essa opção engloba tanto as opções Formato quanto Nó, pois o esquema JSON define a gramática do JSON, nós, tipos de dados, campos obrigatórios/opcionais, valores de enumeração e valores máximos/mínimos.
Nota: Certifique-se de especificar a versão preliminar do esquema JSON na variável do arquivo de definição do esquema ou na string. Se você não especificar a versão, a ação Validar usará a especificação JSON schema draft 2020-12 como opção padrão para validar a fonte de dados JSON.

Resultados da validação

A ação Validar permite que você salve os resultados da validação como variáveis individuais ou uma única variável de dicionário. A execução da automação falhará apenas se houver uma falha de plataforma, como a existência do valor Null na fonte de dados JSON. Os resultados da validação são armazenados nas seguintes chaves:

isvalid
A chave isvalid contém o resultado da validação da fonte JSON. Os seguintes valores possíveis são:
  • true: se a validação for concluída com êxito.
  • false: se a validação falhar.
validationlevel
A chave validationlevel contém o nível de validação que você definiu ao configurar a ação. Os seguintes valores possíveis são:
  • syntax: se o nível de validação estiver definido como Formato.
  • structure: se o nível de validação estiver definido como Nó.
  • schema: se o nível de validação estiver definido como Esquema.
errorpath
A chave errorpath contém o caminho na fonte de dados JSON onde o erro está presente.
error message
A chave error message contém a mensagem de erro. Por exemplo, se o esquema JSON define um número, mas a fonte de dados JSON fornece uma string no mesmo local, a chave error message armazena essa mensagem de erro string encontrada, inteiro esperado como seu valor.