Documentação Workfront Guia do Workfront

Google Sheets módulos

Last update: Wed Jul 17 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:

Criado para:

undefined

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:

Adobe Workfront plano*

Pro ou superior

Adobe Workfront licença*

Plano, Trabalho

Adobe Workfront Fusion licença**

Requisito de licença atual: nenhum requisito de licença Workfront Fusion.

Requisito de licença herdada: Workfront Fusion para Automação e Integração do Trabalho

Produto

Requisito atual do produto: se você tiver o Plano Adobe Workfront da Select ou da Prime, sua organização deve comprar o Adobe Workfront Fusion e o Adobe Workfront para usar a funcionalidade descrita neste artigo. Workfront Fusion está incluído no plano Workfront do Ultimate.

Requisito de produto herdado: sua organização deve comprar o Adobe Workfront Fusion e o Adobe Workfront para usar a funcionalidade descrita 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.

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.

IMPORTANT

Se a planilha contiver uma linha em branco, nenhuma linha após a linha em branco será processada.

Conexão

Para obter instruções sobre como conectar sua conta do Google Sheets ao Workfront Fusion, consulte Conectar o aplicativo ou serviço Web do módulo ao Workfront Fusion no artigo Criar um cenário no Adobe Workfront Fusion.

Planilha

Selecione a planilha que contém a planilha que você deseja observar.

Planilha

Selecione a planilha que deseja observar para uma nova linha.

Tabela contém cabeçalhos

Selecione se a planilha contém a linha de cabeçalho.

Sim

O módulo não recupera a linha de cabeçalho como dados de saída.

Os nomes das variáveis na saída são chamados pelos cabeçalhos.
Não

O módulo também recupera a primeira linha da tabela

Os nomes das variáveis na saída são chamados de A, B, C, D e assim por diante.

Linha com cabeçalhos

Informe a faixa da linha de cabeçalho. Por exemplo, A1:F1.

Primeira linha de tabela

Insira o intervalo da primeira linha da tabela. Por exemplo, A1:F1.

Opção de renderização de valor

Valor formatado

Os valores serão calculados e formatados na resposta de acordo com a formatação da célula. A formatação se baseia no local da planilha, não no local do usuário solicitante. Por exemplo, se A1 for 1.23 e A2 for =A1 e formatado como moeda, A2 retornará "$1.23".

Valor não formatado

Os valores serão calculados, mas não formatados na resposta. Por exemplo, se A1 for 1.23 e A2 for =A1 e formatado como moeda, A2 retornará o número "1.23".

Fórmula

Os valores não serão calculados. A resposta incluirá as fórmulas. Por exemplo, se A1 for 1.23 e A2 for =A1 e formatado como moeda, A2 retornará "=A1".

Opção de renderização de data e hora

Número de série

Instrui os campos date, time, datetime e duration a serem exibidos como duplos no formato "número de série", conforme popularizado pelo Lotus 1-2-3. A parte do número inteiro do valor (à esquerda do decimal) conta os dias desde 30 de dezembro de 1899. A parte fracional (à direita do decimal) conta o tempo como uma fração do dia. Por exemplo, 1º de janeiro de 1900 ao meio-dia seria 2,5, 2 porque é 2 dias depois de 30 de dezembro de 1899, e 0,5 porque o meio-dia é meio dia. 1 de fevereiro de 1900 às 15h seria 33.625. Isso considera corretamente o ano de 1900 como não um ano bissexto.

Cadeia de caracteres formatada

Instrui os campos de data, hora, data e hora e duração a serem exibidos como cadeias de caracteres em seu formato de número fornecido (que depende do local da planilha).

Limite

Defina o número máximo de resultados com os quais Workfront Fusion trabalhará durante um ciclo de execução.

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.

Conexão

Modo

Selecione se deseja selecionar a planilha e a planilha manualmente ou por mapeamento.

Observação: o mapeamento manual é útil, por exemplo, quando uma nova planilha é criada em um cenário Workfront Fusion e você deseja adicionar dados na planilha recém-criada diretamente no cenário.

Planilha

Selecione a planilha Google.

Planilha

Selecione a planilha à qual deseja adicionar uma linha.

Intervalo de Colunas

Selecione o intervalo de colunas com o qual deseja trabalhar.

Tabela contém cabeçalhos

Selecione se a planilha contém a linha de cabeçalho.

Sim

O módulo não recupera a linha de cabeçalho como dados de saída.

Os nomes das variáveis na saída são chamados pelos cabeçalhos.
Não

O módulo também recupera a primeira linha da tabela

Os nomes das variáveis na saída são chamados de A, B, C, D e assim por diante.

Valores

Insira ou mapeie as células desejadas da linha que deseja adicionar.

Opção de entrada de valor

Usuário inserido

Os valores são analisados como se o usuário os tivesse digitado na interface. Os números permanecem números, mas as cadeias de caracteres podem ser convertidas em números, datas ou outros formatos seguindo as mesmas regras aplicadas ao inserir texto em uma célula por meio da interface do usuário do Google Sheets.
Raw

Os valores inseridos pelo usuário não são analisados e são armazenados como estão.

Inserir opção de dados

Especifique como os dados existentes serão alterados quando novos dados forem inseridos.

Inserir linhas

São inseridas linhas para os novos dados.
Substituir

Os novos dados substituem os dados existentes nas áreas em que são gravados. A adição de dados ao final da planilha insere novas linhas ou colunas para que os dados possam ser gravados.

Atualizar uma linha

Esse módulo permite alterar o conteúdo da célula em uma linha selecionada.

Conexão

Modo

Selecione se deseja selecionar a planilha e a planilha manualmente ou por mapeamento.

Observação: o mapeamento manual é útil, por exemplo, quando uma nova planilha é criada no cenário do Workfront Fusion e você deseja adicionar dados à planilha recém-criada diretamente no cenário.

Planilha

Selecione a planilha Google.

Planilha

Selecione a planilha na qual deseja atualizar uma linha.

Número de linha

Informe o número da linha que deseja atualizar.

Tabela contém cabeçalhos

Selecione se a planilha contém a linha de cabeçalho.

Sim

O módulo não recupera a linha de cabeçalho como dados de saída.

Os nomes das variáveis na saída são chamados pelos cabeçalhos.
Não

O módulo também recupera a primeira linha da tabela

Os nomes das variáveis na saída são chamados de A, B, C, D e assim por diante.

Valores

Insira ou mapeie os valores para as células desejadas da linha que você deseja alterar (atualizar).

Opção de entrada de valor

Usuário inserido

Os valores são analisados como se o usuário os tivesse digitado na interface. Os números permanecem números, mas as cadeias de caracteres podem ser convertidas em números, datas ou outros formatos seguindo as mesmas regras aplicadas ao inserir texto em uma célula por meio da interface do usuário do Google Sheets.
Raw

Os valores inseridos pelo usuário não são analisados e são armazenados como estão.

Limpar uma Linha

Exclui valores de uma linha especificada.

Conexão

Planilha

Selecione a planilha Google que contém a planilha da qual você deseja limpar uma linha.

Planilha

Selecione a planilha cujos dados você deseja limpar.

Número de linha

Insira o número da linha da qual deseja limpar dados. Por exemplo, 23.

Excluir uma Linha

Exclui uma linha especificada.

Conexão

Planilha

Selecione a planilha do Google que contém a planilha da qual deseja excluir uma linha.

Planilha

Selecione a planilha da qual deseja excluir uma linha.

Número da linha

Informe o número da linha que deseja deletar. Exemplo: 23

Obter uma Célula

Recupera um valor de uma célula selecionada.

Conexão

Planilha

Selecione a planilha Google.

Planilha

Selecione a planilha que contém a célula da qual deseja recuperar dados.

Célula

Insira a ID da célula da qual deseja recuperar dados. Exemplo: A6

Opção de renderização de valor

Valor formatado

Unformatted value

Os valores serão calculados, mas não formatados na resposta. Por exemplo, se A1 for 1.23 e A2 for =A1 e formatado como moeda, A2 retornará o número "1.23".

Formula

Os valores não serão calculados. A resposta incluirá as fórmulas. Por exemplo, se A1 for 1.23 e A2 for =A1 e formatado como moeda, A2 retornará "=A1".

Date and time render option

Serial number

Formatted string

Instrui os campos de data, hora, data e hora e duração a serem exibidos como cadeias de caracteres em seu formato de número fornecido (que depende do local da planilha).

Atualizar uma Célula

Conexão

Planilha

Selecione a planilha Google.

Célula

Insira a ID da célula que deseja atualizar. Exemplo: A5

Valor

Insira o novo valor para a célula.

Opção de entrada de valor

Usuário inserido

Os valores são analisados como se o usuário os tivesse digitado na interface. Os números permanecem números, mas as cadeias de caracteres podem ser convertidas em números, datas ou outros formatos seguindo as mesmas regras aplicadas ao inserir texto em uma célula por meio da interface do usuário do Google Sheets.
Raw

Os valores inseridos pelo usuário não são analisados e são armazenados como estão.

Limpar uma Célula

Exclui um valor de uma célula especificada.

Conexão

Planilha

Selecione a planilha do Google que contém a planilha da qual você deseja limpar uma célula.

Planilha

Selecione a planilha da qual deseja limpar uma célula.

Célula

Insira a ID da célula que deseja limpar. Exemplo: A5.

Adicionar uma Planilha

Cria uma nova planilha em uma planilha selecionada.

Conexão

Planilha

Selecione a planilha do Google à qual deseja adicionar uma planilha.

Propriedades

Título

Digite o nome da nova planilha.
Índice

Insira a posição da planilha. O padrão é 0 (coloca a planilha no primeiro lugar)

Criar uma Planilha

Conexão

Título

Insira o nome de uma nova planilha.

Localidade

Informe o local da planilha em um dos seguintes formatos:

um código de idioma ISO 639-1, como en
um código de idioma ISO 639-2, como haw, se não existir um código 639-1
uma combinação do código ISO de idioma e do código do país, como en_US

Intervalo de recálculo

O tempo de espera antes que as funções voláteis sejam recalculadas:

Na alteração

Funções voláteis são atualizadas a cada mudança.

Em alteração e a cada minuto

Funções voláteis são atualizadas a cada mudança e a cada minuto.

Em alteração e a cada hora

As funções voláteis são atualizadas a cada mudança e a cada hora.

Fuso horário

Selecione o fuso horário da planilha.

Formato de número

Selecione o formato padrão de todas as células da planilha.

Texto: formatação de texto. Exemplo: 1000. 12

Number: Formatação de número. Exemplo: 1,000.12

Percent: formatação de porcentagem. Exemplo: 10. 12%

Moeda: Formatação de moeda. Exemplo: $1,000.12

Data: formatação de data. Exemplo: 9/26/2008

Time: formatação de hora. Exemplo: 3:59:00 PM

Data hora: formatação de data e hora. Exemplo: 9/26/08 15:59:00

Científico Formatação de número científico. Exemplo: 1. 01E+03

Planilhas

Clique em Adicionar para adicionar uma planilha à planilha. Para cada planilha, insira ou mapeie um título para a planilha e o índice da planilha. Um índice de 0 representa a primeira planilha.

Excluir uma Planilha

Exclui uma planilha específica.

Conexão

Planilha

Selecione a planilha Google.

Planilha

Selecione a planilha que deseja excluir.

Fazer uma chamada de API

Esse módulo de ação permite executar uma chamada de API personalizada.

Conexão

Para obter instruções sobre como conectar sua conta do [Fusion App] ao Workfront Fusion, consulte Criar uma conexão com Adobe Workfront Fusion - Instruções básicas

URL

Insira um caminho relativo para https://sheets.googleapis.com/v4/.

Método

Selecione o método de solicitação HTTP necessário para configurar a chamada de API. Para obter mais informações, consulte Métodos de solicitação HTTP em Adobe Workfront Fusion.

Cabeçalhos

Adicione os cabeçalhos da solicitação na forma de um objeto JSON padrão. Por exemplo, {"Content-type":"application/json"}. Workfront Fusion adiciona os cabeçalhos de autorização para você.

Cadeia de Consulta

Adicione a consulta da chamada à API na forma de um objeto JSON padrão.

Corpo

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
Pesquisar Linhas (Avançado)
Obter Valores de Intervalo
Listar planilhas

Pesquisar Linhas

Pesquisa linhas usando as opções de filtro.

Conexão

Para obter instruções sobre como conectar sua conta do [Fusion App] ao Workfront Fusion, consulte Criar uma conexão com Adobe Workfront Fusion - Instruções básicas

Planilha

Selecione a planilha Google.

Planilha

Selecione a planilha na qual deseja pesquisar as linhas.

Tabela contém cabeçalhos

Selecione se a planilha contém a linha de cabeçalho. Se a opção Sim estiver selecionada, o módulo não recuperará a linha de cabeçalho, pois os dados de saída e os nomes de variáveis na saída são chamados pelos cabeçalhos. Se a opção Não estiver selecionada, o módulo também recuperará a primeira linha da tabela e os nomes de variáveis na saída serão chamados apenas de A, B, C, D e assim por diante.

Intervalo de colunas

Selecione o intervalo de colunas com o qual trabalhar. Exemplo: A-F

Filtro

Defina o filtro para a linha a ser pesquisada.

Para obter mais informações sobre filtros, consulte Adicionar um filtro a um cenário no Adobe Workfront Fusion.

Ordem de classificação

Selecione se deseja classificar em ordem crescente ou decrescente.

Ordenar por

Escolha a coluna pela qual deseja classificar.

Opção de renderização de valor

Valor formatado

Valor não formatado

Os valores serão calculados, mas não formatados na resposta. Por exemplo, se A1 for 1.23 e A2 for =A1 e formatado como moeda, A2 retornará o número "1.23".

Fórmula

Os valores não serão calculados. A resposta incluirá as fórmulas. Por exemplo, se A1 for 1.23 e A2 for =A1 e formatado como moeda, A2 retornará "=A1".

Opção de renderização de data e hora

Número de série

Cadeia de caracteres formatada

Instrui os campos de data, hora, data e hora e duração a serem exibidos como cadeias de caracteres em seu formato de número fornecido (que depende do local da planilha).

Número máximo de linhas retornadas

Defina o número máximo de linhas que Workfront Fusion retornará durante um ciclo de execução.

Pesquisar Linhas (Avançado)

Retorna resultados que correspondem aos critérios fornecidos.

Conexão

Planilha

Selecione a planilha do Google que contém a planilha que você deseja pesquisar.

Planilha

Selecione a planilha que contém as linhas que você deseja pesquisar.

Consulta

Use o Google Charts Query Language. Exemplo: select * where B = "John"

Para obter mais informações sobre Google Charts Query Language, consulte Referência da linguagem de consulta na documentação Google.

Obter Valores de Intervalo

Conexão

Planilha

Selecione a planilha Google.

Planilha

Selecione a planilha da qual deseja obter o conteúdo do intervalo.

Intervalo

Insira o intervalo que deseja obter. Exemplo: A1:D25.

Tabela contém cabeçalhos

Marque esta caixa se a planilha tiver uma linha de cabeçalho

Linha com cabeçalhos

Insira o intervalo dos cabeçalhos da tabela. Exemplo A1:F1. Se você deixar o campo vazio, Workfront Fusion vai supor que o cabeçalho está na primeira linha do intervalo especificado.

Opção de renderização de valor

Valor formatado

Valor não formatado

Os valores serão calculados, mas não formatados na resposta. Por exemplo, se A1 for 1.23 e A2 for =A1 e formatado como moeda, A2 retornará o número "1.23".

Fórmula

Os valores não serão calculados. A resposta incluirá as fórmulas. Por exemplo, se A1 for 1.23 e A2 for =A1 e formatado como moeda, A2 retornará "=A1".

Opção de renderização de data e hora

Número de série

Cadeia de caracteres formatada

Instrui os campos de data, hora, data e hora e duração a serem exibidos como cadeias de caracteres em seu formato de número fornecido (que depende do local da planilha).

Listar planilhas

Este módulo retorna uma lista de todas as planilhas em uma planilha.

Conexão

Planilha

Selecione a planilha Google que contém as planilhas que você deseja listar.

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 uma Planilha Google
Adicionar um botão em uma planilha para executar um cenário

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 da caixa de texto próximo à parte superior da janela.
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.: runScenario e 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 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:
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.

recommendation-more-help

5f00cc6b-2202-40d6-bcd0-3ee0c2316b43