Conectar o AppSheet com o Apps Script

1. Introdução

Neste codelab, você vai criar um projeto do Apps Script chamado "Hello World" e adicionar uma função simples, logThis, que registra uma mensagem que foi transmitida a ele. Em seguida, crie uma automação da página de app e faça com que ela chame o script. Depois que o script for chamado, você retornará ao editor do Apps Script e confirmará a execução dele.

O que você vai aprender

  • Como criar um projeto do Apps Script com uma função simples.
  • Como criar um app simples do AppSheet com base em uma planilha Google.
  • Como criar uma automação do AppSheet que chama a função do script.
  • Como verificar a execução bem-sucedida do script no AppSheet.

O que é necessário

  • Acesso ao ambiente de desenvolvimento do AppSheet (appsheet.com).
  • Acesso ao ambiente de desenvolvimento do Apps Script (script.google.com).

2. Crie um projeto do Apps Script

Primeiro, crie um projeto do Apps Script chamado "Hello World" e adicione uma função simples, logThis, que registre uma mensagem transmitida para ele.

  1. Acesse a página inicial do Apps Script e clique em + Novo projeto.
  2. Mudar o título do projeto para Hello World. Caixa de diálogo "Renomear projeto" com o novo nome.
  3. Atualize o script no editor desta 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, você gera rapidamente um novo app do AppSheet com base em um exemplo de planilha Google copiado e o atualiza para chamar o projeto do Apps Script que você criou antes.

  1. Abra a planilha Exemplo de pedidos de camisetas e clique em Fazer uma cópia para fazer o download e abrir uma cópia nas Planilhas Google. Se quiser, você pode renomear a planilha (por exemplo,"Peças de camisas").
  2. Faça login no AppSheet.
  3. Na página "Meus apps", clique em + Criar um novo app. A caixa de diálogo Criar um novo app vai aparecer.
  4. Clique em Começar com seus próprios dados. Caixa de diálogo de criação de novo app.
  5. Se quiser, edite o nome do app e selecione uma categoria.
  6. Clique em Escolher seus dados.

Selecionando "Escolher seus dados" na caixa de diálogo de criação de apps.

  1. Clique em google para acessar o Google Drive.
  2. Navegue e selecione a planilha Pedidos de camisa que você copiou.

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

  1. Clique em Personalizar seu app para abrir o app no editor do AppSheet.

4. Criar uma automação

Em seguida, crie uma automação da Appsheet e faça com que ela chame o script.

  1. Selecione Automação > Bots.
  2. Clique em + Novo bot.
  3. Selecione o primeiro item na lista de sugestões: Enviar uma notificação quando um registro de pedidos de camisas 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, mude o tipo de tarefa para Chamar um script.

Selecionar o tipo de tarefa "Chamar um script" nas configurações de automação.

  1. No campo Apps Script Project, clique em Procurar (ícone de arquivo).
  2. Acesse e selecione o projeto Hello World do Apps Script no Drive.
  3. Clique em Selecionar e, se for necessário, clique em Autorizar e siga as instruções.

O projeto do Apps Script é adicionado, e o campo Nome da função é preenchido com uma lista de funções disponíveis.

  1. Selecione logThis(msg) na lista Nome da função. Selecionar a função "logThis()" do Apps Script no menu suspenso.

O campo Argumentos da função é exibido.

  1. Para o argumento msg, insira a seguinte expressão usando o Assistente de expressão: ‘Hello from AppSheet'

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

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

68471f4646fc8fbe.png

  1. Adicione um novo pedido de camisa e clique em Salvar.
  2. Clique em Sincronizar para sincronizar as mudanças.

Clique 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 ao editor do Apps Script e confirme a execução.

  1. Volte para a página inicial do Apps Script e visualize 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 Atualizar se o registro não aparecer.

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

6. Etapas adicionais opcionais

Como etapa adicional neste workshop, revise o projeto de exemplos do Apps Script e execute alguns dos exemplos do AppSheet.

Começar a usar 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 Run para autorizar os apps no projeto.

Teste vários dos exemplos

  • createCalendarEvent(): crie um novo evento da Agenda.
  • createDoc(): cria um documento automaticamente.
  • createSheet(): cria uma nova página.
  • createSlideDeck(): crie uma nova apresentação de slides usando uma imagem e texto.

Para saber mais sobre esse recurso importante, consulte Chamar o Apps Script de uma automação, que oferece uma visão geral detalhada, vídeos de recursos, tutoriais e um projeto do Apps Script que pode ser copiado com muitos exemplos de trabalho do AppSheet e do Apps Script.