Select (Método)

Descripción general

Tipo:	Método
Disponible desde:	V1.4.15.0

Descripción funcional

Este método se utiliza para seleccionar el elemento especificado de los datos analizados de formato JSON. A partir del elemento seleccionado, podrán ejecutarse otros métodos.

El elemento se especifica mediante una expresión JPath. Si la expresión JPath coincide con varios elementos, se seleccionará el primer elemento coincidente. Si se asigna una cadena nula a la entrada i_sJPath, se seleccionará el elemento raíz.

Con cada llamada, se iniciará una búsqueda del elemento especificado desde el principio de los datos analizados. Es decir, el uso de la misma expresión JPath siempre conllevará la selección del mismo elemento.

El valor de retorno de tipo BOOL indicará TRUE si se ha seleccionado correctamente un elemento. Si se detecta un error, utilice las propiedades Result y ResultMsg para obtener el resultado del método.

En el caso de que no se pueda seleccionar el elemento solicitado, el elemento anteriormente seleccionado permanecerá seleccionado.

Interfaz

Entrada	Tipo de datos	Descripción
i_sJPath	STRING [255]	JPath Expresión para especificar el elemento que se va a seleccionar. Si se asigna una cadena nula, se seleccionará el elemento raíz.

NOTA: Al ejecutar este método, se restablece el error anteriormente detectado que indicaban las propiedades correspondientes.

JPath Expresiones

Utilice la sintaxis del lenguaje JPath para especificar el elemento que se va a seleccionar.

La tabla contiene una lista de las expresiones JPath admitidas:

JPath expresión	Descripción
`.<item name>` `<item name>` `.[<item name>]` `[<item name>]`	Selecciona el primer elemento con el nombre especificado en el primer nivel.
`.<item name>.<item name>` `.[<item name>].[<item name>]` `[<item name>][<item name>]`	Selecciona el primer elemento que coincide con la ruta absoluta especificada.
`.<parent name>.<item name>[<n>]` `.<parent name>.<item name>.[<n>]`	Selecciona el primer elemento de matriz que coincide con la ruta absoluta especificada. Con `<n>` se especifica el índice (basado en cero) del elemento de la matriz.
`.<parent name>.<item name>.[<n>].<item name>` `.<parent name>.<item name>.[<n>].[<item name>]`	Selecciona el elemento hijo del primer elemento de matriz que coincide con la ruta absoluta especificada. Con `<n>` se especifica el índice (basado en cero) del elemento de la matriz.

En el siguiente ejemplo se muestra cómo utilizar la expresión JPath para seleccionar un elemento de un conjunto de datos de formato JSON:

JPath expresión	Datos JSON analizados
`.Library -------------> .Supported Formats[1]-> .Address -------------> .Address.Street ------>`	`{ "Library": "FileFormatUtility", "Namespace": "FFU", "Forward Compatible": true, "Supported Formats": [ "JSON", "XML", "CSV"], "Company": "Schneider Electric", "Address": { "Street": "Schneiderplatz", "House Number": 1, "Postal Code": "97828", "City": "Marktheidenfeld", "Country": "Germany" } }`

JPath expresión

Datos JSON analizados


.Library ------------->


.Supported Formats[1]->




.Address ------------->
.Address.Street ------>

{ 
  "Library": "FileFormatUtility",
  "Namespace": "FFU",
  "Forward Compatible": true,
  "Supported Formats": [
               "JSON",
               "XML",
               "CSV"],
  "Company": "Schneider Electric",
  "Address":  {
               "Street": "Schneiderplatz",
               "House Number": 1,
               "Postal Code": "97828",
               "City": "Marktheidenfeld",
               "Country": "Germany"
  }
}