ResourceCorrelationRule
A correlation rule correlates resources, linking them to their owners.
Examples
Correlation based on unchanged attributes
The following example creates an Active Directory correlation rule based on the mail property:
<ResourceCorrelationRule ResourceType="AD_Entry_To_Directory_UserRecord" TargetBinding="Directory_UserRecord:Mail" Policy="Default" SourceMatchedConfidenceLevel="100" SourceBinding="AD_Entry:mail" />
Correlation based on attributes changed by a function
The following example copies the previous example (based on unchanged attributes), but using a predefined function (ToLower) in source and target bindings' expressions, to compare the email attributes:
<ResourceCorrelationRule ResourceType="AD_Entry_To_Directory_UserRecord" TargetBinding="Mail" TargetExpression="ToLower" Policy="Default" SourceMatchedConfidenceLevel="100" SourceBinding="mail" SourceExpression="ToLower" />
note
A list of predefined functions is available.
Correlation based on attributes within a C# expression
The following example creates an Active Directory correlation rule based on the comparison between the AD's simplified display name and an expression from the external system:
<ResourceCorrelationRule ResourceType="AD_Entry_NominativeUser" TargetBinding="displayName" TargetExpression="Simplify" Policy="Default" SourceMatchedConfidenceLevel="80" SourceExpression="C#:person:return (person.LastName + person.FirstName).Simplify();" />
This example also uses a confidence rate of 80%.
Properties
| Property | Details |
|---|---|
| Policy required | Type: Int64 Description: Identifier of the policy that the rule is part of. |
| ResourceType required | Type: Int64 Description: Identifier of the resource type. |
| SourceBinding optional | Type: Int64 Description: Binding property from the source system. |
| SourceExpression optional | Type: String Description: Binding expression based on properties from the source system. See C# expressions for details. |
| SourceMatchedConfidenceLevel default value: 0 | Type: Int32 Description: Defines the correlation confidence rate of this rule. If the value is less than 100, a manual review step confirms the choice. |
| TargetBinding optional | Type: Int64 Description: Binding property from the target system. |
| TargetExpression optional | Type: String Description: Binding expression based on properties from the target system. See C# expressions for details. |