AttributeSplitter

The feature type that contains the attribute you want to split.

Features with the selected attribute value split into a list attribute.

After you connect this transformer, choose an attribute from the pull-down menu.

Characters can be expressed as regular characters but they can also include any number of control characters.

Special character sequences (Advanced Editor only) are interpreted as shown below:

Alternatively, instead of using a delimiter character you can provide a string in the format #s#s#s, where each number is the length of the substring you wish to extract.

Defining Special Characters

You can define special characters through the Basic or Advanced Editors. Click Open Editor from the parameter menu:

Basic Text Editor

Select Constant from the String Type column (or, in some transformers, the Value column) and click on the empty field in the column:

Click the browse button to the right of the column to open an Edit Value dialog. In this editor, enter characters using the shortcut keys from the table above.

Advanced Text Editor

Enter characters using the shortcuts from the table above.

Note: To see tab characters, click the Options menu on the bottom left and select Show Spaces/Tabs.

By default, the resulting strings have both leading and trailing (left and right) whitespace removed but you can change the setting to either left or right, or none.

The default list name is _list, but you can change it to a name that is more specific to your workflow.

Note: When a feature has an existing list attribute of the same name as List Name, FME overwrites the newly-created elements onto the existing list attribute. For example, consider a feature that has an attribute src with values 1,2, and a list attribute _list with values {A,B,C,D}. If the AttributeSplitter splits src into a list attribute that is also named _list, the result is one list attribute _list with values {1,2,C,D}.

Determines whether to keep empty parts (or tokens) that resulted from splitting. By default, all parts will be returned, whether or not they are empty. If the parameter value is set to Yes, only non-empty parts will be returned.

If this parameter is set to No, splitting a,b,,,c,d,e with commas returns the following list:

`_list{0}' has value `a'

`_list{1}' has value `b'

`_list{2}' has value `'

`_list{3}' has value `'

`_list{4}' has value `c'

`_list{5}' has value `d'

`_list{6}' has value `e'

If this parameter is set to Yes, splitting a,b,,,c,d,e with commas returns the following list:

`_list{0}' has value `a'

`_list{1}' has value `b'

`_list{2}' has value `c'

`_list{3}' has value `d'

`_list{4}' has value `e'

 if myattr =  A,B,C and the delimiter is ,

  then the result would be:

  mylist{0} = A

  mylist{1} = B

  mylist{2} = C

  if myattr =  20030210 and the format string is 4s2s2s

  then the result would be:

  mylist{0} = 2003

  mylist{1} = 02

  mylist{2} = 10