Read Range Workbook

Atividade Read Range Workbook que lê o valor de um intervalo do Excel e o armazena em uma variável DataTable.

UiPath.Excel.Activities.ReadRange

Description

Lê o valor de um intervalo do Excel e o armazena em uma variável TabelaDeDados. Se o intervalo não for especificado, a planilha inteira será lida. Se o intervalo for especificado como uma célula, a planilha inteira a partir dessa célula é lida.

Observação:

Os formatos de pasta de trabalho suportados são .xls, .xlsm, .xltm, .xlsx e .xltx.

Compatibilidade do projeto

Windows - Legada | Windows | Multiplataforma

Propriedades

Comum

• DisplayName - O nome de exibição da atividade.

Entrada

• Intervalo - Especifica o intervalo de células a ser lido. Se esse valor não for especificado, a planilha inteira é lida. Se o valor consistir de apenas uma célula, a planilha inteira é lida, a partir daquela célula. Apenas strings e variáveis String são compatíveis.

Observação:

Strings devem ser colocadas entre aspas.

• SheetName - The name of the sheet in which the range that you want to read is. By default, this is filled in with "Sheet1." Only String variables and strings are supported.
• Caminho da pasta de trabalho - O caminho completo da planilha do Excel que você deseja usar. Esse campo aceita entrada IResource. Use o botão de adição para alternar o modo de entrada entre Arquivo local e Recurso de arquivo. Se o arquivo do Excel a ser usado estiver localizado na pasta do projeto, seu caminho relativo pode ser usado. Apenas strings e variáveis String são compatíveis.

Observação:

Alternativamente, em vez de fornecer o caminho para o arquivo, você pode melhorar o desempenho do runtime ao usar várias atividades de Pasta de trabalho com o mesmo arquivo, conectando o projeto ao arquivo a partir do Data Manager e, em seguida, fazer referência a ele usando a propriedade Pasta de trabalho .

Diversos

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

Opções

• AdicionarCabeçalhos - Quando estiver selecionado, os cabeçalhos das colunas do intervalo especificado da planilha também são extraídos. Por padrão, essa caixa de seleção fica desmarcada.
• Senha - A senha da pasta de trabalho do Excel, se necessário. Apenas strings e variáveis String são compatíveis.
• PreservarFormato - Selecione essa opção para ler os valores, conforme eles são exibidos no intervalo (por exemplo moeda, data, texto). A formatação de número real não é mantida, apenas a maneira como os dados são exibidos. Por padrão, a opção fica desmarcada.

Saída

• TabelaDeDados - Armazena os dados extraídos do intervalo especificado do Excel em uma variável Tabela de dados. Apenas variáveis Tabela de dados são compatíveis.

Observação:

Para iterar pelas linhas da DataTable, use a atividade For Each Row in Data Table . Ou então, use uma atividade For Each com dataTable.Rows no campo In . Para obter mais informações sobre a iteração no Studio Web, consulte Iteração por itens.

Usar pasta de trabalho

• Pasta de trabalho — selecione um recurso de pasta de trabalho no menu Mais . Disponível se você adicionou o arquivo do Excel como um recurso, conectando-se à pasta de trabalho a partir do Data Manager. Adicionar um recurso de pasta de trabalho e, em seguida, fazer referência ao recurso em várias atividades de pasta de trabalho garante que o arquivo não seja recarregado na memória para cada operação, melhorando o desempenho do runtime, especialmente ao trabalhar com arquivos grandes. Para obter mais informações, consulte Como usar o Data Manager.