Ausdrücke: Unterschied zwischen den Versionen

Version vom 16. März 2021, 07:55 Uhr

Attribute oder Eigenschaften kombiniert mit Operatoren werden als Ausdrücke bezeichnet. Diese können in Form von Abfragen auf Haltungen, Schächte,Wasserleitungen, Wasserknoten, und Gebiete angewendet werden. Ein wichtiger Grund ist das Finden von Objekten, die über die Abfrage definierte Eigenschaften haben müssen. Ausdrücke können aber auch für die Ansichtskonfiguration & Farbkonfiguration verwendet werden, um Informationen bestmöglich darzustellen.

Möglichkeit zur Verwendung von Ausdrücken:

Abfragen: Die gefundenen Elemente werden in einem Meldungsfenster aufgelistet. Darüber lassen sich die gefundenen Elemente markieren und folglich Eigenschaften ändern oder setzen.
Ansichtskonfigurationen: In den Ansichtskonfigurationen können Informationen gezielt dargestellt werden, um komplexe Sachverhalte zu erklären.
Farbkonfiguration: Einfärbung der Objekte nach der Anwendung von Ausdrücken.
Eigenschaftslisten: Das Erstellen von Listen kann auch mit zuvor definierten Ausdrücken durchgeführt werden. Oder es können eigene Ausdrücke angefertigt werden und für jedes Objekt ausgegeben werden.

Kontextmenü

Neuen Ausdruck erstellen.

Sie können projektübergreifend Ausdrücke über das Clipboard kopieren und mit dieser Funktion in das bestehende Projekt einfügen.

Löscht alle vorhandenen Ausdrücke.

Legt ein Unterverzeichnis „Unterverzeichnis_1“ an, um bei vielen Ausdrücken eine Ordnungsstruktur anlegen zu können. Die einzelnen Ausdrucksobjekte können per Drag&Drop zwischen den Verzeichnissen verschoben werden.

Objektebene

Kontextmenü

Ein Dialog zum Erstellen eines neuen Ausdrucks wird geöffnet.

Ein vorhandener Ausdruck wird zum Ändern geöffnet.

Löscht den ausgewählten Ausdruck.

Ausdruck in die Zwischenablage kopieren um ihn in ein anderes Projekt zu kopieren.

Neuer Ausdruck wird mit „Name_Kopie“ angelegt.

Starten der Abfrage auf Schächte/Abschnitte Haltungen/Wasserknoten/Wasserleitungen/Gebiete/Schäden.

Starten der Abfrage auf eine markierte Menge von ausgewählten Objekten

Syntax der Ausdrücken

Liste der Operatoren für die Ausdrücke


Operator	Name	Beschreibung	Beispiel
()	Klammern	Attribute welche sich in der Klammer befinden, werden	&
"	Anführungszeichen	Texte/Strings werden unter Anführungszeichen gestellt, der Abstand zwischen Text und Feldwert gehört noch zum Text.	„Text1 “
"	Anführungszeichen	Texte/Strings werden unter Anführungszeichen gestellt, der Abstand zwischen Text und Feldwert gehört noch zum Text.	„Text1 “
.	Pointer	Zugriff auf verknüpfte Daten über Pointer	Deckel.Radius
*	Multiplikation	Multipliziert die Werte seiner Operanden und gibt das Ergebnis zurück.
/	Division	Dividiert die Werte seiner Operanden und gibt das Ergebnis zurück. Bei der Division von Ganzzahlen fällt ein eventueller Rest weg, es wird also nicht gerundet.
%	Modulo	Dividiert die Werte seiner Operanden und gibt den Divisionsrest zurück. Kann nur auf ganzzahlige Operanden angewendet werden. Ist mindestens ein Operand negativ, so ist das Vorzeichen des Resultats implementationsabhängig.
<	kleiner	Ergibt den boolschen Wert WAHR, wenn der linke Operand kleiner als der rechte ist, sonst FALSCH.
<=	kleiner oder gleich	Ergibt den boolschen Wert WAHR, wenn der linke Operand kleiner oder gleich dem rechten ist, sonst FALSCH.
=	gleich	Ergibt den boolschen Wert WAHR, wenn die beiden Operanden gleich sind, sonst FALSCH.
<>	Drei-Wege Vergleich	kleiner 0 ist, falls der linke Operand kleiner als der rechte ist gleich 0 ist, falls der linke Operand gleich dem rechten ist größer 0 ist, falls der linke Operand größer als der rechte ist
>=	größer oder gleich	Ergibt den boolschen Wert true, wenn der linke Operand größer oder gleich dem rechten ist, sonst false.
>	größer	Ergibt den boolschen Wert WAHR, wenn der linke Operand größer als der rechte ist, sonst FALSCH.
!	Negierung	Invertiert den Wert seiner Operanden. Aus WAHR wird FALSCH und umgekehrt.
&	Und-Verknüpfung	Verknüpft die beiden Operanden und gibt WAHR zurück, wenn beide Operanden den Wert WAHR haben, sonst FALSCH.
	Oder-Verknüpfung	Verknüpft die beiden Operanden und gibt WAHR zurück, wenn mindestens einer der beiden Operanden den Wert WAHR hat, sonst FALSCH.
.exists	Abfrage-Vorhanden	Abfrage nach dem gesuchten Attribut und gibt WAHR zurück
.size	Abfrage-Größe
.len	Abfrage-Länge
.max	Abfrage-Maximalwert
.min	Abfrage-Minimalwert
.sum	Abfrage-Minimalwert	Summiert die Attribute
.eq	Vergleichsfunktion Strings	Vergleicht das angegebene Attribut darauf ob es ein String ist und gibt den Wert WAHR zurück.
.neq	Vergleichsfunktion Strings	Vergleicht das angegebene Attribut darauf ob es kein String ist und gibt den Wert WAHR zurück.
WENN ? DANN : SONST	Wenn-Dann Abfrage	Soll die Beschriftung variabel, je nach bestimmten Eigenschaften eines Objektes erfolgen kann diese vorher abgefragt werden	((Maximales Überstauvolumen) > 0) ?(Name) :""
#	Raute	Eine Folge von Texten (Strings) und Feldnamen verbunden mit #	„Text1 “#Feldname.f2#“ Text“
</br>	Neue Zeile	Über den Ausdruch kann eine neue Zeile eingefügt werden	„Text1 “#Feldname.f2#“ Text“

Anwendung von Ausdrücken

Bsp AQUA

Um spezielle Untermengen der Wasserknoten bzw. Leitungen auszuwählen bzw. suchen zu lassen, steht die Option Suchen durch Ausdrücke zur Verfügung. Rechtsklick auf Ausdrücke, Auswahl von Neu… und der Dialog zur Konfiguration von Ausdrücken erscheint. Alle relevanten Attribute sind unter Wasserknoten und Wasserleitungen aufgeführt. Beispielausdruck: (Berechnete Länge)>15 Dieser Ausdruck liefert die Menge aller Leitungen, deren „Berechnete Länge“ größer als 15 Meter ist.

Einfache Beispiele von Ausdrücken

Eine Folge von Texten (Strings) und Feldnamen verbunden mit #Texte sind dabei unter Anführungszeichen zu stellen, der Abstand zwischen Text und Feldwert gehört noch zum Text.Für nummerische Felder kann die Ausgabegenauigkeit festgelegt werden .f0 ...

„Text1 “#Feldname.f2#“
Text“"maxÜV "#Maximales Überstauvolumen.f2#" m³"

Für nicht nummerische Datenfelder gibt es die Möglichkeit die Ausgabe zu beschneiden, hier am Beispiel des Datenfeldes „Name“Name.substr(3 ,5)liefert vom Namen eines Objektes den Teil vom 3. Charakter ab die nächsten 5 Stellen (nach 3 steht ein Leerzeichen !!)Name.right(4)liefert die letzten 4 Stellen als StringName.left(4)liefert die ersten 4 Stellen als String

@@ Zeile 109: / Zeile 109: @@
 |#||Raute||Eine Folge von Texten (Strings) und Feldnamen verbunden mit #||„Text1 “#Feldname.f2#“ Text“
 |-
-|<nowiki></br>||Neue Zeile||Über den Ausdruch </b> kann eine neue Zeile eingefügt werden||„Text1 “#Feldname.f2#“ Text“</nowiki>
+|<nowiki></br></nowiki>||Neue Zeile||Über den Ausdruch </b> kann eine neue Zeile eingefügt werden||„Text1 “#Feldname.f2#“ Text“
 |-
 |}