Developing Custom Objects for Integration Services

Nouveau : 14 avril 2006

When the control flow and data flow objects that are included with SQL Server 2005 Integration Services (SSIS) do not completely meet your requirements, you can develop many types of custom objects on your own including:

• Custom tasks.
• Custom connection managers.   Connect to external data sources that are not currently supported.
• Custom log providers.    Log package events in formats that are not currently supported.
• Custom enumerators.   Support iteration over a set of objects or values formats that are not currently supported.
• Custom data flow components.   Can be configured as sources, transformations, or destinations.

The Integration Services object model facilitates this custom development with base classes that provide a consistent and reliable framework for your custom implementation.

If you do not have to reuse custom functionality across multiple packages, the Script task and the Script component give you the full power of a managed programming language with significantly less infrastructure code to write. For more information, see Comparing Scripting Solutions and Custom Objects.

For working samples of each type of object, see Exemples de programmation.

Steps in Developing a Custom Object for Integration Services

When you develop a custom object for use in Integration Services, you develop a Class Library (a DLL) that will be loaded at design time and run time by SSIS Designer and by the Integration Services runtime. The most important methods that you must implement are not methods that you call from your own code, but methods that the runtime calls at appropriate times to initialize and validate your component and to invoke its functionality.

Here are the steps that you follow in developing a custom object:

1. Create a new project of type Class Library in your preferred managed programming language.
2. Inherit from the appropriate base class, as shown in the following table.
3. Apply the appropriate attribute to your new class, as shown in the following table.
4. Override the methods of the base class as required and write code for the custom functionality of your object.
5. Optionally, build a custom user interface for your component. For ease of deployment, you may want to develop the user interface as a separate project within the same solution, and to build it as a separate assembly.
6. Build, deploy, and debug your new custom object as described in Building, Deploying, and Debugging Custom Objects.

Base Classes, Attributes, and Important Methods

This table provides an easy reference to the most important elements in the Integration Services object model for each type of custom object that you can develop.

Custom object	Base class	Attribute	Important methods
Task	Task	DtsTaskAttribute	Execute
Connection manager	ConnectionManagerBase	DtsConnectionAttribute	AcquireConnection, ReleaseConnection
Log provider	LogProviderBase	DtsLogProviderAttribute	OpenLog, Log, CloseLog
Enumerator	ForEachEnumerator	DtsForEachEnumeratorAttribute	GetEnumerator
Data flow component	PipelineComponent	DtsPipelineComponentAttribute	ProvideComponentProperties, PrimeOutput, ProcessInput

Providing a Custom User Interface

To allow users of your custom object to configure its properties, you may have to develop a custom user interface also. In those cases where a custom user interface is not strictly required, you may choose to create one to provide a more user-friendly interface than the default editor.

In a custom user interface project or assembly, you generally have two classes —a class that implements an Integration Services interface for user interfaces for the specific type of custom object, and the Windows form that it displays to gather information from the user. The interfaces that you implement have only a few methods, and a custom user interface is not difficult to develop.

Remarque :

Many Integration Services log providers have a custom user interface that implements IDtsLogProviderUI and replaces the Configuration text box with a filtered drop-down list of available connection managers. However custom user interfaces for custom log providers are not implemented in this release of SQL Server 2005 Integration Services (SSIS). Specifying a value for the UITypeName property of the DtsLogProviderAttribute has no effect.

The following table provides an easy reference to the interfaces that you must implement when you develop a custom user interface for each type of custom object. It also explains what the user sees if you choose not to develop a custom user interface for your object, or if you fail to link your object to its user interface by using the UITypeName property in the object's attribute. Although the powerful Advanced Editor may be satisfactory for a data flow component, the Properties window is a less user-friendly solution for tasks and connection managers, and a custom ForEach enumerator cannot be configured at all without a custom form.

Custom object	Base class for user interface	Default editing behavior if no custom user interface is provided
Task	IDtsTaskUI	Properties window only
Connection manager	IDtsConnectionManagerUI	Properties window only
Log provider	IDtsLogProviderUI (Not implemented in SQL Server 2005 Integration Services (SSIS).)	Text box in Configuration column
Enumerator	ForEachEnumeratorUI	Properties window only. Enumerator Configuration area of editor is empty.
Data flow component	IDtsComponentUI	Advanced Editor

Voir aussi

Tâches

Building, Deploying, and Debugging Custom Objects

Concepts

Persisting Custom Objects

Aide et Informations

Assistance sur SQL Server 2005