{"id":708,"date":"2020-08-27T23:53:49","date_gmt":"2020-08-28T02:53:49","guid":{"rendered":"https:\/\/wp.ufpel.edu.br\/planilhasgoogle\/?page_id=708"},"modified":"2020-08-28T00:03:50","modified_gmt":"2020-08-28T03:03:50","slug":"formatacao-de-dados","status":"publish","type":"page","link":"https:\/\/wp.ufpel.edu.br\/planilhasgoogle\/modulo-avancado\/aula-3-scripts-google\/formatacao-de-dados\/","title":{"rendered":"Formata\u00e7\u00e3o de Dados"},"content":{"rendered":"

Configurando<\/h3>\n

Antes de continuar, voc\u00ea precisa de uma planilha com alguns dados.\u00a0Como antes, fornecemos uma folha de dados que voc\u00ea pode copiar para esses exerc\u00edcios.\u00a0Execute as seguintes etapas:<\/p>\n

    \n
  1. Clique neste link para copiar a planilha de dados<\/a>\u00a0e, em seguida, clique no bot\u00e3o\u00a0Fazer uma c\u00f3pia\u00a0.\u00a0A nova planilha \u00e9 colocada na pasta inicial do Google Drive e \u00e9 chamada de “C\u00f3pia da\u00a0formata\u00e7\u00e3o\u00a0de dados”.<\/li>\n
  2. Clique no t\u00edtulo da planilha e altere-o de “C\u00f3pia da\u00a0formata\u00e7\u00e3o\u00a0de dados” para “Formata\u00e7\u00e3o\u00a0de dados”.\u00a0Sua folha deve ficar assim, com algumas informa\u00e7\u00f5es b\u00e1sicas sobre os tr\u00eas primeiros filmes de Star Wars:<\/li>\n<\/ol>\n

    <\/p>\n

      \n
    1. Selecione\u00a0Ferramentas> Editor de scripts\u00a0para abrir o editor de scripts.<\/li>\n
    2. Clique no t\u00edtulo “Projeto sem t\u00edtulo” e altere para “Formata\u00e7\u00e3o\u00a0de dados”.<\/li>\n
    3. Clique em\u00a0OK\u00a0para salvar a altera\u00e7\u00e3o do t\u00edtulo.<\/li>\n<\/ol>\n

       <\/p>\n

       <\/p>\n

      Crie um menu personalizado<\/h3>\n

      Voc\u00ea pode aplicar v\u00e1rios m\u00e9todos b\u00e1sicos de\u00a0formata\u00e7\u00e3o\u00a0no Apps Script \u00e0s suas planilhas.\u00a0Os exerc\u00edcios a seguir demonstram algumas maneiras de formatar dados.\u00a0Para ajudar a controlar suas a\u00e7\u00f5es de\u00a0formata\u00e7\u00e3o, vamos criar um menu personalizado com os itens de que voc\u00ea precisa.\u00a0O processo de cria\u00e7\u00e3o de menus personalizados foi descrito no\u00a0codelab\u00a0Trabalhando com dados<\/a>\u00a0, mas vamos resumi-lo aqui novamente.<\/p>\n

       <\/p>\n

      Implementa\u00e7\u00e3o<\/h4>\n

      Vamos criar um menu personalizado!<\/p>\n

        \n
      1. No editor do Apps Script, substitua o c\u00f3digo em seu projeto de script pelo seguinte:<\/li>\n<\/ol>\n
        \/**\r\n * A special function that runs when the spreadsheet is opened\r\n * or reloaded, used to add a custom menu to the spreadsheet.\r\n *\/<\/span>\r\nfunction<\/span> onOpen<\/span>()<\/span> {<\/span>\r\n  \/\/ Get the Ui object. <\/span>\r\n  var<\/span> ui <\/span>=<\/span> SpreadsheetApp<\/span>.<\/span>getUi<\/span>();<\/span>\r\n  \r\n  \/\/ Create and add a named menu and its items to the menu bar.<\/span>\r\n  ui<\/span>.<\/span>createMenu<\/span>(<\/span>'Quick formats'<\/span>)<\/span>\r\n   .<\/span>addItem<\/span>(<\/span>'Format row header'<\/span>,<\/span> 'formatRowHeader'<\/span>)<\/span>\r\n   .<\/span>addItem<\/span>(<\/span>'Format column header'<\/span>,<\/span> 'formatColumnHeader'<\/span>)<\/span>\r\n   .<\/span>addItem<\/span>(<\/span>'Format dataset'<\/span>,<\/span> 'formatDataset'<\/span>)<\/span> \r\n  .<\/span>addToUi<\/span>();<\/span>\r\n}<\/span><\/code><\/pre>\n
          \n
        1. Salve seu projeto de script.<\/li>\n
        2. No editor de script, selecione\u00a0onOpen<\/code>no menu suspenso da barra de tarefas e clique no\u00a0bot\u00e3o.\u00a0Isso ser\u00e1 executado\u00a0onOpen()<\/code>para reconstruir o menu da planilha, para que voc\u00ea n\u00e3o precise recarregar a planilha.<\/li>\n<\/ol>\n
           <\/p>\n
          Revis\u00e3o de c\u00f3digo<\/h4>\n
          Vamos revisar este c\u00f3digo para entender como ele funciona.\u00a0Em\u00a0onOpen()<\/code>, a primeira linha usa o\u00a0getUi()<\/code><\/a>m\u00e9todo para adquirir um\u00a0Ui<\/code><\/a>objeto que representa a interface do usu\u00e1rio da planilha ativa \u00e0 qual este script est\u00e1 vinculado.<\/p>\n
          As pr\u00f3ximas linhas criar um novo menu (\u00a0Quick formats<\/code>), itens de menu add (\u00a0Format row header<\/code>,\u00a0Format column header<\/code>e\u00a0Format dataset<\/code>) para esse menu, e depois adicionar o menu para a interface do planilha.\u00a0Isto \u00e9 feito com as\u00a0createMenu(caption)<\/code><\/a>,\u00a0addItem(caption, functionName)<\/code><\/a>e\u00a0addToUi()<\/code><\/a>m\u00e9todos, respectivamente.<\/p>\n
          O\u00a0addItem(caption, functionName)<\/code><\/a>cria uma conex\u00e3o entre o r\u00f3tulo do item de menu e uma fun\u00e7\u00e3o Apps Script que \u00e9 executada quando esse item de menu \u00e9 selecionado.\u00a0Por exemplo, selecionar o\u00a0Format row header<\/code>item de menu faz com que o Planilhas tente executar a\u00a0formatRowHeader()<\/code>fun\u00e7\u00e3o (que ainda n\u00e3o existe).<\/p>\n
           <\/p>\n
          Resultados<\/h4>\n
          Em sua planilha, voc\u00ea pode clicar no\u00a0Quick formats<\/code>menu para ver os novos itens de menu:<\/p>\n
          <\/p>\n
          \u00a0 \u00a0 Clicar em qualquer um desses itens agora causar\u00e1 um erro, pois voc\u00ea ainda n\u00e3o implementou suas fun\u00e7\u00f5es correspondentes.\u00a0As pr\u00f3ximas se\u00e7\u00f5es cobrem a implementa\u00e7\u00e3o dessas fun\u00e7\u00f5es.<\/p>\n
           <\/p>\n
           <\/p>\n
          Formate uma linha de cabe\u00e7alho<\/h3>\n
          Os conjuntos de dados em planilhas geralmente t\u00eam linhas de cabe\u00e7alho que identificam os dados em cada coluna.\u00a0Normalmente, \u00e9 uma boa ideia formatar linhas de cabe\u00e7alho para separ\u00e1-los visualmente do restante dos dados da planilha.<\/p>\n
          No primeiro codelab, voc\u00ea construiu uma macro para seu cabe\u00e7alho e ajustou seu c\u00f3digo.\u00a0Aqui, voc\u00ea formatar\u00e1 uma linha de cabe\u00e7alho do zero usando o Apps Script.\u00a0A linha de cabe\u00e7alho que voc\u00ea criar aqui ir\u00e1 colocar em negrito o texto do cabe\u00e7alho, colorir o fundo de um azul-esverdeado escuro, colorir o texto de branco e adicionar algumas bordas s\u00f3lidas.<\/p>\n
           <\/p>\n
          Implementa\u00e7\u00e3o<\/h4>\n
          Para implementar a opera\u00e7\u00e3o de\u00a0formata\u00e7\u00e3o, voc\u00ea usar\u00e1 os mesmos\u00a0m\u00e9todos de\u00a0servi\u00e7o de planilha<\/a>\u00a0usados \u200b\u200bantes, mas agora tamb\u00e9m usar\u00e1 alguns dos m\u00e9todos de\u00a0formata\u00e7\u00e3o\u00a0do servi\u00e7o.\u00a0Execute as seguintes etapas:<\/p>\n
            \n
          1. No editor do Apps Script, adicione a seguinte fun\u00e7\u00e3o ao final do seu projeto de script:<\/li>\n<\/ol>\n
            \/**\r\n * Formats top row of the sheet using our header row style. \r\n *\/<\/span>\r\nfunction<\/span> formatRowHeader<\/span>()<\/span> {<\/span>\r\n  \/\/ Get the current active sheet and the top row's range.<\/span>\r\n  var<\/span> sheet <\/span>=<\/span> SpreadsheetApp<\/span>.<\/span>getActiveSheet<\/span>();<\/span>\r\n  var<\/span> headerRange <\/span>=<\/span> sheet<\/span>.<\/span>getRange<\/span>(<\/span>1<\/span>,<\/span> 1<\/span>,<\/span> 1<\/span>,<\/span> sheet<\/span>.<\/span>getLastColumn<\/span>());<\/span>\r\n \r\n  \/\/ Apply each format to the top row: bold white text,<\/span>\r\n  \/\/ blue-green background, and a solid black border<\/span>\r\n  \/\/ around the cells.<\/span>\r\n  headerRange\r\n    <\/span>.<\/span>setFontWeight<\/span>(<\/span>'bold'<\/span>)<\/span>\r\n    .<\/span>setFontColor<\/span>(<\/span>'#ffffff'<\/span>)<\/span>\r\n    .<\/span>setBackgroundColor<\/span>(<\/span>'#007272'<\/span>)<\/span>\r\n    .<\/span>setBorder<\/span>(<\/span>\r\n      true<\/span>,<\/span> true<\/span>,<\/span> true<\/span>,<\/span> true<\/span>,<\/span> null<\/span>,<\/span> null<\/span>,<\/span>\r\n      null<\/span>,<\/span>\r\n      SpreadsheetApp<\/span>.<\/span>BorderStyle<\/span>.<\/span>SOLID_MEDIUM<\/span>);<\/span>\r\n\r\n}<\/span><\/code><\/pre>\n
              \n
            1. Salve seu projeto de script.<\/li>\n<\/ol>\n
               <\/p>\n
              Revis\u00e3o de c\u00f3digo<\/h4>\n
              Como muitas tarefas de\u00a0formata\u00e7\u00e3o, o c\u00f3digo do Apps Script necess\u00e1rio para implement\u00e1-lo \u00e9 direto.\u00a0As primeiras duas linhas usam m\u00e9todos que voc\u00ea viu antes para obter uma refer\u00eancia para a planilha ativa atual (\u00a0sheet<\/code>) e a linha superior da planilha (\u00a0headerRange)<\/code>. O\u00a0Sheet.getRange(row, column, numRows, numColumns)<\/code><\/a>\u00a0m\u00e9todo especifica a linha superior, incluindo apenas as colunas com dados nelas. O\u00a0Sheet.getLastColumn()<\/code><\/a>m\u00e9todo apenas retorna o \u00edndice da \u00faltima coluna que cont\u00e9m os dados da planilha. Em nosso exemplo, \u00e9 a coluna E (\u00a0url\u00a0).<\/p>\n
               <\/p>\n