Saltar al contenido

Escribir datos en una hoja de cálculo de Google Sheets en Jitterbit Studio

Introducción

El conector de Google Sheets escribe datos tabulares en Google Sheets usando una cuenta de servicio que configuras en la Google Cloud Console. La actividad Create Sheets crea una nueva hoja de cálculo y la completa con filas de la fuente cada vez que se ejecuta la operación.

Para escribir en una hoja de cálculo existente, usa la actividad Update Sheets en su lugar.

Esta guía asume lo siguiente:

  • Una cuenta de servicio de Google Cloud con la API de Google Sheets habilitada y credenciales obtenidas, como se describe en Requisitos previos de Google Sheets.
  • Una actividad de origen ya configurada en el proyecto.

Patrón de diseño

La actividad Create Sheets sigue el patrón de transformación:

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

Parte 1: Configura la conexión de Google Sheets

Paso 1: Crea la conexión

  1. En la pestaña Project endpoints and connectors de la paleta de componentes de diseño, localiza el conector de Google Sheets y haz clic en él para abrir su configuración.

  2. Connection Name: Ingresa un nombre único para la conexión. El nombre no debe contener barras / ni dos puntos :.

  3. Project ID: Ingresa el valor project_id del archivo JSON de credenciales de la cuenta de servicio.

  4. Client Email: Ingresa el valor client_email del archivo JSON de credenciales.

  5. Private Key String: Ingresa el valor private_key del archivo JSON de credenciales.

  6. Key Algorithm: Selecciona RSA.

  7. Haz clic en Test para verificar la conexión.

  8. Haz clic en Save Changes.

Parte 2: Configura la actividad Create Sheets

Paso 1: Nombra la actividad y configura la hoja de cálculo

  1. En el lienzo de diseño, arrastra una actividad Create Sheets del tipo de conexión de Google Sheets al lienzo.

  2. Haz doble clic en la actividad para abrir su configuración.

  3. Name: Ingresa un nombre descriptivo, como Create Contacts Spreadsheet.

  4. Spreadsheet Name: Ingresa el nombre del archivo de Google Sheets, como Contacts Export. Este es el nombre de archivo que aparece en Google Drive.

    Consejo

    Usa una variable de proyecto para el nombre de la hoja de cálculo si el nombre del archivo de destino necesita diferir entre entornos.

  5. Number of Columns: Ingresa el número de columnas que tu conjunto de datos requiere. El valor predeterminado es 26, que proporciona columnas A a Z. Aumenta este valor si tus datos de origen tienen más de 26 campos.

  6. Continue on Error: Selecciona para permitir que la operación continúe si se encuentra un error en una solicitud por lotes. Los errores se escriben en el registro de operación.

  7. Haz clic en Next.

Paso 2: Revisa el esquema de datos

  1. Revisa el esquema de solicitud. La estructura clave es:

    createSheetsRequest > Entity > Sheets > Sheet > data > row

    El nodo row es el nodo de bucle: cada entrada representa una fila en la hoja de cálculo. Dentro de cada row, los campos A, B, C... contienen valores de cadena para cada celda.

  2. El campo folder_id bajo createSheetsRequest es opcional. Proporciona una ID de carpeta de Google Drive en la transformación para colocar la hoja de cálculo en una carpeta específica. Si se omite, la hoja de cálculo se crea en la carpeta compartida con la cuenta de servicio de la conexión.

  3. Haz clic en Finished.

Parte 3: Asigna la transformación

  1. En el lienzo de diseño, añade un paso de Transformation entre la actividad de origen y la actividad Create Sheets.

  2. Abre la transformación. El esquema de origen aparece a la izquierda y el esquema de destino Create Sheets aparece a la derecha.

  3. Localiza el nodo row en Entity > Sheets > Sheet > data. Studio trata automáticamente este nodo como un nodo de bucle, por lo que cada registro de origen produce una fila en la hoja de cálculo.

  4. Asigna los campos de origen a las letras de columna (A, B, C...) bajo el nodo row. Las columnas corresponden a las columnas de la hoja de cálculo de izquierda a derecha.

  5. (Opcional) Asigna el campo SheetTitle bajo Sheet para establecer el nombre de la pestaña de la hoja dentro de la hoja de cálculo. Si no se asigna, se utiliza un título de pestaña predeterminado.

  6. (Opcional) Asigna los valores startRow y startColumn bajo Sheet para controlar dónde comienza a escribirse los datos. Ambos campos son enteros basados en cero, por lo que un valor de 0 comienza en la primera fila o columna.

Para un recorrido completo del mapeo de transformación, consulta Descripción general del mapeo de transformación.

Verifica la integración

Despliega y ejecuta la operación. Consulta los registros de operación para confirmar que la actividad Create Sheets se completó correctamente. Abre Google Drive para verificar que la hoja de cálculo se creó con el nombre esperado y que las filas y columnas coincidan con los datos de origen.

Si faltan datos o las columnas están cortadas, verifica que el valor Number of Columns en la configuración de la actividad sea al menos igual al número de columnas asignadas en la transformación.

Para ejecutar esta operación en un cronograma recurrente, consulta Programa una operación para que se ejecute automáticamente.