-
Notifications
You must be signed in to change notification settings - Fork 4
Reference lookup constructor
The reference lookup constructor (RLC) allows you to find objects in a database that match a specified criteria, and populate references to them on an attribute on the current object.
All constructors must have a ID that is unique across the configuration set. This includes across different [class constructors](Class constructors). Any string value can be used using the characters A-Z, 0-9, and -.
This setting allows you to temporarily disable the constructor. Disabled constructors' execution conditions are never evaluated and the constructor never runs.
This field provides an opportunity to document what your constructor does. It is a free text field that can contain as much or as little information as you like
The attribute that the constructor will modify the value on. Must be a reference-type attribute bound to the current object class.
This constructor always replaces the existing values on the attribute. If no matches are found, any existing values are deleted.
You can configure how you want the constructor to handle a situation where multiple matches are found for the given search criteria. If the target is a single-valued attribute, you must choose an action to take. If the target is a multivalued attribute, you can store all the matches.
| Action | Description | Single-Valued | Multi-Valued | Use Cases |
|---|---|---|---|---|
| Use all | All matches found will be stored on the target attribute | Not available | Available | Group memberships, multi-manager scenarios |
| Use first | Gets the first matching result and stores that on the target attribute | Available | Available | Primary manager, default assignments |
| Use none | Deletes the attribute if more than one value is found | Available | Available | Ensure uniqueness, conflict avoidance |
| Error | Throws an error and aborts the current export operation | Available | Available | Strict validation, data quality enforcement |
The lookup query node allows you to define the search criteria. It is a standard [database query](Database query) that can search multiple attributes across the various [object classes](Object classes). As with all database queries, attributes that are inherited on a particular object class cannot participate in a search, as they do not exist on the inheriting object within the database.