Ir para o conteúdo

Atividade de Atualização de Planilhas do Google Sheets

Introdução

Uma atividade Atualizar planilhas do Google Sheets usando sua conexão do Google Sheets, atualiza uma planilha do Google Sheets e deve ser usado como destino para consumir dados em uma operação.

Crie uma Atividade de Atualização do Google Sheets

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

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

Uma atividade existente do Google Sheets Atualizar planilhas pode ser editada nestes locais:

Configurar uma Atividade de Atualização do Google Sheets

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

Etapa 1: Insira um Nome e Especifique as Configurações

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

Etapa 1 da configuração da atividade das planilhas de atualização do Google Sheets

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

  • Número de Colunas: Informe o número de colunas que serão utilizadas na criação da planilha (opcional); se não for fornecido, o valor padrão de 26 será usado.

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

  • Salvar e Sair: Se ativado, clique para salvar a configuração desta etapa e feche a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração desta etapa e prosseguir para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.

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

Etapa 2: Revise os Esquemas de Dados

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

Etapa 2 da configuração da atividade das planilhas de atualização do Google Sheets

  • 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 usa 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 do spreadsheetId, title, e sheetId campos é [0, 1] no esquema de solicitação (indicando os campos como opcionais), a entrada para esses campos é exigida pela API do Google Sheets, conforme documentado abaixo.

    • Solicitação:

      Campo/nó do esquema de solicitação Campo/método da API do Google, tipo Notas
      updateSheetsRequest spreadsheets.update Solicitação para atualizar uma planilha
      spreadsheetId (obrigatório) spreadsheetId ID da planilha a ser atualizada (obrigatório)
      title (obrigatório) title Título da folha (obrigatório)
      request nó Cada solicitação é uma de findReplaceRequest, addSheetRequest, updateSheetRequest, deleteSheetRequest, deleteCellRequest, ou updateCellRequest
      findReplaceRequest FindReplaceRequest Localiza e substitui dados em células em um intervalo, planilha ou em todas as planilhas
      find Corda O valor a ser pesquisado
      replacement Corda O valor a ser usado como substituição
      matchCase Booleano True se a pesquisa diferenciar maiúsculas de minúsculas
      searchByRegex Booleano True se o valor encontrado for um regex. A expressão regular e a substituição devem seguir regras de regex Java.
      matchEntireCell Booleano True se o valor de localização deve corresponder à célula inteira
      includeFormulas Booleano True se a pesquisa incluir células com fórmulas. False para pular células com fórmulas.
      unionFields nó Âmbito do domínio da União: O âmbito sobre o qual encontrar/substituir; você deve definir um dos SheetID ou allSheets campos ou os campos sob [gridRange][faixa de grade] nó.
      addSheetRequest
      updateSheetsRequest spreadsheets.update Solicitação para atualizar uma planilha
      spreadsheetId spreadsheetId ID da planilha a ser atualizada
      title title Título da folha
      request nó Cada solicitação é uma de findReplaceRequest, addSheetRequest, updateSheetRequest, deleteSheetRequest, deleteCellRequest, ou updateCellRequest
      findReplaceRequest FindReplaceRequest Localiza e substitui dados em células em um intervalo, planilha ou em todas as planilhas
      find Corda O valor a ser pesquisado
      replacement Corda O valor a ser usado como substituto
      matchCase Booleano True se a pesquisa diferenciar maiúsculas de minúsculas
      searchByRegex Booleano True se o valor encontrado for um regex. A expressão regular e a substituição devem seguir regras de regex Java.
      matchEntireCell Booleano True se o valor de localização deve corresponder à célula inteira
      includeFormulas Booleano True se a pesquisa incluir células com fórmulas. False para pular células com fórmulas.
      unionFields (obrigatório) nó Âmbito do domínio da União: O âmbito sobre o qual encontrar/substituir; entrada em qualquer SheetID ou allSheets campo é obrigatório
      SheetId Inteiro A planilha a ser localizada/substituída
      allSheets Booleano Definido como true localizar/substituir todas as folhas
      gridRange nó Localiza 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 A linha inicial (inclusive) do intervalo
      endRowIndex Inteiro A linha final (exclusiva) do intervalo
      startColumnIndex Inteiro A coluna inicial (inclusive) do intervalo
      endColumnIndex Inteiro A coluna final (exclusiva) do intervalo

    • Resposta:

      Campo/nó do esquema de resposta Campo 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ó que representa a planilha
      properties n/a Nó que representa as propriedades retornadas
      code n/a Código de erro retornado (se houver)
      message n/a Mensagem retornada na criação (se houver)

  • Atualizar: Clique no ícone de atualização Ícone de atualização ou a 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 desta etapa e retornar à etapa anterior.

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

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

Próximos Passos

Depois de configurar uma atividade Atualizar planilhas do Google Sheets, conclua a configuração da operação adicionando e configurando outras atividades, transformações ou scripts como etapas da operação. Você também pode definir as configurações de operação, que incluem a capacidade de encadear operações que estejam no mesmo fluxo de trabalho ou em workflows diferentes.

As ações de menu para uma atividade podem ser acessadas no painel do projeto e na quadro de design. Para obter detalhes, consulte Menu Ações da atividade em Noções básicas do conector.

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

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

Quando estiver pronto, implantar e execute a operação e validar o comportamento verificando os logs de operação.