Saltar al contenido

Actividad de Obtención de Hojas de Cálculo de Google Sheets

Introducción

Una actividad de Google Sheets Obtener Sheets, usando su conexión de Google Sheets, recupera una hoja de cálculo de Google Sheets y está diseñado para usarse como fuente para proporcionar datos en una operación.

Crear una Actividad Obtener Hojas de Cálculo de Google Sheets

Se crea una instancia de una actividad de Google Sheets Obtener Sheets a partir de una conexión de Google Sheets usando su tipo de actividad Obtener hojas.

Para crear una instancia de una actividad, arrastre el tipo de actividad al tela de diseño o cópielo y péguelo en el tela de diseño. Para obtener más información, consulte Crear una instancia de actividad en Reutilización de componentes.

Una actividad Obtener hojas de Google Sheets existente se puede editar desde estas ubicaciones:

Configurar una Actividad de Obtención de Hojas de Cálculo de Google Sheets

Siga estos pasos para configurar una actividad Obtener hojas de Google Sheets:

Paso 1: Ingrese un Nombre y Especifique la Configuración

En este paso, proporcione un nombre para la actividad y especifique el ID de la hoja de cálculo, el rango y el número de columnas. Cada elemento de la interfaz de usuario de este paso se describe a continuación.

Paso 1 de configuración de la actividad de obtención de hojas de cálculo de Google Sheets

Consejo

Campos con un ícono de variable Ícono de variable admite el uso de variables globales, variables del proyecto, y variables de Jitterbit. Comience escribiendo un corchete abierto [ en el campo o haciendo clic en el icono de variable para mostrar una lista de las variables existentes para elegir.

  • Nombre: Introduzca un nombre para identificar la actividad. El nombre debe ser único para cada actividad de Obtener hojas de Google Sheets Sheets y no debe contener barras diagonales. / o dos puntos :.

  • ID de hoja de cálculo: Ingrese el ID de la hoja de cálculo de Google Sheets.

  • Rango: Las celdas que se recuperarán, en notación A1 (opcional).

  • Número de columnas: Ingrese el número de columnas que se devolverán en la respuesta (opcional); si no se proporciona, se utiliza el valor predeterminado de 26.

  • Guardar y salir: Si está habilitado, haga clic para guardar la configuración para este paso y cerrar la configuración de la actividad.

  • Siguiente: Haga clic para almacenar temporalmente la configuración para este paso y continuar con el siguiente. La configuración no se guardará hasta que haga clic en el botón Finalizado en el último paso.

  • Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.

Paso 2: Revisar los Esquemas de Datos

Se muestran todos los esquemas de solicitud o respuesta. Cada elemento de la interfaz de usuario de este paso se describe a continuación.

Paso 2 de configuración de la actividad de obtención de hojas de Google Sheets

  • Esquemas de datos: Estos esquemas de datos se heredan mediante transformaciones adyacentes y se muestran nuevamente durante asignación de transformación.

    Nota

    Los datos proporcionados en una transformación tienen prioridad sobre la configuración de la actividad.

    El conector de Google Sheets utiliza Google Sheets API v4. Consulte la documentación de la API para obtener información sobre los campos y nodos del esquema.

    • Solicitud:

      Solicitar campo/nodo de esquema Campo/método API de Google Notas
      getSheetRequest spreadsheets.get Solicitud para recuperar una hoja de cálculo
      SpreadSheetID n/a ID de la hoja de cálculo (opcional)
      ranges n/a Nodo que representa la hoja de cálculo rangos
      range n/a Rango en notación A1

    • Respuesta:

      Campo/nodo del esquema de respuesta Campo API de Google Notas
      getSheetsResponse n/a Respuesta de la creación de la hoja de cálculo
      Entity n/a Nodo que representa toda la estructura de la hoja de cálculo
      SpreadSheet n/a Nodo que representa la hoja de cálculo
      spreadsheetId spreadsheetId ID de la hoja de cálculo
      Sheets sheets Nodo que representa las hojas
      Sheet sheet Nodo que representa una hoja
      SheetTitle title Título de la hoja
      SheetID sheetId Identificación de hoja; debe ser no negativo y no se puede cambiar una vez configurado
      data GridData Nodo que representa los datos de la hoja
      row RowdData Nodo que representa una fila de la hoja
      A…Z n/a Datos de cadena para columnas de la hoja; de forma predeterminada, se crean 26 columnas en una nueva hoja de cálculo

  • Actualizar: Haga clic en el icono de actualización Icono de actualización o la palabra Actualizar para regenerar esquemas desde el extremo de Google Sheets. Esta acción también regenera un esquema en otras ubicaciones del proyecto donde se hace referencia al mismo esquema, como en una transformación adyacente.

  • Volver: Haga clic para almacenar temporalmente la configuración de este paso y volver al paso anterior.

  • Terminado: Haga clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.

  • Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.

Próximos Pasos

Después de configurar una actividad Obtener hojas de Google Sheets, complete la configuración de la operación agregando y configurando otras actividades, transformaciones o secuencias de comandos como pasos de la operación. También puede configurar los ajustes de operación, que incluyen la capacidad de encadenar operaciones que se encuentran en el mismo flujos de trabajo o en diferentes.

Se puede acceder a las acciones del menú para una actividad desde el panel del proyecto y el tela de diseño. Para obtener más información, consulte Menú de acciones de actividad en Conceptos básicos del conector.

Las actividades de Google Sheets Get Sheets se pueden utilizar como fuente con estos patrones de operación:

Para usar la actividad con funciones de secuencias de comandos, escriba los datos en una ubicación temporal y luego use esa ubicación temporal en la función de secuencias de comandos.

Cuando esté listo, desplegar y ejecutar la operación y validar el comportamiento comprobando los registros de operación.