Microsoft Identity Integration Server 2003 Developer Reference

IMASynchronization.MapAttributesForJoin

The MapAttributesForJoin method generates a list of values based on the CSEntry attribute values that will be used to search the metaverse.

[C#]
public void MapAttributesForJoin(
  String FlowRuleName,
  CSEntry csentry,
  ref ValueCollection values
);

[Visual Basic .NET]
Public Sub MapAttributesForJoin( _
  ByVal FlowRuleName As String, _
  ByVal csentry As CSEntry, _
  ByRef values As ValueCollection _
)
Implements IMASynchronization.MapAttributesForJoin

Parameters

FlowRuleName: Contains the name of the flow rule. You must use only alphanumeric characters for the FlowRuleName parameter, otherwise you can encounter problems in a rules extension.
Note Flow rules are not executed in the order shown in Identity Manager. Identity Integration Server uses these rules according to the state of the connector space object. Configure your rules based on the state of the object rather than the rules being called in a predetermined order.
csentry: Contains a CSEntry object that represents the connector space entry.
values: Contains a ValueCollection object that receives the list of attribute values generated by this method to be used to search the metaverse.

Return Values

This method has no return values.

Exceptions

Exception type	Condition
DeclineMappingException	The method cannot produce a mapping for the attribute.
EntryPointNotImplementedException	The rules extension does not implement this method.
UnexpectedDataException	The method received unexpected data.

Remarks

Use this method to convert attribute values to a format used in the metaverse. For example, the metaverse stores the full name attribute as a single string made up of the first name and last name while the connected data source stores a first name and a last name as separate attributes. You can use this method to combine a first name and last name into a single string that can be used to search the full name attribute in the metaverse.

Requirements

Product: Microsoft Identity Integration Server 2003
Namespace: Defined in Microsoft.MetadirectoryServices.
Assembly: Requires Microsoft.MetadirectoryServices (in Microsoft.MetadirectoryServices.dll).
.NET Framework: Requires .NET Framework 1.1.