Creating a Connected Data Source Extension in C#

To create a password extension project, copy the Microsoft.MetadirectoryServices assembly to your development system and manually create a reference to the assembly.

You can find the assembly in the bin\assemblies folder of the MIIS program folder. The default folder for Microsoft Identity Integration Server 2003 Service Pack 1 is C:\Program Files\Microsoft Identity Integration Server\bin\assemblies\.

To create a connected data source extension, complete the following steps:

1. Create a new C# class library project
2. Add a reference to the Microsoft.MetadirectoryServices assembly
3. Implement the interfaces
4. Build the class library
5. Install the connected data source extension in the extensions folder (optional)

To create a new C# class library project using Visual Studio .NET

1. Click Start, point to All Programs, and then click Visual Studio .NET 2003.

   The Microsoft Visual Studio .NET 2003 development environment appears.

2. On the File menu, point to New, and then click Project.
3. In the New Project dialog box, in Project Types, click C# Projects.
4. On the Template menu, click Class Library.
5. In the Name box, type the name of the rules extension that you are creating, rules extension, and then click k Browse.
6. Browse to the location where you want to store the project files, click Open, and then click OK.

   The name of the new project now appears in Solution Explorer.

To add a reference to the Microsoft.MetadirectoryServices assembly

1. On the Project menu in Visual Studio .NET 2003, click Add Reference.
2. In the .NET tab of the Add Reference dialog box, click Microsoft.MetadirectoryServices, and then click Select. If the file does not appear in the Selected Components list, click Browse. In the Selected Components dialog box, go to the folder with the assembly file, click Microsoft.MetadirectoryServices.dll, and then click Open.

   Verify that Microsoft.MetadirectoryServices.dll appears in the Selected Components list of the Add Reference dialog box.

3. Click OK to close the Add Reference dialog box.

   In Solution Explorer, Microsoft.MetadirectoryServices now appears as one of the references.

For the import interface, implement the IMAExtensibleFileImport interface. For the export interface for a call-based data source, implement the IMAExtensibleCallExport interface. For the export interface for a file-based data source, import the IMAExtensibleFileExport interface.

To implement the interfaces

1. Add using Microsoft.MetadirectoryServices; to the declarations section above the namespace in the source code.
2. Change Class1 to the name of your class by adding : IMAExtensibleFile Import,. For example, if the class name is SampleMAFileExport then the class declaration would be public class SampleMAFileExport : IMAExtensibleFileImport,.
3. Add the name of the other interface you have to implement. For example, if you are creating a file-based connected data source extension, then you need to implement the IMAExtensibleFileExport interface. The class declaration would be public class SampleMAFileExport : IMAExtensibleFileImport, IMAExtensibleFileExport.
4. Add the following code to implement the IMAExtensibleFileImport interface.

   public void GenerateImportFile( 
   	string					filename, 
   	string					connectTo, 
   	string					user, 
   	string					password, 
   	ConfigParameterCollection   configParameters,
   	bool						fullImport, 
   	TypeDescriptionCollection   types,
   	ref string				customData 
   	)
   
   {
   
   }
   

5. Add the following code to implement the IMAExtensibleFileExport interface to export data to a call-based data source:

   public void DeliverExportFile(
     string fileName,
     string connectTo,
     string user,
     string password,
     ConfigParameterCollection configParameters
   )
   
   {
   
   }
   

   If you are implementing the IMAExtensibleCallExport interface to export data to a call-based data source, then change the code as appropriate.

To build the class library

This procedure is optional. You can set Visual Studio .NET 2003 to install the connected data source extension automatically in the extensions folder as part of the build process.

To install the connected data source extension in the extensions folder

1. In Solution Explorer, click your class library project.
2. On the View menu, click Property Pages.

   There are two folders in the Property Pages dialog box: Common Properties and Configuration Properties.

3. Open the Configuration Properties folder. In the Configuration drop-down list box, click All Configurations.
4. In the left pane of the Property Pages dialog box, click Build.
5. In Output Path, type the name of the rules extensions folder or browse to the location of the rules extensions folder.

   The default folder for rules extensions is C:\Program Files\Microsoft Identity Integration Server\Extensions.

6. Click OK to close the Property Pages dialog box.

See Also

Example: Connected Data Source Extension for Call-Based Data Sources, Example: Connected Data Source Extension for File-Based Data Sources