Nível de programação: iniciante
Duração: 5 minutos
Tipo de projeto: função personalizada
Objetivos
- Entender o que a solução faz.
- Entender o que os serviços do Apps Script fazem na solução.
- Configurar o script.
- Executar o script.
Sobre esta solução
Se você tiver dados estruturados com estrutura semelhante em várias planilhas, como métricas de suporte ao cliente para membros da equipe, pode usar esta função personalizada para criar um resumo de cada planilha. O foco desta solução é em tíquetes de suporte ao cliente, mas você pode personalizá-la de acordo com suas necessidades.

Como funciona
A função personalizada, chamada getSheetsData(), resume os dados de cada planilha com base na coluna Status. O script ignora as planilhas que não devem ser incluídas na agregação, como as planilhas ReadMe e Summary.
Serviços do Apps Script
Esta solução usa o seguinte serviço:
- Serviço de planilha: recebe as planilhas que precisam ser resumidas e conta o número de itens que correspondem a uma string especificada. Em seguida, o script adiciona as informações calculadas a um intervalo relativo ao local em que a função personalizada foi chamada na planilha.
Pré-requisitos
Para usar este exemplo, você precisa dos seguintes pré-requisitos:
- Uma Conta do Google (as contas do Google Workspace podem exigir a aprovação do administrador).
- Um navegador da Web com acesso à Internet.
Configurar o script
Para fazer uma cópia da planilha Summarize spreadsheet data custom function, clique no botão a seguir:
O projeto do Apps Script para essa solução está anexado à planilha.
Executar o script
- Na planilha copiada, acesse a planilha Summary.
- Clique na célula
A4. A funçãogetSheetsData()está nessa célula. - Acesse uma das planilhas do proprietário e atualize ou adicione dados a ela. Algumas ações que você pode tentar incluem o seguinte:
- Adicione uma nova linha com informações de amostra do tíquete.
- Na coluna Status, mude o status de um tíquete atual.
- Mude a posição da coluna Status. Por exemplo, na planilha Owner1, mova a coluna Status da coluna C para a coluna D.
- Acesse a planilha Summary e analise a tabela de resumo atualizada que
getSheetsData()criou na célulaA4. Talvez seja necessário marcar a caixa de seleção na linha 10 para atualizar os resultados armazenados em cache da função personalizada. O Google armazena em cache funções personalizadas para otimizar a performance.- Se você adicionou ou atualizou linhas, o script atualiza as contagens de tíquetes e status.
- Se você moveu a posição da coluna Status, o script ainda funciona conforme esperado com o novo índice de coluna.
Revisar o código
Para revisar o código do Apps Script para essa solução, clique em Acessar o código-fonte:
Acessar o código-fonte
Code.gs
Modificações
Você pode editar a função personalizada quantas vezes quiser para atender às suas necessidades. Para conferir uma adição opcional para atualizar manualmente os resultados da função personalizada, clique em Atualizar resultados armazenados em cache:
Atualizar resultados armazenados em cache
Ao contrário das funções integradas, o Google armazena em cache funções personalizadas para otimizar a performance. Isso significa que, se você mudar algo na função personalizada , como um valor que está sendo calculado, talvez não force uma atualização imediatamente. Para atualizar o resultado da função manualmente, siga estas etapas:
- Adicione uma caixa de seleção a uma célula vazia clicando em Inserir > Caixa de seleção.
- Adicione a célula que tem a caixa de seleção como um parâmetro da função personalizada,
por exemplo,
getSheetsData(B11). - Marque ou desmarque a caixa de seleção para atualizar os resultados da função personalizada.
Colaboradores
Este exemplo é mantido pelo Google com a ajuda de Especialistas do Google Developers.