{"id":707,"date":"2020-08-27T23:53:46","date_gmt":"2020-08-28T02:53:46","guid":{"rendered":"https:\/\/wp.ufpel.edu.br\/planilhasgoogle\/?page_id=707"},"modified":"2020-08-28T00:08:21","modified_gmt":"2020-08-28T03:08:21","slug":"trabalhando-com-dados","status":"publish","type":"page","link":"https:\/\/wp.ufpel.edu.br\/planilhasgoogle\/modulo-avancado\/aula-3-scripts-google\/trabalhando-com-dados\/","title":{"rendered":"Trabalhando com Dados"},"content":{"rendered":"

Configurando<\/h3>\n

Os exerc\u00edcios neste codelab requerem uma planilha para funcionar. Siga estas etapas para criar uma nova planilha para usar nestes exerc\u00edcios:<\/p>\n

    \n
  1. Crie uma nova planilha em seu Google Drive.\u00a0Voc\u00ea pode fazer isso na\u00a0interface<\/a>\u00a0do\u00a0Drive<\/a>\u00a0selecionando\u00a0Novo> Planilhas Google\u00a0.\u00a0A nova planilha \u00e9 colocada em seu Drive raiz por padr\u00e3o.<\/li>\n
  2. Clique no t\u00edtulo da planilha e altere de “Planilha sem t\u00edtulo” para “Manipula\u00e7\u00e3o de dados e menus personalizados”.\u00a0Sua planilha deve ser semelhante a esta:<\/li>\n<\/ol>\n

    <\/p>\n

    \n

      \n
    1. Selecione\u00a0Ferramentas> Editor de scripts\u00a0para abrir o editor de scripts.<\/li>\n
    2. Clique no t\u00edtulo do projeto e altere-o de “Projeto sem t\u00edtulo” para “Manipula\u00e7\u00e3o de dados e menus personalizados”.\u00a0Clique em\u00a0OK\u00a0para salvar a altera\u00e7\u00e3o do t\u00edtulo:<\/li>\n<\/ol>\n

      <\/p>\n

      \n

      \u00a0 \u00a0 Com uma planilha e um projeto em branco, voc\u00ea est\u00e1 pronto para iniciar o laborat\u00f3rio!\u00a0Passe para a pr\u00f3xima se\u00e7\u00e3o para come\u00e7ar a aprender sobre os menus personalizados.<\/p>\n

       <\/p>\n

      Observa\u00e7\u00e3o:\u00a0se voc\u00ea estiver usando uma\u00a0conta\u00a0gmail.com<\/a>\u00a0, poder\u00e1 ver uma caixa de di\u00e1logo “Este aplicativo n\u00e3o foi verificado” ao usar o script pela primeira vez.\u00a0O Google usa isso para avisar os usu\u00e1rios que podem estar usando c\u00f3digo de autores desconhecidos ou n\u00e3o confi\u00e1veis.\u00a0Se voc\u00ea vir esta caixa de di\u00e1logo, n\u00e3o h\u00e1 problema em continuar, pois voc\u00ea \u00e9 o autor do script.\u00a0Nesses casos, continue autorizando o script fazendo o seguinte:<\/p>\n

        \n
      1. Na caixa de di\u00e1logo “Este aplicativo n\u00e3o foi verificado”, clique em\u00a0Avan\u00e7ado\u00a0.<\/li>\n
      2. Clique em\u00a0Ir para manipula\u00e7\u00e3o de dados e menus personalizados (inseguro).<\/li>\n
      3. Na pr\u00f3xima tela, clique em\u00a0Permitir\u00a0.<\/li>\n<\/ol>\n

        Ao longo deste codelab, voc\u00ea pode ver v\u00e1rios prompts de permiss\u00e3o.\u00a0Siga as instru\u00e7\u00f5es na tela para continuar autorizando o c\u00f3digo.\u00a0Voc\u00ea pode ler mais sobre esse processo no\u00a0guia de autoriza\u00e7\u00e3o<\/a>\u00a0do\u00a0Apps Script<\/a>\u00a0.<\/p>\n

         <\/p>\n

        Vis\u00e3o\u00a0geral: importar dados com um item de menu personalizado<\/h3>\n

        O Apps Script oferece a capacidade de definir\u00a0menus personalizados<\/a>\u00a0que podem aparecer no Planilhas Google.\u00a0Voc\u00ea tamb\u00e9m pode usar menus personalizados no Google Docs, Google Slides e Google Forms.\u00a0Ao definir um item de menu personalizado, voc\u00ea cria um r\u00f3tulo de texto e o conecta a uma fun\u00e7\u00e3o do Apps Script em seu projeto de script.\u00a0Quando voc\u00ea adiciona o menu \u00e0 IU, ele aparece no Planilhas Google:<\/p>\n

        <\/p>\n

        \u00a0 \u00a0 Quando um usu\u00e1rio clica em um item de menu personalizado, a fun\u00e7\u00e3o do Apps Script associada a ele \u00e9 executada.\u00a0Esta \u00e9 uma maneira pr\u00e1tica de fazer com que as fun\u00e7\u00f5es do Apps Script sejam executadas sem ter que abrir o editor de script.\u00a0Ele tamb\u00e9m permite que outros usu\u00e1rios da planilha executem seu c\u00f3digo sem precisar saber nada sobre como ele ou o Apps Script funcionam – para eles, \u00e9 apenas mais um item de menu.<\/p>\n

        Os itens de menu personalizados s\u00e3o definidos na\u00a0fun\u00e7\u00e3o de\u00a0gatilho simples<\/em>\u00a0, sobre a qual voc\u00ea aprender\u00e1 na pr\u00f3xima se\u00e7\u00e3o.onOpen()<\/code><\/a><\/p>\n

         <\/p>\n

        A fun\u00e7\u00e3o onOpen ()<\/h3>\n

        \u00a0 \u00a0\u00a0Os gatilhos<\/a><\/em>\u00a0no Apps Script fornecem uma maneira de executar c\u00f3digos espec\u00edficos do Apps Script em resposta a condi\u00e7\u00f5es ou eventos espec\u00edficos.\u00a0Ao criar um gatilho, voc\u00ea define qual evento faz com que o gatilho seja disparado e fornece uma fun\u00e7\u00e3o do Apps Script que \u00e9 executada quando esse evento acontece.<\/p>\n

        onOpen()<\/a><\/code>\u00e9 um exemplo de\u00a0gatilho simples<\/em>\u00a0.\u00a0Gatilhos simples s\u00e3o f\u00e1ceis de configurar – tudo o que voc\u00ea precisa fazer \u00e9 escrever uma fun\u00e7\u00e3o do Apps Script chamada\u00a0onOpen()<\/code>\u00a0e o Apps Script a executar\u00e1 sempre que a planilha associada for aberta ou recarregada:<\/p>\n

        \/**\r\n * A special function that runs when the spreadsheet is first\r\n * opened or reloaded. onOpen() is used to add custom menu\r\n * items to the spreadsheet.\r\n *\/<\/span>\r\nfunction<\/span> onOpen<\/span>()<\/span> {<\/span>\r\n \/* ... *\/<\/span> \r\n}<\/span><\/code><\/pre>\n
         <\/p>\n