IMAExtensibleFileImport::GenerateImportFile Method


The IMAExtensibleFileImport.GenerateImportFile(String, String, String, String, ConfigParameterCollection, Boolean, TypeDescriptionCollection, ref String) method is called during an import run to connect to the data source and generate a file that contains the data to be imported from a connected directory to the connector space.

Syntax


public void GenerateImportFile(
  String fileName,
  String connectTo,
  String user,
  String password,
  ConfigParameterCollection configParameters,
  Boolean fFullImport,
  TypeDescriptionCollection types,
  ref String customData
);


Public Sub GenerateImportFile( _
  ByVal fileName As String, _
  ByVal connectTo As String, _
  ByVal user As String, _
  ByVal password As String, _
  ByVal configParameters As ConfigParameterCollection, _
  ByVal fFullImport As Boolean, _
  ByVal types As TypeDescriptionCollection, _
  ByRef customData As String _
)
Implements IMAExtensibleFileImport.GenerateImportFile

Parameters

fileName

The name of the intermediate file that contains the data from a connected directory to be imported to the connector space. This value comes from Output file name: in Management Agent Configuration of Configure Run Profile when you create a run profile with a Export type step for an extensible connectivity management agent.

connectTo

The name of the connected directory. This value comes from Connect To: in Connect To of the Configure Connection Information in the extensible connectivity management agent properties.

user

The user name of the account with the appropriate privileges on the connected directory. This value comes from User: in Connect To of the Configure Connection Information in the extensible connectivity management agent properties.

password

The password of the account with the appropriate privileges on the connected directory. This value comes from Password: in Connect To of the Configure Connection Information in the extensible connectivity management agent properties.

configParameters

The parameters and values configured in Configure Additional Parameters of the extensible connectivity management agent properties.

fFullImport

The value for a full or delta import. Set to true for a full import or false for a delta import.

types

The collection of TypeDescription objects. Each TypeDescription object represents a description of a Type class that contains a collection of attribute descriptions.

customData

Arbitrary string information that can be retrieved in a subsequent import run. Use this parameter to store a watermark to enable delta import runs. Embedded nulls are not supported. To use binary information in this parameter, encode the information to Base 64 and then decode the data.

Return Value

This method does not return a value.

Exceptions

Exception typeCondition
BadServerCredentialsException

The credentials that are used to connect to the connected directory are not valid. When this exception is thrown by this method, the run stops and the WMI Provider returns the string stopped-bad-server-credentials.

This exception does not generate an event log entry.

EntryPointNotImplementedException

The rules extension does not implement this method. When this exception is thrown by this method, the run stops and the WMI Provider returns the string stopped-entry-point-not-implemented.

This exception does not generate an event log entry.

ExtensibleExtensionException

An unexpected error occurred in the extension. When this exception is thrown by this method, the run stops and the WMI Provider returns the string stopped-extensible-extension-error.

This exception generates an event log entry.

ServerDownException

The connected directory extension cannot establish a connection to the connected directory. When this exception is thrown by this method, the run stops and the WMI Provider returns the string stopped-server-down.

This exception does not generate an event log entry.

UnexpectedDataException

The method received unexpected data. When this exception is thrown by this method, the run stops and the WMI Provider returns the string stopped-unexpected-data.

This exception generates an event log entry.

Remarks

All the exceptions described in this topic stop a run. If the method throws an exception that is not described in this topic, the run continues. If the run stops, the WMI Provider returns the string stopped-extension-dll-exception and generates an event log entry.

All data in ILM 2007 FP1 uses the Unicode character set. If the connected data source that imports the data into the metaverse uses a different character set, use this method to convert the imported data to the Unicode character set.

The Extensible Management Agent is configured to use the file that is created by IMAExtensibleFileImport.GenerateImportFile as a Unicode file. The IMAExtensibleFileImport.GenerateImportFile function should therefore create a Unicode file, even when the connected source is not Unicode-encoded.

Watermark data can be passed to the customData parameter. Do not rely upon watermark data to be accurate in the customData parameter. The watermark data can remain even after the connector space has been deleted. Instead of relying upon the watermark data in this parameter, create the watermark in this method.

Examples

Example: Connected Data Source Extension for File-Based Data Sources contains code example that implement this interface.

Requirements

ProductMicrosoft Identity Integration Server 2003 SP1
NamespaceMicrosoft.MetadirectoryServices
AssemblyMicrosoft.MetadirectoryServices
.NET Framework.NET Framework 2.0

See Also

IMAExtensibleFileImport
ConfigParameterCollection
TypeDescriptionCollection


Send comments about this topic to Microsoft

Build date: 2/16/2009

Show: