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 |