Cadenas, cadenas numéricas y secuencias

Las cadenas de expresiones incluyen campos como nombres de propiedad y descripciones, así como valores literales. Después de seleccionar una cadena en una expresión, hay varios métodos y atributos que puede seleccionar para esa cadena. Por ejemplo, puede concatenar el nombre y la descripción de un nodo y usar la cadena resultante en una propiedad Alias, o bien puede devolver solo una parte de una cadena de origen mediante el método substring.

Las cadenas numéricas y los tipos de datos de secuencia son cadenas que soportan solo valores numéricos (0-9). Están limitadas a 40 caracteres.

Puede agregar valores literales a los tipos de datos de cadena. Consulte Trabajo con valores literales.

En muchos de los métodos string tendrá que introducir más parámetros. El creador de expresiones crea un nuevo término de expresión para esos parámetros al seleccionar ese método. Por ejemplo, al seleccionar un método concat, se agrega un término de expresión adicional para que especifique la cadena que agregar. Al seleccionar un método replace, se agregan dos términos de expresión adicionales para que especifique el texto que buscar y el texto con el que reemplazarlo.

En la tabla siguiente se describen los métodos y atributos que puede usar para manipular los valores de cadenas en el creador de expresiones, así como los parámetros para esos campos.

Método o atributo Uso Parámetros
Concat

Concatena (o agrega) dos o más campos de cadenas juntos y devuelve la cadena combinada como resultado.

Note:

Puede agregar varias cadenas en una sola sentencia concat. Cuando tenga que concatenar varias cadenas, puede hacer clic en seleccionar término en un término de expresión y seleccionar Insertar encima o Eliminar para mover ese campo o eliminarlo.

La cadena que agregar

endsWith

Devuelve True si la cadena original termina por la cadena especificada.

Note:

La cadena especificada distingue entre mayúsculas y minúsculas.

Cadena especificada para comprobar si la cadena original termina por esta cadena.

equals

Devuelve True si la cadena es igual a la cadena especificada.

Cadena especificada para comprobar si la cadena original es igual a esta cadena.

greaterThan

Devuelve True si el valor de la cadena es mayor que el valor especificado (ambos deben ser del mismo tipo de datos).

Cadena especificada para comprobar si la cadena original es mayor que esta cadena.

greaterThanOrEqual

Devuelve True si el valor de la cadena es mayor o igual que el valor especificado (ambos deben ser del mismo tipo de datos).

Cadena especificada para comprobar si la cadena original es mayor o igual que esta cadena.

indexOf

Devuelve la posición de inicio de la cadena especificada en la cadena original.

Note:

El método indexOf devuelve un entero, que no se puede usar directamente como valor de devolución. Puede usar este entero para determinar el lugar de inicio para una subcadena. Consulte Entero y flotante.

La cadena cuya posición inicial desea encontrar.

IsEmpty

Devuelve True si la propiedad contiene un valor nulo o una cadena vacía.

No es necesario ningún parámetro

isNull Devuelve True si la propiedad de cadena contiene un valor nulo. No es necesario ningún parámetro
length

Realiza un recuento de la cantidad de caracteres de una cadena.

El atributo length es un entero. Consulte Entero y flotante.

No es necesario ningún parámetro

lessThan

Devuelve True si el valor de la cadena es menor que el valor especificado (ambos deben ser del mismo tipo de datos).

Cadena especificada para comprobar si la cadena original es menor que esta cadena.

lessThanOrEqual

Devuelve True si el valor de la cadena es menor o igual que el valor especificado (ambos deben ser del mismo tipo de datos).

Cadena especificada para comprobar si la cadena original es menor o igual que esta cadena.

matches

Devuelve True si la cadena coincide con la expresión regular de Java especificada.

Tip:

Las expresiones regulares especifican los patrones que se van a buscar en los datos de cadena mediante convenciones de sintaxis estandarizadas. Una expresión regular, o regex, puede especificar patrones complejos de secuencias de caracteres.

Por ejemplo, la siguiente expresión regular: a(b|c)d, busca el patrón: a, seguido de b o c y, a continuación, seguido de d. Esta expresión regular coincide con abd y con acd.

Expresión regular de Java especificada para comprobar si coincide la cadena original.

Note:

Las expresiones regulares Java realizan coincidencias completas en las cadenas, no coincidencias parciales. Por tanto, si realiza una búsqueda de Corporate en un nombre de aplicación, una aplicación con el nombre Corporate Planning no sería una coincidencia.

Utilice comodines delante o detrás de una cadena para buscar coincidencias parciales. Por ejemplo, .*Corporate.* coincidirá con Corporate Planning.

orElse Devuelve un valor especificado si el término de expresión anterior tiene un valor nulo.

Valor que se devuelve si el término de expresión anterior es nulo.

Por ejemplo, return node.properties.Core.Description.orElse('Default Descr') devolverá "Default Descr" si la propiedad Core.Description de un nodo es nula.

replace

Sustituye todas las instancias de una cadena antigua por una nueva cadena

  • La cadena original que buscar

    Note:

    Puede usar una expresión regular de Java para identificar el patrón de cadena que buscar.
  • La cadena con la que reemplazar la cadena original
split

Divide una cadena en una lista de cadenas según el delimitador especificado.

Note:

Consulte Lista y lista de cadenas para obtener información sobre los métodos que puede agregar a una lista de cadenas.

Delimitador por el que dividir la cadena

Incluir valores en blanco: especifique si se deben o no incluir valores en blanco como elementos de lista en la lista de cadenas resultante.

  • True: permite incluir valores en blanco en la lista de cadenas resultante.
  • False (por defecto): se excluyen los valores en blanco de la lista de cadenas resultante.

Por ejemplo, para la cadena A//C, si Incluir valores en blanco está activado, la lista de cadenas tendrá tres entradas: A, (blank value), C. Si está desactivado, la lista de cadenas tendrá dos entradas: A y C.

startsWith

Devuelve True si la cadena original empieza por la cadena especificada.

Note:

La cadena especificada distingue entre mayúsculas y minúsculas.

Cadena especificada para comprobar si la cadena original comienza por esta cadena.

substring

Devuelve parte de una cadena.

  • La posición de inicio
  • La cantidad de caracteres que devolver
toDate

Convierte un valor de cadena en un valor de fecha

Formato de fecha (por ejemplo, MM/dd/aaaa).

Consulte Símbolos de formato de fecha y hora para obtener información sobre el formato de fecha y hora.

toFloat

Convierte un valor de cadena en un valor flotante

No es necesario ningún parámetro

toInteger

Convierte un valor de cadena en un valor entero.

No es necesario ningún parámetro

toLowerCase

Devuelve una cadena en minúsculas.

No es necesario ningún parámetro

toUpperCase

Devuelve una cadena en mayúsculas.

No es necesario ningún parámetro

trim

Devuelve la cadena con los espacios iniciales y finales eliminados.

Note:

Trim también eliminará los caracteres de espacio en blanco, como los tabuladores y los retornos de carro.

No es necesario ningún parámetro

Para greaterThan, greaterThanOrEqual, lessThan y lessThanorEqual, la cadena se ordena por el primer carácter y, a continuación, por el segundo carácter y así sucesivamente. Al realizar la comparación, 0-9 es menor que A-Z.

Ejemplos:

  • A < AA
  • AA > B
  • 11 < 2
  • A > 1

Puede combinar métodos y atributos de cadena en la expresión. Por ejemplo, con la siguiente cadena se busca el carácter @ en la descripción de un nodo y se devuelve todo lo que haya tras ese carácter.


la captura de pantalla contiene una expresión según se describe en el siguiente párrafo

En este ejemplo, el primer término de expresión es una expresión substring, que necesita dos parámetros: una posición de inicio y la cantidad de caracteres que devolver.

  • Para el término de expresión de la posición de inicio, hemos seleccionado un método indexOf con un parámetro "@". De esta forma se buscará en el campo de descripción el signo @ y se devolverá el valor entero donde se encuentre ese signo como posición de inicio.
  • Para la cantidad de caracteres para devolver el término de expresión, hemos seleccionado un atributo length. De esta forma se garantiza que, con independencia de la longitud de la cadena, se devolverá el valor completo tras el signo @ porque la cantidad de caracteres es igual a la longitud de la cadena completa.