Example: Creating a New Connector or Renaming an Existing Connector [MIIS]

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 IMVSynchronization.Provision method provides you with the opportunity 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 example shows how to use the Visual Basic .NET and C# programming languages to rename an existing connector or create a new connector for a CSEntry object by constructing a distinguished name based on attributes on the MVEntry object.

[Visual Basic .NET]

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)

		' Microsoft Identity Integration Server&nbsp;2003 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

[C#]

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];
	
		// Microsoft Identity Integration Server&nbsp;2003 will rename/move if different, if not, nothing will happen.
		myConnector.DN = dn;
}
	else
	{
		throw(new UnexpectedDataException("multiple connectors:" + numConnectors.ToString()));
}
}