1. Introdução
Neste codelab, você criará um projeto do Apps Script chamado "Hello World" e adicionará uma função simples, logThis
, que registra uma mensagem transmitida para ele. Em seguida, você criará uma automação do AppSheet para que ele chame o script. Depois que o script for chamado, você retornará ao editor do Apps Script e confirmar a execução.
O que você aprenderá
- Como criar um projeto do Apps Script com uma função simples.
- Como criar um app do AppSheet simples com base em um arquivo do Planilhas Google.
- criar uma automação do AppSheet que chame a função do script;
- Como verificar se o script foi executado corretamente no AppSheet.
Pré-requisitos
- Acesso ao ambiente de desenvolvimento do AppSheet (
appsheet.com
). - Acesso ao ambiente de desenvolvimento do Apps Script (
script.google.com
).
2. Criar um projeto do Apps Script
Primeiro, crie um projeto do Apps Script chamado "Hello World" e adicione uma função simples, logThis
, que registra uma mensagem transmitida para ele.
- Acesse a página inicial do Apps Script e clique em + Novo projeto.
- Mude o título do projeto para
Hello World.
.
- Atualize o script no editor da seguinte forma:
function logThis(msg) {
Logger.log('Message from AppSheet was: ' + msg);
}
- Clique em Salvar projeto.
Para mais informações, consulte Criar e excluir projetos.
3. Criar um app do AppSheet
Em seguida, gere rapidamente um novo app do AppSheet com base em um arquivo do Planilhas Google de exemplo copiado e atualize-o para chamar o projeto do Apps Script criado antes.
- Abra a planilha Exemplo de pedidos de camisa e clique em Fazer uma cópia para fazer o download e abrir uma cópia no Planilhas Google. Você tem a opção de renomear a planilha (por exemplo,"Pedidos de camisetas").
- Faça login no AppSheet.
- Na página "Meus apps", clique em Criar novo app. A caixa de diálogo Criar um novo aplicativo é exibida.
- Clique em Começar com seus próprios dados.
- Se quiser, edite o nome do app e selecione uma categoria.
- Clique em Escolher seus dados.
- Clique em Google para acessar o Google Drive.
- Acesse e selecione a planilha Pedidos de camisas que você copiou anteriormente.
O AppSheet configura seu app.
- Clique em Personalizar seu app para abri-lo no editor do AppSheet.
4. Criar uma automação
Em seguida, crie uma automação do AppSheet para que ela chame o script.
- Selecione Automação > Bots.
- Clique em + New Bot.
- Selecione o primeiro item na lista de sugestões: Envie ou envie uma notificação quando um registro de pedidos de camisa for criado ou atualizado.
- Clique na etapa Enviar uma notificação para editá-la.
- Mude o nome para
Call a script
.
- Em Configurações, altere o tipo de tarefa para Chamar um script.
- No campo Apps Script Project, clique em Browse (ícone de arquivo).
- Navegue até o projeto
Hello World
do Apps Script e selecione-o no seu Drive. - Clique em Selecionar e, se receber uma autorização, clique em Autorizar e siga as instruções.
O projeto do Apps Script será adicionado, e o campo Nome da função será preenchido com uma lista de funções disponíveis.
- Selecione logThis(msg) na lista Nome da função.
O campo Argumentos de função é exibido.
- Para o argumento msg, insira a seguinte expressão usando o Expression Assistant: 'Hello from AppSheet'.
- Clique em Salvar para salvar o aplicativo.
- No painel de visualização, clique no ícone de dispositivo móvel ou tablet para exibir o emulador do app.
- Adicione um novo pedido de camisa e clique em Salvar.
- Clique em Sync para sincronizar as alterações.
5. Confirme a execução do Apps Script
Depois que o script for chamado, volte para o editor do Apps Script e confirme a execução.
- Volte para a página inicial do Apps Script e veja o projeto Hello World.
- Clique em Execuções na barra de navegação para confirmar que a função
logThis
foi concluída. Clique em Refresh se o registro não aparecer.
6. Etapas adicionais opcionais
Como uma etapa extra deste workshop, analise o projeto de exemplos do Apps Script e execute alguns exemplos do AppSheet.
Primeiros passos com os exemplos do Apps Script
- Para começar, faça uma cópia do projeto de exemplos do Apps Script.
- Clique no ícone de cópia.
- Salve o novo projeto e clique em Executar para autorizar os aplicativos nele.
Faça testes com vários exemplos
createCalendarEvent()
: crie um evento no Agenda.createDoc()
: crie automaticamente um novo documento.createSheet()
: crie uma nova página.createSlideDeck()
: crie uma nova apresentação de slides com imagem e texto.
Veja mais informações sobre esse recurso importante em Chamar o Apps Script por uma automação, que fornece uma visão geral detalhada, um vídeo sobre recursos, tutoriais e um projeto do Apps Script que pode ser copiado e contém muitos exemplos funcionais do AppSheet.