Elementfilter

Der Elementfilter ist ein Werkzeug zur Filterung von Elementen nach Kategorien und/oder Parametern, bestehend aus Filteralgorithmen und einer Einstellungsoberfläche (im Folgenden "Werkzeug" genannt). Das Werkzeug wird in vielen Plugins verwendet. Zum Beispiel in den Plugins Arbeitssets, Werte kopieren, Elemente einfärben und anderen

Das Werkzeug besteht aus zwei Filtern – einem Kategoriefilter und einem Parameterfilter. In manchen Plugins kann nur einer der Filter verwendet werden. Zum Beispiel verwendet das Plugin Himmelsrichtung nur den Parameterfilter

In der Plugin-Oberfläche kann das Werkzeug eine horizontale Form haben:

Oder eine vertikale Form:

Wenn beide Filter verwendet werden, befindet sich zwischen ihnen ein logischer Operator UND/ODER. Der Operator UND bedeutet, dass ein Element die Filterbedingungen erfüllt, wenn es die Bedingungen beider Filter erfüllt. Der Operator ODER bedeutet entsprechend, dass ein Element die Filterbedingungen erfüllt, wenn es mindestens eine der beiden Filterbedingungen erfüllt

Die Kategorienliste aus dem Kategoriefilter und die Bedingungen aus dem Parameterfilter können in die Zwischenablage kopiert und über das Kontextmenü, das mit der rechten Maustaste geöffnet wird, eingefügt werden

Kategoriefilter

Der Kategoriefilter ist eine baumartige Liste zulässiger Kategorien. Die Bearbeitung der Kategorienliste erfolgt im Dialogfenster des übergeordneten Fensters (Plugin-Fenster):

Oben im Dialog befindet sich ein Suchfeld für Kategorien. Die Suche erfolgt sowohl nach dem angezeigten Kategorienamen als auch nach dem eindeutigen Programmnamen. Wenn ein Sternchen (*) in das Suchfeld eingegeben wird, werden alle ausgewählten Kategorien angezeigt. Die Schaltflächen rechts neben der Liste ermöglichen es, alle Kategorien abzuwählen , alle Kategorien aufzuklappen oder zuzuklappen , nur ausgewählte Kategorien anzuzeigen oder Kategorien zu markieren, deren Elemente in der aktuellen Ansicht vorhanden sind . Markierte Kategorien können als Sets gespeichert und später sowohl in diesem Plugin als auch in anderen Plugins, die den Kategoriefilter verwenden, angewendet werden

Ein Kategorienset kann mit der Schaltfläche geladen werden

Parameterfilter

Der Parameterfilter ist eine Liste von Bedingungen, die durch den logischen Operator UND oder ODER getrennt sind. Im Filterfeld werden die Bedingungen in einer speziellen Syntax geschrieben, in der die Vergleichsoperatoren die folgenden Symbole verwenden:

=	– Gleich
<	– Weniger
<=	– Weniger oder gleich
>	– Mehr
>=	– Mehr oder gleich
<>	– Nicht gleich
~	– Enthält
!~	– Enthält nicht

Die Bearbeitung der Bedingungen erfolgt in einem separaten Fenster:

Regeln zur Erstellung von Bedingungen:

1. In das Feld "Werte" können Sie mehrere gültige Werte eingeben, die durch ein Komma getrennt sind. Ein Parameter erfüllt eine Bedingung, wenn sein Wert mit mindestens einem gültigen Wert übereinstimmt.
2. Damit ein Komma nicht als Trennzeichen wahrgenommen wird, muss es mit einem als Escapezeichen fungierenden Backslash versehen werden. Z.B. "Wert 1\,5".
3. Die Bedingung "Vorhandensein eines Parameters" bedeutet, dass das Element verarbeitet wird, wenn ein solcher Parameter vorhanden ist, unabhängig vom Wert des Parameters.
4. Die Bedingung "Fehlender Parameter" bedeutet, dass das Element bearbeitet wird, wenn solcher Parameter fehlt.
5. Die Bedingung "Schreibgeschützt" mit dem Wert "Nein" bedeutet, dass das Element verarbeitet wird, wenn der Parameter zur Bearbeitung verfügbar ist. Die Bedingung "Schreibgeschützt" mit dem Wert "Ja" bedeutet, dass das Element verarbeitet wird, wenn der Parameter nicht zur Bearbeitung verfügbar ist. Ein Parameter kann nicht zur Bearbeitung verfügbar sein, wenn es sich um einen unveränderlichen Systemparameter handelt (zum Beispiel den Parameter "Volumen"), sich das Element in einem nicht zugänglichen Arbeitssatz befindet oder unter anderen Bedingungen.
6. Zeichenfolgeparameter werden nur durch die Bedingungen "Gleich", "Nicht gleich", "Enthält", "Enthält nicht" geprüft.
7. Die Bedingung "Enthält" prüft, ob der Parameter des Elements mindestens einen der gültigen Werte enthält. Die Bedingung "Enthält nicht" prüft, ob der Parameter des Elements mindestens einen der gültigen Werte enthält.
8. Um die Bedingung "Beginnt mit" zu verwenden, wählen Sie die Bedingung "Enthält" und fügen ein "*" am Ende des Wertes hinzu. Zum Beispiel "Wall*.
9. Um die Bedingung "Endet mit" zu verwenden, wählen Sie die Bedingung "Enthält" und fügen ein "*" am Ende des Wertes hinzu. Zum Beispiel "*Wall.
10. Um die Bedingung "Beginnt nicht mit" zu verwenden, wählen Sie die Bedingung "Enthält nicht" und fügen ein "*" am Ende des Wertes hinzu. Zum Beispiel "Wall*.
11. Um die Bedingung "Endet nicht mit" zu verwenden, wählen Sie die Bedingung "Enthält nicht" und fügen ein "*" am Anfang des Wertes hinzu. Zum Beispiel "*Wall.
12. Bei der Prüfung von Zeichenfolgen wird die Groß- und Kleinschreibung berücksichtigt.
13. Parameter des Typs "on/off" werden als Ganzzahl geprüft (0 – off, 1 – on).
14. Es werden die Bedingungen "Vorhandensein des Parameters" und "Fehlender Parameter" bei der Prüfung des Schlüsselparameters "Group" (übergeordnete Gruppe) überprüft, ob das Element jeweils in der Gruppe vorhanden ist oder
15. fehlt. Das heißt, die Bedingung "Vorhandensein des Parameters" interpretiert die Prüfung "Element muss in der Gruppe vorhanden sein" und die Bedingung "Fehlender Parameter" interpretiert die Prüfung "Element darf nicht in der
16. Gruppe vorhanden sein". Jeweils andere Bedingung überprüft, sobald das Element in der Gruppe vorhanden ist, den Gruppennamen nach den Regeln für Zeichenfolgen.
17. Es werden die Bedingungen "Vorhandensein des Parameters" und "Fehlender Parameter" bei der Prüfung des Schlüsselparameters "Assembly" (übergeordnete Baugruppe) überprüft, ob das Element jeweils in der Baugruppe vorhanden ist oder fehlt. Das heißt, die Bedingung "Vorhandensein des Parameters" interpretiert die Prüfung "Element muss in der Baugruppe vorhanden sein" und die Bedingung "Fehlender Parameter" interpretiert die Prüfung "Element darf nicht in der Baugruppe vorhanden sein". Jeweils andere Bedingung überprüft, sobald das Element in der Baugruppe vorhanden ist, den Namen der Baugruppe nach den Regeln für Zeichenfolgen.
18. Es werden die Bedingungen "Vorhandensein des Parameters" und "Fehlender Parameter" bei der Prüfung des Schlüsselparameters "Curtain" (Die Wand ist eine Fassade) überprüft, ob die Wand jeweils eine Fassade ist oder nicht. Das heißt, die Bedingung "Vorhandensein des Parameters" interpretiert die Prüfung "Die Wand muss eine Fassade sein" und die Bedingung "Fehlender Parameter" interpretiert die Prüfung "Die Wand darf keine Fassade sein".
19. Es werden die Bedingungen "Vorhandensein des Parameters" und "Fehlender Parameter" bei der Prüfung des Schlüsselparameters "Nested" (Die Familie ist untergeordnet) überprüft, ob die Familie untergeordnet ist oder nicht. Das heißt, die Bedingung "Vorhandensein des Parameters" interpretiert die Prüfung "Die Familie muss untergeordnet sein" und die Bedingung "Fehlender Parameter" interpretiert die Prüfung "Die Familie darf nicht untergeordnet sein".
20. Es werden die Bedingungen "Vorhandensein des Parameters" und "Fehlender Parameter" bei der Prüfung des Schlüsselparameters "Parent" (Die Familie ist übergeordnet) überprüft, ob die Familie übergeordnet ist (enthält untergeordnete Familien) oder nicht. Das heißt, die Bedingung "Vorhandensein des Parameters" interpretiert die Prüfung "Die Familie muss übergeordnet sein" und die Bedingung "Fehlender Parameter" interpretiert die Prüfung "Die Familie darf nicht übergeordnet sein".
21. Beim Verwenden der Schlüsselparameter "BottomZ" und "TopZ" wird jeweils die unterste bzw. die oberste Marke aus der Geometrie des Elements überprüft. Die Schlüsselparameter "BottomZ" und "TopZ" gelten als numerisch und werden durch die entsprechenden Bedingungen überprüft. Die Markenwerte werden in Millimetern mit Rundung auf drei Dezimalstellen angegeben. Im Feld "Wert" können Sie Ebenennamen angeben: ist die angegebene Ebene gefunden, wird ihre Marke in Millimetern (gerundet auf 3 Dezimalstellen) verwendet.
22. Der AreaScheme-Schlüsselparameter gibt den Namen des Flächenschemas zurück, zu dem die Fläche gehört. Der Wert des AreaScheme-Schlüsselparameters wird nach Zeichenfolgenregeln überprüft.
    Es werden die Bedingungen "Vorhandensein des Parameters" und "Fehlender Parameter" bei der Prüfung des Schlüsselparameters "InMEPSystem" (element befindet sich in einem Ingenieursystem) überprüft, ob das Element Teil eines Ingenieursystems ist oder nicht. Das heißt, die Bedingung "Vorhandensein des Parameters" interpretiert die Prüfung "Das Element ist Teil eines Ingenieursystems", und die Bedingung "Fehlender Parameter" interpretiert die Prüfung "Das Element ist kein Teil eines Ingenieursystems".
23. Die Bedingungen "Vorhandensein des Parameters" und "Fehlender Parameter" bei der Prüfung des Schlüsselparameters "InRebarSystem" (Bewehrung befindet sich in einem Bewehrungssystem) prüfen entsprechend, ob die Bewehrung Teil eines Bewehrungssystems ist oder nicht. Das heißt, die Bedingung "Parameter vorhanden" interpretiert die Prüfung als "Die Bewehrung ist Teil eines Bewehrungssystems", und die Bedingung "Parameter nicht vorhanden" interpretiert die Prüfung als "Die Bewehrung ist nicht Teil eines Bewehrungssystems".
24. Der Schlüsselparameter DocumentTitle gibt den Namen des aktuellen Dokuments zurück. Der Wert des Schlüsselparameters DocumentTitle wird nach den Regeln für Zeichenfolgen geprüft. Wenn das Dokument nicht gespeichert oder getrennt ist, wird der Standardwert oder eine leere Zeichenfolge zurückgegeben.
    Alle einfachen Bedingungen einer Gruppenbedingung werden mit dem Operator "UND" geprüft - d.h. alle Bedingungen müssen übereinstimmen.

Rechts befinden sich zwei Links, die als Schaltflächen funktionieren und es ermöglichen, eine neue einfache oder Gruppenbedingung hinzuzufügen

Im Eingabefeld für den Parameterbezeichner kann eine Schaltfläche erscheinen, mit der ein Parameter aus einer Liste ausgewählt werden kann:

Diese Schaltfläche erscheint, wenn im Kategoriefilter Kategorien ausgewählt sind. Wenn im aktuellen Dokument Exemplare von Elementen dieser Kategorien vorhanden sind, sind zwei Listen verfügbar – Instanzparameter und Typparameter. Wenn keine Exemplare vorhanden sind, aber Typen vorhanden sind, steht nur eine Liste mit Typparametern zur Verfügung

Als Parameterbezeichner kann der Name des Parameters, die GUID eines gemeinsamen Parameters oder der technische Name eines eingebauten Parameters verwendet werden

Neben Parametern können in den Bedingungen auch Element-ID, Typ-ID sowie übergeordnete Gruppe (Group) und übergeordnete Baugruppe (Assembly) verwendet werden, sofern vorhanden

Bei Auswahl der Bedingungen „Gleich“ und „Ungleich“ wird die Schaltfläche zum Suchen von Parameterwerten im aktuellen Projekt verfügbar :

Eine Gruppenbedingung ist eine Liste von einfachen Bedingungen. Alle einfachen Bedingungen innerhalb einer Gruppenbedingung werden mit dem logischen Operator UND geprüft. Das bedeutet, ein Element erfüllt die Gruppenbedingung, wenn es alle verschachtelten einfachen Bedingungen erfüllt. In der Filterzeile wird eine Gruppenbedingung in eckigen Klammern hervorgehoben

Unten im Fenster befindet sich eine Auswahlliste Element passt, wenn, die den logischen Operator bestimmt, der zwischen allen Bedingungen verwendet wird. Der Wert alle Bedingungen erfüllen entspricht dem logischen Operator UND, und der Wert mindestens eine Bedingung erfüllt entspricht dem logischen Operator ODER

Das Beispiel aus dem obigen Screenshot sieht im Filterfeld folgendermaßen aus:

Dies bedeutet, dass eine Wand passt, wenn sie im Parameter "Marke" den Wert "C-1" hat oder wenn sie im Parameter "Marke" den Wert C-2 hat und im Parameter "Tragende Konstruktionen" den Wert "1"

Die Suche nach Parametern im überprüften Element erfolgt nach dem Parameternamen. Der Parameter wird zuerst in der Liste der Instanzparameter gesucht und dann (falls nicht gefunden) in der Liste der Typparameter

Bei der Überprüfung von Zeichenkettenparametern mit den Operatoren "Gleich", "Ungleich", "Enthält" und "Enthält nicht" wird die Groß-/Kleinschreibung berücksichtigt