Chaînes, chaînes numériques et séquences

Les chaînes dans les expressions incluent des champs tels que les noms et descriptions de propriété, ainsi que des valeurs littérales. Lorsque vous sélectionnez une chaîne dans une expression, vous pouvez sélectionner plusieurs méthodes et attributs pour cette chaîne. Par exemple, vous pouvez concaténer le nom et la description d'une chaîne et utiliser la chaîne obtenue dans une propriété d'alias, ou vous pouvez renvoyer une partie d'une chaîne source à l'aide de la méthode de sous-chaîne.

Les types de données Chaîne numérique et Séquence sont des chaînes qui prennent en charge uniquement des valeurs numériques (0-9). Elles sont limitées à 40 caractères.

Vous pouvez ajouter des valeurs littérales aux types de données de chaîne. Reportez-vous à Utilisation de valeurs littérales.

La plupart des méthodes de chaîne requièrent la saisie de paramètres supplémentaires. Le générateur d'expressions crée un terme d'expression pour ces paramètres lorsque vous sélectionnez cette méthode. Par exemple, lorsque vous sélectionnez une méthode concat, un terme d'expression supplémentaire est ajouté pour que vous indiquiez la chaîne à ajouter. Lorsque vous sélectionnez une méthode replace, deux termes d'expression supplémentaires sont ajoutés pour que vous indiquiez le texte à rechercher et le texte par lequel le remplacer.

Le tableau suivant décrit les méthodes et les attributs que vous pouvez utiliser pour manipuler les valeurs de chaîne dans le générateur d'expressions, ainsi que les paramètres pour ces champs.

Méthode ou attribut	Utilisation	Paramètres
`Concat`	Concatène (ou ajoute) au moins deux champs de chaîne et renvoie la chaîne combinée comme résultat. Note: Vous pouvez ajouter plusieurs chaînes dans une même instruction `concat`. Lorsque vous devez concaténer plusieurs chaînes, vous pouvez cliquer sur dans un terme d'expression, et sélectionner Insérer au-dessus ou Enlever pour déplacer le champ ou l'enlever.	Chaîne à ajouter
`endsWith`	Renvoie `True` si la chaîne d'origine se termine par la chaîne spécifiée. Note: La chaîne spécifiée distingue les majuscules des minuscules.	Chaîne spécifiée pour vérifier si la chaîne d'origine se termine par celle-ci.
`equals`	Renvoie `True` si la chaîne équivaut à la chaîne spécifiée.	Chaîne spécifiée pour vérifier si la chaîne d'origine correspond.
`greaterThan`	Renvoie `True` si la valeur de chaîne est supérieure à la valeur indiquée (les deux doivent être du même type de données).	Chaîne spécifiée pour vérifier si la chaîne d'origine est supérieure.
`greaterThanOrEqual`	Renvoie `True` si la valeur de chaîne est supérieure ou égale à la valeur indiquée (les deux doivent être du même type de données).	Chaîne spécifiée pour vérifier si la chaîne d'origine est supérieure ou égale.
`indexOf`	Renvoie la position de départ de la chaîne spécifiée dans la chaîne d'origine. Note: La méthode `indexOf` renvoie un entier, qui ne peut pas être utilisé directement comme valeur renvoyée. Vous pouvez utiliser cet entier pour déterminer la position de départ d'une sous-chaîne. Reportez-vous à la section Valeur entière et flottante.	Chaîne pour laquelle déterminer la position de départ.
`IsEmpty`	Renvoie `True` si la propriété contient une valeur NULL ou une chaîne vide.	Aucun paramètre requis
`isNull`	Renvoie `True` si la propriété de chaîne contient une valeur NULL.	Aucun paramètre requis
`length`	Compte le nombre de caractères d'une chaîne L'attribut `length` est un entier. Reportez-vous à la section Valeur entière et flottante.	Aucun paramètre requis
`lessThan`	Renvoie `True` si la valeur de chaîne est inférieure à la valeur indiquée (les deux doivent être du même type de données).	Chaîne spécifiée pour vérifier si la chaîne d'origine est inférieure.
`lessThanOrEqual`	Renvoie `True` si la valeur de chaîne est inférieure ou égale à la valeur indiquée (les deux doivent être du même type de données).	Chaîne spécifiée pour vérifier si la chaîne d'origine est inférieure ou égale.
`matches`	Renvoie `True` si la chaîne correspond à l'expression régulière Java. Tip: Les expressions régulières spécifient les modèles à rechercher dans les données de chaîne à l'aide de conventions syntaxiques normalisées. Une expression régulière, ou regex, peut spécifier des modèles complexes de séquences de caractères. Par exemple, l'expression régulière `a(b\|c)d` recherche le modèle `a`, suivi de `b` ou `c`, puis de `d`. Cette expression régulière correspond à la fois à `abd` et à `acd`.	Expression régulière Java spécifiée pour vérifier si la chaîne originale correspond. Note: Les expressions régulières Java recherchent des correspondances totales dans les chaînes, pas des correspondances partielles. Ainsi, si vous recherchez `Corporate` dans un nom d'application, une application du nom de `Corporate Planning` ne sera pas trouvée. Placez des caractères génériques avant et après la chaîne pour rechercher des correspondances partielles. Par exemple, `.Corporate.` offre une correspondance avec `Corporate Planning`.
`orElse`	Renvoie une valeur indiquée si le terme d'expression précédent a une valeur NULL.	Valeur à renvoyer si le terme d'expression précédent est NULL. Par exemple, `return node.properties.Core.Description.orElse('Default Descr')` renvoie "Default Descr" si la propriété Core.Description d'un noeud est NULL.
`replace`	Remplace toutes les instances d'une ancienne chaîne par une nouvelle	Chaîne d'origine à rechercher Note: Vous pouvez employer une expression régulière Java permettant d'identifier le modèle de chaîne à rechercher. Chaîne par laquelle remplacer celle d'origine
`split`	Fractionne une chaîne en liste de chaînes selon le séparateur indiqué. Note: Reportez-vous à la section Liste et liste de chaînes pour connaître les méthodes que vous pouvez ajouter à une liste de chaînes.	Séparateur selon lequel fractionner la chaîne Inclure les entrées vides : indiquez si les valeurs vides doivent être incluses en tant qu'éléments de liste dans la liste de chaînes obtenue. `True` : inclut les valeurs vides dans la liste de chaînes obtenue. `False` (valeur par défaut) : exclut les valeurs vides de la liste de chaînes obtenue. Prenons par exemple la chaîne `A//C`. Si le paramètre Inclure les entrées vides est activé, la liste de chaînes aura trois entrées : `A, (valeur vide), C`. Si le paramètre est désactivé, la liste de chaînes aura deux entrées : `A` et `C`.
`startsWith`	Renvoie `True` si la chaîne d'origine commence par la chaîne spécifiée. Note: La chaîne spécifiée distingue les majuscules des minuscules.	Chaîne spécifiée pour vérifier si la chaîne d'origine commence par celle-ci.
`substring`	Renvoie une partie d'une chaîne.	Position de départ Nombre de caractères à renvoyer
`toDate`	Convertit une valeur de chaîne en valeur de date	Format de date (par exemple, MM/dd/yyyy). Reportez-vous à la section Symboles de formatage de date et d'heure pour plus d'informations sur le formatage de la date et de l'heure.
`toFloat`	Convertit une valeur de chaîne en valeur flottante	Aucun paramètre requis
`toInteger`	Convertit une valeur de chaîne en valeur entière.	Aucun paramètre requis
`toLowerCase`	Renvoie une chaîne entièrement en minuscules.	Aucun paramètre requis
`toUpperCase`	Renvoie une chaîne entièrement en majuscules.	Aucun paramètre requis
`trim`	Renvoie une chaîne en omettant les espaces de tête et de fin. Note: `Trim` supprimera également les caractères d'espacement, tels que les tabulations et les retours chariot.	Aucun paramètre requis

Pour greaterThan, greaterThanOrEqual, lessThan et lessThanorEqual, la chaîne est triée par le premier caractère, puis le deuxième, et ainsi de suite. Pour la comparaison, 0-9 est inférieur à A-Z.

Exemples :

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

Vous pouvez combiner méthodes et attributs de chaîne dans l'expression. Par exemple, la chaîne suivante permet de rechercher le caractère @ dans la description d'un noeud et renvoie tout ce qui suit ce caractère.

capture d'écran contenant une expression telle que décrite dans le paragraphe suivant

Dans cet exemple, le premier terme d'expression est une expression substring, qui requiert deux paramètres : la position de départ et le nombre de caractères à renvoyer.

Pour le terme d'expression de la position de départ, nous avons sélectionné une méthode indexOf avec le paramètre "@". Cette action recherche le caractère @ dans le champ de description et renvoie l'entier correspondant à l'emplacement du caractère comme position de départ.
Pour le terme d'expression du nombre de caractères à renvoyer, nous avons sélectionné un attribut length. Ainsi, quelle que soit la longueur de la chaîne, l'intégralité de la valeur qui suit le caractère @ est renvoyée car le nombre de caractères est égal à la longueur complète de la chaîne.