Microsoft Identity Integration Server 2003 Developer Reference

Creating a Management Agent Rules Extension

A management agent rules extension must implement the IMASynchronization interface. The contents of IMASynchronization are specified in the Microsoft.MetadirectoryServices namespace and include the following methods:

Creating a Management Agent Rules Extension Project

There are two ways to create a rules extension in a Visual Studio .NET project. In either case, use a unique name for each source code file that you use to create your rules extensions. It is much easier to search for the line of code that is causing an error if you use unique file names.

The following example shows a class declaration for a management agent rules extension:

[Visual Basic .NET]
Public Class Sample_Visual_Basic_MA_Extension
	Implements IMASynchronization
[C#]
namespace Sample_CSharp_MA_Extension
{
	public class MyMAExtensionClass : IMASynchronization
	{
}
}

When you implement an interface, you must implement all of the methods defined by that interface. This means that when you create a management agent rules extension, you must also implement, at a minimum, all methods listed above.

The following example shows an entire class declaration for a management agent rules extension:

[Visual Basic .NET]
Public Class Sample_Visual_Basic_MA_Extension
	Implements IMASynchronization

	Public Sub Initialize() Implements IMASynchronization.Initialize
		' TODO: Add initialization code here
	End Sub

	Public Sub Terminate() Implements IMASynchronization.Terminate
		' TODO: Add termination code here
	End Sub

	Public Function ShouldProjectToMV(ByVal csentry As CSEntry, ByRef MVObjectType As String) As Boolean Implements IMASynchronization.ShouldProjectToMV
		' TODO: Remove this throw statement if you implement this method
		Throw New EntryPointNotImplementedException()
	End Function

	Public Function FilterForDisconnection(ByVal csentry As CSEntry) As Boolean Implements IMASynchronization.FilterForDisconnection
		' TODO: Add stay-disconnector code here
		Throw New EntryPointNotImplementedException()
	End Function

	Public Sub MapAttributesForJoin(ByVal FlowRuleName As String, ByVal csentry As CSEntry, ByRef values As ValueCollection) Implements IMASynchronization.MapAttributesForJoin
		' TODO: Add join mapping code here
		Throw New EntryPointNotImplementedException()
	End Sub

	Public Function ResolveJoinSearch(ByVal joinCriteriaName As String, ByVal csentry As CSEntry, ByVal rgmventry() As MVEntry, ByRef imventry As Integer, ByRef MVObjectType As String) As Boolean Implements IMASynchronization.ResolveJoinSearch
		' TODO: Add join resolution code here
		Throw New EntryPointNotImplementedException()
	End Function

	Public Sub MapAttributesForImport(ByVal FlowRuleName As String, ByVal csentry As CSEntry, ByVal mventry As MVEntry) Implements IMASynchronization.MapAttributesForImport
		' TODO: write your import attribute flow code
				Throw New EntryPointNotImplementedException()
	End Sub

	Public Sub MapAttributesForExport(ByVal FlowRuleName As String, ByVal mventry As MVEntry, ByVal csentry As CSEntry) Implements IMASynchronization.MapAttributesForExport
		' TODO: Add export attribute flow code here
		Throw New EntryPointNotImplementedException()
	End Sub

	Public Function Deprovision(ByVal csentry As CSEntry) As DeprovisionAction Implements IMASynchronization.Deprovision
		' TODO: Remove this throw statement if you implement this method
		Throw New EntryPointNotImplementedException()
	End Function
End Class
[C#]
 public class MAExtensionObject : IMASynchronization
		{
				public MAExtensionObject()
				{
			//
			// TODO: Add constructor logic here
			//
	}
				void IMASynchronization.Initialize ()
				{
			//
			// TODO: write initialization code
			//
	}

		void IMASynchronization.Terminate ()
		{
			//
			// TODO: write termination code
			//
	}

		bool IMASynchronization.ShouldProjectToMV (CSEntry csentry, out string MVObjectType)
		{
						//
						// TODO: Remove this throw statement if you implement this method
						//
						throw new EntryPointNotImplementedException();
			}

		DeprovisionAction IMASynchronization.Deprovision (CSEntry csentry)
		{
						//
						// TODO: Remove this throw statement if you implement this method
						//
						throw new EntryPointNotImplementedException();
	}	 

		bool IMASynchronization.FilterForDisconnection (CSEntry csentry)
		{
			//
			// TODO: write disconnection filter code
			//
			throw new EntryPointNotImplementedException();
			}

				void IMASynchronization.MapAttributesForJoin (string FlowRuleName, CSEntry csentry, ref ValueCollection values)
		{
			//
			// TODO: write join mapping code
			//
			throw new EntryPointNotImplementedException();
	}

		bool IMASynchronization.ResolveJoinSearch (string joinCriteriaName, CSEntry csentry, MVEntry[] rgmventry, out int imventry, ref string MVObjectType)
		{
			//
			// TODO: write join resolution code
			//
			throw new EntryPointNotImplementedException();
			}

		void IMASynchronization.MapAttributesForImport( string FlowRuleName, CSEntry csentry, MVEntry mventry)
		{
			//
			// TODO: write your import attribute flow code
			//
			throw new EntryPointNotImplementedException();
	}

		void IMASynchronization.MapAttributesForExport (string FlowRuleName, MVEntry mventry, CSEntry csentry)
		{
			//
						// TODO: write your export attribute flow code
						//
			throw new EntryPointNotImplementedException();
	}
	}