Centro de soporte de Workiva

Introducción

Este artículo explica cómo reemplazar un archivo en Wdata utilizando las APIs de Workiva. Recuperará el archivo existente, lo desimportará y eliminará, y a continuación cargará una nueva versión.

Requisitos previos

Antes de comenzar, asegúrese de haber completado todos los pasos de la guía Importing Workiva API Collections into Postman. Esto garantiza que la colección de API y las variables de entorno están configuradas correctamente.

Autenticación

1. Abra su espacio de trabajo Postman y confirme que está utilizando el entorno correcto.
2. Expanda la colección IAM Services, abra la carpeta oauth2 y seleccione la solicitud Retrieve a token.
3. Haga clic en Enviar para generar su testigo de autenticación. El token se almacena automáticamente en la variable de entorno {{access_token}} y se utilizará en todas las llamadas posteriores a la API.

Nota: Los tokens de caducan a los 600 segundos (10 minutos). Cuando esto ocurra, simplemente repita este paso para generar uno nuevo.

Recuperar el ID de archivo mediante la API Recuperar una lista de archivos

Antes de cargar o sustituir un fichero en una tabla Wdata, confirme si el fichero ya existe. Puede hacerlo utilizando la API Retrieve a List of Files para localizar el archivo y obtener su ID de archivo.

Siga los pasos que se indican a continuación.

1. Abrir el punto final de la API
   • Vaya a Wdata API → Archivo → Recuperar una lista de archivos.
2. Introduzca los parámetros necesarios
   • TableId: el ID de su tabla Wdata
   • SearchText: el nombre del archivo (por ejemplo, Tabla de control (3).csv)
3. Ejecutar la solicitud
   • La API le devolverá todos los archivos que coincidan con su búsqueda.
4. Buscar el ID de archivo
   • En la respuesta JSON, busque:
     • id → el ID del archivo
     • nombre → confirma el archivo correcto

(Opcional) Verificación en Wdata
Abra el conjunto de datos en la interfaz de usuario y confirme que el ID de archivo coincide.

Desimporte el archivo utilizando el ID de archivo

Utilice el punto final Unimport a single file para eliminar un archivo importado de una tabla Wdata. Este paso prepara la mesa para recibir un archivo de sustitución.

1. En Postman, abra la solicitud Unimport a single file.
2. En Variables de ruta, configure:
   • TableId al ID de su tabla Wdata.
   • FileId al File ID recuperado en el paso anterior.
3. Haga clic en Enviar para ejecutar la solicitud.
4. En el cuerpo de la respuesta, confirme que el registro del archivo muestra ahora un estado actualizado (por ejemplo, se ha movido de nuevo a escalonado). 
   
5. En Wdata → Datasets, abra el conjunto de datos y compruebe que el archivo ya no aparece como importado. 
   

Eliminar el archivo utilizando el ID de archivo

1. En Postman, abra la solicitud Delete a single file.
2. En Path Variables, pegue el mismo fileId.
3. Envía la solicitud.
4. Confirme que el cuerpo de la respuesta devuelve que fileId, esto confirma que el archivo ha sido eliminado de la tabla.

Opcional: Desimporte y elimine el archivo en un solo paso utilizando force=true

Por defecto, cuando un archivo se desimporta, se elimina de la tabla y se devuelve al modo por etapas, pero no se elimina. Para eliminar permanentemente el archivo como parte de una única operación, incluya el parámetro de consulta force.

Cuando se especifica force=true, el archivo se desimporta y se elimina en una sola petición. No es necesaria una llamada separada a la API Delete a single file.

Ejemplo:

DELETE /api/v1/table/{tableId}/import/{fileId}?force=true 

Cargar el nuevo archivo

Después de eliminar el archivo anterior, siga los pasos de la guía Cargar e importar un archivo para cargar e importar la nueva versión.