Vytvoření vlastní úlohy

platí pro:SQL Server SSIS Integration Runtime ve službě Azure Data Factory

Postup vytvoření vlastní úlohy je podobný krokům pro vytvoření jakéhokoli jiného vlastního objektu pro integrační služby:

• Vytvořte novou třídu, která dědí ze základní třídy. Základní třída pro úlohu je Microsoft.SqlServer.Dts.Runtime.Task.

• Použijte atribut, který identifikuje typ objektu třídy. Pro úkol je DtsTaskAttributeatribut .

• Přepište implementaci metod a vlastností základní třídy. Pro úkol patří tyto metody Validate a Execute metody.

• Volitelně můžete vyvíjet vlastní uživatelské rozhraní. Pro úlohu to vyžaduje třídu, která implementuje IDtsTaskUI rozhraní.

Začínáme s vlastní úlohou

Vytváření projektů a tříd

Vzhledem k tomu, že všechny spravované úlohy jsou odvozeny od základní třídy Microsoft.SqlServer.Dts.Runtime.Task , prvním krokem při vytváření vlastního úkolu je vytvoření projektu knihovny tříd ve vašem upřednostňovaném spravovaném programovacím jazyce a vytvoření třídy, která dědí ze základní třídy. V této odvozené třídě přepíšete metody a vlastnosti základní třídy pro implementaci vlastní funkce.

Ve stejném řešení vytvořte projekt knihovny druhé třídy pro vlastní uživatelské rozhraní. Pro snadné nasazení se doporučuje samostatné sestavení pro uživatelské rozhraní, protože umožňuje aktualizovat a znovu nasadit správce připojení nebo jeho uživatelské rozhraní nezávisle.

Nakonfigurujte oba projekty tak, aby podepisovaly sestavení, která se budou generovat v době sestavení pomocí souboru klíče silného názvu.

Použití atributu DtsTask

DtsTaskAttribute Použijte atribut na třídu, kterou jste vytvořili, abyste ho identifikovali jako úkol. Tento atribut poskytuje informace o době návrhu, jako je název, popis a typ úkolu úkolu.

UITypeName Vlastnost slouží k propojení úlohy s vlastním uživatelským rozhraním. Chcete-li získat token veřejného klíče, který je vyžadován pro tuto vlastnost, použijete sn.exe -t k zobrazení tokenu veřejného klíče ze souboru páru klíčů (.snk), který chcete použít k podepsání sestavení uživatelského rozhraní.

using System;  
using Microsoft.SqlServer.Dts.Runtime;  
namespace Microsoft.SSIS.Samples  
{  
  [DtsTask  
  (  
   DisplayName = "MyTask",  
   IconResource = "MyTask.MyTaskIcon.ico",  
   UITypeName = "My Custom Task," +  
   "Version=1.0.0.0," +  
   "Culture = Neutral," +  
   "PublicKeyToken = 12345abc6789de01",  
   TaskType = "PackageMaintenance",  
   TaskContact = "MyTask; company name; any other information",  
   RequiredProductLevel = DTSProductLevel.None  
   )]  
  public class MyTask : Task  
  {  
    // Your code here.  
  }  
}  

Imports System  
Imports Microsoft.SqlServer.Dts.Runtime  
  
<DtsTask(DisplayName:="MyTask", _  
 IconResource:="MyTask.MyTaskIcon.ico", _  
 UITypeName:="My Custom Task," & _  
 "Version=1.0.0.0,Culture=Neutral," & _  
 "PublicKeyToken=12345abc6789de01", _  
 TaskType:="PackageMaintenance", _  
 TaskContact:="MyTask; company name; any other information", _  
 RequiredProductLevel:=DTSProductLevel.None)> _  
Public Class MyTask  
  Inherits Task  
  
  ' Your code here.  
  
End Class 'MyTask  

Sestavení, nasazení a ladění vlastní úlohy

Postup sestavení, nasazení a ladění vlastní úlohy v integračních službách se podobá krokům požadovaným pro jiné typy vlastních objektů. Další informace naleznete v tématu Sestavení, Nasazení a Ladění vlastních objektů.

Viz také

Vytvoření vlastní úlohy
Kódování vlastní úlohy
Vývoj uživatelského rozhraní pro vlastní úlohu