Ir para o conteúdo

Atualizar Planilhas do Google Atividade de Atualização de Planilhas no Jitterbit Studio

Introdução

Uma atividade de 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 de Atualizar Planilhas do Google Sheets

Uma instância de uma atividade de 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 detalhes, veja Criar uma instância de atividade ou ferramenta em Reutilização de componentes.

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

Configurar uma atividade de Atualizar Planilhas do Google Sheets

Siga estas etapas para configurar uma atividade de 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.

  • Menu de Endpoint: Se você tiver vários endpoints do mesmo tipo de conector configurados, um menu na parte superior da tela exibe o nome do endpoint atual. Clique no menu para alternar para um endpoint diferente. Para mais informações, veja Alterar o endpoint atribuído em Telasa de configuração.

    • Editar endpoint: Aparece quando você passa o mouse sobre o nome do endpoint atual. Clique para editar a configuração de conexão do endpoint atualmente selecionado.

  • Nome: Insira um nome para identificar a atividade. O nome deve ser único para cada atividade 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 & Sair: Se habilitado, 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.

    • 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 planilha (obrigatório)
      request nó Cada solicitação é uma das findReplaceRequest, addSheetRequest, updateSheetRequest, deleteSheetRequest, deleteCellRequest, ou updateCellRequest
      findReplaceRequest FindReplaceRequest Encontra e substitui dados em células em um intervalo, planilha ou 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 pular células com fórmulas.
      unionFields nó Escopo do campo de união: O escopo sobre o qual encontrar/substituir; você deve definir um dos campos SheetID ou allSheets ou os campos sob o nó [gridRange][grid-range].
      addSheetRequest
      updateSheetsRequest spreadsheets.update Solicitação para atualizar uma planilha
      spreadsheetId spreadsheetId ID da planilha a ser atualizada
      title title Título da planilha
      request nó Cada solicitação é uma das findReplaceRequest, addSheetRequest, updateSheetRequest, deleteSheetRequest, deleteCellRequest, ou updateCellRequest
      findReplaceRequest FindReplaceRequest Encontra e substitui dados em células em um intervalo, planilha ou 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 pular 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 A linha inicial (inclusiva) do intervalo
      endRowIndex Inteiro A linha final (exclusiva) do intervalo
      startColumnIndex Inteiro A coluna inicial (inclusiva) do intervalo
      endColumnIndex Inteiro A coluna final (exclusiva) 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 solicita que você confirme que deseja descartar as alterações.

Próximas etapas

Após configurar uma atividade 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 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.