SharedItemAdder

A feature that contains an Appearance, Texture, or Raster style, or any geometry (when adding Geometry Definitions).

Input features that were used to add an item to the internal FMELibrary are output through the Output port.

Input features that were not used to add an item to the internal FMELibrary.

The type of shared item to add.

When you pass in features, this transformer will be creating shared items. However, there are two ways these new shared items may be stored and used:

• Add New Item: This is the simplest approach. With this option, a new shared item is created and stored in the internal FMELibrary. This new item is referenced by the selected geometry parts; references to previous items are dropped, leaving those items unchanged in the internal FMELibrary.
• Replace Existing Item: This approach is powerful and may change many things in the dataset very efficiently. With this option, a new shared item is not created, but instead, the link to every shared item which is referenced by the selected Geometry Parts is followed, and each of those items is overwritten within the internal FMELibrary.
  
  This is reflected in two ways: First, all chosen geometry parts reflect the new shared item properties, even though they do not change how they reference items. Second, a more subtle effect is that all geometry parts, on all active features (even those features not passing through this factory) that refer to the overwritten shared item will immediately see the new values as well.

When replacing existing items, this parameter specifies the name of the attribute containing the shared item ID to replace.

When adding new items, this parameter specifies the name of the attribute that will store the ID of the added shared item.