Con una solución Workiva conectada, hay varias formas de actualizar los datos de una Hoja de cálculo Workiva. Al utilizar Wdata, se puede crear una conexión entrante para actualizar los datos de una hoja de cálculo a partir de una consulta de Wdata. En este artículo, exploramos el uso de Cadenas para actualizar datos en una Hoja de Cálculo utilizando los comandos Escribir Datos de Hoja y Sobrescribir Datos de Hoja.
Entradas de comando comunes
Los comandos Escribir datos de la hoja y Sobrescribir datos de la hoja tienen varias entradas que son iguales en ambos comandos.
| Entrada | Propósito |
| ID de hoja de cálculo | El ID de la hoja de cálculo de Workiva en la que se escribirán los datos. |
| ID de hoja/Nombre |
El nombre o ID de la hoja dentro de la hoja de cálculo en la que se escriben los datos. Los nombres son CASE-SENSITIVE. |
| Archivo de datos |
El archivo que contiene los datos delimitados que deben escribirse en la hoja. CSV es el formato de archivo más común, pero se admiten otros delimitadores. Los datos JSON deben convertirse a un formato delimitado para poder utilizar este comando. |
| Delimitador |
El delimitador de archivos. La Coma (,) es el más común, pero se admite cualquier delimitador, incluido el punto y coma ( Asegúrate de que los campos cuyos datos contienen el delimitador especificado están entre comillas dobles. Por ejemplo, en un archivo delimitado por comas: Workiva, "Ames, IA, EE.UU.",WK |
| Región (Escribir datos de la hoja) / Inicio Celda (Sobrescribir datos de la hoja) |
La dirección de la celda inicial donde se escribirán los datos. Encontrarás información adicional sobre los valores válidos en la sección específica de cada comando a continuación. |
| Utiliza Async |
Cuando esté comprobado, el comando realizará una actualización asíncrona de la hoja. Esto significa que la Cadena pasará a su siguiente operación mientras se sigue realizando la operación de actualización de la hoja dentro de la plataforma. Esta opción se recomienda para conjuntos de datos grandes, pero solo si las operaciones de Cadena posteriores no dependen de la actualización de la hoja. |
| Utilizar la API de la plataforma |
Cuando está comprobado, el comando utiliza la API de plataforma para realizar la actualización en lugar de la API de hoja de cálculo heredada. Se recomienda la API de plataforma, ya que es la más reciente de las API y sigue mejorándose con funciones adicionales. |
Escribir datos de la hoja
El comando Escribir datos de la hoja se utiliza mejor cuando se necesita actualizar regiones concretas de una hoja conservando los datos de otras regiones de la hoja. La tabla siguiente describe el comportamiento de borrado para cada formato de Región especificado.
| Formato | Ejemplo | Efecto |
| Dirección de una sola celda | B2 |
Actualizar una sola celda dentro de la hoja, no afecta a los valores de ninguna otra celda. Este formato es no Recomendado a menos que escribas el valor de una sola celda. Si el archivo de datos contiene más de un punto de datos, el comando fallará al utilizar este formato. |
| Dirección de la celda inicial, sin celda ni columna finales | B2: |
Actualiza la hoja que empieza en la dirección de la celda inicial. Se conservan los valores de la hoja a la izquierda (columna) y por encima (fila) de la dirección de la celda inicial |
| Dirección de celda inicial, columna final sin fila finalizadora | B2:D |
Actualiza la hoja que empieza en la dirección de la celda inicial. Se conservan los valores de la hoja a la izquierda (columna) y por encima (fila) de la dirección de la celda inicial |
| Dirección inicial de la celda, dirección final de la celda | B2:D5 |
Reemplaza todas las celdas del rango especificado. Nota: Si el rango especificado en el comando es menor (menos filas o columnas) que el archivo de datos que se está cargando, el comando fallará. |
Sobrescribir datos de la hoja
El comando Sobrescribir datos de hoja se utiliza mejor cuando se necesita borrar un bloque entero dentro de una hoja. La tabla siguiente describe el comportamiento de borrado para cada formato de Celda inicial especificado.
| Formato | Ejemplo | Efecto |
| Dirección de una sola celda | B2 |
Se conservan los valores de la hoja a la izquierda (columna) y por encima (fila) de la dirección de la celda inicial |
| Dirección de la celda inicial, sin celda ni columna finales | B2: |
Se conservan los valores de la hoja a la izquierda (columna) y por encima (fila) de la dirección de la celda inicial |
| Dirección de celda inicial, columna final sin fila finalizadora | B2:D |
Este formato no es compatible y dará lugar a un error de ejecución del comando. |
| Dirección inicial de la celda, dirección final de la celda | B2:D5 |
Se conservan los valores de la hoja a la izquierda (columna) y por encima (fila) de la dirección de la celda inicial La Anchura (columnas) y la Altura (filas) del fichero de datos son irrelevantes. |
Pruébalo
Se han creado una Plantilla de Cadenas y una Hoja de Cálculo de pruebas que te permitirán ver los resultados de cada uno de los formatos Inicio Celda/Región anteriores. Evaluar:
- Descarga la hoja de cálculo de pruebas de este enlace (25 KB) y impórtala a tu Espacio de trabajo.
- CREAR UNA CADENA DE PRUEBAS Utilizando la página Utilizar Cadenas para actualizar una Hoja de cálculo Workiva Plantilla que se encuentra en 4. Guías de inicio rápido -> Ejemplos de habilitación y utilización Carpeta de plantillas.
- Se recomienda asignar la ID de la hoja de cálculo variable de la plantilla como Variable de la cadena.
- Actualiza la Variable de la cadena del ID de la hoja de cálculo antes de ejecutar la cadena en tu espacio de trabajo.
- Asegúrate de que el usuario de la conexión Cadenas de Workiva tiene el ámbito file:write y que el usuario ha sido asignado a la hoja de cálculo importada.
- Ejecuta la Cadena y revisa los resultados. Los resultados esperados se indican en la hoja Resultados esperados de la hoja de cálculo importada.