Microsoft Identity Integration Server 2003 Developer Reference |
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:
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:
Public Class Sample_Visual_Basic_MA_Extension Implements IMASynchronization
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:
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
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(); } }