Google Sheets módulos
Em um cenário Adobe Workfront Fusion, você pode automatizar fluxos de trabalho que usam Google Sheets, bem como conectá-los a vários aplicativos e serviços de terceiros.
Para obter instruções sobre como conectar sua conta do Google Sheets ao Workfront Fusion, consulte Criar uma conexão com o Adobe Workfront Fusion - Instruções básicas
Requisitos de acesso
Você deve ter o seguinte acesso para usar a funcionalidade neste artigo:
Para saber que plano, tipo de licença ou acesso você tem, contate o administrador do Workfront.
Para obter informações sobre Adobe Workfront Fusion licenças, consulte Adobe Workfront Fusion licenças.
Pré-requisitos
Para usar os módulos do Google Sheets, você deve ter uma conta do Google.
Informações da API do Google Sheets
O conector do Google Sheets usa o seguinte:
Triggers
Linhas de observação
Recupera valores de cada linha adicionada recentemente na planilha.
O módulo recupera somente novas linhas que não foram preenchidas anteriormente. O disparador não processará uma linha substituída.
Ações
Adicionar uma linha
Este módulo anexa adiciona uma linha a uma planilha.
Ao configurar módulos do Google Sheets, o Workfront Fusion exibe os campos listados abaixo. Junto com esses, campos Google Sheets adicionais podem ser exibidos, dependendo de fatores como seu nível de acesso no aplicativo ou serviço. Um título em negrito em um módulo indica um campo obrigatório.
Se você vir o botão de mapa acima de um campo ou função, poderá usá-lo para definir variáveis e funções para esse campo. Para obter mais informações, consulte Mapear informações de um módulo para outro em Adobe Workfront Fusion.
Atualizar uma linha
Esse módulo permite alterar o conteúdo da célula em uma linha selecionada.
Limpar uma Linha
Exclui valores de uma linha especificada.
Excluir uma Linha
Exclui uma linha especificada.
Obter uma Célula
Recupera um valor de uma célula selecionada.
Atualizar uma Célula
Limpar uma Célula
Exclui um valor de uma célula especificada.
Adicionar uma Planilha
Cria uma nova planilha em uma planilha selecionada.
Criar uma Planilha
Excluir uma Planilha
Exclui uma planilha específica.
Fazer uma chamada de API
Esse módulo de ação permite executar uma chamada de API personalizada.
https://sheets.googleapis.com/v4/.{"Content-type":"application/json"}. Workfront Fusion adiciona os cabeçalhos de autorização para você.Adicione o conteúdo do corpo para a chamada à API na forma de um objeto JSON padrão.
Nota:
Ao usar instruções condicionais como if em seu JSON, coloque as aspas fora da instrução condicional.
Pesquisas
Pesquisar Linhas
Pesquisa linhas usando as opções de filtro.
Pesquisar Linhas (Avançado)
Retorna resultados que correspondem aos critérios fornecidos.
Obter Valores de Intervalo
Listar planilhas
Este módulo retorna uma lista de todas as planilhas em uma planilha.
Limites de uso
Se o erro 429: RESOURCE_EXHAUSTED ocorrer, você excedeu o limite de taxa da API.
A API Google Sheets tem um limite de 500 solicitações por 100 segundos por projeto e 100 solicitações por 100 segundos por usuário. Os limites para leituras e gravações são rastreados separadamente. Não há limite de uso diário.
Veja mais detalhes em developers.google.com/sheets/api/limits.
Dicas e truques
Como obter Células Vazias de um Google Sheet
Use o módulo Linhas de Pesquisa (Avançadas) e use esta fórmula para obter as colunas que estão vazias.
selecione * onde E é nulo
Adicionar um botão em uma planilha para executar um cenário
-
Em Workfront Fusion, insira o módulo/acionador Webhook > Webhooks personalizados no cenário e configure-o (consulte Webhooks).
-
Copie o URL do webhook.
-
Execute o cenário.
-
No Google Sheets, escolha Inserir > Desenho… na barra de menu principal.
-
Na janela Desenho, clique no ícone
-
Crie um botão e clique no botão Salvar e Fechar no canto superior direito:
-
O botão será colocado em sua planilha. Clique nos três pontos verticais no canto superior direito do botão:
-
Escolha Atribuir script… no menu.
-
Insira o nome do seu script (função), ex.:
runScenarioe clique em OK: -
Escolha Ferramentas > Editor de scripts na barra de menu principal.
-
Insira o seguinte código:
-
O nome da função deve corresponder ao nome especificado na etapa 9.
-
Substitua o URL pelo URL do webhook copiado na etapa 2.
função runScenario() {UrlFetchApp.fetch("<webhook copiado>");}
-
-
Pressione Ctrl+S para salvar o arquivo de script, digite um nome de projeto e clique em OK.
-
Volte para Google Sheets e clique no novo botão.
-
Conceda a autorização necessária para o script:
-
Em Workfront Fusion, verifique se o cenário foi executado com êxito.
Armazenamento de datas em uma planilha
Se você armazenar um valor Date em uma planilha sem qualquer formatação, ele será exibido na planilha como texto no formato ISO 8601. No entanto, Google Sheets fórmulas ou funções que funcionam com datas que não compreendem este texto (Exemplo: fórmula =A1+10) exibirão o seguinte erro:
Para ajudar a permitir que Google Sheets entenda a data, formate-a com a função formatDate (date; format; [timezone]). O formato correto passado para a função como o segundo argumento depende das configurações de localidade da planilha.
Para determinar o formato correto:
-
Escolha Arquivo > Planilha configurações no menu principal para verificar/definir a localidade.
-
Depois de verificar/definir a localidade adequada, determine o formato de data e hora correspondente, escolhendo Formato > Número no menu principal. O formato é exibido ao lado do item de menu Data e hora:
-
Para compor o formato correto que deve ser passado para a função formatDate(), consulte a lista de tokens para a formatação de data e hora em Adobe Workfront Fusion.
Exemplo: O uso do formato MM/DD/YYYY HH:mm:ss para a localidade dos Estados Unidos:
Explorando funções Google Sheets
Se você perder uma função interna, mas ela for apresentada por Google Sheets, poderá explorá-la. Para obter mais informações, consulte Usar Google Sheets funções em Mapear itens usando funções em Adobe Workfront Fusion.
Impedir Google Sheets de alterar números em datas
Você pode descobrir que uma sequência de números que você está usando como texto está sendo interpretada como uma data em uma planilha Google. Por exemplo, você digita 1-2019, com a intenção de texto, mas o Google o interpreta como uma data. Você pode pré-formatar o número como texto simples para evitar isso.
- Em Google Sheets, realce a coluna ou célula que contém o número ou os números.
- Clique em Formatar > Número > Texto sem formatação.
Outra solução alternativa em Workfront Fusion é digitar um apóstrofo (') antes de um número, por exemplo, '1-2019 ou '1/47. O apóstrofo não é exibido na célula após os dados serem enviados de Workfront Fusion.