La acción Validar en el paquete JSON permite validar el contenido de una fuente de datos JSON. Puede usar esta acción para validar la sintaxis, la estructura y el esquema de cualquier fuente JSON.

Descripción general

La acción Validar permite verificar si hay posibles errores en la fuente de datos JSON antes de pasarla a cualquier acción posterior. Esta acción mejora la confiabilidad de la automatización al prevenir fallas en tiempo de ejecución y reducir el tiempo de depuración. Puede especificar la fuente de datos JSON, establecer los niveles de validación y guardar los resultados de la validación en varias variables o en una sola variable de diccionario.

La acción Validar admite la capacidad de transmisión de archivos. Puede usar cualquier acción capaz de flujo de archivos para crear una variable de archivo que contenga el flujo de archivos y usar la variable de archivo como la fuente de datos JSON.

Niveles de validación

Los siguientes niveles de validación están disponibles en esta acción:

Formato
La opción Formato valida la fuente de datos JSON según las reglas de sintaxis, como el formato y la gramática. Esta opción le permite verificar el uso correcto de las reglas gramaticales de JSON, tales como llaves {}, corchetes [], dos puntos :, comas ,, string entre comillas dobles y literales de JSON, como true, false y null.
Este nivel de validación no está disponible cuando selecciona una variable Diccionario como fuente de datos.
Nodo
La opción Nodo valida la fuente de datos JSON según reglas de estructura, como la existencia de un nodo específico y su tipo de datos correcto. Esta opción le permite verificar la existencia de un nodo al especificar la clave del nodo o la ruta del nodo. También debe especificar el tipo de datos esperado del nodo especificado en el menú desplegable Tipo de valor.
Esquema
La opción Esquema valida si la fuente de datos JSON sigue la definición de esquema especificada. Esta opción engloba tanto las opciones Formato como Nodo, ya que el esquema JSON define la gramática de JSON, los nodos, los tipos de datos, los campos obligatorios/opcionales, los valores de enumeración y los valores máximos/mínimos.
Nota: Asegúrese de especificar la versión del borrador del esquema JSON en la variable del archivo de definición del esquema o en la string. Si no especifica la versión, la acción Validar utiliza la especificación Borrador del esquema JSON 2020-12 como opción predeterminada para validar la fuente de datos JSON.

Resultados de validación

La acción Validar permite guardar los resultados de la validación como variables individuales o como una sola variable de diccionario. La ejecución de la automatización falla solo si hay una falla de plataforma, como la existencia del valor Null en la fuente de datos JSON. Los resultados de la validación se almacenan en las siguientes claves:

esválido
La clave esválido contiene el resultado de validación de la fuente JSON. Los siguientes son los valores posibles:
  • true: Si la validación es exitosa.
  • falso: Si la validación falla.
niveldevalidación
La clave niveldevalidación contiene el nivel de validación que configuró al establecer la acción. Los siguientes son los valores posibles:
  • sintaxis: Si el nivel de validación está configurado como Formato.
  • estructura: Si el nivel de validación está configurado como Nodo.
  • esquema: Si el nivel de validación está configurado como Esquema.
errorderuta
La clave errorderuta contiene la ruta en la fuente de datos JSON donde está presente el error.
mensaje de error
La clave mensaje de error contiene el mensaje de error. Por ejemplo, si el esquema JSON define un número, pero la fuente de datos JSON proporciona una string en la misma ubicación, la clave mensaje de error almacena este mensaje de error string encontrado, número entero esperado como su valor.