Extracts selected geometry names or traits to feature attributes.
Features with geometries.
Features with newly set attributes based on geometry name or traits.
Features that were not modified by the transformer.
Geometry Part Selection
Use this parameter if you want to isolate only a portion of the geometry passed in to the transformer. If no criteria are specified, the action will apply to the entire geometry at all levels.
Selection can be based on structural location, geometry name, type, appearance information, traits, trait storage types, or definition reference. The syntax used is a restricted set of XQuery, where the return clause is fixed.
The basic Geometry XQuery dialog allows you to construct simple selection queries by automatically writing the necessary query based on specified test clauses. Clicking the Switch to Advanced button opens the Advanced Editor, which allows you to type a query free-form, for more expressive queries.
Note: Once you switch to Advanced mode, you will have to clear all parameters before you can return to Basic mode.
A hierarchical geometry is represented as nodes of type geometry, with attributes containing information about traits, type, and name for each geometry.
- Traits: Extract the selected traits to attributes of the same name.
- Geometry Name: Extract the geometry name to the specified attribute
This parameter is valid when the Property to Extract is set to Geometry Name.
It defines the name of the attribute to which the geometry name will be extracted. If a hierarchical geometry is present, multiple geometry names will be extracted onto a list attribute of the same name. The default value for the Geometry Name Attribute is _geometry_name.
Setting this parameter to Yes will prefix the extracted traits with the respective geometry’s name. If traits with the same name exist on multiple geometries, using this option will allow these traits to exist independently.
The names of traits to extract from the geometry. If the Extract Traits as List checkbox is active, then the traits will be pushed up as a list attribute of the same name (even if just one trait present). If the Extract Traits as List checkbox is not active, then the trait will be set as an attribute, and if the trait is present on multiple parts of the geometry, one of the values will arbitrarily be the value associated with the new attribute. If no traits are specified, all traits on selected geometries will be pushed up as attributes (creating a list if the trait is present on multiple parts of the geometry and not otherwise).
Editing Transformer Parameters
Using a set of menu options, transformer parameters can be assigned by referencing other elements in the workspace. More advanced functions, such as an advanced editor and an arithmetic editor, are also available in some transformers. To access a menu of these options, click beside the applicable parameter. For more information, see Transformer Parameter Menu Options.
FME Licensing Level
FME Professional edition and above
Associated FME function or factory: GQueryFactory
Search FME Community
Search for samples and information about this transformer on the FME Community.
Tags Keywords: GeometryTraitExtractor GeometryTraitFetcher GeometryNameExtractor