CoreOne Universal Connector Mappings

Introduction

In order to connect source attributes (let’s say the first name in SAP HCM) to a target attribute (let’s say the first name in the CoreOne Meta Directory) we have to configure a MappingConfiguration. There are rather simple ones where we simply map one attribute to another one and there are more complex ones where we also transform the data. This page describes the available mappings.

Mapping Types

There are two types of mappings, AttributeMappingand PropertyMapping. AttributeMapping are used to map to an attribute of an entity such as a first name of an Core Identity. Some entities have predefined properties that are not stored as attributes. To map those, you have to configure an PropertyMapping. An example for a PropertyMapping is the tenant on a Core Identity.

Attribute Mappings

Mapping Configuration	Description	Example
`FixObjectAttributeConfiguration`	Can be used to map a target attribute to a fixed value.	`new FixObjectAttributeConfiguration<string>(7, "johdoe")`
`SoureParameterAttributeMappingConfiguration`	Can be used to map a target attribute to a source attribute	`new SourceParameterAttributeMappingConfiguration(7, "sAMAccountname")`
`SwitchCaseAttributeMappingConfiguration`	Can be used to map a target attribute to a fixed value based on the source value	`new SwitchCaseAttributeMappingConfiguration(500044, "TwoFAMethode", new Dictionary<string, object> {{ "TOT Pin", true}}, false )`

Property Mappings

Mapping Configuration	Description	Example
`ConcatCollectionPropertyMappingConfiguration`	Can be applied to a source list and will return all values that match a criteria with the option to replace those values with new ones. I.e. the source collection is a list of customers ids. If customer id 1000 is present in the list, return the customer name “BestRun”. Multiple of such conditions can be applied.
`ConcatCollectionPropertyRegexMappingConfiguration`	Can be applied to a source list and will return all values that match a regex pattern with the option to replace those values with new ones. I.e. the source collection is a list of customers ids. If the id matches 100*, return the customer name “BestRung”.
`FixObjectPropertyMappingConfiguration`	Can be used to map a target property to a fixed value.	`new FixObjectPropertyMappingConfiguration<uint>(CoreIdentityDefinition.PropertyNames.CoreIdentityTypeId, 1)`
`ResolvedCoreIdentityIdByAttributeValueMappingConfiguration`	Resolves to the ID of a Core Identity in the CoreOne Meta Directory based on a given Attribute ID and Value
`ResolvedCoreIdentityIdByForeignIdMappingConfiguration`	Resolves to the ID of a Core Identity in the CoreOne Meta Directory based on a foreign id
`ResolvedCoreIdentityIdByObjectIdMappingConfiguration`	Resolves to the ID of a Core Identity in the CoreOne Meta Directory based on a given object id of an identity
`ResolvedResourceIdByAttributeValueMappingConfiguration`	Resolves to the ID of a resource in the CoreOne Meta Directory based on a given Attribute ID and Value
`ResolvedResourceIdByForeignIdMappingConfiguration`	Resolves to the ID of a resource in the CoreOne Meta Directory based on a given foreign id
`ResolvedResourceIdByObjectIdMappingConfiguration`	Resolves to the ID of a resource in the CoreOne Meta Directory based on a given object id of an resource
`ResolvedResourceIdByResourceDefinitionAttributeValueMappingConfiguration`	Resolves to the ID of a resource in the CoreOne Meta Directory based on a given Attribute ID and Value of an existing resource definition
`ResolvedRoleIdByAttributeValueMappingConfiguration`	Resolves to the ID of a role in the CoreOne Meta Directory based on a given Attribute ID and Value
`ResolvedRoleIdByForeignIdMappingConfiguration`	Resolves to the ID of a role in the CoreOne Meta Directory based on a given foreign id
`SourceParameterPropertyMappingConfiguration`	Can be used to map a target property to a source attribute	`new SourceParameterPropertyMappingConfiguration(ResourceDefinition.PropertyNames.ResourceIdentifier, "objectSid"),`
`SourceParameterPropertyMappingDateTimeFormatConfiguration`	Can be used to map a target property to a source attribute and formats the value to a specific date time
`SwitchCasePropertyMappingConfiguration`	Can be used to map a target attribute to a fixed value based on the source value

Value Processors

Some of the mapping processors can be further enhanced with value processors. In this case, the resolved value will be further transformed by using a list of value processors. The following are the values processors that are available.

Value Processors	Description	Example
`CollectionValueProcessor`	Takes elements out of a collection based on a mode. Modes are `first`, `last`, `max`, `min`and `none`
`CultureName2AttributeDropDownDefinitionValueProcessor`	Resolves a source attribute to a valid language supported in the system
`NullIfEmptyStringProcessor`	Returns null if the source value is null or empty, if not it returns the trimmed value
`RegexIfMatchThenElseValueProcessor`	Returns the a value if a regex pattern matches the source attribute, if not another
`RegexReplaceValueProcessor`	Replaces the configured pattern in the source attribute
`StringFormatValueProcessor`	Formats the source attribute according to the input
`StringToDateTimeConversionProcessor`	Converts the source attribute to a date time
`SubPropertyValueProcessor`	Returns a sub property of a complex source attribute
`SubstringValueProcessor`	Returns a substring of the source attribute
`TrimValueProcessor`	Trims trailing and leading white spaces of a source attribute