Skip to main content

Adaptador JSON

English

Introducción

El Adaptador JSON le permite interactuar con un archivo .json, gracias a una variedad de funciones predefinidas que permiten recuperar y confirmar la existencia de valores gracias a un TagName o a un JsonPath.

Parámetros de inicialización

En el proceso de inicialización de este Adaptador es necesario proporcionar la información siguiente: 

  • JsonFilePath: directorio o ruta completa del archivo json.

Funciones Predefinidas (PF's)

  • getALLJSONElementInfoByTagName: esta función permite recuperar todos los valores de un elemento, con su nivel de profundidad en un archivo JSON y devolverlos bajo un TastDataTable de tres columnas (TagName, valor, nivel). También se puede filtrar el resultado específicando el nivel bajo el que se debe encontrar el TagName.
      • Parámetros de entrada: TagName, LevelPosition.

      • Parámetros de salida: #TASTTABLEDATA de 3 columnas (TagName, valor, nivel).

  • getALLJSONElementValueByTagName: esta función permite recuperar todos los valores de un elemento, asociado al TagName, como un array de valores representado por un objeto TastRowValues.
      • Parámetros de entrada: TagName.
      • Parámetros de salida: #TASTROWVALUES Array con los valores de tipo STRING.
  • getElementsCountByJsonPath: esta función permite recuperar el número de elementos que coinciden con el JsonPath proporcionado.

      • Parámetros de entrada: JsonPath.

      • Parámetros de salida: #INTEGER Número de elementos que coinciden con el JsonPath.

  • getElementsCountByTagName: esta función permite recuperar el número de elementos que coinciden con el TagName proporcionado.

      • Parámetros de entrada: TagName.

      • Parámetros de salida: #INTEGER Número de elementos que coinciden con el TagName.

  • getElementsValueByJsonPath: esta función permite recuperar datos de tipo TASTROWVALUES con los valores de los tags que tienen el mismo JsonPath
      • Parámetros de entrada: JsonPath.

      • Parámetros de salida: #TASTROWVALUES Array de tipo STRING con los valores de los tags.

  • getJSONElementValueByJsonPath: esta función permite recuperar el valor de un elemento, empleando una expresión JsonPath para identificar el elemento.
      • Parámetros de entrada: JsonPath.

      • Parámetros de salida: #STRING Valor del tag que coincide con el JsonPath.

  • getJSONElementValueByTagName: esta función permite recuperar el valor de un elemento, empleando el TagName para identificar el valor a recuperar. Si existen varios elementos con este TagName, se devolverá el valor del primer elemento.
      • Parámetros de entrada: TagName.

      • Parámetros de salida: #STRING Valor del tag que tiene ese atributo TagName.