Saltar al contenido

Actividad de Actualización de Hojas de Google

Introducción

Una actividad de Actualización de Hojas de Google Sheets, utilizando su conexión de Google Sheets, actualiza una hoja de cálculo de Google Sheets y está destinada a ser utilizada como un objetivo para consumir datos en una operación.

Crear una actividad de Actualización de Hojas de Google Sheets

Una instancia de una actividad de Actualización de Hojas de Google Sheets se crea a partir de una conexión de Google Sheets utilizando su tipo de actividad Actualizar Hojas.

Para crear una instancia de una actividad, arrastre el tipo de actividad al lienzo de diseño o copie el tipo de actividad y péguelo en el lienzo de diseño. Para más detalles, consulte Crear una instancia de actividad o herramienta en Reutilización de componentes.

Una actividad de Actualización de Hojas de Google Sheets existente se puede editar desde estas ubicaciones:

Configurar una actividad de Actualización de Hojas de Google Sheets

Siga estos pasos para configurar una actividad de Actualización de Hojas de Google Sheets:

Paso 1: Ingrese un nombre y especifique configuraciones

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

Configuración de la actividad de actualización de hojas de Google Sheets paso 1

  • Nombre: Ingrese un nombre para identificar la actividad. El nombre debe ser único para cada actividad de Google Sheets Actualizar Hojas y no debe contener barras diagonales / ni dos puntos :.

  • Número de Columnas: Ingrese el número de columnas que se utilizarán al crear la hoja de cálculo (opcional); si no se proporciona, se utiliza el valor predeterminado de 26.

  • Continuar en Error: Seleccione para continuar la ejecución de la actividad si se encuentra un error para un conjunto de datos en una solicitud por lotes. Si se encuentran errores, se escriben en el registro de operaciones.

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

  • Siguiente: Haga clic para almacenar temporalmente la configuración de este paso y continuar al siguiente paso. 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: Revise los esquemas de datos

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

Configuración de la actividad de actualización de hojas de Google Sheets paso 2

  • Esquemas de Datos: Estos esquemas de datos son heredados por transformaciones adyacentes y se muestran nuevamente durante el mapeo de transformaciones.

    Nota

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

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

    Importante

    Aunque la cardinalidad de los campos spreadsheetId, title y sheetId es [0, 1] en el esquema de solicitud (lo que indica que los campos son opcionales), la entrada para estos campos es requerida por la API de Google Sheets, como se documenta a continuación.

    • Solicitud:

      Campo/Nodo del Esquema de Solicitud Campo/Método de la API de Google, tipo Notas
      updateSheetsRequest spreadsheets.update Solicitud para actualizar una hoja de cálculo
      spreadsheetId (requerido) spreadsheetId ID de la hoja de cálculo que se va a actualizar (requerido)
      title (requerido) title Título de la hoja (requerido)
      request nodo Cada solicitud es uno de findReplaceRequest, addSheetRequest, updateSheetRequest, deleteSheetRequest, deleteCellRequest, o updateCellRequest
      findReplaceRequest FindReplaceRequest Busca y reemplaza datos en celdas sobre un rango, hoja o todas las hojas
      find String El valor a buscar
      replacement String El valor a usar como reemplazo
      matchCase Boolean True si la búsqueda es sensible a mayúsculas y minúsculas
      searchByRegex Boolean True si el valor a buscar es una expresión regular. La expresión regular y el reemplazo deben seguir las reglas de expresiones regulares de Java.
      matchEntireCell Boolean True si el valor a buscar debe coincidir con toda la celda
      includeFormulas Boolean True si la búsqueda debe incluir celdas con fórmulas. Falso para omitir celdas con fórmulas.
      unionFields nodo Alcance del campo de unión: El alcance sobre el cual buscar/reemplazar; debes establecer uno de los campos SheetID o allSheets o los campos bajo el nodo [gridRange][grid-range].
      addSheetRequest
      updateSheetsRequest spreadsheets.update Solicitud para actualizar una hoja de cálculo
      spreadsheetId spreadsheetId ID de la hoja de cálculo que se va a actualizar
      title title Título de la hoja
      request nodo Cada solicitud es uno de findReplaceRequest, addSheetRequest, updateSheetRequest, deleteSheetRequest, deleteCellRequest, o updateCellRequest
      findReplaceRequest FindReplaceRequest Busca y reemplaza datos en celdas sobre un rango, hoja o todas las hojas
      find String El valor a buscar
      replacement String El valor a usar como reemplazo
      matchCase Boolean True si la búsqueda es sensible a mayúsculas y minúsculas
      searchByRegex Boolean True si el valor a buscar es una expresión regular. La expresión regular y el reemplazo deben seguir las reglas de expresiones regulares de Java.
      matchEntireCell Boolean True si el valor a buscar debe coincidir con toda la celda
      includeFormulas Boolean True si la búsqueda debe incluir celdas con fórmulas. Falso para omitir celdas con fórmulas.
      unionFields (requerido) nodo Alcance del campo de unión: El alcance sobre el cual buscar/reemplazar; la entrada en el campo SheetID o allSheets es requerida
      SheetId Integer La hoja sobre la cual buscar/reemplazar
      allSheets Boolean Establecer en true para buscar/reemplazar en todas las hojas
      gridRange nodo Busca y reemplaza datos dentro de un rango en una hoja
      sheetId (requerido) Integer La hoja en la que se encuentra este rango (requerido)
      startRowIndex Integer La fila de inicio (inclusiva) del rango
      endRowIndex Integer La fila final (exclusiva) del rango
      startColumnIndex Integer La columna de inicio (inclusiva) del rango
      endColumnIndex Integer La columna final (exclusiva) del rango

    • Respuesta:

      Campo/Nodo del Esquema de Respuesta Campo de la API de Google Notas
      updateSheetsResponse n/a Respuesta de la creación de la hoja de cálculo
      spreadsheetId spreadsheetId ID de la hoja de cálculo recién actualizada
      sheets n/a Nodo que representa la hoja de cálculo
      properties n/a Nodo que representa las propiedades devueltas
      code n/a Código de error devuelto (si lo hay)
      message n/a Mensaje devuelto al crear (si lo hay)

  • Actualizar: Haga clic en el ícono de actualizar o en la palabra Actualizar para regenerar esquemas desde el endpoint de Google Sheets. Esta acción también regenera un esquema en otras ubicaciones a lo largo del proyecto donde se hace referencia al mismo esquema, como en una transformación adyacente.

  • Atrás: Haz clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.

  • Terminado: Haz 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, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas descartar los cambios.

Siguientes pasos

Después de configurar una actividad de Google Sheets Actualizar Hojas, completa la configuración de la operación añadiendo y configurando otras actividades o herramientas como pasos de la operación. También puedes configurar los ajustes de la operación, que incluyen la capacidad de encadenar operaciones que están en los mismos o diferentes flujos de trabajo.

Las acciones del menú para una actividad son accesibles desde el panel del proyecto y el lienzo de diseño. Para más detalles, consulta el menú de acciones de actividad en Conceptos básicos de conectores.

Las actividades de Google Sheets Actualizar Hojas pueden ser utilizadas como un objetivo con estos patrones de operación:

Para usar la actividad con funciones de scripting, escribe los datos en una ubicación temporal y luego utiliza esa ubicación temporal en la función de scripting.

Cuando estés listo, despliega y ejecuta la operación y valida el comportamiento revisando los registros de operación.