Módulos de Google Sheets
En un escenario de Adobe Workfront Fusion, puede automatizar los flujos de trabajo que utilizan Google Sheets, así como conectarlo a varias aplicaciones y servicios de terceros.
Para obtener instrucciones sobre la conexión de la cuenta de Google Sheets a Workfront Fusion, consulte Crear una conexión a Adobe Workfront Fusion: instrucciones básicas
Requisitos de acceso
Para utilizar la funcionalidad de este artículo debe tener el siguiente acceso:
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| paquete de Adobe Workfront | Cualquiera |
| Licencia de Adobe Workfront |
Nuevo: estándar O Actual: Trabajo o superior |
| Licencia de Adobe Workfront Fusion** |
Actual: No se requiere licencia de Workfront Fusion O Heredado: Workfront Fusion para la automatización e integración del trabajo |
| Producto |
Nuevo:
O Actual: Su organización debe comprar Adobe Workfront Fusion. |
Para obtener más información sobre esta tabla, consulte Requisitos de acceso en la documentación.
Para obtener información sobre las licencias de Adobe Workfront Fusion, consulte licencias de Adobe Workfront Fusion.
Requisitos previos
Para usar los módulos de Google Sheets, debe tener una cuenta de Google.
Información de API de hojas de Google
El conector de Google Sheets utiliza lo siguiente:
Módulos de hojas de Google y sus campos
Al configurar módulos de Google Forms, Workfront Fusion muestra los campos que se indican a continuación. Junto a estos, pueden aparecer campos de Google Sheets adicionales, en función de factores como el nivel de acceso del que disponga en la aplicación o el servicio. El título en negrita en un módulo indica un campo obligatorio.
Si ve el botón Asignar encima de un campo o función, puede utilizarlo para establecer variables y funciones para ese campo. Para obtener más información, vea Asignar información de un módulo a otro.
Activadores
Watch Rows
Recupera valores de filas recién agregadas en la hoja de cálculo.
El módulo solo recupera las filas nuevas que no se hayan rellenado anteriormente. El déclencheur no procesa una fila sobrescrita.
Acciones
Añadir una fila
Este módulo añade una fila a una hoja.
Al configurar módulos de Google Sheets, Workfront Fusion muestra los campos que se indican a continuación. Junto a estos, pueden aparecer campos de Google Sheets adicionales, en función de factores como el nivel de acceso del que disponga en la aplicación o el servicio. El título en negrita en un módulo indica un campo obligatorio.
Si ve el botón Asignar encima de un campo o función, puede utilizarlo para establecer variables y funciones para ese campo. Para obtener más información, vea Asignar información de un módulo a otro.
Add a Sheet
Crea una hoja nueva en una hoja de cálculo seleccionada.
Clear a Cell
Elimina un valor de una celda especificada.
Clear a Row
Elimina valores de una fila especificada.
Create a Spreadsheet
Eliminar una fila
Elimina una fila especificada.
Eliminar una hoja
Elimina una hoja específica.
Obtener una celda
Recupera un valor de una celda seleccionada.
Realización de una llamada de API
Este módulo de acción le permite realizar una llamada de API personalizada.
https://sheets.googleapis.com/v4/.{"Content-type":"application/json"}. Workfront Fusion añade los encabezados de autorización para usted.Añada el contenido del cuerpo para la llamada de API en forma de objeto JSON estándar.
Nota:
Cuando utilice afirmaciones condicionales como if en su JSON, coloque las comillas fuera de la afirmación condicional.
Actualizar una celda
Actualizar una fila
Este módulo permite cambiar el contenido de la celda en una fila seleccionada.
Búsquedas
Obtener valores de rango
List Sheets
Este módulo devuelve una lista de todas las hojas de una hoja de cálculo.
Buscar filas
Busca filas utilizando las opciones de filtro.
Buscar filas (avanzado)
Devuelve los resultados que coinciden con los criterios especificados.
Límites de uso
Si se produce el error 429: RESOURCE_EXHAUSTED, ha excedido el límite de la API.
La API de Google Sheets tiene un límite de 500 solicitudes por 100 segundos por proyecto, y de 100 solicitudes por 100 segundos por usuario. Los límites para lecturas y escrituras se contabilizan por separado. No hay límite de uso diario.
Puede encontrar información más detallada en https://developers.google.com/sheets/api/limits?hl=es-419.
Sugerencias y trucos
Obtener celdas vacías de Google Sheet
Para obtener celdas vacías, puede usar el módulo Buscar filas (avanzadas). Utilice esta fórmula para obtener las columnas vacías.
select * where E is null
Aquí, "E" es la columna y "es nulo" es la condición. Puede crear una consulta más avanzada utilizando el lenguaje de consulta Google. Para obtener más información, consulte Google Query Lang en la documentación de Google.
Añadir un botón a una hoja para ejecutar un escenario
-
En Workfront Fusion, inserte el módulo Webhook > Webhooks personalizados en el escenario y configúrelo. Para obtener instrucciones, consulte Webhooks.
-
Copie la URL del webhook.
-
Ejecute el escenario.
-
En Google Sheets, elija Insertar > Dibujo… en la barra de menús principal.
-
En la ventana Dibujo, haga clic en el icono Cuadro de texto
-
Diseñe un botón y haga clic en el botón Guardar y cerrar en la esquina superior derecha:
-
El botón se coloca en la hoja de cálculo. Haga clic en los tres puntos verticales de la esquina superior derecha del botón:
-
Elija Asignar script… en el menú.
-
Escriba el nombre del script (función), por ejemplo
runScenarioy haga clic en Aceptar: -
Elija Herramientas > Editor de scripts en la barra de menús principal.
-
Inserte el siguiente código:
-
El nombre de la función debe corresponder al nombre especificado en el paso 9.
-
Reemplace la URL con la URL del webhook que copió en el paso 2.
code language-none function runScenario() { UrlFetchApp.fetch("<webhook you copied>"); }
-
-
Presione Ctrl+S para guardar el archivo de script, ingrese un nombre de proyecto y haga clic en Aceptar.
-
Vuelva a Google Sheets y haga clic en el nuevo botón.
-
Conceda la autorización necesaria al script:
-
En Workfront Fusion, compruebe que el escenario se ha ejecutado correctamente.
Almacenamiento de fechas en una hoja de cálculo
Si almacena un valor Date en una hoja de cálculo sin ningún formato, aparecerá en la hoja de cálculo como texto en formato ISO 8601. Sin embargo, Google Sheets fórmulas o funciones que funcionan con fechas que no comprenden este texto (Ejemplo: fórmula =A1+10) muestran el siguiente error:
Para permitir que Google Sheets entienda la fecha, debe aplicarle formato con la función formatDate. El formato correcto pasado a la función como segundo argumento depende de la configuración regional de la hoja de cálculo.
Para obtener más información sobre esta función, consulte formatDate (date; format; [timezone]) en el artículo Funciones de fecha y hora.
Para determinar el formato correcto:
-
En Hojas de cálculo de Google, elija la configuración de Archivo > Hoja de cálculo en el menú principal para comprobar y establecer la configuración regional.
-
Después de comprobar o establecer la configuración regional adecuada, determine el formato de fecha y hora correspondiente eligiendo Formato > Número en el menú principal. El formato se muestra junto al elemento de menú Fecha y hora:
-
Para componer el formato correcto que se debe pasar a la función formatDate(), consulte la lista de tokens para el formato de fecha y hora.
Ejemplo:
Para el formato MM/DD/YYYY HH:mm:ss (para la configuración regional de Estados Unidos):
Aprovechar las funciones de Google Sheets
Para utilizar una función integrada desde Hojas de cálculo de Google, puede aprovecharla. Para obtener más información, vea Usar Google Sheets funciones en el artículo Asignar un elemento mediante funciones.
Impedir que Google Sheets cambie números en fechas
Si una cadena de números que está utilizando como texto se interpreta como una fecha en una hoja de cálculo Google, puede aplicar formato previo al número como texto sin formato para evitarlo. Por ejemplo, si escribe 1-2019 con la intención de que sea texto, Google puede interpretarlo como una fecha.
- En Google Sheets, resalte la columna o celda que contenga el número o los números.
- Haga clic en Formato > Número > Texto sin formato.
Otra solución en Workfront Fusion es escribir un apóstrofo (') antes de un número, por ejemplo, '1-2019 o '1/47. El apóstrofo no se muestra en la celda después de que se hayan enviado los datos desde Workfront Fusion.