Zeichenfolgen, numerische Zeichenfolgen und Sequenzen

Zeichenfolgen in Ausdrücken enthalten Felder wie Eigenschaftsnamen und -beschreibungen sowie Literalwerte. Nachdem Sie eine Zeichenfolge in einem Ausdruck ausgewählt haben, können Sie verschiedene Methoden und Attribute für diese Zeichenfolge auswählen. Beispiel: Sie können den Namen und die Beschreibung eines Knotens verketten und die resultierende Zeichenfolge in einer Aliaseigenschaft verwenden, oder Sie können nur einen Teil einer Quellzeichenfolge zurückgeben, indem Sie die Methode "Teilzeichenfolge" verwenden.

Numerische Zeichenfolgen und Zeichenfolgen vom Datentyp "Sequenz" unterstützen nur numerische Werte (0-9). Sie sind auf 40 Zeichen beschränkt.

Sie können Zeichenfolgedatentypen Literalwerte hinzufügen. Informationen hierzu finden Sie unter Mit Literalwerten arbeiten.

Sie müssen für zahlreiche Zeichenfolgenmethoden zusätzliche Parameter eingeben. Wenn Sie diese Methode auswählen, erstellt der Expression Builder einen neuen Ausdrucksbegriff für diese Parameter. Beispiel: Wenn Sie eine concat-Methode auswählen, wird ein zusätzlicher Ausdrucksbegriff hinzugefügt, damit Sie die anzuhängende Zeichenfolge angeben können. Wenn Sie eine replace-Methode auswählen, werden zwei zusätzliche Ausdrucksbegriffe hinzugefügt, damit Sie den zu suchenden Text sowie den zu ersetzenden Text angeben können.

In der folgenden Tabelle werden die Methoden und Attribute beschrieben, die Sie zum Ändern von Zeichenfolgenwerten im Expression Builder verwenden können. Außerdem sind die Parameter für diese Felder aufgeführt.

Methode oder Attribut	Verwendung	Parameter
`Concat`	Verkettet mindestens zwei Zeichenfolgenfelder (oder hängt sie an) und gibt eine kombinierte Zeichenfolge als Ergebnis zurück. Note: Sie können mehrere Zeichenfolgen an eine einzelne `concat`-Anweisung anhängen. Wenn Sie mehrere Zeichenfolgen verketten möchten, können Sie in einem Ausdrucksbegriff auf klicken und Oben einfügen oder Entfernen auswählen, um das Feld zu verschieben oder um es zu entfernen.	Anzuhängende Zeichenfolge
`endsWith`	Gibt `True` zurück, wenn die ursprüngliche Zeichenfolge mit der angegebenen Zeichenfolge endet. Note: Bei der angegebenen Zeichenfolge muss die Groß-/Kleinschreibung beachtet werden.	Die angegebene Zeichenfolge, für die überprüft werden soll, ob die ursprüngliche Zeichenfolge mit ihr endet.
`equals`	Gibt `True` zurück, wenn die Zeichenfolge der angegebenen Zeichenfolge entspricht.	Die angegebene Zeichenfolge, für die überprüft werden soll, ob die ursprüngliche Zeichenfolge ihr entspricht.
`greaterThan`	Gibt `True` zurück, wenn der Zeichenfolgenwert größer ist als der angegebene Wert (beide Werte müssen denselben Datentyp aufweisen).	Die angegebene Zeichenfolge zum Prüfen, ob die ursprüngliche Zeichenfolge größer ist
`greaterThanOrEqual`	Gibt `True` zurück, wenn der Zeichenfolgenwert größer/gleich dem angegebenen Wert ist (beide Werte müssen denselben Datentyp aufweisen).	Die angegebene Zeichenfolge zum Prüfen, ob die ursprüngliche Zeichenfolge größer/gleich ist
`indexOf`	Gibt die Startposition der angegebenen Zeichenfolge in der ursprünglichen Zeichenfolge zurück. Note: Die `indexOf`-Methode gibt eine Ganzzahl zurück, die nicht direkt als Rückgabewert verwendet werden kann. Sie können diese Ganzzahl verwenden, um die Startposition für eine Teilzeichenfolge zu bestimmen. Informationen hierzu finden Sie unter Ganzzahl und Gleitkommawert.	Zeichenfolge, deren Startposition Sie finden möchten.
`IsEmpty`	Gibt `True` zurück, wenn die Eigenschaft einen Nullwert oder eine leere Zeichenfolge enthält.	Keine Parameter erforderlich
`isNull`	Gibt `True` zurück, wenn die Zeichenfolgeeigenschaft einen Nullwert enthält.	Keine Parameter erforderlich
`length`	Zählt die Zeichenanzahl in einer Zeichenfolge Das Attribut `length` ist eine Ganzzahl. Informationen hierzu finden Sie unter Ganzzahl und Gleitkommawert.	Keine Parameter erforderlich
`lessThan`	Gibt `True` zurück, wenn der Zeichenfolgenwert kleiner ist als der angegebene Wert (beide Werte müssen denselben Datentyp aufweisen).	Die angegebene Zeichenfolge zum Prüfen, ob die ursprüngliche Zeichenfolge kleiner ist
`lessThanOrEqual`	Gibt `True` zurück, wenn der Zeichenfolgenwert kleiner/gleich dem angegebenen Wert ist (beide Werte müssen denselben Datentyp aufweisen).	Die angegebene Zeichenfolge zum Prüfen, ob die ursprüngliche Zeichenfolge kleiner/gleich ist
`matches`	Gibt `True` zurück, wenn die Zeichenfolge dem angegebenen regulären Java-Ausdruck entspricht. Tip: Reguläre Ausdrücke geben Muster an, nach denen unter Verwendung standardisierter Syntaxkonventionen in Zeichenfolgedaten gesucht werden soll. Ein regulärer Ausdruck, oder regex, kann komplexe Muster von Zeichensequenzen angeben. Beispiel: Mit dem regulären Ausdruck `a(b\|c)d` wird nach dem Muster `a` gefolgt entweder von `b` oder `c` gefolgt von `d` gesucht. Dieser reguläre Ausdruck entspricht sowohl `abd` als auch `acd`.	Der angegebene reguläre Java-Ausdruck, für den geprüft werden soll, ob die ursprüngliche Zeichenfolge diesem entspricht. Note: Reguläre Java-Ausdrücke führen vollständige Abgleiche für Zeichenfolgen aus, keine teilweisen Abgleiche. Wenn Sie in einem Anwendungsnamen nach `Corporate` suchen, wäre eine Anwendung mit dem Namen `Corporate Planning` keine Übereinstimmung. Verwenden Sie Platzhalter vor und nach einer Zeichenfolge, um nach teilweisen Übereinstimmungen zu suchen. Beispiel: `.Corporate.` stimmt mit `Corporate Planning` überein.
`orElse`	Gibt einen angegebenen Wert zurück, wenn der vorherige Ausdrucksbegriff einen Nullwert aufweist.	Der zurückzugebende Wert, wenn der vorherige Ausdrucksbegriff null ist. Beispiel: `return node.properties.Core.Description.orElse('Default Descr')` gibt "Default Descr" zurück, wenn die Eigenschaft "Core.Description" für einen Knoten null ist.
`replace`	Ersetzt alle Instanzen einer alten Zeichenfolge durch eine neue Zeichenfolge.	Zu suchende ursprüngliche Zeichenfolge Note: Sie können einen regulären Java-Ausdruck verwenden, um das zu suchende Zeichenfolgenmuster zu bestimmen. Zeichenfolge, durch die die ursprüngliche Zeichenfolge ersetzt werden soll
`split`	Teilt eine Zeichenfolge basierend auf dem angegebenen Trennzeichen in eine Liste mit Zeichenfolgen auf. Note: Informationen zu den Methoden, die Sie einer Zeichenfolgenliste hinzufügen können, finden Sie unter Listen und Zeichenfolgelisten.	Das Trennzeichen, mit dem die Zeichenfolge geteilt werden soll Leerzeichen einschließen: Geben Sie an, ob leere Werte als Listenelemente in der resultierenden Zeichenfolgenliste eingeschlossen werden sollen. `True`: Zulassen, dass leere Werte in der resultierenden Zeichenfolgenliste eingeschlossen werden. `False` (Standard): Leere Werte werden in der resultierenden Zeichenfolgenliste ausgeschlossen. Beispiel: Wenn für die Zeichenfolge `A//C` die Option Leerzeichen einschließen aktiviert ist, enthält die Zeichenfolgenliste drei Einträge: `A, (blank value), C`. Wenn die Option deaktiviert ist, enthält die Zeichenfolgenliste zwei Einträge: `A` und `C`.
`startsWith`	Gibt `True` zurück, wenn die ursprüngliche Zeichenfolge mit der angegebenen Zeichenfolge beginnt. Note: Bei der angegebenen Zeichenfolge muss die Groß-/Kleinschreibung beachtet werden.	Die angegebene Zeichenfolge, für die überprüft werden soll, ob die ursprüngliche Zeichenfolge mit ihr beginnt.
`substring`	Gibt einen Teil einer Zeichenfolge zurück.	Die Startposition Anzahl an zurückzugebenden Zeichen
`toDate`	Konvertiert einen Zeichenfolgewert in einen Datumswert.	Das Datumsformat (z.B. MM/tt/jjjj). Informationen zur Datums- und Zeitformatierung finden Sie unter Symbole für die Formatierung von Datum und Uhrzeit.
`toFloat`	Konvertiert einen Zeichenfolgewert in einen Gleitkommawert.	Keine Parameter erforderlich
`toInteger`	Konvertiert einen Zeichenfolgewert in einen Ganzzahlwert.	Keine Parameter erforderlich
`toLowerCase`	Gibt eine Zeichenfolge ausschließlich aus Kleinbuchstaben zurück.	Keine Parameter erforderlich
`toUpperCase`	Gibt eine Zeichenfolge ausschließlich aus Großbuchstaben zurück.	Keine Parameter erforderlich
`trim`	Gibt eine Zeichenfolge zurück, bei der voran- und nachgestellte Leerzeichen entfernt wurden. Note: Mit `trim` werden auch Leerzeichen wie Tabulatoren und Wagenrückläufe entfernt.	Keine Parameter erforderlich

Für greaterThan, greaterThanOrEqual, lessThan und lessThanorEqual wird die Zeichenfolge nach dem ersten Zeichen, dann nach dem zweiten Zeichen usw. sortiert. Beim Vergleich ist 0-9 kleiner als A-Z.

Beispiele:

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

Sie können Zeichenfolgenmethoden und -attribute in Ihrem Ausdruck kombinieren. Beispiel: Die folgende Zeichenfolge sucht das @-Zeichen in der Beschreibung eines Knotens und gibt alles nach diesem Zeichen zurück.

Screenshot eines Ausdrucks wie im nachfolgenden Abschnitt beschrieben

In diesem Beispiel ist der erste Ausdrucksbegriff ein substring-Ausdruck, für den zwei Parameter erforderlich sind: eine Startposition und die Anzahl an zurückzugebenden Zeichen.

Für den Ausdrucksbegriff "Startposition" wurde eine indexOf-Methode mit einem Parameter "@" ausgewählt. Dadurch wird das Beschreibungsfeld nach dem @-Zeichen durchsucht, und es wird der Ganzzahlwert der Position zurückgegeben, an der dieses Zeichen als Startposition vorhanden ist.
Für den Ausdrucksbegriff "Anzahl an zurückzugebenden Zeichen" wurde ein Attribut length ausgewählt. Dadurch wird sichergestellt, dass - unabhängig von der Länge der Zeichenfolge - der vollständige Wert nach dem @-Zeichen zurückgegeben wird, da die Anzahl der Zeichen identisch mit der Länge der vollständigen Zeichenfolge ist.