Create multi-value names
Multi-value names tab
Combine existing name outputs into a single array for a target attribute that accepts multiple values.
At a glanceDirect link to At a glance
Create the individual values on the Names tab first. On Multi-value names, select which outputs belong in the array and optionally add a prefix or postfix to each one. Save the generator and use the combined output in a mapping for a target field that accepts multiple strings.
For example, two names can produce a primary email address and an alias. If the target is Active Directory proxyAddresses, their formatted values might be SMTP:aiko.beach@example.org and smtp:abeach@example.org. Microsoft uses uppercase SMTP: for the primary address and lowercase smtp: for a secondary address; verify the required format and domain with your Exchange administrator before applying it. See Microsoft's email address policy guidance.
Before you beginDirect link to Before you begin
- Confirm the selected filter returns the source columns required for every individual name.
- Create and preview each name separately so a missing or malformed value is easy to identify.
- Confirm the target attribute accepts multiple values and whether its existing values must be retained or replaced by your mapping.
Create a multi-value nameDirect link to Create a multi-value name
Use a multi-value name when a target attribute accepts an array of strings, such as Active Directory proxyAddresses.
Create the individual outputs firstDirect link to Create the individual outputs first
Edit a name generator that already contains at least two names. Each selected name becomes one value in the resulting array. Give the outputs distinct names, such as primaryMail and aliasMail, and preview both before combining them.
Select and format valuesDirect link to Select and format values
- Open Multi-Value Names and select Add Multi-Value Name.
- Enter an output name, such as
AD_proxyAddresses. - Select the names to include and optionally set a prefix or postfix for each value.
For proxyAddresses, you might prefix the primary output with SMTP: and the alias with smtp:. Review the complete generated strings; the prefix is part of the value sent to the target.
Use the array in a target mappingDirect link to Use the array in a target mapping
Save the generator, then select the multi-value output in a mapping that uses this name generator. Test one safe record and inspect the resulting target attribute before enabling a broader job. Check that every intended value is present, the primary address is identified correctly, and existing values are handled as intended.
If the target value is wrongDirect link to If the target value is wrong
Inspect each source name in Results, then check the selected names and prefix or postfix for the multi-value output. If the generated array looks right but the target does not, review the mapping's target field and how that operation handles an existing multi-value attribute. Return to Uniqueness if an individual address must avoid a value already in use.