Ejemplo para crear una tarea incremental personalizada

  • Artículo

Actualizado: 5 de diciembre de 2005

El ejemplo Increment Task muestra cómo crear tareas personalizadas y sus interfaces de usuario relacionadas mediante programación. Este ejemplo no es compatible con los sistemas operativos basados en Itanium. El ejemplo de código implementa la siguiente funcionalidad:

  • Reemplazo de la clase base Microsoft.SqlServer.Dts.Runtime.Task
  • Validación
  • Ejecución
  • Soporte de persistencia
  • Soporte de puntos de interrupción
  • Eventos personalizados

Este ejemplo de código en particular entra en un bucle durante la ejecución. Una variable de entero privada se incrementa en cada iteración del bucle. Las propiedades InitialValue, IncrementValue, y LoopCount controlan el procesamiento del bucle. Estas propiedades se configuran mediante la interfaz de usuario personalizada que la tarea implementa. Los puntos de interrupción personalizados OnBeforeIncrement y OnAfterIncrement y sus eventos se producen antes y después de que se incremente la variable. La propiedad ExecutionResult contiene el valor de la variable interna incrementada después de que la tarea haya terminado de ejecutarse.

ms160699.note(es-es,SQL.90).gifImportante:
Los ejemplos se proporcionan exclusivamente con fines formativos. No se han diseñado para utilizarse en un entorno de producción y no se han probado en ningún entorno de este tipo. Microsoft no ofrece soporte técnico para estos ejemplos.

Ejecutar el ejemplo

Si ya sabe cómo ubicar, generar e instalar ejemplos de código, puede pasar directamente a la sección Probar el ejemplo y leer acerca de la configuración y ejecución del ejemplo de código.

Requisitos previos

Antes de ejecutar este ejemplo de código, asegúrese de cumplir las condiciones siguientes:

  • El paquete de ejemplo y sus datos de ejemplo asociados se deben instalar primero en el disco duro local. Para obtener más información, vea la el tema acerca de la instalación y compilación de ejemplos de código de Integration Services en los Libros en pantalla.
  • Microsoft Visual Studio 2005
  • Microsoft SQL Server 2005 Integration Services

Ubicación

Si el ejemplo de código se instaló en la ubicación predeterminada, estará en el siguiente directorio:

C:\Archivos de programa\Microsoft SQL Server\100\Ejemplos\Integration Services\\Programming Samples\Control Flow\IncrementTask Sample

La solución C# para el ejemplo de código está ubicada en el directorio CS y la solución Visual Basic, en el directorio VB.

Para obtener información acerca del proceso de dos pasos necesario para instalar los ejemplos, vea Instalar ejemplos. Para obtener la última versión de los ejemplos, incluidos aquéllos comercializados tras la versión comercial original de SQL Server 2005, vea el artículo acerca de ejemplos y bases de datos de ejemplo de SQL Server 2005 publicado en abril de 2006.

Generar el ejemplo

Si aún no ha generado un archivo de clave de nombre seguro en la carpeta Samples, siga este procedimiento para generarlo. Los proyectos de ejemplo se configuran en la ficha Firma del cuadro de diálogo Propiedades del proyecto para firmar los ensamblados en tiempo de generación con este archivo de clave.

Para generar un archivo de clave de nombre seguro

  1. Para abrir un símbolo del sistema de Microsoft Visual Studio 2005, haga clic en Inicio, seleccione Todos los programas, seleccione Microsoft Visual Studio 2005, Visual Studio Tools y, después, haga clic en Símbolo del sistema de Visual Studio 2005.

    O bien

    Para abrir un símbolo del sistema de Microsoft .NET Framework, haga clic en Inicio, seleccione Todos los programas, seleccione Microsoft .NET Framework SDK v2.0 y haga clic en SDK Command Prompt.

  2. En el símbolo del sistema, utilice el comando de cambio de directorio (CD) para cambiar la carpeta actual de la ventana del símbolo del sistema a la carpeta Samples. El archivo de clave que cree en esta carpeta se usará en todos los ejemplos de código de Microsoft SQL Server 2005.

    [!NOTA] Para determinar la carpeta donde se encuentran los ejemplos, haga clic en Inicio, seleccione Todos los programas, Microsoft SQL Server 2005, Documentación y tutoriales y, a continuación, haga clic en el directorio Ejemplos. Si se usó la ubicación de instalación predeterminada, los ejemplos se encuentran en <unidadDelSistema>:\Archivos de programa\Microsoft SQL Server\90\Samples.

  3. En el símbolo del sistema, ejecute el comando siguiente para generar el archivo de clave:

    sn -k SampleKey.snk

    ms160699.note(es-es,SQL.90).gifImportante:
    Para obtener más información acerca del par de claves de nombre seguro, vea el apartado sobre informes de seguridad de nombres seguros y seguridad en .NET Framework en el centro de desarrollo de .NET de MSDN.

  4. Necesitará el símbolo (token) de clave pública del archivo de clave en un paso posterior. Para obtener el símbolo de clave pública, extraiga primero la clave pública del archivo de clave ejecutando el comando siguiente en el símbolo del sistema:

    sn -p SampleKey.snk SampleKeyPublic.snk

  5. Muestre el símbolo de clave pública ejecutando el comando siguiente en el símbolo del sistema:

    sn -t SampleKeyPublic.snk

  6. Copie el símbolo de clave pública al Portapapeles o guárdelo para usarlo posteriormente.

Para generar el ejemplo

  1. Abra Microsoft Visual Studio 2005.

  2. En el menú Archivo | Abrir, haga clic en Proyecto y abra IncrementTask.sln en el directorio de ejemplos que desee: CS para el lenguaje C# o VB para Visual Basic.

  3. En el Explorador de soluciones, seleccione el código de IncrementTask.cs o IncrementTask.vb.

  4. En el código, busque el atributo DtsTask. En esa línea de código, reemplace el valor existente del símbolo de clave pública en la propiedad del atributo UITypeName en IncrementTask.cs. El valor alfanumérico después de "PublicKeyToken =" se debe reemplazar con el valor mostrado en el paso anterior.

  5. Haga clic en Generar / Generar IncrementTask en el menú para generar la DLL para el proyecto.

Instalar el ejemplo

Este ejemplo se proporciona en Visual Basic y C#. Para distinguir los ensamblados para cada versión del ejemplo, el nombre del ensamblado de salida lleva anexado CS o VB. Una vez que haya generado correctamente el componente, siga los pasos que se indican a continuación para agregarlo a una tarea Flujo de control en Business Intelligence Development Studio.

Para instalar el componente en la caché de ensamblados global (GAC) arrastrando y colocando el ensamblado

  1. Copie el ensamblado (IncrementTaskCS.dll o IncrementTaskVB.dll) en la carpeta que se encuentra en %system%\Archivos de programa\Microsoft SQL Server\90\DTS\Tasks.

  2. Con otra ventana, abra el directorio de la caché de ensamblados global en %system%\assembly. En la mayoría de equipos, será C:\Windows\assembly.

  3. Seleccione el ensamblado en la primera ventana y, a continuación, arrástrelo a la ventana que contiene la carpeta assembly.

Para instalar el componente en la caché de ensamblados global mediante gacutil.exe

  1. Abra una ventana de símbolo del sistema.

  2. Escriba el siguiente comando para instalar la versión C# del componente y la interfaz de usuario en la caché de ensamblados global:

    gacutil.exe -iF "``C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\IncrementTask Sample\CS\bin\Debug\IncrementTaskCS.dll"

  3. Escriba el siguiente comando para instalar la versión de Visual Basic del componente y la interfaz de usuario en la caché de ensamblados global:

    gacutil.exe -iF "``C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\IncrementTask Sample\VB\bin\Debug\IncrementTaskVB.dll"

Nota   Para simplificar, la interfaz de usuario de este ejemplo se ha colocado en el mismo proyecto que el código de tarea. Por lo tanto, basta con copiar la DLL en el directorio del ensamblado. Si decide codificar la interfaz del usuario en un proyecto diferente, deberá agregar la DLL que contiene la interfaz de usuario a la caché global de ensamblados, así como la DLL que contiene el código. Sólo se debe compilar el código en un directorio específico.

Probar el ejemplo

Puede probar la tarea de ejemplo en el Diseñador de SSIS si sigue estos pasos.

Para usar el ejemplo en Business Intelligence Development Studio

  1. Abra Business Intelligence Development Studio.

  2. En el menú, haga clic en Archivo / Nuevo / Proyecto.

  3. En el cuadro de diálogo Nuevo proyecto, en Tipos de proyecto, haga clic en Proyectos de Business Intelligence y, en el panel derecho, haga clic en Proyecto de Integration Services.

  4. En el cuadro Nombre, escriba IncrementTask como nombre del nuevo proyecto.

  5. En el cuadro Ubicación, seleccione la ubicación donde desea guardar el archivo. Haga clic en Aceptar.

  6. En el cuadro de diálogo Explorador de soluciones, haga doble clic en Package.dtsx.

  7. En el cuadro de herramientas Elementos de flujo de control, haga clic con el botón secundario en cualquier parte del área donde se enumeran los Elementos de flujo de control. Haga clic en Elegir elementos.

  8. Haga clic en la ficha Elementos de flujo de control SSIS. Desplácese hacia abajo y seleccione el elemento IncrementTaskCS o IncrementTaskVB. Haga clic en Aceptar. La tarea IncrementTask ahora debe estar visible en el cuadro de herramientas Elementos de flujo de control.

  9. Agregue IncrementTask a la superficie de flujo de control del paquete haciendo doble clic en la tarea o arrastrando la tarea a la superficie de Flujo de control.

  10. Una vez que la tarea se encuentre en la superficie de diseño, haga doble clic en la tarea para abrir el editor. Establezca Cuenta de bucle en 5 y Valor de incremento en 1.

  11. Haga clic en Listo.

  12. Ejecute el paquete.

  13. Cuando el paquete haya terminado, vea la ficha Resultados de la ejecución del diseñador.

Historial de cambios

Versión Historial

5 de diciembre de 2005
Contenido modificado:
  • Se agregaron pasos para crear una clave.