Read Range

UiPath.Excel.Activities.ExcelReadRange

Reads the value of an Excel range and stores it in a DataTable variable. If the range isn't specified, the whole spreadsheet is read. If the range is specified as a cell, the whole spreadsheet starting from that cell is read. Can only be used in the Excel Application Scope or Use Excel File activities.

Observação:

Devido a uma limitação do software, a leitura de células que têm formato de moeda só recupera no máximo quatro casas decimais.

Propriedades

Comum

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

Entrada

• Intervalo - O intervalo que você deseja ler. 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 daquela célula é lida. Apenas strings e variáveis String são compatíveis.
• 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.

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 de seleção está marcada (definido como True).
• 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.

Observação:

Marcar a caixa de seleção PreservarFormatopode causar problemas de desempenho em grandes intervalos. Isso acontece porque após essa caixa de seleção estar marcada, as células são lidas uma a uma, em vez de serem lidas em massa.

• UsarFiltro - Quando estiver selecionado, a atividade não lê o que foi filtrado fora do intervalo especificado. Por padrão, essa caixa de seleção não está marcada e, portanto, o intervalo inteiro é lido, independentemente de algumas informações terem sido filtradas.

Saída

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

Exemplo de como usar a atividade Read Range

Você pode ver como a atividade Read Range é usada em um exemplo que incorpora várias atividades.

To exemplify how to use this activity, we have built an automation project which also includes a Read Range activity.

Você pode verificar e baixar o exemplo em Funções de tabela