Microsoft Identity Integration Server 2003 Developer Reference

IMASynchronization.MapAttributesForImport

The MapAttributesForImport method is called to map attributes from a connector space entry to a metaverse entry.

[C#]
public void MapAttributesForImport(
  String FlowRuleName,
  CSEntry csentry,
  MVEntry mventry
);

[Visual Basic .NET]
Public Sub MapAttributesForImport( _
  ByVal FlowRuleName As String, _
  ByVal csentry As CSEntry, _
  ByVal mventry As MVEntry _
)
Implements IMASynchronization.MapAttributesForImport

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 source connector space entry.
mventry: Contains an MVEntry object that represents the destination metaverse entry.

Return Values

This method has no return values.

Exceptions

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

Remarks

For multiple import flow rules, the management agent with precedence provides the attribute value. You set management agent precedence in the Metaverse Designer. For more information about setting management agent precedence, see the Microsoft Identity Integration Server 2003 Help.

Attribute flow mapping is called only if a source attribute exists. When the last source attribute of an import attribute flow mapping has been deleted, the attribute flow rules is not called and the target attribute is automatically deleted.

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.