The Elector Data Filter evaluates available attributes and elects one based on configured Precedence Rules. The elected value is passed to the associated Provisioning Target.
This is a non-core plugin, see Installing and Enabling Registry Plugins for more information.
- After instantiating the plugin as a Data Filter, proceed to the plugin's Configuration page.
- Set the Subject Attribute to the Attribute this instantiation will process. Each instantiation only processes one Attribute, to elect multiple Attributes configure multiple instances of the plugin.
- Once the Attribute Name is selected, the Outbound Attribute Type can be selected.
- For more information about the configuration options, see Attribute Election, below.
- Once the initial configuration is saved, return to the Plugin Configuration page to set the Elector Data Precedences.
This Attribute Processing configuration is experimental, and may change across minor releases.
Sample Attribute Election Flow
Each instantiation of the Elector Data Filter Plugin operates over one Subject Attribute, which is a multi-valued attribute attached to the CO Person record. Supported Subject Attributes include Address, EmailAddress, TelephoneNumber, and Name.
Multi-value attributes are typed, for example official or personal. The Plugin examines the types of the Subject Attribute to determine which value to elect. The available values of the Subject Attribute on the CO Person record being evaluated are referred to as the Source Attributes Values. For example, a CO Person might have three Email Addresses: one official, one personal, and one preferred.
The goal of the Elector is to select exactly one of these Source Attribute Values, the selected value is referred to as the Elected Attribute Value. The Elected Attribute Value, once selected, is assigned the Elected Attribute Type and is made available to the Provisioning Target. If the Election Mode is Insert, the Elected Attribute Value will be added to the existing set of Source Attribute Values. If the Election Mode is Replace, the Elected Attribute Value will replace all existing Source Attribute Values.
Elector Precedence Rules
The actual selection of the Elected Attribute Value is primarily governed by the Elector Data Precedence Rule configuration. Each Precedence Rule applies an order to a Source Attribute Type, ie one of the Extended Types that might be found in the set of Source Attribute Values. Order processing starts with 1 and then continues with higher order values until a Source Attribute Value of the configured type is found. The first matching Source Attribute Value is chosen as the Elected Attribute Value. If two Precedence Rules are assigned the same order, it is non-deterministic as to which Precedence Rule will be examined first.
It is possible to further refine Precedence Rules by associating the rule with an Organizational Identity Source plugin. This allows Source Attribute Values to be selected based on which System of Record asserted a value of any given type.
In the event a Precedence Rule results in more than one candidate Elected Attribute Value, which candidate is selected will be determined using the Tie Break Mode. This allows either the oldest or newest value to be chosen.
If the Precedence Rules fail to match any value, no Elected Attribute Value is assigned.
The Elected Attribute Value is not persisted in the database. It is passed to the attached Provisioning Target and then discarded.