Ir para o conteúdo

Escrever dados em uma planilha Google Sheets no Jitterbit Studio

Introdução

O conector Google Sheets escreve dados tabulares em Google Sheets usando uma conta de serviço que você configura no Google Cloud Console. A atividade Create Sheets cria uma nova planilha e a popula com linhas da fonte cada vez que a operação é executada.

Para escrever em uma planilha existente, use a atividade Update Sheets em vez disso.

Este guia pressupõe o seguinte:

  • Uma conta de serviço Google Cloud com a API Google Sheets ativada e credenciais obtidas, conforme descrito em Pré-requisitos do Google Sheets.
  • Uma atividade de origem já está configurada no projeto.

Padrão de design

A atividade Create Sheets segue o padrão de transformação:

%%{init: {"themeVariables": {"lineColor": "#6b7280", "edgeLabelBackground": "#f5f5f5"}}}%% flowchart LR A[Source activity] --> B[Transformation] --> C[Create Sheets activity]

Parte 1: Configurar a conexão Google Sheets

Etapa 1: Criar a conexão

  1. Na aba Project endpoints and connectors da paleta do componente de design, localize o conector Google Sheets e clique nele para abrir sua configuração.

  2. Connection Name: Digite um nome único para a conexão. O nome não deve conter barras / ou dois pontos :.

  3. Project ID: Digite o valor project_id do arquivo JSON de credenciais da conta de serviço.

  4. Client Email: Digite o valor client_email do arquivo JSON de credenciais.

  5. Private Key String: Digite o valor private_key do arquivo JSON de credenciais.

  6. Key Algorithm: Selecione RSA.

  7. Clique em Test para verificar a conexão.

  8. Clique em Save Changes.

Parte 2: Configurar a atividade Create Sheets

Etapa 1: Nomear a atividade e configurar a planilha

  1. Na tela de design, arraste uma atividade do tipo Create Sheets da conexão Google Sheets para a tela.

  2. Clique duas vezes na atividade para abrir sua configuração.

  3. Name: Digite um nome descritivo, como Create Contacts Spreadsheet.

  4. Spreadsheet Name: Digite o nome do arquivo Google Sheets, como Contacts Export. Este é o nome do arquivo que aparece no Google Drive.

    Dica

    Use uma variável de projeto para o nome da planilha se o nome do arquivo de destino precisar diferir entre ambientes.

  5. Number of Columns: Digite o número de colunas que seu conjunto de dados requer. O padrão é 26, que fornece colunas A até Z. Aumente este valor se seus dados de origem tiverem mais de 26 campos.

  6. Continue on Error: Selecione para permitir que a operação continue se um erro for encontrado em uma solicitação em lote. Todos os erros são escritos no log de operação.

  7. Clique em Next.

Etapa 2: Revisar o esquema de dados

  1. Revise o esquema da solicitação. A estrutura de chaves é:

    createSheetsRequest > Entity > Sheets > Sheet > data > row

    O nó row é o nó de loop: cada entrada representa uma linha na planilha. Dentro de cada row, os campos A, B, C... contêm valores de string para cada célula.

  2. O campo folder_id sob createSheetsRequest é opcional. Forneça uma ID de pasta do Google Drive na transformação para colocar a planilha em uma pasta específica. Se omitido, a planilha é criada na pasta compartilhada com a conta de serviço da conexão.

  3. Clique em Finished.

Parte 3: Mapear a transformação

  1. Na tela de design, adicione uma etapa Transformation entre a atividade de origem e a atividade Create Sheets.

  2. Abra a transformação. O esquema de origem aparece à esquerda e o esquema de destino Create Sheets aparece à direita.

  3. Localize o nó row em Entity > Sheets > Sheet > data. O Studio trata automaticamente esse nó como um nó de loop, portanto cada registro de origem produz uma linha na planilha.

  4. Mapeie os campos de origem para as letras de coluna (A, B, C...) sob o nó row. As colunas correspondem às colunas da planilha da esquerda para a direita.

  5. (Opcional) Mapeie o campo SheetTitle em Sheet para definir o nome da aba da planilha dentro da pasta de trabalho. Se não for mapeado, um título de aba padrão será usado.

  6. (Opcional) Mapeie os valores startRow e startColumn em Sheet para controlar onde os dados começam a ser gravados. Ambos os campos são inteiros baseados em zero, portanto um valor de 0 começa na primeira linha ou coluna.

Para uma explicação completa sobre mapeamento de transformações, consulte Visão geral do mapeamento de transformações.

Verificar a integração

Implante e execute a operação. Verifique os logs da operação para confirmar que a atividade Create Sheets foi concluída com sucesso. Abra o Google Drive para verificar se a planilha foi criada com o nome esperado e se as linhas e colunas correspondem aos dados de origem.

Se os dados estiverem faltando ou as colunas estiverem cortadas, verifique se o valor Number of Columns na configuração da atividade é pelo menos igual ao número de colunas mapeadas na transformação.

Para executar essa operação em um agendamento recorrente, consulte Agendar uma operação para ser executada automaticamente.