Stringhe, stringhe numeriche e sequenze

Le stringhe nelle espressioni includono campi quali i nomi e le descrizioni delle proprietà, nonché i valori letterali. Dopo aver selezionato una stringa in un'espressione, è possibile selezionare diversi metodi e attributi per la stringa in questione. Ad esempio, è possibile concatenare il nome e la descrizione di un nodo e utilizzare la stringa risultante in una proprietà Alias oppure è possibile restituire solo una parte di una stringa di origine utilizzando il metodo substring.

Le stringhe numeriche e i tipi di dati Sequenza sono stringhe che supportano solo valori numerici (0-9). Il limite massimo è di 40 caratteri.

Ai tipi di dati stringa è possibile aggiungere valori letterali. Fare riferimento a Utilizzo dei valori letterali.

Molti dei metodi string richiedono l'immissione di parametri aggiuntivi. Quando si seleziona il metodo, il generatore espressioni crea un nuovo termine espressione per tali parametri. Ad esempio, quando si seleziona un metodo concat, viene aggiunto automaticamente un ulteriore termine espressione per specificare la stringa da aggiungere in fondo. Quando si seleziona un metodo replace, vengono aggiunti automaticamente due ulteriori termini espressione per specificare il testo da ricercare e il testo con cui sostituirlo.

Nella tabella seguente vengono illustrati i metodi e gli attributi che è possibile utilizzare per manipolare i valori stringa nel generatore espressioni, nonché i parametri per tali campi.

Metodo o attributo	Utilizzo	Parametri
`Concat`	Concatena (o aggiunge in fondo) due o più campi stringa e restituisce come risultato la stringa combinata. Note: è possibile aggiungere in fondo più stringhe in un'unica istruzione `concat`. Quando sono presenti più stringhe da concatenare, è possibile fare clic su in un termine espressione e selezionare Inserisci sopra oRimuovi per spostare il campo o rimuoverlo.	La stringa da aggiungere in fondo
`endsWith`	Restituisce `True` se la stringa originale termina con la stringa specificata. Note: La stringa specificata fa distinzione tra maiuscole e minuscole.	La stringa specificata da controllare se la stringa originaria termina con il valore specificato.
`equals`	Restituisce `True` se la stringa è uguale alla stringa specificata.	La stringa specificata da controllare se la stringa originaria è uguale.
`greaterThan`	Restituisce `True` se il valore della stringa è maggiore del valore specificato (entrambi devono essere dello stesso tipo di dati).	La stringa specificata da controllare se la stringa originaria è maggiore del valore specificato.
`greaterThanOrEqual`	Restituisce `True` se il valore della stringa è maggiore del valore specificato (entrambi devono essere dello stesso tipo di dati).	La stringa specificata da controllare se la stringa originaria è maggiore o uguale al valore specificato.
`indexOf`	Restituisce la posizione iniziale della stringa specificata nella stringa originaria. Note: Il metodo `indexOf` restituisce un numero intero che non può essere utilizzato direttamente come valore restituito. È possibile utilizzare tale numero intero per determinare la posizione iniziale di una sottostringa. Fare riferimento alla sezione Valore intero e a virgola mobile.	La stringa per cui si desidera trovare la posizione iniziale.
`IsEmpty`	Restituisce `True` se la proprietà contiene un valore null o una stringa vuota.	Non è necessario specificare alcun parametro
`isNull`	Restituisce `True` se la proprietà della stringa contiene un valore null.	Non è necessario specificare alcun parametro
`length`	Conteggia il numero di caratteri presenti in una stringa. L'attributo `length` è un numero intero. Fare riferimento alla sezione Valore intero e a virgola mobile.	Non è necessario specificare alcun parametro
`lessThan`	Restituisce `True` se il valore della stringa è minore del valore specificato (entrambi devono essere dello stesso tipo di dati).	La stringa specificata da controllare se la stringa originaria è minore del valore specificato.
`lessThanOrEqual`	Restituisce `True` se il valore della stringa è minore o uguale al valore specificato (entrambi devono essere dello stesso tipo di dati).	La stringa specificata da controllare se la stringa originaria è minore o uguale al valore specificato.
`matches`	Restituisce `True` se la stringa corrisponde all'espressione regolare Java specificata. Tip: Le espressioni regolari specificano i pattern da cercare nei dati della stringa utilizzando convenzioni di sintassi standardizzate. Un'espressione regolare, o regex, può specificare pattern complessi di sequenze di caratteri. Ad esempio, la seguente espressione regolare: `a(b\|c)d` cerca il pattern: `a`, seguito da `b` o `c`, quindi seguito da `d`. Questa espressione regolare corrisponde sia ad `abd` che ad `acd`.	L'espressione regolare Java specificata da controllare se la stringa originaria corrisponde. Note: Le espressioni regolari Java eseguono corrispondenze complete sulle stringhe, non corrispondenze parziali. Se quindi si cerca `Corporate` nel nome di un'applicazione, non verrà selezionata come corrispondente un'applicazione con nome `Corporate Planning`. Usare caratteri jolly prima e dopo una stringa per cercare corrispondenze parziali. Ad esempio, `.Corporate.` corrisponderà a `Corporate Planning`.
`orElse`	Restituisce un valore specificato se il termine espressione precedente contiene un valore null.	Il valore da restituire se il termine espressione precedente è null. Ad esempio, `return node.properties.Core.Description.orElse('Default Descr')` restituisce "Default Descr" se la proprietà Core.Description per un nodo è null.
`replace`	Sostituisce tutte le istanze di una stringa precedente con una nuova stringa.	La stringa originaria da cercare Note: È possibile utilizzare un'espressione regolare Java per identificare il pattern di stringa da cercare. La stringa con cui sostituire la stringa originaria
`split`	Suddivide una stringa in una lista di stringhe in base al delimitatore specificato. Note: Fare riferimento alla sezione Lista e Lista di stringhe per informazioni sui metodi che possono essere aggiunti a una lista di stringhe.	Delimitatore da utilizzare per suddividere la stringa Includi valori vuoti: specificare se i valori vuoti possono essere inclusi come voci di elenco nella lista di stringhe risultante. `True`: consente l'inclusione dei valori vuoti nella lista di stringhe risultante. `False` (valore predefinito): i valori vuoti sono esclusi dalla lista di stringhe risultante. Ad esempio, per la stringa `A//C`, se l'opzione Includi valori vuoti è abilitata, la lista di stringhe conterrà tre voci: `A, (valore vuoto), C`. Se è disabilitata, la lista di stringhe conterrà due voci: `A` e `C`.
`startsWith`	Restituisce `True` se la stringa originale inizia con la stringa specificata. Note: La stringa specificata fa distinzione tra maiuscole e minuscole.	La stringa specificata da controllare se la stringa originaria inizia con il valore specificato.
`substring`	Restituisce parte di una stringa.	La posizione iniziale Il numero di caratteri da restituire
`toDate`	Converte un valore stringa in un valore data	Formato della data, ad esempio (MM/gg/aaaa). Per informazioni sulla formattazione per data e ora, fare riferimento alla sezione Simboli di formattazione della data e dell'ora.
`toFloat`	Converte un valore stringa in un valore a virgola mobile	Non è necessario specificare alcun parametro
`toInteger`	Converte un valore stringa in un valore intero.	Non è necessario specificare alcun parametro
`toLowerCase`	Restituisce una stringa con tutti i caratteri in minuscolo.	Non è necessario specificare alcun parametro
`toUpperCase`	Restituisce una stringa con tutti i caratteri in maiuscolo.	Non è necessario specificare alcun parametro
`trim`	Restituisce una stringa dopo aver eliminato gli spazi iniziali e finali. Note: `Trim` rimuoverà anche gli spazi vuoti, ad esempio le tabulazioni e i ritorni a capo.	Non è necessario specificare alcun parametro

Per greaterThan, greaterThanOrEqual, lessThan e lessThanorEqual, la stringa viene ordinata in base al primo carattere, quindi al secondo e così via. Nel confronto, 0-9 è minore di A-Z.

Esempi

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

È possibile combinare metodi e attributi per le stringhe nell'espressione. Ad esempio, la stringa seguente cerca il carattere @ nella descrizione di un nodo e restituisce tutto ciò che segue tale carattere.

screenshot che contiene un'espressione descritta nel paragrafo seguente

In questo esempio il primo termine espressione è un'espressione substring che richiede due parametri, ovvero una posizione iniziale e il numero di caratteri da restituire.

Per il termine espressione relativo alla posizione iniziale, è stato selezionato un metodo indexOf con un parametro "@". In questo modo, verrà ricercato il carattere @ nel campo della descrizione e restituito il valore intero corrispondente alla posizione iniziale di tale carattere.
Per il termine espressione relativo al numero di caratteri, è stato selezionato un attributo length. In questo modo, ci si assicura che, indipendentemente dalla lunghezza della stringa, venga restituito l'intero valore dopo il carattere @ perché il numero di caratteri è uguale alla lunghezza della stringa completa.