Módulos de Google Sheets
En un escenario de Adobe Workfront Fusion, es posible automatizar los flujos de trabajo que utilizan Google Sheets, así como conectarlo a varias aplicaciones y servicios de terceros.
Para obtener instrucciones sobre cómo conectar su cuenta de Google Sheets a Workfront Fusion, consulte Crear una conexión con Adobe Workfront Fusion : instrucciones básicas
Requisitos de acceso
Para utilizar la funcionalidad de este artículo debe tener el siguiente acceso:
Para saber qué plan, tipo de licencia o acceso tiene, póngase en contacto con el administrador de Workfront.
Para obtener información sobre Adobe Workfront Fusion licencias, consulte Adobe Workfront Fusion licencias.
Requisitos previos
Para usar módulos Google Sheets, debe tener una cuenta de Google.
Información de API de hojas de Google
El conector de Google Sheets utiliza lo siguiente:
Activadores
Watch Rows
Recupera valores de cada fila recién añadida a la hoja de cálculo.
El módulo recupera únicamente las filas nuevas que no se hayan rellenado anteriormente. El activador no procesará una fila sobrescrita.
Acciones
Add a Row
Este módulo añade una fila a una hoja.
Al configurar Google Sheets módulos, Workfront Fusion muestra los campos que se indican a continuación. Junto con estos, podrían mostrarse Google Sheets campos adicionales, según factores como el nivel de acceso 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.
Update a Row
Este módulo permite cambiar el contenido de la celda en una fila seleccionada.
Clear a Row
Elimina valores de una fila especificada.
Delete a Row
Elimina una fila especificada.
Get a Cell
Recupera un valor de una celda seleccionada.
Update a Cell
Clear a Cell
Elimina un valor de una celda especificada.
Add a Sheet
Crea una hoja nueva en una hoja de cálculo seleccionada.
Create a Spreadsheet
Delete a Sheet
Elimina una hoja específica.
Make an API Call
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 en su lugar.Añada el contenido del cuerpo para la llamada de API en forma de objeto JSON estándar.
Nota:
Cuando utilice instrucciones condicionales como if en su JSON, coloque las comillas fuera de la instrucción condicional.
Búsquedas
Search Rows
Busca filas utilizando las opciones de filtro.
Search Rows (Advanced)
Devuelve los resultados que coinciden con los criterios especificados.
Get Range Values
List Sheets
Este módulo devuelve una lista de todas las hojas de una hoja de cálculo.
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
Cómo obtener celdas vacías de Google Sheet
Utilice el módulo Search Rows (Advanced) y utilice esta fórmula para obtener las columnas que están vacías.
select * where E is null
Añadir un botón a una hoja para ejecutar un escenario
-
En Workfront Fusion, inserte el módulo/déclencheur Webhook > Custom webhooks en el escenario y configúrelo (consulte Webhooks).
-
Copie la URL del webhook.
-
Ejecute el escenario.
-
En Hojas de cálculo de Google, elija Insert > Drawing… en la barra de menús principal.
-
En la ventana Drawing, haga clic en el icono Text box
-
Diseñe un botón y haga clic en el botón Save and Close en la esquina superior derecha:
-
El botón se colocará en la hoja de cálculo. Haga clic en los tres puntos verticales de la esquina superior derecha del botón:
-
Elija Assign script… en el menú.
-
Escriba el nombre del script (función), por ejemplo
runScenarioy haga clic en OK: -
Elija Tools > Script editor 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.
function runScenario() {UrlFetchApp.fetch("<webhook que copió>");}
-
-
Pulse Ctrl+S para guardar el archivo de script, escriba un nombre de proyecto y haga clic en OK.
-
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 haya ejecutado correctamente.
Almacenamiento de fechas en una hoja de cálculo
Si almacena un valor de fecha 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, las fórmulas o funciones de Google Sheets que trabajan con fechas que no entienden este texto (ejemplo: fórmula =A1+10) mostrarán el siguiente error:
Para permitir que Google Sheets entienda la fecha, debe aplicarle formato con la función formatDate (fecha; formato; [zona horaria]). El formato correcto pasado a la función como segundo argumento depende de la configuración regional de la hoja de cálculo.
Para determinar el formato correcto:
-
Elija la configuración de File > Spreadsheet en el menú principal para comprobar o establecer la configuración regional.
-
Una vez que haya verificado/establecido la configuración regional adecuada, determine el formato de fecha y hora correspondiente eligiendo Format > Number del 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: Uso del formato MM/DD/YYYY HH:mm:ss para la configuración regional de Estados Unidos:
Aprovechar las funciones de Google Sheets
Si se le pasa por alto una función integrada, pero Google Sheets la presenta, puede aprovecharla. Para obtener más información, consulte Usar Google Sheets funciones en Asignar elementos usando funciones en Adobe Workfront Fusion .
Evitar que Google Sheets convierta números en fechas
Es posible que descubra que una cadena de números que está utilizando como texto se interpreta como una fecha en una hoja de cálculo de Google. Por ejemplo, se escribe 1-2019 con la intención de que sea texto, pero Google lo interpreta como una fecha. Para evitarlo, puede formatear previamente el número como texto sin formato.
- En Google Sheets, resalte la columna o celda que contenga el número o los números.
- Haga clic en Format > Number > Plain text.
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 enviar los datos desde Workfront Fusion.