Como criar funções personalizadas no Planilhas Google

Embora o Planilhas Google forneça centenas de funções , ele também permite que você crie as suas próprias. Antes, você só podia fazer isso usando o Apps Script . Agora, há uma ferramenta fácil de usar em sua planilha chamada Funções Nomeadas.

Usando funções nomeadas, você dá um título à sua função, fornece uma descrição, adiciona espaços reservados para argumentos e insere as definições. Você pode então usar suas funções personalizadas nas planilhas da sua pasta de trabalho e importá-las para outras pastas de trabalho do Planilhas Google.

Crie uma função nomeada no Planilhas Google

Para demonstrar facilmente como cada um dos elementos de configuração funciona, percorreremos o processo usando um exemplo. Criaremos uma função que nos diga se devemos ou não aplicar um bônus aos nossos departamentos com base nas vendas totais.

Como a fórmula de matriz atual que estamos usando é longa, criaremos uma versão simplificada com nossa própria função personalizada. 

Para começar, abra uma planilha e vá para a guia Dados. Selecione “Funções nomeadas” que abre a barra lateral onde você criará sua função.

Você pode selecionar “Ver exemplo” para ver um do Planilhas Google ou escolher “Adicionar nova função” para configurar a sua própria.

Comece inserindo um nome para sua função após o  sinal de igual em uma célula para iniciar sua fórmula . Você também pode usar o nome padrão fornecido, que é MY_FUNCTION1.

Em seguida, adicione uma descrição da função. Embora opcional, isso é exibido na caixa Ajuda da função, o que é útil para você e seus colaboradores.

Em seguida, adicione seus espaços reservados para argumentos. Embora também sejam opcionais, são necessários para montar a maioria das fórmulas.

Os exemplos incluem valor, célula, intervalo, valor1, célula2 e intervalo3. À medida que você digita cada espaço reservado, ele é exibido diretamente abaixo com uma cor para auxiliar na adição da Definição da Fórmula. Para nosso exemplo, simplesmente adicionamos “intervalo”.

Para finalizar a área principal, adicione a Definição da Fórmula. Esta é a fórmula que você deseja usar para definir sua Função Nomeada. Você pode usar os espaços reservados adicionados acima na fórmula, inserindo-os ou selecionando-os.

Abaixo está a definição da fórmula para nosso exemplo. Como você pode ver, incluímos o

 range 

argumento que é o único argumento que precisaremos inserir para nossa função personalizada.

=ARRAYFORMULA(IF(intervalo>=20000,"Cha-ching", "Boo"))

Clique em “Avançar”.

Na tela de visualização a seguir, você pode adicionar mais detalhes à sua função na caixa Ajuda. Isso inclui uma descrição e um exemplo de cada argumento. Você pode ver o que incluímos na imagem abaixo.

Clique em “Criar” para salvar sua nova função.

Você será direcionado para a barra lateral principal de Funções Nomeadas, onde verá sua nova função listada. Se você percorrer o exemplo fornecido pelo Planilhas Google ao abrir a barra lateral, também verá essa função.

Usando sua função nomeada

Agora é hora de testar sua nova função. Adicione um sinal de igual e o nome da sua função seguido dos argumentos.

Finalize sua fórmula, pressione Enter ou Return e confirme se funciona conforme o esperado. Como você pode ver aqui, inserimos nossa fórmula de matriz simplificada (que é mais curta e menos complicada) com nossa função personalizada e recebemos os resultados esperados:

=BÔNUS(D2:D6)

Se você abrir a caixa Ajuda, como pode fazer com todas as funções do Planilhas Google usando o ponto de interrogação em azul, verá as informações da função inserida acima.

Editar ou remover uma função nomeada

Se quiser fazer alterações em sua função ou estiver vendo  mensagens de erro ao tentar usá-la, você pode editá-la. Vá para Dados > Funções Nomeadas. Selecione os três pontos à direita da sua função na barra lateral e escolha “Editar”.

Você verá as mesmas telas da configuração inicial da função. Faça seus ajustes, selecione “Avançar” e clique em “Atualizar”.

Sua planilha é atualizada automaticamente para acompanhar suas alterações.

Você também pode remover uma Função Nomeada se usar uma para testar o recurso ou simplesmente não quiser uma que você criou. Selecione os três pontos à direita na barra lateral de funções nomeadas e escolha “Remover”. 

Talvez você precise ajustar sua planilha se tiver uma fórmula para a função excluída. Você deveria ver o #NAME? erro na célula assim que a função é removida, como nossa captura de tela abaixo, onde excluímos MY_FUNCTION6.

Importar funções nomeadas para outras pastas de trabalho

Ao criar uma Função Nomeada em uma pasta de trabalho, você pode usá-la em todas as planilhas desse livro. Se quiser usar a função personalizada em uma pasta de trabalho diferente do Planilhas Google, você pode simplesmente importá-la .

Abra uma planilha na pasta de trabalho onde deseja usar a Função Nomeada. Vá para Dados > Funções Nomeadas para abrir a barra lateral e selecione “Importar Função”.

Use as guias na parte superior da janela pop-up para localizar a pasta de trabalho que contém a função personalizada e escolha “Selecionar”.

Você verá uma janela aberta exibindo todas as funções nomeadas nessa pasta de trabalho. Use as marcas de seleção para selecionar os que deseja e clique em “Importar” ou clique em “Importar todos” para selecionar todos.

As funções importadas são exibidas na barra lateral Funções nomeadas e ficam disponíveis para uso em sua pasta de trabalho.

Se você editar uma função nomeada importada de outra planilha, as alterações não serão sincronizadas com a outra planilha. Você pode importar a função atualizada para sua outra planilha ou fazer alterações manualmente nela também.

Talvez você esteja usando o Apps Script com JavaScript para criar suas próprias funções personalizadas. Ou talvez você seja completamente novo na criação de uma função. De qualquer forma, a ferramenta Funções nomeadas é um recurso excelente e útil do Planilhas Google. De uma chance!