Google Sheets módulos
Em um cenário do Adobe Workfront Fusion, é possível automatizar fluxos de trabalho que usam o Google Sheets, bem como conectá-lo 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:
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Pacote do Adobe Workfront | Qualquer |
| Licença do Adobe Workfront |
Novo: Padrão Ou Atual: trabalho ou superior |
| Licença do Adobe Workfront Fusion** |
Atual: nenhum requisito de licença do Workfront Fusion Ou Herdados: Automação e integração do Workfront Fusion for Work |
| Produto |
Novo menu:
Ou Atual: sua organização deve comprar o Adobe Workfront Fusion. |
Para obter mais detalhes sobre as informações nesta tabela, consulte Requisitos de acesso na documentação.
Para obter informações sobre licenças do Adobe Workfront Fusion, consulte licenças do Adobe Workfront Fusion.
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:
Módulos do Google Sheets e seus campos
Ao configurar módulos do Google Forms, 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.
Acionadores
Linhas de observação
Recupera valores de linhas recém-adicionadas na planilha.
O módulo recupera somente novas linhas que não foram preenchidas anteriormente. O acionador não processa 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.
Adicionar uma Planilha
Cria uma nova planilha em uma planilha selecionada.
Limpar uma Célula
Exclui um valor de uma célula especificada.
Limpar uma Linha
Exclui valores de uma linha especificada.
Criar uma Planilha
Excluir uma Linha
Exclui uma linha especificada.
Excluir uma Planilha
Exclui uma planilha específica.
Obter uma Célula
Recupera um valor de uma célula selecionada.
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"}. O 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.
Observação:
Ao usar instruções condicionais como if em seu JSON, coloque as aspas fora da instrução condicional.
Atualizar uma Célula
Atualizar uma linha
Esse módulo permite alterar o conteúdo da célula em uma linha selecionada.
Pesquisas
Obter Valores de Intervalo
Listar planilhas
Este módulo retorna uma lista de todas as planilhas em uma planilha.
Pesquisar Linhas
Pesquisa linhas usando as opções de filtro.
Pesquisar Linhas (Avançado)
Retorna resultados que correspondem aos critérios fornecidos.
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
Obter células vazias de um Google Sheet
Para obter células vazias, você pode usar o módulo Linhas de Pesquisa (Avançadas). Use esta fórmula para obter as colunas que estão vazias.
select * where E is null
Aqui, "E" é a coluna e "é nulo" é a condição. Você pode criar uma consulta mais avançada usando a linguagem de consulta do Google. Para obter mais informações, consulte Google Query Lang na documentação do Google.
Adicionar um botão em uma planilha para executar um cenário
-
No Workfront Fusion, insira o módulo Webhook > Webhooks personalizados no cenário e configure-o. Para obter instruções, 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 Caixa de texto
-
Crie um botão e clique no botão Salvar e Fechar no canto superior direito:
-
O botão é 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.
code language-none function runScenario() { UrlFetchApp.fetch("<webhook you copied>"); }
-
-
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:
-
No 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 aparecerá 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 esse texto (Exemplo: fórmula =A1+10) exibem o seguinte erro:
Para ajudar Google Sheets a entender a data, formate-a com a função formatDate. O formato correto passado para a função como o segundo argumento depende das configurações de localidade da planilha.
Para obter mais informações sobre esta função, consulte formatDate (date; format; [timezone]) no artigo Funções de data e hora.
Para determinar o formato correto:
-
No Google Sheets, escolha Arquivo > Planilha configurações no menu principal para verificar e definir a localidade.
-
Depois de verificar ou definir a localidade apropriada, 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.
Exemplo:
Para o formato MM/DD/YYYY HH:mm:ss (para a localidade dos Estados Unidos):
Explorando funções Google Sheets
Para usar uma função integrada do Google Sheets, você pode explorá-la. Para obter mais informações, consulte Usar Google Sheets funções no artigo Mapear um item usando funções.
Impedir Google Sheets de transformar números em datas
Se uma sequência de números que você está usando como texto estiver sendo interpretada como uma data em uma planilha Google, você poderá pré-formatar o número como texto simples para evitar isso. Por exemplo, se você digitar 1-2019, com a intenção de usá-lo como texto, o Google poderá interpretá-lo como uma data.
- 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 no 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 do Workfront Fusion.