Saltearse al contenido
Nappai Documentation

Spread Sheet

Spread Sheet trabaja con hojas de cálculo de Google Sheets como archivos completos y con sus pestañas: crear una hoja de cálculo nueva, añadirle pestañas, consultar sus datos, cambiarle el nombre, duplicarla a partir de una plantilla, vaciar su contenido o eliminarla.

Para leer, añadir o cambiar filas dentro de una pestaña, usa Sheet Cells.

Cuándo usarlo

  • Cada mes quieres crear una copia de tu plantilla de informe con el nombre del mes.
  • Al dar de alta un cliente, quieres crearle una hoja de cálculo con las pestañas Pedidos y Facturas.
  • Antes de volcar los datos del día, quieres vaciar la pestaña donde se cargan.
  • Quieres obtener la lista de hojas de cálculo de tu cuenta o las pestañas de una de ellas.

Configuración

Necesitas una credencial Google Sheets, que se conecta iniciando sesión con tu cuenta de Google. Para crear, modificar o eliminar, la credencial debe tener el acceso Create, Update, Delete, Read; con Read Only solo puedes consultar. Consulta Credenciales.

CampoQué hace
Credential (obligatorio)La credencial Google Sheets de la cuenta con la que trabajas.
OperationLo que hace el componente. Ver Operaciones. Por defecto, Create SpreadSheet.
Mode of InputEn todas las operaciones menos Create SpreadSheet, cómo indicas la hoja de cálculo: By Selection muestra un selector para elegirla de tu Drive; By Id te pide su identificador; By Url te pide su enlace. Por defecto, By Selection.
Select Spreadsheet / Spreadsheet ID / Spreadsheet URLLa hoja de cálculo con la que trabajas, según Mode of Input. Obligatorio salvo en Get, donde si lo dejas vacío se devuelven tus hojas de cálculo.
Spreadsheet NameSolo en Create SpreadSheet. El nombre de la hoja de cálculo nueva. Obligatorio.
New Spreadsheet NameEn Update, el nombre nuevo de la hoja de cálculo. En Duplicate SpreadSheet, el nombre de la copia. Obligatorio en las dos.
Sheet NameEn Create SpreadSheet y Create Sheet, el nombre de las pestañas que se crean. Puedes añadir varias. Obligatorio en Create Sheet.
Select SheetEn Get, Clear y Delete, la pestaña con la que trabajas, o All SpreadSheet para toda la hoja de cálculo. La lista se carga al elegir la hoja de cálculo; pulsa el botón de actualizar si no aparece.

Operaciones

OperaciónQué hace
Create SpreadSheetCrea una hoja de cálculo nueva. Si rellenas Sheet Name, se crea con esas pestañas en lugar de la pestaña por defecto.
Create SheetAñade una o varias pestañas a una hoja de cálculo existente.
GetDevuelve los datos de una hoja de cálculo y sus pestañas, solo de una pestaña, o la lista de tus hojas de cálculo si no eliges ninguna.
UpdateCambia el nombre de una hoja de cálculo.
Duplicate SpreadSheetCrea una copia de una hoja de cálculo con el nombre de New Spreadsheet Name. Es la forma de usar una plantilla.
ClearVacía el contenido de una pestaña, o de todas con All SpreadSheet. Las pestañas se mantienen.
DeleteElimina una pestaña. Con All SpreadSheet elimina la hoja de cálculo entera.

Opciones avanzadas

CampoQué hace
Include DataSolo en Get. Incluye también el contenido de las celdas. Por defecto, desactivado.

Resultado

La salida Data devuelve la hoja de cálculo con la que has trabajado: su identificador, su nombre, su enlace (spreadsheetUrl) y la lista de pestañas. En Get sin hoja de cálculo elegida sale un elemento por cada una. En Duplicate SpreadSheet devuelve el identificador y el nombre de la copia. En Clear y Delete, una confirmación de lo que se ha vaciado o eliminado.

Puedes usar el identificador en Sheet Cells para escribir filas, o conectar el resultado a un componente de correo para enviar el enlace. El componente también se puede conectar a un Agente como herramienta. Ver Tool Mode.

Ejemplo

Un equipo financiero prepara cada mes su informe a partir de una plantilla.

  1. Programa el flujo para el día 1 de cada mes. Consulta Programador.
  2. Añade Spread Sheet con la operación Duplicate SpreadSheet y elige la plantilla en Select Spreadsheet.
  3. En New Spreadsheet Name pon Informe seguido del mes.
  4. Conecta la salida Data a Sheet Cells para escribir los datos del mes en la copia.

Buenas prácticas

  • Clear no se puede deshacer desde el flujo. Si dudas, duplica antes la hoja de cálculo con Duplicate SpreadSheet.

Componentes relacionados