Nivel de programación: Intermedio
Duración: 15 minutos
Tipo de proyecto: Automatización con un activador basado en el tiempo
Objetivos
- Comprende lo que hace la solución.
- Comprender lo que hacen los servicios de Apps Script dentro de la solución
- Configura la secuencia de comandos.
- Ejecuta la secuencia de comandos.
Acerca de esta solución
Importa datos automáticamente de archivos CSV a una hoja de cálculo de Google. Si trabajas con varios archivos CSV que tienen una estructura similar, puedes usar esta solución para centralizar los datos en Hojas de cálculo.
Cómo funciona
La secuencia de comandos se ejecuta a diario en un activador basado en el tiempo. Itera a través de los archivos CSV en una carpeta designada y agrega los datos de cada archivo a una hoja de cálculo. Según la configuración predeterminada, la secuencia de comandos quita la fila de encabezado de cada conjunto de datos de CSV antes de agregar los datos a la última fila de la hoja. La secuencia de comandos envía un correo electrónico de resumen con una lista de los archivos que se importaron y los mueve a otra carpeta para evitar el procesamiento duplicado.
La secuencia de comandos también incluye funciones que configuran archivos CSV de muestra para hacer una demostración de esta solución.
Servicios de Apps Script
En esta solución, se usan los siguientes servicios:
- Servicio de secuencias de comandos: Crea el activador basado en el tiempo.
- Servicio de Drive: Obtiene las carpetas que la secuencia de comandos usa para almacenar archivos CSV procesados y sin procesar, y las crea si no existen. Obtiene la URL del proyecto de Apps Script para incluir en el correo electrónico de resumen.
- Servicio de hoja de cálculo: obtiene la hoja de cálculo en la que la secuencia de comandos agrega los datos de cada archivo CSV.
- Servicio base: Usa la clase
Session
para obtener la dirección de correo electrónico del usuario y la zona horaria de la secuencia de comandos.- El usuario se basa en quién ejecuta la secuencia de comandos. Dado que la secuencia de comandos se ejecuta en un activador basado en el tiempo, el usuario se define como la persona que creó el activador.
- La secuencia de comandos usa la zona horaria para agregar la fecha y hora en que se ejecutó la secuencia de comandos al correo electrónico de resumen.
- Servicio de utilidades: analiza cada archivo CSV en un array. Da formato a la fecha en la que la secuencia de comandos agrega al correo electrónico de resumen.
- Servicio de correo electrónico: Envía el correo electrónico de resumen después de que se importan los datos de los archivos CSV a la hoja de cálculo.
Requisitos previos
Para usar esta muestra, necesitas los siguientes requisitos previos:
- Una Cuenta de Google (es posible que las cuentas de Google Workspace requieran la aprobación del administrador)
- Un navegador web con acceso a Internet
Configura la secuencia de comandos
- Haz clic en el siguiente botón para abrir el proyecto de Apps Script Importar datos CSV.
Abre el proyecto. - Haz clic en Descripción general .
- En la página de descripción general, haz clic en Crear una copia .
Ejecuta la secuencia de comandos:
- En el proyecto de Apps Script que copiaste, ve al archivo SetupSample.gs.
- En el menú desplegable de la función, selecciona setupSample y haz clic en Ejecutar. Esta función crea el activador basado en el tiempo, los archivos CSV, la hoja de cálculo y la carpeta que la secuencia de comandos usa para ejecutarse de forma correcta.
Cuando se te solicite, autoriza la secuencia de comandos. Si la pantalla de consentimiento de OAuth muestra la advertencia Esta app no está verificada, selecciona Avanzado > Ir a {Nombre del proyecto} (no seguro).
Para ver el activador basado en el tiempo una vez que se complete la configuración, haz clic en Activadores
.Para ver los archivos creados, abre la carpeta [Apps Script sample] Importar CSV en Google Drive.
Vuelve al proyecto de Apps Script y, en el editor, ve al archivo Code.gs.
En el menú desplegable de la función, selecciona updateApplicationSheet y haz clic en Ejecutar.
Para ver el correo electrónico de resumen con un vínculo a la hoja de cálculo con datos importados, revisa la bandeja de entrada del correo electrónico.
(Opcional) Restablece la solución
Puedes restablecer la solución para actualizarla con tus propios datos o volver a probar la demostración.
- En el proyecto de Apps Script, ve al archivo SetupSample.gs.
- En el menú desplegable de la función, selecciona removeSample y haz clic en Ejecutar. Esta función borra el activador, los archivos y la carpeta que se crearon en la sección anterior.
Revisa el código
Para revisar el código de Apps Script de esta solución, haz clic en Ver código fuente a continuación:
Ver el código fuente
Code.gs
SampleData.gs
SetupSample.gs
Utilities.gs
Colaboradores
Google mantiene esta muestra con la ayuda de Expertos de Google Developers.