Handler - AttributeCombiner
AttributeCombiner handler generates a new value automatically from existing attribute values (two or more). A combined value is composed from the attribute values that are denoted by their class attribute codes in the combined attribute's metadata. Hereby, in order to use the existing attribute values for generating a new value, each source attribute must have an individual attribute code that you denote in the metadata of the combined attribute.
For example, the attribute Full name is composed of the values of the First name (John) and Last name (Smith) attributes. The combined value includes a separator (comma) in between the values that is also denoted in the Full name attribute's metadata.
A Full name attribute with AttributeCombiner handler:
If you want to combine the source values in a specific order, enter the attribute code in the Name field and define the order in the corresponding Value field. It doesn't make a difference which numbers you use to order the values as long as you use a numerical order. To use a separator between the combined values, define the separator in the Attribute metadata view as illustrated below.
Metadata for an attribute Full Name:
You cannot use AttributeCombiner handler with multivalued attributes.
The following tables provide information on the attribute settings and metadata requirements for AttributeCombiner handler. Compulsory metadata is provided in a Required attribute metadata table including proposals for possible metadata values. Accordingly, an optional metadata is also presented in a corresponding table.
Table 1. Attribute Settings
| Handler name | Datatype |
|---|---|
| AttributeCombiner | String |
Table 2. Required Attribute Metadata
| Name | Value | Description |
|---|---|---|
[attribute_code1] |
[integer] |
In the In the For example, the indicator for the first value segment can be 10. |
[attribute_code2] |
[integer] |
In the In the For example, the indicator for the first value segment can be 20. |
The number of source attributes is not limited. You can denote as many source attribute codes as needed, each in its row.
You can use the AttributeCombiner handler to generate a combined value also from referrer and referred attribute values. The attribute values are denoted in the metadata of the reference attribute by [code1$code2] where code1 indicates the attribute code of the referrer attribute, and code2 the attribute code of the reference target. Note that the there is a dollar sign in between the codes!
Also notice that with reference attributes, the referring attribute's data type is reference. In addition, the Expand references automatically option must be selected in the Reference settings of the referring attribute.
Table 3. Optional Attribute Metadata
| Name | Value | Description |
|---|---|---|
Separator |
_ none |
A string separating the values. The default separator is an underscore. If you do not define a separator, there is no separator between the combined values. |
Space after separator |
true |
Adds an empty space after separator string. Useful, for example, when writing names in form of lastname, firstname. In that case separator would be a comma ',' and Space after separator had to be true. |
Interval |
[ms] |
This meta data is obsolete as off Efecte 14. |
Table of Contents