Configurando o componente Script no Editor de Componentes de Script

A página Colunas de Entrada do Editor de Transformação Scripts é exibida para transformações e destinos, mas não para origens. Nessa página, você seleciona as colunas de entrada disponíveis a serem disponibilizadas para seu script personalizado, e especifica o acesso somente leitura ou de leitura/gravação a elas.

No projeto de código que será gerado com base nesses metadados, o item de projeto BufferWrapper contém uma classe para cada entrada. Essa classe contém propriedades de acessador tipado para cada coluna de entrada selecionada. Por exemplo, se você selecionar uma coluna de inteiros CustomerID e uma coluna de cadeia de caracteres CustomerName de uma entrada nomeada CustomerInput, o item de projeto BufferWrapper conterá uma classe CustomerInput que deriva de ScriptBuffer, e a classe CustomerInput exporá uma propriedade de inteiro nomeada CustomerID e uma propriedade de cadeia de caracteres nomeada CustomerName. Essa convenção permite escrever código com verificação de tipo, conforme mostrado a seguir:

Dim currentCustomerID as Integer = CustomerInput.CustomerID
Dim currentCustomerName as String = CustomerInput.CustomerName

Para obter mais informações sobre como configurar colunas de entrada para um tipo específico de componente de fluxo de dados, consulte o exemplo apropriado em Desenvolvendo tipos específicos de componentes Script.

A página Entradas e Saídas do Editor de Transformação Scripts é exibida para origens, transformações e destinos. Nessa página, você adiciona, remove e configura entradas, saídas e colunas de saída a serem usadas no seu script personalizado, dentro das seguintes limitações:

• Quando usado como uma origem, o componente Script não possui entrada e dá suporte a várias saídas.

• Quando usado como uma transformação, o componente Script dá suporte a uma entrada e a várias saídas.

• Quando usado como um destino, o componente Script dá suporte a uma entrada e não possui saídas.

No projeto de código que será gerado com base nesses metadados, o item de projeto BufferWrapper contém uma classe para cada entrada e saída. Por exemplo, se você criar uma saída nomeada CustomerOutput, o item de projeto BufferWrapper conterá uma classe CustomerOutput que deriva de ScriptBuffer, e a classe CustomerOutput conterá propriedades do acessador tipado para cada coluna de saída criada.

Você só pode configurar colunas de saída na página Entradas e Saídas. Você pode selecionar colunas de entrada para transformações e destinos na página Colunas de Entrada. As propriedades de acessador tipado criadas para você no item de projeto BufferWrapper serão somente para gravação em colunas de saída. As propriedades do acessador para colunas de entrada serão somente leitura ou de leitura/gravação, dependendo do tipo de uso selecionado para cada coluna na página Colunas de Entrada.

Para obter mais informações sobre como configurar entradas e saídas para um tipo específico de componente de fluxo de dados, consulte o exemplo apropriado em Desenvolvendo tipos específicos de componentes Script.

Observação

Embora não seja possível configurar diretamente uma saída como uma saída de erro no componente Script para manipular automaticamente as linhas de erro, você pode reproduzir a funcionalidade de uma saída de erro criando uma saída adicional e usando o script para direcionar linhas a essa saída quando apropriado. Para obter mais informações, consulte Simulando uma saída de erro para o componente Script.

Propriedades de saída ExclusionGroup e SynchronousInputID

A propriedade ExclusionGroup possui um valor diferente de zero somente em transformações com saídas síncronas, onde seu código executa a filtragem ou cria ramificações e direciona cada linha para uma das saídas que compartilham o mesmo valor ExclusionGroup diferente de zero. Por exemplo, a transformação pode direcionar linhas para a saída padrão ou para uma saída de erro. Ao criar saídas adicionais para este cenário, certifique-se de que tenha definido o valor da propriedade SynchronousInputID como o inteiro que corresponde ao ID da entrada do componente.

A propriedade SynchronousInputID só tem um valor diferente de zero em transformações com saídas síncronas. Se o valor dessa propriedade for zero, significa que a saída é assíncrona. Para uma saída síncrona, em que linhas são transmitidas às saídas selecionadas sem adicionar novas linhas, essa propriedade deve conter a ID da entrada do componente.

Observação

Quando o Editor de Transformação de Scripts cria a primeira saída, ele define a propriedade SynchronousInputID da saída para o ID da entrada do componente. Porém, quando o editor cria saídas subseqüentes, ele define as propriedades SynchronousInputID dessas saídas como zero. Se você estiver criando um componente com saídas síncronas, cada saída deverá ter sua propriedade SynchronousInputID definida como a ID da entrada do componente. Portanto, cada saída criada pelo editor depois da primeira saída precisa mudar seu valor SynchronousInputID de zero para a ID da entrada do componente. Se você estiver criando um componente com saídas assíncronas, cada saída deverá ter sua propriedade SynchronousInputID definida como zero. Portanto, a primeira saída precisa alterar seu valor SynchronousInputID da ID da entrada do componente para zero.

Para obter um exemplo de como direcionar linhas para uma das duas saídas síncronas no componente Script, consulte Criando uma transformação síncrona com o componente Script.

O componente Script analisa os nomes de entradas e saídas, além dos nomes de colunas nas entradas e saídas. Com base nesses nomes, ele gera classes e propriedades no item de projeto BufferWrapper. Se os nomes encontrados incluírem caracteres que não pertencem às categorias Unicode UppercaseLetter, LowercaseLetter, TitlecaseLetter, ModifierLetter, OtherLetter ou DecimalDigitLetter, os caracteres inválidos serão descartados nos nomes gerados. Por exemplo, espaços são descartados; portanto, quando duas colunas de entrada têm os nomes FirstName e [First Name], elas são interpretadas como ambas contendo o nome de coluna FirstName, com resultados imprevisíveis. Para evitar essa situação, os nomes das entradas e saídas e das colunas de entrada e saída usados pelo componente Script devem conter apenas caracteres nas categorias Unicode listadas nessa seção.

Na página Script do Editor da Tarefa Script, atribua um nome exclusivo e uma descrição para a tarefa Script. Você também pode atribuir valores para as propriedades a seguir.

Observação
No SQL Server 2008 Integration Services (SSIS), todos os scripts são pré-compilados. Em versões anteriores, você especificava se os scripts eram pré-compilados definindo uma propriedade Precompile para a tarefa.

Propriedade ValidateExternalMetadata

Propriedades ReadOnlyVariables e ReadWriteVariables

Você pode inserir listas de variáveis existentes, delimitadas por vírgulas, como os valores dessas propriedades a fim de disponibilizar as variáveis para acesso somente leitura ou leitura/gravação dentro do código de componente Script. Variáveis são acessadas em código através das propriedades ReadOnlyVariables e ReadWriteVariables da classe base gerada automaticamente. Para obter mais informações, consulte Usando variáveis no componente Script.

Observação
Nomes de variáveis diferenciam maiúsculas de minúsculas.

ScriptLanguage

Botão Editar Script

Na página Gerenciadores de Conexões do Editor de Transformação Scripts, você adiciona e remove gerenciadores de conexões a serem usados no seu script personalizado. Em geral, você precisa referenciar gerenciadores de conexões quando cria um componente de origem ou destino.

No projeto de código que será gerado com base nesses metadados, o item de projeto ComponentWrapper contém uma classe de coleção Connections que possui uma propriedade de acessador tipado para cada gerenciador de conexões selecionado. Cada propriedade de acessador tipado possui nome idêntico ao do próprio gerenciador de conexões e retorna uma referência ao gerenciador de conexões como uma instância de IDTSConnectionManager100. Por exemplo, se você adicionou um gerenciador de conexões nomeado MyADONETConnection na página Gerenciadores de Conexões do editor, poderá obter uma referência ao gerenciador de conexões no seu script através do seguinte código:

Dim myADONETConnectionManager As IDTSConnectionManager100 = _
    Me.Connections.MyADONETConnection

Para obter mais informações, consulte Conectando-se a fontes de dados no componente de Script.