Search Criteria Format/de

Filterkriterienformat

Syntax

Filterkriterien in Skripten bestehen aus zwei Teilen: dem Suchattribut-Typ und dem Suchwert. Der Suchattribut-Typ gibt an, welches Attribut zum Filtern von Objekten im Dokument verwendet wird; der Suchwert gibt den Wert an, der durch den Filtervorgang gefunden und abgeglichen werden soll. So gibt z. B. der Filterkriterien-Ausdruck

(C=’Wand’)

an, dass nach allen Objekten gesucht werden soll, deren Klasse Wand ist. Im Filterkriterien-Ausdruck gibt der Attributtyp C an, dass die Suche nach dem Klassenattribut von Objekten im Dokument durchgeführt werden soll. Der Suchwert Wand gibt an, welche Klasse beim Filtern als übereinstimmend gewertet wird.

Die allgemeine Syntax für Filterkriterien-Ausdrücke lautet:

(<Suchattribut Type> = <Suchwert>)

Klammern werden üblicherweise verwendet, um einzelne Filter-Ausdrücke einzuschließen und zu kennzeichnen; sie sind nicht erforderlich.

Mehrfache Filterkriterien

Es können mehrere Kriterien angegeben werden, um den Suchvorgang auf eine spezifischere Untergruppe von Objekten einzuschränken. Mehrere Filterkriterien werden mit dem Operator & erstellt, um einzelne Filterkriterien zu verketten. Im Ausdruck

((L='Neue Bebauung') & (C='Phase 1'))

werden zwei Suchbegriffe kombiniert, um nach einer bestimmten Gruppe von Objekten zu filtern, in diesem Fall nach allen Objekten auf der Ebene Neue Bebauung, deren Klasse Phase 1 ist. Um die Suche noch weiter einzugrenzen, fügen Sie einfach weitere Suchbegriffe hinzu:

((L='Neue Bebauung') & (C='Phase 1') & (SEL=TRUE))

Im Beispiel wurde der Attributtyp "Aktivierungsstatus" hinzugefügt, so dass jetzt nur aktivierte Objekte der Klasse "Phase 1" auf der Ebene "Neue Bebauung" der Suche entsprechen.

Mehrfache Suchwerte

Es ist auch möglich, anhand von Filterkriterien nach mehreren übereinstimmenden Werten zu filtern. Mehrere übereinstimmende Werte verwenden die folgende Syntax:

(<Attribut Type> IN [<Suchwert>,<Suchwert>,...])

Wenn ein Suchbegriff auf diese Weise angegeben wird, werden Objekte, die mit einem beliebigen Wert in der durch Komma getrennten Werteliste übereinstimmen, in die Liste der Objekte aufgenommen, die der Suche entsprechen. Zum Beispiel:

(R IN ['Bauteildaten','Baugruppendaten','Montagedaten'])

Eine Suche mit dem oben gezeigten Filterkriterien-Ausdruck führt zu allen Objekten mit einer verknüpften Datenbank, der mit einer der Datenbanken in der Suchliste übereinstimmen.

Attribut-Typen

Diese Standard-Attribut-Typen sind für die Verwendung in Suchbegriffen verfügbar.

Attribut	Tastenkürzel	Beschreibung	Bemerkungen
Datenbank	(R)	Mit dem Attribut "Datenbank" wird nach Objekten gesucht, denen die angegebene Datenbank zugeordnet ist. Das Attribut "Datenbank" erfordert die Verwendung des Mehrfachkriterienformats zur Angabe des Datenbanknamens. Um zum Beispiel nach Objekten zu suchen, mit denen die Datenbank "Bauteildaten" verknüpft ist, würde der Suchbegriff lauten: (R IN ['Bauteildaten']) Der Datenbankname muss ein literaler STRING-Wert sein.
Klasse	(C)	Mit dem Attributtyp "Klasse" wird nach Objekten gesucht, die der angegebenen Klasse zugeordnet sind. Der Suchwert sollte ein STRING-Wert mit einer Länge von bis zu 64 Zeichen sein.	(Literale und Variablen werden unterstützt.)
Füllhintergrundfarbe	(FB)	Mit dem Attributtyp "Füllhintergrundfarbe" wird nach Objekten gesucht, die die angegebene Füllhintergrundfarbe aufweisen. Der Suchwert sollte ein Standard-Vectorworks-Farbindexwert sein.	(Diesen können Sie erhalten mit RGBToColorIndex).
Füllvordergrundfarbe	(FF)	Mit dem Attributtyp "Füllvordergrundfarbe" wird nach Objekten gesucht, die die angegebene Füllvordergrundfarbe aufweisen. Der Suchwert sollte ein Standard-Vectorworks-Farbindexwert sein.	(Diesen können Sie erhalten mit RGBToColorIndex).
Füllmuster	(FP)	Mit dem Attributtyp "Füllmuster" wird nach Objekten gesucht, die das angegebene Füllmuster aufweisen. Der Suchwert sollte ein Standardwert der Vectorworks Füllmuster-Auswahl sein.	(in einem Bereich von 0 – 71)
Ebene	(L)	Mit dem Attributtyp "Ebene" wird nach Objekten auf der angegebenen Ebene gesucht. Der Suchwert sollte ein STRING-Wert mit einer Länge von bis zu 64 Zeichen sein.	(Literale und Variablen werden unterstützt.)
Linienstil	(LS)	Mit dem Attribut "Linienstil" wird nach Objekten gesucht, die den angegebenen Stiftstil aufweisen.	(Solid, Stiftmuster, Stiftart etc.). Der Suchwert sollte ein Standardwert der Linienstil-Auswahl sein.
Linienart	(LT)	Mit dem Attribut "Linienart" wird nach Objekten gesucht, die die angegebene Linienart aufweisen. Der Suchwert sollte ein STRING-Wert mit einer Länge von bis zu 64 Zeichen sein.	(Literale und Variablen werden unterstützt.)
Liniendicke	(LW)	Mit dem Attribut "Liniendicke" wird nach Objekten gesucht, die die angegebene Liniendicke aufweisen. Der Suchwert sollte ein INTEGER-Wert sein, der die Liniendicke angibt.
Pfeiltyp	(AR)	Der Attributtyp "Pfeiltyp" sucht nach dem angegebenen Pfeiltyp. Der Suchwert sollte einer der unterstützten Pfeiltyp-Flag-Auswahlwerte sein.	(in einem Bereich von 0 – 27)
Name	(N)	Mit dem Attribut "Name" wird nach dem Objekt gesucht, dem der angegebene Objektname zugeordnet ist. Der Suchwert sollte ein STRING-Wert mit einer Länge von bis zu 64 Zeichen sein.	(Literale und Variablen werden unterstützt.)
Objekttyp	(T)	Mit dem Attribut "Objekttyp" wird nach Objekten gesucht, die dem angegebenen Objekttyp entsprechen. Der Suchwert muss einer der vordefinierten Objekttypen in der Auswahl sein.	(Eine vollständige Liste finden Sie in der Tabelle am Ende dieses Abschnitts.)
Deckkraft	(OPA)	Mit dem Attribut "Deckkraft" wird nach Objekten mit dem angegebenen Deckkraft-Prozentsatz gesucht.
Stifthintergrundfarbe	(PB)	Mit dem Attributtyp "Stifthintergrundfarbe" wird nach Objekten gesucht, die die angegebene Stifthintergrundfarbe aufweisen. Der Suchwert sollte ein Standard-Vectorworks-Farbindexwert sein.	(Diesen können Sie erhalten mit RGBToColorIndex).
Stiftvordergrundfarbe	(PF)	Mit dem Attributtyp "Stiftvordergrundfarbe" wird nach Objekten gesucht, die die angegebene Stiftvordergrundfarbe aufweisen. Der Suchwert sollte ein Standard-Vectorworks-Farbindexwert sein.	(Diesen können Sie erhalten mit RGBToColorIndex).
Stiftmuster	(PP)	Mit dem Attributtyp "Stiftmuster" wird nach Objekten gesucht, die das angegebene Stiftmuster aufweisen. Der Suchwert sollte ein Standardwert der Stiftmuster-Auswahl sein.
Aktivierungsstatus	(SEL)	Der Auswahlstatus-Spezifikator sucht nach aktivierten oder nicht aktivierten Objekten. Der Suchwert ist ein BOOLEAN-Wert, der den Aktivierungsstatus angibt.	(WAHR für aktiviert, FALSCH für nicht aktiviert).
Boden/Deckenstil	(SLST)	(Design Suite erforderlich) Der Attributtyp "Boden/Deckenstil" sucht nach Boden/Deckenstilen mit dem angegebenen Namen. Der Suchwert sollte ein STRING-Wert mit einer Länge von bis zu 64 Zeichen sein.	(Literale und Variablen werden unterstützt.)
Geschoss	(STO)	(Design Suite erforderlich) Mit dem Attributtyp "Geschoss" wird nach Objekten auf dem angegebenen Geschoss gesucht. Der Suchwert sollte ein STRING-Wert mit einer Länge von bis zu 64 Zeichen sein.	(Literale und Variablen werden unterstützt.)
Symbolname	(S)	Der Attributtyp "Symbolname" sucht nach Symbolen, die auf dem angegebenen Symbolnamen basieren. Der Suchwert sollte ein STRING-Wert mit einer Länge von bis zu 64 Zeichen sein.	(Literale und Variablen werden unterstützt.)
Textstil	(TSTY)	Der Attributtyp "Textstil" sucht nach Textstilen mit dem angegebenen Namen. Der Suchwert sollte ein STRING-Wert mit einer Länge von bis zu 64 Zeichen sein.	(Literale und Variablen werden unterstützt.)
Mosaik	(TFI)	Der Attributtyp "Mosaik" sucht nach Mosaiken mit dem angegebenen Namen. Der Suchwert sollte ein STRING-Wert mit einer Länge von bis zu 64 Zeichen sein.	(Literale und Variablen werden unterstützt.)
Sichtbarkeitsstatus	(V)	Der Auswahlstatus-Spezifikator sucht nach Objekten aufgrund von deren Sichtbarkeitsstatus. Der Suchwert ist ein BOOLEAN-Wert, der den Aktivierungsstatus angibt.	(WAHR für sichtbar, FALSCH für nicht sichtbar).

Spezialisiertes Filtern

Zusätzlich zu den Standard-Attributtypen, die für die Verwendung in Filterausdrücken zur Verfügung stehen, bieten Skripte auch spezielle Filter-Attributtypen für zusätzliche Flexibilität bei der Suche in einer Datei.

Werte in Datenbankfeldern

Datenbankfelder können mit Hilfe eines speziellen Attributtyps zur Abfrage des Feldwerts nach bestimmten übereinstimmenden Werten durchsucht werden. Die Syntax für die Abfrage von Datenbankfeldern lautet:

(<Datenbankname>.<Feldname>[< = |<> |> |>= |< |<= ><Suchwert>])

Die Datenbank- und Feldnamen sind STRING-Werte und sollten in einfache Anführungszeichen gesetzt werden. Jeder der optionalen Vergleichsoperatoren kann verwendet werden, um die Suche auf eine bestimmte Teilmenge von Elementen zu fokussieren, die mit der Datenbank verknüpft sind. So wird zum Beispiel mit

('Montagedaten'.'Grundkosten' < 250.00)

nach Elementen gesucht, die mit der Datenbank verknüpft sind und deren Grundkosten weniger als 250.00 betragen.

[CMP] undokumentierte, aber sehr nützliche Funktion: Die Wildcards ? und * können in Suchwerten verwendet werden. So findet zum Beispiel

('Gerät'.'Name' = 'VJF_*')

alle Felder, deren Werte mit "VJF_" beginnen. Meine Tests haben gezeigt, dass mehrere Instanzen von * und ? in einem Suchbegriff verwendet werden können und dass diese sich ziemlich intelligent verhalten. So kann zum Beispiel nach Strings gesucht werden, die einen Teilstring enthalten.

In Symbolinstanzen suchen (INSYMBOL)

Der Spezifikator "INSYMBOL" veranlasst die Suche, in allen gefundenen Symbolen nach der Symboldefinition zu suchen. Angenommen, Sie richten ein großes Büro ein und möchten die Gesamtzahl der zu beschaffenden Schreibtischteile zählen. Ihr Dokument enthält eine Mischung aus Symbolen für einzelne Schreibtische und Schubladenelemente sowie Symbole, die sich aus einer Kombination der beiden Schreibtischkomponenten zusammensetzen. Eine Suche nach dem Ausdruck

(S IN ['3660 Schreibtisch','3660 LH Schubladenelement'])

wird eine ungenaue Zählung zurückgegeben, da Instanzen von Symbolen, die selbst innerhalb eines anderen Symbols liegen, nicht berücksichtigt werden. Fügen Sie den Typ-Spezifikator INSYMBOL zum Ausdruck hinzu:

((S IN ['3660 Schreibtisch','LH Schubladenelement']) & (INSYMBOL))

zwingt die Suche, in allen gefundenen Symbolen zu suchen und alle eingebetteten Instanzen der Symbole im Suchausdruck zu erkennen.

In Intelligenten Objekten suchen (INOBJECT)

Der Spezifikator INOBJECT veranlasst die Suche, in Plug-in-Objekte zu suchen und auch deren einzelne Bestandteile auszuwerten. Normalerweise werden Unterobjekte von Plug-in-Objekten und Symbolen von den Filterkriterien ignoriert. Die Spezifikatoren INSYMBOL und INOBJECT beeinflussen das Durchlaufen der Zeichnung und bewirken, dass mehr Objekte anhand der Filterkriterien ausgewertet werden.

Um zum Beispiel die Anzahl der Rechtecke in der Zeichnung zu zählen, einschließlich der Rechtecke, die sich innerhalb von Symbolen und Plug-in-Objekten befinden, verwenden Sie den folgenden Ausdruck:

ZÄHLEN(INSYMBOL & INOBJECT & (T=RECHTECK))

In Ansichtsbereichen suchen (INVIEWPORT)

Der Spezifikator "INVIEWPORT" veranlasst die Suche, in den Ergänzungen aller gefundenen Ansichtsbereiche zu suchen Sie können z. B. nach Zeichnungsbeschriftungen oder Bemaßungen innerhalb der Ergänzung suchen. Eine Suche mit dem Ausdruck

(S IN [T=BEMASSUNG])

wird eine ungenaue Anzahl zurückgeben, da er keine Ansichtsbereiche enthält. Fügen Sie den Typ-Spezifikator INVIEWPORT zum Ausdruck hinzu:

(S IN (INVIEWPORT)&(T= BEMASSUNG))

zwingt die Suche, alle Bemaßungen in den Ergänzungen der Ansichtsbereiche zu finden.

Auf ähnliche Weise können Sie nicht referenzierte Ansichtsbereiche auf Konstruktionsebenen mit dem Spezifikator NOTINDLVP und referenzierte Ansichtsbereiche auf Konstruktionsebenen mit NOTINREFDLVP ausschließen..

(S IN (NOTINDLVP)&(PON='Door CW'))

findet alle Türen, die sich nicht in nicht referenzierten Ansichtsbereichen auf Konstruktionsebenen befinden.

(S IN (NOTINREFDLVP)&(PON='Door CW'))

findet alle Türen, die sich nicht in referenzierten Ansichtsbereichen auf Konstruktionsebenen befinden.

Ort (LOC)

Der LOC-Spezifikator findet Objekte, die sich innerhalb der Grenzen eines benannten Objekts befinden, z. B. innerhalb eines Zauns.

Spiegelungsstatus eines Symbols (GESPIEGELT)

Der Spezifikator GESPIEGELT prüft den Spiegelungsstatus von Symbolen oder anderen Objekten. Um zum Beispiel die Anzahl aller gespiegelten Instanzen eines bestimmten Symbols festzustellen, findet der Ausdruck:

((S=’Zargentür’) & (GESPIEGELT))

nur die Instanzen des Symbols, die gespiegelt wurden. Der GESPIEGELT-Spezifikator ist nützlich, um die Ausrichtung von Objekten für die Bearbeitung oder verwandte Aufgaben herauszufinden.

Alle Objekte (ALL)

Mit dem Attributtyp ALL werden alle Objekte im Dokument aktiviert.

Filterkriterien-Tabelle

Die Attributtypen für Filterkriterien sind in der folgenden Tabelle aufgelistet.

Attributtyp	Typauswahl	Beispiel
Alle Objekte	ALL	nicht anwendbar
Datenbank	R	STRING mit bis zu 64 Zeichen
Klasse	C	C=“Vitra”
Durchsuche auch Intelligente Objekte	INOBJECT	(T=RECHTECK) & INOBJECT
Durchsuche auch Symbole	INSYMBOL	& (INSYMBOL)
Durchsuche auch Ansichtsbereich-Ergänzungen	INVIEWPORT	& (INVIEWPORT)
Durchsuche keine Ansichtsbereiche auf Konstruktionsebenen	NOTINDLVP	& (NOTINDLVP)
Durchsuche keine referenzierten Ansichtsbereiche auf Konstruktionsebenen	NOTINREFDLVP	& (NOTINREFDLVP)
Füllhintergrundfarbe	FB	Farbindex-Wert
Füllvordergrundfarbe	FF	Farbindex-Wert
Füllmuster	FP	FP=4
Gespiegelt	ISFLIPPED	nicht anwendbar
Schrift	FOT	FOT=“Arial”
Schriftgröße	FSZ	FSZ=10
Verlauf	GFI	GFI=“Schwarz-weiß”
Schraffur	HFI	HFI=“Beton”
Bildfüllung	IFI	IFI=“Steine”
Ebene	L	L=”Erdgeschoss”
Linienstil	LS	INTEGER-Wert
Linienart	LT	LT=” Linienart‐1”
Liniendicke	LW	INTEGER-Wert
Ort (innerhalb der Begrenzung eines benannten Objekts)	LOC	(LOC=‘MeinRaum’)
Pfeiltyp	AR	INTEGER-Auswahlwert
Pfeilgröße	ASZ	ASZ=0.125
Name	N	STRING mit bis zu 64 Zeichen
Objekttyp	T	Typauswahl (siehe Tabelle)
Deckkraft	OPA	OPA=70
Stifthintergrundfarbe	PB	Farbindex-Wert
Stiftvordergrundfarbe	PF	Farbindex-Wert
Stiftmuster	PP	PP=3
Aktivierungsstatus	SEL	BOOLEAN-Wert
Skizzenstil	SST	SST=“Grob”
Boden/Deckenstil	SLST	SLST=”Boden/Deckenstil‐1”
Geschoss	STO	STO = “Obergeschoss”
Symbolname	S	STRING mit bis zu 64 Zeichen
Textur	TX	TX=“Glas”
Textstil	TSTY	TSTY=” Textstil‐1”
Mosaik	TFI	TFI=” Mosaik‐1”
Sichtbarkeitsstatus	V	BOOLEAN-Wert
Wandstil	WST	WST=“ Wandstil‐1”

Objekttyp	Typauswahl	Beispiel
Punkt	PUNKT	T= PUNKT
3D-Punkt	PUNKT3D	T= PUNKT3D
3D-Polygon	POLYGON3D	T= POLYGON3D
Kreisbogen	KREISBOGEN	T= KREISBOGEN
Bild	BILD	T= BILD
Schicht-Index (Objekte, die Schichten aufweisen; nur in IFC-Zuordnungsformeln verfügbar)	INDEX	T=INDEX
3D-Objekt (Kugel, Halbkugel, Kegel...)	SOLID	T= SOLID
Vollkörper	VOLLKÖRPER	T= VOLLKÖRPER
Bemaßung	BEMASSUNG	T= BEMASSUNG
Extrusionskörper	TIEFENKÖRPER	T= TIEFENKÖRPER
Freihandlinie	POLYLINIE	T=POLYLINIE
Gruppe	GRUPPE	T= GRUPPE
Ebenenmodell	EBENENMODELL	T= EBENENMODELL
Linie	LINIE	T=LINIE
Punktkörper	PUNKTKÖRPER	T= PUNKTKÖRPER
Schichtkörper	SCHICHTKÖRPER	T= SCHICHTKÖRPER
Ellipse	ELLIPSE	T= ELLIPSE
Intelligentes Objekt	INTELLOBJEKT	T= INTELLOBJEKT
Polygon	POLYGON	T= POLYGON
Polylinie	POLYLINIE	T=POLYLINIE
Kreisbogen (Kreis, Kreisbogen)	KREISKREISBOGEN	T= KREISKREISBOGEN
Rechteck	RECHTECK	T= RECHTECK
Dach	DACH	T=DACH
Hybrides Element (Dach, Boden, Stütze)	DACHFLSTÜTZEBODEN	T= DACHFLSTÜTZEBODEN
Rund Wand	WAND	T= WAND
Radiusrechteck	RADIUSRECHTECK	T= RADIUSRECHTECK
Untertypen (alle Objekte außer Intelligente Objekte; verfügbare Untertypen sind aufgeführt unter VS:Search_Criteria#Search Criteria Sub Types )	ST	ST=KEGEL
Untertypen (nur Namen von Intelligenten Objekten)	PON	PON=“DOOR CW”
Rotationskörper	ROTATIONSKÖRPER	T= ROTATIONSKÖRPER
Symbol	SYMBOL	T=SYMBOL
Text	TEXT	T=TEXT
Wand	Wand	T=Wand
Tabelle	TABELLE	T= TABELLE

Filterkriterien-Untertypen

Verwenden Sie die ST-Objekttyp-Auswahl für Objekte, die keine Plug-in-Objekte sind, stehen die folgenden Untertypen zur Verfügung:

Objekt-Untertyp	Objekttyp	Untertyp-Auswahl	Beispiel
Parallellicht	Lichtquelle	PARALLELLICHT	ST= PARALLELLICHT
Spotlicht	Lichtquelle	SPOTLICHT	ST=SPOTLICHT
Punktlicht	Lichtquelle	PUNKTLICHT	ST= PUNKTLICHT
Eigene Lichtquelle	Lichtquelle	EIGENELICHTQUELLE	ST= EIGENELICHTQUELLE
Flächenlichtquelle	Lichtquelle	FLÄCHENLICHT	ST= FLÄCHENLICHT
Linienlichtquelle	Lichtquelle	LINIENLICHT	ST= LINIENLICHT
Normaler Ansichtsbereich	Ansichtsbereich	ANSICHTSBEREICHNORM	ST= ANSICHTSBEREICHNORM
Schnitt	Ansichtsbereich	ANSICHTSBEREICHSCHN	ST= ANSICHTSBEREICHSCHN
Dachfläche	Dachfläche	DACHFLÄCHE	ST=DACHFLÄCHE
Stütze	Stütze	STÜTZE	ST= STÜTZE
Kegel	3D-Objekt	KEGEL	ST= KEGEL
Kugel	3D-Objekt	KUGEL	ST= KUGEL
Halbkugel	3D-Objekt	HALBKUGEL	ST= HALBKUGEL
Kreis	Kreisbogen	KREIS	ST=KREIS
Offener Kreisbogen	Kreisbogen	KREISBOGEN	ST= KREISBOGEN
Vollkörper Subtraktion	Vollkörper	VOLLKÖRPERSUB	ST= VOLLKÖRPERSUB
Vollkörper Addition	Vollkörper	VOLLKÖRPERADD	ST= VOLLKÖRPERADD
Vollkörper Schnittvolumen	Vollkörper	VOLLKÖRPERSCHNITTVOLUMEN	ST= VOLLKÖRPERSCHNITTVOLUMEN
Vollkörper Schnitt	Vollkörper	VOLLKÖRPERSCHNITT	ST= VOLLKÖRPERSCHNITT
3D-Hohlkörper	Vollkörper	HOHLKÖRPER	ST= HOHLKÖRPER
3D-Fase	Vollkörper	FASE3D	ST= FASE3D
3D-Verrundung	Vollkörper	VERRUNDUNG3D	ST= VERRUNDUNG3D
NURBS-Fläche auf Grundlage von Kontrollpunkten	NURBS-Fläche	NURBSFLÄCHENPUNKT	ST= NURBSFLÄCHENPUNKT
Interpolierte NURBS-Fläche	NURBS-Fläche	NURBSFLÄCHENINTERPOL	ST= NURBSFLÄCHENINTERPOL