Share via


How to: Create New Connectors or Rename Existing Connectors

When you project, join, or disconnect a CSEntry object to the metaverse or import attribute flow changes to the attribute values on the metaverse, the Provision method enables you to react to those changes. The method hosts the logic to create a connector to an MVEntry object, to rename or move a connector to an MVEntry object, or to disconnect and deprovision a connector to an MVEntry object.

The following examples show how to rename an existing connector or create a new connector for a CSEntry object by constructing a distinguished name that is based on attributes on the MVEntry object.

Public Sub Provision( _
    ByVal mventry As MVEntry) _
    Implements IMVSynchronization.Provision

    Dim container As String
    Dim rdn As String
    Dim FabrikamADMA As ConnectedMA
    Dim numConnectors As Integer
    Dim myConnector As CSEntry
    Dim csentry As CSEntry
    Dim dn As ReferenceValue

    ' Ensure that the cn attribute is present.
    If Not mventry("cn").IsPresent Then
        Throw New UnexpectedDataException("cn attribute is not present.")
    End If

    ' Determine the container and relative distinguished name 
    ' of the new connector space entry.
    container = "CN=users,DC=fabrikam,DC=com"
    rdn = "CN=" & mventry("cn").Value

    FabrikamADMA = mventry.ConnectedMAs("Fabrikam AD MA")
    dn = FabrikamADMA.EscapeDNComponent(rdn).Concat(container)

    numConnectors = FabrikamADMA.Connectors.Count

    ' If there is no connector present, create a new connector.
    If 0 = numConnectors Then
        csentry = FabrikamADMA.Connectors.StartNewConnector("user")
        csentry.DN = dn
        csentry.CommitNewConnector()

    ElseIf 1 = numConnectors Then

        ' Check if the connector has a different DN and rename if necessary.
        ' Get the connector.
        myConnector = FabrikamADMA.Connectors.ByIndex(0)

        ' <tla rid="fim_sync_short"/> will rename/move if different, if not,
        ' nothing will happen.
        myConnector.DN = dn
    Else
        Throw New UnexpectedDataException("multiple connectors:" + numConnectors.ToString)
    End If
End Sub
void IMVSynchronization.Provision(MVEntry mventry)
{
    string container;
    string rdn; 
    ConnectedMA FabrikamADMA; 
    int numConnectors;
    CSEntry myConnector;
    CSEntry csentry; 
    ReferenceValue dn; 

    // Ensure that the cn attribute is present.
    if(!mventry["cn"].IsPresent)
    {
        throw new UnexpectedDataException("cn attribute is not present.");
    }

    // Determine the container and relative distinguished name 
    // of the new connector space entry.
    container = "CN=users,DC=fabrikam,DC=com";
    rdn = "CN=" + mventry["cn"].Value;   

    FabrikamADMA = mventry.ConnectedMAs["Fabrikam AD MA"];
    dn = FabrikamADMA.EscapeDNComponent(rdn).Concat(container);

    numConnectors = FabrikamADMA.Connectors.Count;

    // If there is no connector present, create a new connector.
    if (numConnectors == 0)
    {
        csentry = FabrikamADMA.Connectors.StartNewConnector("user");
        csentry.DN = dn;
        csentry.CommitNewConnector();
    }

    else if (numConnectors == 1)
    {
        // Check if the connector has a different DN and rename if necessary.
        // Get the connector.
        myConnector = FabrikamADMA.Connectors.ByIndex[0];
        
        // <tla rid="fim_sync_short"/> will rename/move if different, if not,
        // nothing will happen.
        myConnector.DN = dn;
    }
    else
    {
        throw(new UnexpectedDataException("multiple connectors:" + numConnectors.ToString()));
    }
}

See Also

Reference

CSEntry
MVEntry

Concepts

Rules Extensions Examples
Using Rules Extensions