Name generators
Name generation
Build usernames, email addresses, display names, and other target values from current filter data. Configure a generator through its Names, Uniqueness, and Multi-value names tabs.
At a glanceDirect link to At a glance
A name generator uses columns from a filter to produce values that a mapping can send to a target system. Start on Names to assemble an output from methods and parts. Use Uniqueness when the value must not collide with an existing one. Use Multi-value names when one target attribute needs an array of generated values.
The three tabs build on each other: create individual names first, then configure collision checks or combine those names as needed. Preview representative records in Results before saving, and test a limited mapping before scheduling broader automation.
| NIM tab | Use it to | Example |
|---|---|---|
| Names | Select a filter, build output names from source columns, and apply methods, conditions, iterations, or conversions. | Turn a first and last name into a username or email address. |
| Uniqueness | Check candidate values against selected system fields and try ordered fallbacks when a collision occurs. | Try another username method or append a number when the first candidate exists. |
| Multi-value names | Combine existing names into one array, with optional prefixes or postfixes for each entry. | Build the values for an Active Directory proxyAddresses attribute. |
Before you beginDirect link to Before you begin
- Collect the source system and confirm the source columns contain the expected data.
- Create a filter that returns the people and attributes to process. Include records with missing or unusual values in your test set.
- Identify the target attribute's format, maximum length, allowed characters, and whether its value must be unique. Check the target integration's supported operations before using the result in a mapping.
Create a name generatorDirect link to Create a name generator
Open Processing > Name Generation, select Add, give the generator a descriptive name, and choose its source filter. Continue with Names: create outputs, methods, and parts. The filter determines which columns you can use; each output name can have one or more candidate methods.
Enforce uniqueness for namesDirect link to Enforce uniqueness for names
If the target value must be unique, configure the Uniqueness tab after building its names. Select the fields to check, order fallback methods, and preview how collisions resolve. A name that does not require a uniqueness check can use one method.
Create a multi-value nameDirect link to Create a multi-value name
If the target field accepts multiple values, combine existing names in the Multi-value names tab. Define each individual output first, then select and format the values that belong in the array.
Restrict a method by conditionDirect link to Restrict a method by condition
Conditions are configured with methods on the Names tab. Use them when a source attribute, such as department or organizational unit, determines which naming pattern applies.
Conversion referenceDirect link to Conversion reference
Conversions change one method part at a time. See the Names conversion reference for the available text, case, character, and shortening operations. Apply them in the required order and check the result with actual source values.
Go directly to adding text and spacing, changing case and characters, removing or retaining text, or shortening a value.
Maintain an existing generatorDirect link to Maintain an existing generator
Use Edit Name Generator to change its filter, outputs, or rules. Copy Object creates a numbered copy; Rename Object changes its name. Before you remove a generator, check whether a mapping still uses one of its outputs. See edit, copy, rename, or remove a generator for the controls.