BulkAttributeRenamer

Renames attributes by adding or removing prefixes or suffixes, or replacing text using regular expressions or character strings. This transformer is useful if you need to quickly rename all (or many) of your attributes.

Jump to Configuration

Typical Uses

  • Rename multiple attributes to match a naming convention
  • Add prefixes or suffixes to attribute names
  • Remove prefixes or suffixes from attribute names
  • Change the case of attribute names
  • Replace a string in attribute names

How does it work?

The BulkAttributeRenamer lets you select either all attributes or specific ones, and then choose a renaming method. All attributes on features that enter the transformer are modified according to your selections.

If the renaming process results in an empty attribute name, that attribute will be removed - for example, removing a suffix where the suffix itself is the whole attribute name.

The values of attributes are unchanged.

Examples

Usage Notes

  • This transformer is specifically for changes to attribute names. To change attribute values use the StringReplacer or AttributeManager transformers.
  • Use the AttributeManager to rename individual attributes, with the option of supplying a default value if the original attribute was not present.
  • Use the StringCaseChanger to change the case of attribute values (not names).
  • If Rename All attributes is chosen, unexposed format attributes may also be renamed, which may produce unexpected results. Consider using Selected Attributes and the attribute pick list for finer control.

Configuration

Input Ports

Output Ports

Parameters

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.

Defining Values

There are several ways to define a value for use in a Transformer. The simplest is to simply type in a value or string, which can include functions of various types such as attribute references, math and string functions, and workspace parameters. There are a number of tools and shortcuts that can assist in constructing values, generally available from the drop-down context menu adjacent to the value field.

Dialog Options - Tables

Transformers with table-style parameters have additional tools for populating and manipulating values.

Reference

Processing Behavior

Feature-Based

Feature Holding

No

Dependencies None
FME Licensing Level FME Base Edition and above
Aliases  
History Replaces the AttributePrefixer and the AttributeExpressionRenamer

FME Community

The FME Community is the place for demos, how-tos, articles, FAQs, and more. Get answers to your questions, learn from other users, and suggest, vote, and comment on new features.

Search for all results about the BulkAttributeRenamer on the FME Community.

 

Examples may contain information licensed under the Open Government Licence – Vancouver and/or the Open Government Licence – Canada.