As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Excel
<a name="actions-excel"></a>

As ações do Excel permitem que você leia, atualize e crie arquivos do Excel em suas automações. Todas as ações do Excel oferecem suporte aos formatos de arquivo.xlsx e .xlsm. Os identificadores da pasta de trabalho mantêm referências em várias operações.

**nota**  
Embora os valores possam ser lidos em arquivos.xlsm, a execução de macros não é suportada.

## Criar nova pasta de trabalho
<a name="create-new-workbook"></a>

Cria um arquivo Excel em branco. Produz um identificador de pasta de trabalho que você pode usar para atualizar a planilha nas etapas subsequentes.

**Propriedades:**
+ **Identificador da pasta de trabalho** (saída): nome da variável que armazena a referência da pasta de trabalho para ações futuras (padrão:) `workbook_id`

## Abrir pasta de trabalho existente
<a name="open-existing-workbook"></a>

Carrega um arquivo Excel existente. Retorna um identificador de pasta de trabalho que você pode usar para atualizar a planilha nas etapas subsequentes. Suporta somente arquivos Excel (.xlsx).

**Propriedades:**
+ **Arquivo Excel** (obrigatório): o arquivo.xlsx a ser aberto, normalmente armazenado em uma variável (por exemplo,) `my_file`
+ **Identificador da pasta de trabalho** (saída): nome da variável que armazena a referência da pasta de trabalho (padrão:) `workbook_id`

**Requisitos de arquivo:**
+ Deve ser um arquivo Excel (.xlsx) válido
+ O arquivo deve estar acessível como um objeto de arquivo de mídia

## Salvar pasta de trabalho
<a name="save-workbook"></a>

Salva as atualizações em um arquivo do Excel. Permite que você atualize o nome e o tipo de arquivo da pasta de trabalho salva.

**Propriedades:**
+ **Nome do arquivo** (obrigatório): nome do arquivo salvo sem extensão (por exemplo, “Relatório mensal”)
+ **Tipo de arquivo** (lista suspensa): formato de saída - atualmente suporta XLSX (padrão: XLSX)
+ **Arquivo salvo** (saída): variável que armazena o objeto de arquivo salvo (padrão:`saved_file`)

## Leia a planilha
<a name="read-sheet"></a>

Obtém dados de uma variedade de células. A ação armazena a saída em uma variável da tabela de dados.

**Propriedades:**
+ **Identificador da pasta de trabalho** (obrigatório): a pasta de trabalho a ser lida (por exemplo,) `workbook_id`
+ **Nome da planilha** (obrigatório): nome da planilha ou guia (padrão: “Planilha1")
+ **Intervalo de células** (opcional): especificação de intervalo - suporta vários formatos:
  + Célula inicial: “A2" (lê todos os dados do ponto de ancoragem)
  + Alcance exato: “A1:B10"
  + Intervalo de colunas: “A:B”
  + Intervalo de linhas: "1:3”
  + Vazio: lê a folha inteira
+ **Incluir cabeçalhos** (caixa de seleção): trata a primeira linha como cabeçalhos de coluna quando ativada. Quando desativado, usa a nomenclatura padrão (Coluna0, Coluna1 etc.) (padrão: TRUE)
+ **Tabela de dados** (saída): variável que armazena os dados extraídos (padrão:`excel_table`)

**Manipulação da fórmula:**
+ A ação calcula automaticamente as fórmulas e armazena os resultados na tabela de dados.

## Célula de leitura
<a name="read-cell"></a>

Obtém o valor de uma célula. Usado para ler um valor de célula individual de uma planilha.

**Propriedades:**
+ **Identificador da pasta de trabalho** (obrigatório): a pasta de trabalho a ser lida (por exemplo,) `workbook_id`
+ **Nome da planilha** (obrigatório): nome da planilha (padrão: “Planilha1")
+ **Referência da célula** (obrigatório): localização da célula (por exemplo, “A1")
+ **Valor da célula** (saída): variável que armazena o conteúdo da célula (padrão:`cell_value`)

## Gravar na planilha
<a name="write-to-sheet"></a>

Produz uma tabela de dados em uma planilha. Usado para gravar uma variedade de linhas e colunas em uma planilha.

**Propriedades:**
+ **Tabela de dados** (obrigatória): A tabela de dados a ser gravada (por exemplo,`my_table`)
+ **Identificador da pasta de trabalho** (obrigatório): pasta de trabalho de destino (por exemplo,) `workbook_id`
+ **Nome da planilha** (obrigatório): planilha de destino (padrão: “Planilha1")
+ **Iniciar na célula** (opcional): posição inicial para posicionamento de dados (padrão: “A1")
+ **Incluir cabeçalhos** (caixa de seleção): grava cabeçalhos de coluna quando ativado (padrão: TRUE)

## Escrever para a célula
<a name="write-to-cell"></a>

Exibe um valor para uma célula. Usado para atualizar células individuais em uma planilha.

**Propriedades:**
+ **Valor a ser gravado** (obrigatório): conteúdo da célula (por exemplo, “Pedido \$112345 “)
+ **Identificador da pasta de trabalho** (obrigatório): pasta de trabalho de destino (por exemplo,) `workbook_id`
+ **Nome da planilha** (obrigatório): planilha de destino (padrão: “Planilha1")
+ **Referência da célula** (obrigatório): localização da célula alvo (por exemplo, “A1")

## Escrever nova linha
<a name="write-new-row"></a>

Adiciona uma linha de dados à planilha. A nova linha é anexada ao final dos dados existentes.

**Propriedades:**
+ **Valores de linha** (obrigatório): matriz de valores para a nova linha, começando pela primeira coluna (por exemplo, ["Q1", “Vendas”, 100])
+ **Identificador da pasta de trabalho** (obrigatório): pasta de trabalho de destino (por exemplo,) `workbook_id`
+ **Nome da planilha** (obrigatório): planilha de destino (padrão: “Planilha1")

**Validação de dados:**
+ Deve fornecer valores como um formato de matriz
+ Os valores são escritos sequencialmente a partir da primeira coluna

## Criar nova planilha
<a name="create-new-sheet"></a>

Adiciona uma planilha em branco. A nova planilha é adicionada ao final da pasta de trabalho.

**Propriedades:**
+ **Identificador da pasta de trabalho** (obrigatório): pasta de trabalho de destino (por exemplo,) `workbook_id`
+ **Nome da planilha** (obrigatório): Nome da nova planilha (por exemplo, “Dados de vendas”)

## Folha de cópia
<a name="copy-sheet"></a>

Cria uma cópia da planilha. A nova planilha é criada na mesma pasta de trabalho.

**Propriedades:**
+ **Identificador da pasta de trabalho** (obrigatório): pasta de trabalho de destino (por exemplo,) `workbook_id`
+ **Nome da planilha a ser copiada** (obrigatório): nome da planilha de origem (por exemplo, “Planilha original”)
+ **Nome da nova planilha** (obrigatório): Nome da planilha duplicada (por exemplo, “Folha original (cópia)”)

## Renomear planilha
<a name="rename-sheet"></a>

Atualiza o nome de uma planilha existente.

**Propriedades:**
+ **Identificador da pasta de trabalho** (obrigatório): pasta de trabalho de destino (por exemplo,) `workbook_id`
+ **Nome da planilha atual** (obrigatório): nome da planilha existente (por exemplo, “Planilha1")
+ **Nome da planilha atualizado** (obrigatório): Novo nome para a planilha (por exemplo, “Dados do primeiro trimestre”)

## Excluir planilha
<a name="delete-sheet"></a>

Remove uma planilha de uma pasta de trabalho. Não é possível excluir a última planilha restante de uma pasta de trabalho.

**Propriedades:**
+ **Identificador da pasta de trabalho** (obrigatório): pasta de trabalho de destino (por exemplo,) `workbook_id`
+ **Nome da planilha a ser excluída** (obrigatório): planilha a ser removida (por exemplo, “Planilha1")

**Restrições**:
+ Não é possível excluir a última planilha restante em uma pasta de trabalho

## Definir cor da célula
<a name="set-cell-color"></a>

Atualiza a cor de fundo da célula. Usado para destacar um intervalo específico de células.

**Propriedades:**
+ **Cor da célula** (obrigatório): formato de código hexadecimal RGB (por exemplo, "FF0000" para vermelho)
+ **Identificador da pasta de trabalho** (obrigatório): pasta de trabalho de destino (por exemplo,) `workbook_id`
+ **Nome da planilha** (obrigatório): planilha de destino (por exemplo, “Planilha1")
+ **Intervalo de células** (obrigatório): intervalo para formatar - suporta:
  + Célula única: “A1"
  + Alcance exato: “A1:B10"
  + Intervalo de colunas: “A:B”
  + Intervalo de linhas: "1:3”

## Obtenha a cor da célula
<a name="get-cell-color"></a>

Lê a cor de fundo da célula. Produz a cor no formato de código hexadecimal RGB (por exemplo, "FF0000" para vermelho).

**Propriedades:**
+ **Identificador da pasta de trabalho** (obrigatório): pasta de trabalho de origem (por exemplo,) `workbook_id`
+ **Nome da planilha** (obrigatório): planilha de origem (por exemplo, “Planilha1")
+ **Referência de célula** (obrigatório): Célula a ser lida (por exemplo, “A1")
+ **Cor da célula** (saída): variável que armazena código hexadecimal RGB (padrão:) `cell_color`

## Ocultar linhas
<a name="hide-rows"></a>

Faz linhas ocultas na planilha. Os dados permanecem intactos, mas não são visíveis.

**Propriedades:**
+ **Identificador da pasta de trabalho** (obrigatório): pasta de trabalho de destino (por exemplo,) `workbook_id`
+ **Nome da planilha** (obrigatório): planilha de destino (por exemplo, “Planilha1")
+ **Linha inicial** (obrigatório): número da primeira linha a ser ocultado (a numeração do Excel começa em 1)
+ **Linha final** (opcional): número da última linha a ser ocultada. Se estiver vazio, somente a linha inicial ficará oculta

**Numeração de linhas:**
+ Os números das linhas do Excel começam em 1 (não 0)
+ Deve fornecer valores inteiros

## Exibir linhas
<a name="unhide-rows"></a>

Torna as linhas ocultas visíveis. Usado para mostrar linhas anteriormente ocultas.

**Propriedades:**
+ **Identificador da pasta de trabalho** (obrigatório): pasta de trabalho de destino (por exemplo,) `workbook_id`
+ **Nome da planilha** (obrigatório): planilha de destino (por exemplo, “Planilha1")
+ **Linha inicial** (obrigatório): número da primeira linha a ser exibido (a numeração do Excel começa em 1)
+ **Linha final** (opcional): número da última linha a ser exibida. Se estiver vazio, somente a linha inicial ficará visível

## Melhores práticas e limitações
<a name="excel-best-practices-limitations"></a>

### Gerenciamento de identificadores de pasta de trabalho
<a name="excel-workbook-identifier-management"></a>
+ Armazene identificadores da pasta de trabalho em variáveis descritivas (por exemplo,,) `sales_workbook` `report_file`
+ Reutilize o mesmo identificador em várias ações na mesma pasta de trabalho
+ Sempre crie ou abra uma pasta de trabalho antes de realizar operações de dados

### Especificações de alcance
<a name="excel-range-specifications"></a>
+ Use intervalos exatos (“A1:B10") para operações de dados precisas
+ Use intervalos de colunas (“A:B”) ao trabalhar com colunas inteiras
+ Use intervalos de linhas (” 1:3 “) para operações de cabeçalho ou resumo
+ Deixe o intervalo vazio para processar folhas inteiras

### Otimização do desempenho
<a name="excel-performance-optimization"></a>
+ Leia intervalos inteiros quando possível, em vez de células individuais
+ Operações de gravação em lote usando tabelas de dados em vez de gravações de células individuais
+ Salve pastas de trabalho somente quando todas as modificações estiverem concluídas

### Limitação
<a name="excel-limitation"></a>

A compatibilidade de arquivos é limitada somente ao formato Excel moderno (.xlsx) - arquivos antigos do Excel (.xls) não são suportados.