Conectar o AppSheet ao Apps Script

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.

  1. Acesse a página inicial do Apps Script e clique em + Novo projeto.
  2. Mude o título do projeto para Hello World. Caixa de diálogo "Renomear" do projeto com um novo nome..
  3. Atualize o script no editor da seguinte forma:
function logThis(msg) {
  Logger.log('Message from AppSheet was: ' + msg);
}
  1. 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.

  1. 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").
  2. Faça login no AppSheet.
  3. Na página "Meus apps", clique em Criar novo app. A caixa de diálogo Criar um novo aplicativo é exibida.
  4. Clique em Começar com seus próprios dados. Nova caixa de diálogo de criação de app.
  5. Se quiser, edite o nome do app e selecione uma categoria.
  6. Clique em Escolher seus dados.

Selecionando "Escolha seus dados" na caixa de diálogo de criação de um novo app.

  1. Clique em Google para acessar o Google Drive.
  2. Acesse e selecione a planilha Pedidos de camisas que você copiou anteriormente.

O AppSheet configura seu app. Janela de visualização inicial do app gerado.

  1. 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.

  1. Selecione Automação > Bots.
  2. Clique em + New Bot.
  3. 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.

5037cdd726e326e9.png

  1. Clique na etapa Enviar uma notificação para editá-la.
  2. Mude o nome para Call a script.

Etapas de automação para chamar um script.

  1. Em Configurações, altere o tipo de tarefa para Chamar um script.

Selecionando o tipo de tarefa "Chamar um script" nas configurações de "Automação".

  1. No campo Apps Script Project, clique em Browse (ícone de arquivo).
  2. Navegue até o projeto Hello World do Apps Script e selecione-o no seu Drive.
  3. 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.

  1. Selecione logThis(msg) na lista Nome da função. Selecionando a função "logThis()" do Apps Script na lista suspensa.

O campo Argumentos de função é exibido.

  1. Para o argumento msg, insira a seguinte expressão usando o Expression Assistant: 'Hello from AppSheet'.

Adicionar argumentos à chamada de função do Apps Script

  1. Clique em Salvar para salvar o aplicativo.
  2. No painel de visualização, clique no ícone de dispositivo móvel ou tablet para exibir o emulador do app.

68471f4646fc8fbe.png

  1. Adicione um novo pedido de camisa e clique em Salvar.
  2. Clique em Sync para sincronizar as alterações.

Clicar no ícone de sincronização no canto superior direito do painel de visualização para sincronizar com a fonte de dados.

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.

  1. Volte para a página inicial do Apps Script e veja o projeto Hello World.
  2. 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.

Veja os registros de execução no ambiente do editor do Apps Script para verificar a execução da função da chamada do AppSheet.

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

  1. Para começar, faça uma cópia do projeto de exemplos do Apps Script.
  2. Clique no ícone de cópia.
  3. 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.