FeatureMerger

In this example, we have two datasets - a CSV text file of historical crime reports, and a shapefile of public streets. Both of the datasets have one piece of information in common, that is an address in the form of “hundred” block.

TheFeatureJoiner这可能更有效地执行简单的属性值加入，但是，每个数据集中地址的格式略有不同。CSV数据使用字符串“XX”代替地址中的零：

And the street data has the more conventional form, with zeroes:

Our goal is to merge the street geometry onto the crime data - producing one output feature for each crime record. And so, The CSV data is routed into theRequestorinput port, and the streets are routed into the供应商port.

在“参数”对话框中，我们需要创建一个Join On双Requestorand供应商values. As the format of the addresses is not identical, we will adjust one, constructing a key. With the assistance of the Text Editor, we create an expression that will replace the “XX” of the address with “00”, and so match the format of the street (Supplier) data.

配对的其他一半是属性值HBLOCKfrom the street data.

Feature Merge Type是set toAttributes and Geometry。The default values forAttribute Accumulation(Merge Supplier) will provide the correct results.

TheMergedoutput contains crime records, now with geometry for the street and associated street attributes. Note that the address format was not actually changed by the constructed expression - it was just used for matching evaluation. In this location, 137 crime records were found. Each one now has (identical) geometry.

To see this example reversed - attaching all crime records to a single street - see the next example.

In this example, we reverse the scenario in the above example. We want to merge all the historical crime records onto the street data, producing one record per street line segment (block), with alist attributecontaining the crime data.

In this case, the streets are theRequestorfeatures, and the crime data is the供应商。

In the parameters dialog, we again create aJoin Onpair, using an expression to match the two (slightly different) hundred block formats. TheFeature Merge Type是仅属性, as the Requestors (streets) already have the desired geometry.

Process Duplicate Suppliers是enabled. Without this, the first match would be processed and the remainder discarded. A count of how many Suppliers (crimes) matched will be kept in theNumber of Suppliers Attribute, namedIncident_Count。

Generate List是enabled, and given theList NameofCrime_Records。We will add onlySelected Attributesto the List, and chooseTYPEandYEAR。

TheMergedoutput features now have alist attribute，包含来自CSV的所有匹配记录。注意incident_count属性。

Features that will receive new attributes and/or geometry from the features connected to the供应商port.

The source of new attributes and/or geometry for features that enter through theRequestorport.

Note that by settingProcess Duplicate SupplierstoYes, more than one Supplier may be merged to each Requestor. These Suppliers potentially could come from different sources (such as different database tables).

匹配供应商的请求者（或可能的多个供应商，如果Process Duplicate Suppliers是set toYes）。

Requestors that donot匹配任何供应商。如果一个Join Onkey is null or missing on a Requestor feature, that feature is output onto this port.

供应商s that are found by at least one Requestor.

Note: ">Note:A Supplier may still be output through this port even though none of its attributes were merged. This can occur because all of the attributes were already present in the Requestor or were provided by earlier Suppliers.

供应商s that donot匹配任何请求者。如果一个Join Onkey is null or missing on a Supplier feature, that feature is output onto this port.

如果Process Duplicate Suppliers是No, then duplicate suppliers will be rejected. IfReject Null and Missing Keys是Yes，然后将拒绝钥匙特征。

Rejected Feature Handling:can be set to either terminate the translation or continue running when it encounters a rejected feature. This setting is available both as a defaultFME optionand as a工作区参数。

如果more than one Supplier is found for a given Requestor, andProcess Duplicate Suppliers是not enabled, then every Supplier after the first is output via theport and only the first of the Suppliers will be matched with a Requestor.

如果Process Duplicate Suppliers是enabled, duplicate Suppliers are all matched with the corresponding Requestor. Attributes are merged based on the Attribute Accumulation mode, and optionally output as alist attributeof the Requestor, using the specifiedList Name。The Supplier geometry is merged using the specifiedGeometry Merge Type。

请注意，启用Generate Listalso implicitly enablesProcess Duplicate Suppliers。

Geometry Merge Type	Specifies how to merge duplicate Suppliers onto the Requestor. It is applicable only ifFeature Merge Type指定合并几何。选择包括： Build Polygons:如果the Suppliers consist exclusively of polygon and donut polygon features, any common border segments will be removed. If the Suppliers contain at least one non-donut or non-polygon feature, then the transformer will form polygons and donuts from the Suppliers and will join connected line segments of the Supplier features before setting the geometry of the Requestor feature. In this case, the geometry may be an aggregate if several disjoint geometries were created. Build Aggregates:The transformer will create an aggregate of the geometries of the Supplier features. (If there is only one Supplier feature, then the Requestor geometry will be an aggregate with one element.) Build Lines from Points:变压器将供应商功能的点连接到行中。请注意，在构建线路时，将忽略所引用的任何非点特征。
Tolerance	The minimum distance between geometries in 2D before they are considered equal, in ground units. If the tolerance isNone, the geometries must be exactly identical to be considered equal. If the tolerance is自动的, a tolerance will be automatically computed based on the location of the input geometries. Additionally, a custom tolerance may be used.
Connect Z Mode	如果一个pplicable, select a method for handling z values. Connect Z Mode When viewed in 2D (ignoring Z), a path (which may define the border of a polygon) may appear to be closed as shown in the left figure below. This same path, when viewed in 3D, may appear to be open as shown in the right figure below. To specify how (and if) paths should be closed in 3D, select one of the listed modes. Mode Description 例子 Extend The Curve is extended so that all vertices are left at their original location. Average Subsequent vertices that are not connected, but share an x and a y value are combined into one vertex, whose Z value is the average of the original two. First Wins Subsequent vertices that are not connected, but share an x and a y value are combined into one vertex, whose Z value is taken from the first encountered vertex. Last Wins Subsequent vertices that are not connected, but share an x and a y value are combined into one vertex, whose Z value is taken from the last encountered vertex. Ignore Z values are ignored. No change is made to the way the nodes are connected.
Number of Suppliers Attribute	The name of an attribute which will store a count of the number of Suppliers matched a Requestor.

如果一个ttributes on the Supplier and Requestor feature share the same name, but are not geometry attributes that start withfme_,then they are deemed conflicted.

如果there are duplicate Suppliers andGenerate List已启用，然后与请求者组合的任何供应商都将其属性添加到请求者上的指定列表中。请注意，启用Generate Listalso implicitly enablesProcess Duplicate Suppliers。

Note: ">Note:List attributesare not accessible from the output schema in Workbench unless they are first processed using a transformer that operates on them, such asListExploderorListConcateator。Alternatively,AttributeExposercan be used.

Using the Text Editor

The Text Editor provides a convenient way to construct text strings (including regular expressions) from various data sources, such as attributes, parameters, and constants, where the result is used directly inside a parameter.

Text Editor

Using the Arithmetic Editor

The Arithmetic Editor provides a convenient way to construct math expressions from various data sources, such as attributes, parameters, and feature functions, where the result is used directly inside a parameter.

算术编辑器

Conditional Values

Set values depending on one or more test conditions that either pass or fail.

Parameter Condition Definition Dialog

Content

Expressions and strings can include a number of functions, characters, parameters, and more.

设置值 - 无论是否直接在参数中输入或使用其中一个编辑器和包含字符串的表达式都是构造的，都会评估这些函数的字符串和表达式。因此，这些函数的名称（以@ <function_name.>) should not be used as literal string values.

Content Types

String Functions	These functions manipulate and format strings.
Special Characters	A set of control characters is available in the Text Editor.
Math Functions	Math functions are available in both editors.
Date/Time Functions	Date and time functions are available in the Text Editor.
数学运营商	这些运算符可在算术编辑器中使用。
FME Feature Functions	These return primarily feature-specific values.
FME Parameters	可以使用FME和工作区的参数。
Creating and Modifying User Parameters	Create your own editable parameters.

Note:Not all tools are available in all transformers.