Obter Conteúdo da Célula / Get Cell Value

Obter Conteúdo da Célula / Get Cell Value

Obtém o conteúdo de uma célula de uma planilha Excel.

Figura 1 - Bloco Obter Conteúdo da Célula

 

Este bloco faz parte do plugin Excel. Para visualizá-lo, é necessário instalar o plugin.

Compatibilidade

  • Bloco servidor: cronapi.excel.Excel.getCellValue()

Retorno

Retorna o conteúdo da célula selecionada.

Parâmetros

Número da Linha

Número da linha da célula a ter seu conteúdo obtido. A contagem começa em zero (0), diferentemente do Excel, que inicia em um (1).

  • Posição: 1

  • Inglês: Number of Line

  • Tipo: Texto / String

  • Exemplo: "0"

Número da Coluna

Número da coluna da célula a ter seu conteúdo obtido. Os valores inseridos neste parâmetro são numéricos, iniciando em 0 (equivalente à coluna 'A' no Excel).

  • Posição: 2

  • Inglês: Number of Column

  • Tipo: Texto / String

  • Exemplo: "0"

Aba

Objeto que representa a aba do arquivo Excel. Deve-se utilizar o retorno do bloco Criar Aba.

  • Posição: 3

  • Inglês: Sheet

  • Tipo: Objeto / Object

  • Exemplo: uso do retorno do bloco Criar Aba

Exemplo

Na função abaixo, na variável "planilha" é criado o objeto da planilha a partir do bloco Criar Planilha Excel. Na planilha criada será adicionada a aba "Aba 1" por meio do bloco Criar Aba inserido na variável "aba". O bloco Inserir Conteúdo na Célula adiciona o conteúdo desejado na posição A1 (referência padrão do Excel).

Em seguida, o bloco imprime irá exibir, no console do depurador, o conteúdo da célula configurada no bloco Obter Conteúdo da Célula, que corresponde a mesma célula configurada no bloco Inserir Conteúdo na Célula. Por fim, o bloco Salvar Planilha Excel salvará o arquivo gerado no local especificado.

Figura 2 - Exemplo de uso do bloco Obter Conteúdo da Célula

 

Na imagem abaixo, podemos visualizar o conteúdo obtido pelo bloco, após a execução da função da Figura 2.

Figura 2.1 - Conteúdo obtido pelo bloco Obter Conteúdo da Célula