Read Range

UiPath.Excel.Activities.ExcelReadRange

Lê o valor de um intervalo do Excel e o armazena em uma variável DataTable. 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. Só pode ser usado nas atividades Excel Application Scope ou Use Excel File.

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

• NomeDeExibição - 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.
• NomeDaPlanilha — o nome da planilha na qual está o intervalo que você deseja ler. Por padrão, é preenchido com "Sheet1". Apenas strings e variáveis String são compatíveis.

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 real do número 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 PreservarFormato pode 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.

Para exemplificar a forma de usar essa atividade, criamos um projeto de automação que também inclui uma atividade Read Range.

Você pode verificar e baixar o exemplo aqui