The provided
search options of the GeoDb Topology search are specified in the
configuration file topostructure.cfg. It is
specified what kind of categories exist and which features / global
attribute groups are displayed in the topology search dialog. Furthermore,
the config allows to describe which attributes of the respective feature /
global attribute group are considered for the search. These config blocks
can be extended with custom information (display name, help text ID, icons,
etc.).
The following explains how to determine search categories in the config and how these settings are presented in the topology search dialog. Categories are described as separate config blocks, e.g. [category_features]. The prefix "category_" is mandatory. It is followed by the internal name of the category, e.g. "features" (can be chosen freely). Using this internal name the respective category can be referenced in the block [rootCategories] under "categories". The categories are displayed in this order in the topo search dialog.
The listed features and global attribute groups (globalAttributeGroups) within the categories are specified in detail in other blocks of the config (e.g. [feature_Cylinder] or [globalAttributeGroup_symmetry]). Both global attribute groups and features can be added to a category.
Global attribute groups can be freely defined. The global attributes that should be displayed and their order are stated under "globalAttributes". In contrast, the global attributes are restricted to a certain selection.
Global attributes: xDim, yDim, zDim, minorDim, mediumDim, majorDim, area, volume, thickness, axisSym, planeSym, shape.
Example for global attribute group "size": xDim, yDim, zDim, minorDim, mediumDim, majorDim
Additionally, the global attributes can be enriched with extra information within separate config blocks (globalAttribute_) in order to determine the display name (displayName) and the short description (shortDesc).
Features and their attributes are also restricted for selection just like the global attributes.
Cone: aperture, truncatedLength, frustumLength, area, orientation, sweepAngle, majorDiameter, minorDiameter
Sphere: area, orientation, latitudinalAngle, longitudinalAngle, diameter
Torus: area, orientation, latitudinalAngle, longitudinalAngle, minorDiameter, majorDiameter
Hole: depth, diameter, holeType, counterTypeStart, counterTypeEnd
LinearHolePattern: holeCount, width, height, distanceX, distanceY, alignment
LinearSlottedHolePattern: holeCount, width, height, distanceX, distanceY, alignment
LinearRectHolePattern: holeCount, width, height, distanceX, distanceY, alignment
The key "attributes" within the config blocks of features defines the order of the attributes to be displayed. If this key is omitted, all feature attributes are used in their internal sequence by default. The feature attributes can be extended in the same way as the global attributes. For the config blocks of feature attributes the prefix "featureAttribute_" is followed by the feature name (e.g. "Cylinder_") and finally by the attribute name (e.g. "diameter").
There is also the option to define derived features (derivedFeature_) in the config in order to combine, to map or to restrict certain attributes to a fixed value. However, here the syntax is very complicated and changes should only be made by developers.







