Editor de Loop Foreach (página Coleção)

Use a página Coleção da caixa de diálogo Editor de Loop Foreach para especificar e configurar o tipo de enumerador.

Para saber mais sobre o contêiner Loop Foreach e como configurá-lo, consulte Contêiner Loop Foreach e Como configurar um contêiner Loop Foreach.

Opções estáticas

  • Enumerador
    Selecione o tipo de enumerador na lista. As opções desta propriedade estão listadas na tabela a seguir.

    Valor

    Descrição

    Enumerador de Arquivo Foreach

    Enumera arquivos. Se este valor for selecionado, serão exibidas as opções dinâmicas na seção Enumerador de Arquivo Foreach.

    Enumerador de Item Foreach

    Enumera valores em um item. Se este valor for selecionado serão exibidas as opções dinâmicas na seção Enumerador de Item Foreach.

    Enumerador ADO Foreach

    Enumera tabelas ou linhas em tabelas. Se este valor for selecionado serão exibidas as opções dinâmicas na seção Enumerador ADO Foreach.

    Enumerador de Conjunto de Linhas de Esquema ADO.NET Foreach

    Enumera um esquema. Se este valor for selecionado serão exibidas as opções dinâmicas na seção Enumerador ADO.NET Foreach.

    Enumerador Foreach de Variável

    Enumera o valor em uma variável. Se este valor for selecionado serão exibidas as opções dinâmicas na seção Enumerador Foreach de Variável.

    Enumerador NodeList Foreach

    Enumera nós em um documento XML. Se este valor for selecionado serão exibidas as opções dinâmicas na seção Enumerador NodeList Foreach.

    Enumerador SMO Foreach

    Enumera um objeto SMO. Se este valor for selecionado serão exibidas as opções dinâmicas na seção Enumerador SMO Foreach.

  • Expressões
    Clique ou expanda Expressões para exibir a lista de expressões de propriedade existentes. Clique no botão de reticências (...) para adicionar uma expressão de propriedade para uma propriedade de enumerador ou edite e avalie uma expressão de propriedade existente.

    Tópicos relacionados: Referência de Expressões do Integration Services, Editor de Expressões de Propriedades, Construtor de Expressões

Opções dinâmicas do Enumerador

Enumerador = Enumerador de Arquivo Foreach

Você usa o Enumerador de Arquivo Foreach para enumerar arquivos em uma pasta. Por exemplo, se o Loop Foreach incluir uma tarefa Execute SQL, você poderá usar o enumerador de arquivo Foreach para enumerar arquivos que contêm instruções SQL executadas pela tarefa Execute SQL. O enumerador pode ser configurado para incluir subpastas.

O conteúdo das pastas e subpastas que o enumerador de arquivo Foreach enumera pode alterar-se enquanto o loop estiver sendo executando porque processos externos ou tarefas no loop adicionam, renomeiam ou excluem arquivos enquanto o loop está em execução. Isso significa que podem acontecer várias situações inesperadas:

  • Se forem excluídos arquivos, uma tarefa no Loop Foreach poderá executar o trabalho em um conjunto de arquivos diferente dos arquivos usados por tarefas subseqüentes.

  • Se forem renomeados arquivos e um processo externo adicionar arquivos automaticamente para substituir os arquivos renomeados, o Loop Foreach poderá executar o trabalho duas vezes no mesmo conteúdo de arquivo.

  • Se forem adicionados arquivos, poderá ser difícil determinar para quais arquivos o Loop Foreach executou o trabalho.

  • Pasta
    Forneça o caminho da pasta raiz a enumerar.

  • Procurar
    Procure para localizar a pasta raiz.

  • Arquivos
    Especifique os arquivos a enumerar.

    Quando você especifica uma extensão de nome de arquivo, o enumerador também retorna os arquivos que têm a mesma extensão com caracteres adicionais acrescentados. (É o mesmo comportamento do comando dir no sistema operacional, que também compara nomes de arquivos 8.3 para fins de compatibilidade com versões anteriores.) Este comportamento do enumerador poderia causar resultados inesperados. Por exemplo, você deseja enumerar somente arquivos do Excel 2003 e especifica "*.xls". Todavia, o enumerador também retornará arquivos do Excel 2007 porque esses arquivos têm a extensão ".xlsx".

    ObservaçãoObservação

    Use caracteres curinga para especificar os arquivos a serem incluídos na coleção.

  • Totalmente qualificado
    Selecione para recuperar o caminho totalmente qualificado de nomes de arquivo. Se forem especificados caracteres curinga na opção Arquivos, os caminhos totalmente qualificados que retornarem corresponderão ao filtro.

  • Apenas nome
    Selecione para recuperar só os nomes de arquivo. Se forem especificados caracteres curinga na opção Arquivos, os nomes de arquivo que retornarem corresponderão ao filtro.

  • Nome e extensão
    Selecione para recuperar os nomes de arquivo e suas extensões. Se forem especificados caracteres curinga na opção Arquivos, os nomes e extensões que retornarem corresponderão ao filtro.

  • Desviar subpastas
    Selecione para incluir as subpastas na enumeração.

Enumerador = Enumerador de Item Foreach

Use o Enumerador de Item Foreach para enumerar itens em uma coleção. Defina os itens na coleção especificando colunas e valores de coluna. As colunas em uma linha definem um item. Por exemplo, um item que especifica os executáveis que uma tarefa Execute Process executa e o diretório de trabalho usado pela tarefa tem duas colunas, uma que lista os nomes de executáveis e outra que lista o diretório de trabalho. O número de linhas determina o número de vezes que o loop é repetido. Se a tabela tiver 10 linhas, o loop será repetido 10 vezes.

Para atualizar as propriedades da tarefa Execute Process, mapeie variáveis para colunas de item usando o índice da coluna. A primeira coluna definida no item do enumerador tem o valor de índice 0, a segunda coluna, 1 e assim por diante. Os valores das variáveis são atualizados com cada repetição do loop. As propriedades do Executable e do WorkingDirectory da tarefa Execute Process podem então ser atualizadas por expressões de propriedade que usam estas variáveis.

  • Defina os itens na coleção de Itens Foreach
    Forneça um valor para cada coluna na tabela.

    ObservaçãoObservação

    Uma linha nova é adicionada automaticamente à tabela depois que você insere valores nas colunas das linhas.

    ObservaçãoObservação

    Se os valores fornecidos não forem compatíveis com o tipo de dados da coluna, o texto aparecerá em vermelho.

  • Tipo de dados da coluna
    Lista o tipo de dados da coluna ativa.

  • Remover
    Selecione um item e clique em Remover para removê-lo da lista.

  • Colunas
    Clique para configurar o tipo de dados das colunas no item.

    Tópicos relacionados:, Colunas Para Cada Item.

Enumerador = Enumerador ADO Foreach

Use o enumerador ADO Foreach para enumerar linhas ou tabelas em um objeto ADO ou ADO.NET armazenado em uma variável. Por exemplo, se o Loop Foreach incluir uma tarefa de Script que grava um conjunto de dados em uma variável, você poderá usar o enumerador ADO Foreach para enumerar linhas no conjunto de dados. Se a variável contiver um conjunto de dados ADO.NET, o enumerador poderá ser configurado para enumerar linhas em várias tabelas ou para enumerar tabelas.

  • Variável de origem de um objeto ADO
    Selecione uma variável definida pelo usuário na lista ou clique em <Nova variável...> para criar uma nova variável.

    ObservaçãoObservação

    A variável deve ter o tipo de dados do Objeto, caso contrário ocorrerá um erro.

    Tópicos relacionados:Variáveis do Integration Services, Adicionar VariávelVariáveis do Integration Services, Adicionar Variável

  • Linhas na primeira tabela
    Selecione para enumerar somente linhas na primeira tabela.

  • Linhas em todas as tabelas (somente conjunto de dados ADO.NET)
    Selecione para enumerar linhas em todas as tabelas. Esta opção só estará disponível se os objetos a enumerar forem todos membros do mesmo conjunto de dados ADO.NET.

  • Todas as tabelas (somente conjunto de dados ADO.NET)
    Selecione para enumerar somente tabelas.

Enumerador = Enumerador de Conjunto de Linhas de Esquema ADO.NET Foreach

Use o Enumerador de Conjunto de Linhas de Esquema ADO.NET Foreach para enumerar um esquema para uma fonte de dados específica. Por exemplo, se o Loop Foreach incluir uma tarefa Execute SQL, você poderá usar o Enumerador de Conjunto de Linhas de Esquema ADO.NET Foreach para enumerar esquemas como as colunas no banco de dados AdventureWorks e a tarefa Execute SQL para obter as permissões do esquema.

Enumerador = Enumerador Foreach de Variável

Você usa o Enumerador Foreach de Variável para enumerar os objetos enumeráveis na variável especificada. Por exemplo, se o Loop Foreach incluir uma tarefa Execute SQL que executa uma consulta e armazena o resultado em uma variável, você poderá usar o Enumerador Foreach de Variável para enumerar os resultados da consulta.

Enumerador = Enumerador NodeList Foreach

Use o enumerador NodeList Foreach para enumerar o conjunto de nós XML resultante da aplicação de uma expressão XPath a um arquivo XML. Por exemplo, se o Loop Foreach incluir uma tarefa Script, você poderá usar o enumerador NodeList Foreach para passar um valor que atende aos critérios da expressão XPath do arquivo XML para a tarefa Script.

A expressão XPath que se aplica ao arquivo XML é a operação XPath externa, armazenada na propriedade OuterXPathString. Se o tipo de enumeração XPath for definido como ElementCollection, o enumerador NodeList Foreach poderá aplicar uma expressão XPath interna, armazenada na propriedade InnerXPathString, a uma coleção de elementos.

Para saber mais sobre como trabalhar com documentos e dados XML, consulte "Employing XML in the .NET Framework" na Biblioteca MSDN.

  • DocumentSourceType
    Selecione o tipo de origem do documento XML. As opções desta propriedade estão listadas na tabela a seguir.

    Valor

    Descrição

    Entrada direta

    Defina a origem de um documento XML.

    Conexão do arquivo

    Selecione um arquivo que contém o documento XML.

    Variável

    Defina a origem de uma variável que contém o documento XML.

  • DocumentSource
    Se DocumentSourceType for definido como Entrada direta, forneça o código XML ou clique no botão de reticências (...) para fornecer o XML usando a caixa de diálogo Editor de Origem de Documento.

    Se DocumentSourceType for definido como Conexão do arquivo, selecione um Gerenciador de conexões de arquivos ou clique em <Nova conexão...> para criar um novo gerenciador de conexões.

    Tópicos relacionados:Gerenciador de conexões de arquivos, Editor do Gerenciador de Conexões de Arquivos

    Se DocumentSourceType for definido como Variável, selecione uma variável existente ou clique em <Nova variável...> para criar uma nova variável.

    Tópicos relacionados:Variáveis do Integration Services, Adicionar Variável. Variáveis do Integration Services, Adicionar Variável.

  • EnumerationType
    Selecione um tipo de enumeração na lista. As opções desta propriedade estão listadas na tabela a seguir.

    Valor

    Descrição

    Navegador

    Enumere usando um XPathNavigator.

    Enumere nós retornados por uma operação XPath.

    NodeText

    Enumere nós de texto retornados por uma operação XPath.

    ElementCollection

    Enumera nós de elementos retornados por uma operação XPath.

  • OuterXPathStringSourceType
    Selecione o tipo de origem da cadeia XPath. As opções desta propriedade estão listadas na tabela a seguir.

    Valor

    Descrição

    Entrada direta

    Defina a origem de um documento XML.

    Conexão do arquivo

    Selecione um arquivo que contém o documento XML.

    Variável

    Defina a origem de uma variável que contém o documento XML.

  • OuterXPathString
    Se OuterXPathStringSourceType for definido como Entrada direta, forneça a cadeia de caracteres XPath.

    Se OuterXPathStringSourceType for definido como Conexão de arquivos, selecione um Gerenciador de conexões de arquivos ou clique em <Nova conexão...> para criar um novo gerenciador de conexões.

    Tópicos relacionados:Gerenciador de conexões de arquivos, Editor do Gerenciador de Conexões de Arquivos

    Se OuterXPathStringSourceType for definido como Variável, selecione uma variável existente ou clique em <Nova variável...> para criar uma nova variável.

    Tópicos relacionados:Variáveis do Integration Services, Adicionar Variável. Variáveis do Integration Services, Adicionar Variável.

  • InnerElementType
    Se EnumerationType for definido como ElementCollection, selecione o tipo de elemento interno na lista.

  • InnerXPathStringSourceType
    Seleciona o tipo de origem da cadeia interna XPath. As opções desta propriedade estão listadas na tabela a seguir.

    Valor

    Descrição

    Entrada direta

    Defina a origem de um documento XML.

    Conexão do arquivo

    Selecione um arquivo que contém o documento XML.

    Variável

    Defina a origem de uma variável que contém o documento XML.

  • InnerXPathString
    Se InnerXPathStringSourceType for definido como Entrada direta, forneça a cadeia de caracteres XPath.

    Se InnerXPathStringSourceType for definido como Conexão de arquivos, selecione um Gerenciador de conexões de arquivos ou clique em <Nova conexão...> para criar um novo gerenciador de conexões.

    Tópicos relacionados:Gerenciador de conexões de arquivos, Editor do Gerenciador de Conexões de Arquivos

    Se InnerXPathStringSourceType for definido como Variável, selecione uma variável existente ou clique em <Nova variável...> para criar uma nova variável.

    Tópicos relacionados:Variáveis do Integration Services, Adicionar Variável. Variáveis do Integration Services, Adicionar Variável.

Enumerador = Enumerador SMO Foreach

Use o enumerador SMO Foreach para enumerar objetos SMO (SQL Server Management Object). Por exemplo, se o Loop Foreach incluir uma tarefa Execute SQL, você poderá usar o enumerador SMO Foreach para enumerar as tabelas no banco de dados AdventureWorks e executar consultas que contam o número de linhas em cada tabela.