Share via

IMASynchronization.MapAttributesForImport Method

  • Article

Called to map attributes from a connector space entry to a metaverse entry.

Namespace: Microsoft.MetadirectoryServices
Assembly: Microsoft.MetadirectoryServicesEx (in Microsoft.MetadirectoryServicesEx.dll)

Usage

'Usage
Dim instance As IMASynchronization
Dim FlowRuleName As String
Dim csentry As CSEntry
Dim mventry As MVEntry

instance.MapAttributesForImport(FlowRuleName, csentry, mventry)

Syntax

'Declaration
Sub MapAttributesForImport ( _
    FlowRuleName As String, _
    csentry As CSEntry, _
    mventry As MVEntry _
)

void MapAttributesForImport (
    string FlowRuleName,
    CSEntry csentry,
    MVEntry mventry
)

void MapAttributesForImport (
    String^ FlowRuleName, 
    CSEntry^ csentry, 
    MVEntry^ mventry
)

void MapAttributesForImport (
    String FlowRuleName, 
    CSEntry csentry, 
    MVEntry mventry
)

function MapAttributesForImport (
    FlowRuleName : String, 
    csentry : CSEntry, 
    mventry : MVEntry
)

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 that is shown in Synchronization Service Manager. Forefront Identity Manager Synchronization Service (FIM Synchronization Service) uses these rules according to the state of the connector space object. Configure your rules based on the state of the object instead of the rules being called in a predetermined order.

  • csentry
    Contains a CSEntry object that represents the source connector space entry.
  • mventry
    Contains a CSEntry object that represents the destination metaverse entry.

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 that has precedence provides the attribute value. You set management agent precedence in the Metaverse Designer. For more information about setting management agent precedence, see the Forefront Identity Manager Synchronization Service 2010 Help on Microsoft TechNet.

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

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Target Platforms

Change History

See Also

Reference

IMASynchronization Interface
IMASynchronization Members
Microsoft.MetadirectoryServices Namespace
CSEntry Class
IMASynchronization Interface

Other Resources

Example: Handling Attribute Value Accumulation