Seguimiento de la exportación e importación
Se puede realizar un seguimiento del progreso de las entidades y los datos que se importan y exportan en ThingWorx.
Estado del progreso de la tarea
Se utiliza una caché para realizar el seguimiento del progreso de las tareas enviadas. Una tarea puede tener los siguientes estados:
|
Estado
|
Descripción
|
|
REGISTERED
|
La tarea se envía en la caché para efectuar el seguimiento del progreso.
|
|
IN PROGRESS
|
La tarea está actualmente en curso.
|
|
SUCCESSFUL
|
La tarea se ha completado sin ninguna excepción.
|
|
PARTIAL SUCCESSFUL
|
La tarea se ha completado, pero algunas subtareas han encontraron algún error o excepción y no se han completado.
|
|
FAILURE
|
La tarea no se ha completado debido a un error o excepción y se ha abortado.
|
|
UNREGISTERED
|
Esta tarea no se encuentra en la caché y no se efectúa el seguimiento del estado del progreso.
|
Activación del seguimiento del progreso de la tarea de exportación o importación
Esta función se puede activar añadiendo el parámetro trackTaskProgress=true a la llamada de servicio. Las acciones de exportación ( > ) y de importación ( > ) no activarán el seguimiento de tareas relacionadas.
• Activar el progreso de la tarea de exportación de entidades
A continuación, se muestra una llamada de ejemplo para activar el seguimiento del estado de progreso de la tarea de exportación:
http://localhost:8080/Thingworx/Exporter?repositoryName=SystemRepository&path=/&trackTaskProgress=true
Añada Accept=application/octet-stream a la cabecera.
Se envía un objeto taskID en la respuesta a esta solicitud GET. A continuación, se proporciona una respuesta de ejemplo:
"Se ha enviado la exportación de entidades para procesamiento. Verifique el registro del estado de finalización de Task-1493913609284".
Donde taskID es 1493913609284. Se debe recuperar este objeto taskID de esta respuesta y utilizarlo para efectuar el seguimiento del estado de finalización de la tarea.
• Activar el progreso de la tarea de importación de entidades
A continuación, se muestra una llamada de ejemplo para activar el seguimiento del estado de progreso de la tarea de importación:
http://localhost:8080/Thingworx/Importer?repositoryName=SystemRepository&path=/&trackTaskProgress=true&exportFileName=AllEntities.twx
Se envía un objeto taskID en la respuesta a esta solicitud GET. A continuación, se proporciona una respuesta de ejemplo:
"Se ha enviado la importación de entidades para procesamiento. Verifique el registro del estado de finalización de Task-1493913609285".
Donde taskID es 1493913609285. Se debe recuperar este objeto taskID de esta respuesta y utilizarlo para efectuar el seguimiento del estado de finalización de la tarea.
Uso del seguimiento para obtener el estado de finalización de la tarea
El objeto taskID enviado en la respuesta de la solicitud GET de la exportación o importación se puede utilizar para efectuar el seguimiento del progreso de la tarea. taskCacheKey=taskID es un parámetro requerido en la llamada de servicio para efectuar el seguimiento del estado de finalización de la tarea concreta.
• Tarea de seguimiento del progreso de exportación
A continuación, se muestra un ejemplo de seguimiento para obtener el estado de finalización de una tarea que ya se ha enviado:
http://localhost:8080/Thingworx/Exporter/cache/?taskCacheKey=1493913609284
Según el estado de la tarea en la caché, se envía una respuesta al usuario. En la respuesta se incluye uno de los estados de progreso de la tarea mencionados arriba. Como usuario, se puede efectuar un seguimiento periódico basado en el estado de tarea devuelto y finalmente obtener el estado de la tarea registrada.
• Tarea de seguimiento del progreso de importación
A continuación, se muestra un ejemplo de seguimiento para obtener el estado de finalización de una tarea que ya se ha enviado:
http://localhost:8080/Thingworx/Importer?taskCacheKey=1493913609285
Según el estado de la tarea en la caché, se envía una respuesta al usuario. En la respuesta se incluye uno de los estados de progreso de la tarea mencionados arriba. Se puede efectuar un seguimiento periódico basado en el estado de tarea devuelto y finalmente obtener el estado de la tarea registrada.