Ir para o conteúdo

Atividade Atualizar Planilhas do Google Sheets

Introdução

Uma atividade Atualizar Planilhas do Google Sheets, utilizando sua conexão com o Google Sheets, atualiza uma planilha do Google Sheets e é destinada a ser usada como um destino para consumir dados em uma operação.

Criar uma atividade Atualizar Planilhas do Google Sheets

Uma instância de uma atividade Atualizar Planilhas do Google Sheets é criada a partir de uma conexão com o Google Sheets usando seu tipo de atividade Atualizar Planilhas.

Para criar uma instância de uma atividade, arraste o tipo de atividade para a tela de design ou copie o tipo de atividade e cole-o na tela de design. Para mais detalhes, veja Criar uma instância de atividade ou ferramenta em Reutilização de componentes.

Uma atividade Atualizar Planilhas do Google Sheets existente pode ser editada a partir destes locais:

Configurar uma atividade Atualizar Planilhas do Google Sheets

Siga estas etapas para configurar uma atividade Atualizar Planilhas do Google Sheets:

Passo 1: Insira um nome e especifique as configurações

Neste passo, forneça um nome para a atividade e especifique o número de colunas. Cada elemento da interface do usuário deste passo é descrito abaixo.

  • Nome: Insira um nome para identificar a atividade. O nome deve ser exclusivo para cada atividade de Atualizar Planilhas do Google Sheets e não deve conter barras / ou dois pontos :.

  • Número de Colunas: Insira o número de colunas a serem usadas ao criar a planilha (opcional); se não fornecido, o valor padrão de 26 é utilizado.

  • Continuar em Caso de Erro: Selecione para continuar a execução da atividade se um erro for encontrado para um conjunto de dados em uma solicitação em lote. Se algum erro for encontrado, ele será registrado no log de operações.

  • Salvar e Sair: Se ativado, clique para salvar a configuração deste passo e fechar a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração deste passo e continuar para o próximo passo. A configuração não será salva até que você clique no botão Concluído no último passo.

  • Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer passo. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Passo 2: Revise os esquemas de dados

Quaisquer esquemas de solicitação ou resposta são exibidos. Cada elemento da interface do usuário deste passo é descrito abaixo.

  • Esquemas de Dados: Esses esquemas de dados são herdados por transformações adjacentes e são exibidos novamente durante o mapeamento de transformação.

    Nota

    Os dados fornecidos em uma transformação têm precedência sobre a configuração da atividade.

    O conector do Google Sheets utiliza a API do Google Sheets v4. Consulte a documentação da API para obter informações sobre os nós e campos do esquema.

    Importante

    Embora a cardinalidade dos campos spreadsheetId, title e sheetId seja [0, 1] no esquema de solicitação (indicando que os campos são opcionais), a entrada para esses campos é obrigatória pela API do Google Sheets, conforme documentado abaixo.

    • Requisição:

      Campo/Nó do Esquema de Requisição Campo/Método da API do Google, tipo Notas
      updateSheetsRequest spreadsheets.update Requisição para atualizar uma planilha
      spreadsheetId (obrigatório) spreadsheetId ID da planilha a ser atualizada (obrigatório)
      title (obrigatório) title Título da planilha (obrigatório)
      request nó Cada requisição é uma das findReplaceRequest, addSheetRequest, updateSheetRequest, deleteSheetRequest, deleteCellRequest, ou updateCellRequest
      findReplaceRequest FindReplaceRequest Encontra e substitui dados em células em um intervalo, planilha ou em todas as planilhas
      find String O valor a ser pesquisado
      replacement String O valor a ser usado como substituição
      matchCase Boolean True se a pesquisa for sensível a maiúsculas e minúsculas
      searchByRegex Boolean True se o valor de busca for uma regex. A expressão regular e a substituição devem seguir as regras de regex do Java.
      matchEntireCell Boolean True se o valor de busca deve corresponder à célula inteira
      includeFormulas Boolean True se a pesquisa deve incluir células com fórmulas. Falso para ignorar células com fórmulas.
      unionFields nó Escopo do campo de união: O escopo sobre o qual encontrar/substituir; é necessário definir um dos campos SheetID ou allSheets ou os campos sob o nó [gridRange][grid-range].
      addSheetRequest
      updateSheetsRequest spreadsheets.update Requisição para atualizar uma planilha
      spreadsheetId spreadsheetId ID da planilha a ser atualizada
      title title Título da planilha
      request nó Cada requisição é uma das findReplaceRequest, addSheetRequest, updateSheetRequest, deleteSheetRequest, deleteCellRequest, ou updateCellRequest
      findReplaceRequest FindReplaceRequest Encontra e substitui dados em células em um intervalo, planilha ou em todas as planilhas
      find String O valor a ser pesquisado
      replacement String O valor a ser usado como substituição
      matchCase Boolean True se a pesquisa for sensível a maiúsculas e minúsculas
      searchByRegex Boolean True se o valor de busca for uma regex. A expressão regular e a substituição devem seguir as regras de regex do Java.
      matchEntireCell Boolean True se o valor de busca deve corresponder à célula inteira
      includeFormulas Boolean True se a pesquisa deve incluir células com fórmulas. Falso para ignorar células com fórmulas.
      unionFields (obrigatório) nó Escopo do campo de união: O escopo sobre o qual encontrar/substituir; a entrada em qualquer um dos campos SheetID ou allSheets é obrigatória
      SheetId Inteiro A planilha sobre a qual encontrar/substituir
      allSheets Boolean Defina como true para encontrar/substituir em todas as planilhas
      gridRange nó Encontra e substitui dados dentro de um intervalo em uma planilha
      sheetId (obrigatório) Inteiro A planilha em que este intervalo está (obrigatório)
      startRowIndex Inteiro O índice da linha inicial (inclusivo) do intervalo
      endRowIndex Inteiro O índice da linha final (exclusivo) do intervalo
      startColumnIndex Inteiro O índice da coluna inicial (inclusivo) do intervalo
      endColumnIndex Inteiro O índice da coluna final (exclusivo) do intervalo

    • Resposta:

      Campo/Nó do Esquema de Resposta Campo da API do Google Notas
      updateSheetsResponse n/a Resposta da criação da planilha
      spreadsheetId spreadsheetId ID da planilha recém-atualizada
      sheets n/a Nó representando a planilha
      properties n/a Nó representando as propriedades retornadas
      code n/a Código de erro retornado (se houver)
      message n/a Mensagem retornada ao criar (se houver)

  • Atualizar: Clique no ícone de atualizar ou na palavra Atualizar para regenerar esquemas do endpoint do Google Sheets. Esta ação também regenera um esquema em outros locais do projeto onde o mesmo esquema é referenciado, como em uma transformação adjacente.

  • Voltar: Clique para armazenar temporariamente a configuração para esta etapa e retornar à etapa anterior.

  • Concluído: Clique para salvar a configuração para todas as etapas e fechar a configuração da atividade.

  • Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Próximas etapas

Após configurar uma atividade de Atualizar Planilhas do Google Sheets, complete a configuração da operação adicionando e configurando outras atividades ou ferramentas como etapas da operação. Você também pode configurar as configurações da operação, que incluem a capacidade de encadear operações que estão no mesmo ou em diferentes fluxos de trabalho.

As ações do menu para uma atividade estão acessíveis a partir do painel do projeto e da tela de design. Para detalhes, consulte o menu de ações da atividade em Conceitos básicos do conector.

As atividades de Atualizar Planilhas do Google Sheets podem ser usadas como um alvo com esses padrões de operação:

Para usar a atividade com funções de script, escreva os dados em um local temporário e, em seguida, use esse local temporário na função de script.

Quando estiver pronto, implante e execute a operação e valide o comportamento verificando os logs da operação.