Capítulo 3 Estudo de caso: organizar a tabela de vendas do mês ・ MISSÃO 12

Missão 12: Rodar a partir de um menu próprio (onOpen)

📋 Lista de missões

Tarefa

Faça aparecer um menu "Fechamento mensal" ao abrir a planilha, com "Marcar vendas grandes" executando markLarge. Depois de salvar, recarregue o navegador (F5) e execute pelo menu.

Vendas de outubro - Planilhas Google
Vendas de outubro

Para praticar, a tabela volta ao estado inicial antes de cada execução (uma planilha de verdade não volta. As mudanças de um script às vezes podem ser desfeitas com Ctrl+Z, mas não todas de uma vez).

Apps ScriptProjeto sem títuloImplantar ▾
function onOpen() {
SpreadsheetApp.getUi()
.('Fechamento mensal')
.addItem('Marcar vendas grandes', '')
.();
}
function markLarge() {
const sheet = SpreadsheetApp.getActiveSheet();
const lastRow = sheet.getLastRow();
const amounts = sheet.getRange(2, 4, lastRow - 1, 1).getValues();
const labels = amounts.map((row) => [row[0] >= 100000 ? 'Grande' : '']);
sheet.getRange(2, 5, labels.length, 1).setValues(labels);
}
Ctrl+S: salvar · Ctrl+R: executar (editor) · F5: reabrir

Capítulo 3 ・ MISSÃO 12

Rodar a partir de um menu próprio (onOpen)

Faça aparecer um menu "Fechamento mensal" ao abrir a planilha, com "Marcar vendas grandes" executando markLarge. Depois de salvar, recarregue o navegador (F5) e execute pelo menu.

Agora
Meta (executar pelo menu "Fechamento mensal")

Lendo o código

function onOpen() {
Função que roda automaticamente quando a planilha é aberta. Se mudar o nome, ela não roda.
SpreadsheetApp.getUi().createMenu('Fechamento mensal')
Cria na tela (Ui) um menu chamado "Fechamento mensal".
.addItem('Marcar vendas grandes', 'markLarge')
Adiciona um item. Ao clicar, roda a função markLarge.
.addToUi();
Mostra o menu pronto na barra de menus.

Uma função chamada onOpen roda automaticamente quando a planilha é aberta. Se você adicionar um menu aqui, até quem nunca abre o Apps Script pode rodar a tarefa pelo menu. Ótimo para planilhas usadas pela equipe toda.

Como começar no GAS e o código mais usado estão em um artigo.O que é GAS? Como começar e código mais usado

O código que você escreve roda em um espaço isolado dentro desta página. Ele não alcança fora da página nem outros sites.

* Esta é uma simulação do comportamento do Planilhas Google e do Apps Script e pode diferir em parte do original.

* Planilhas Google é uma marca da Google LLC. Este site não tem relação com o Google.