导出和导入跟踪
您可以跟踪在 ThingWorx 中导入和导出实体和数据的进度。
任务进度状况
缓存用于跟踪已提交任务的进度。任务可具有以下状况:
状况
说明
已注册
任务以提交到缓存中以跟踪进度。
进行中
任务目前正在进行。
成功
任务完成且无任何异常。
部分成功
任务完成,但某些子任务出现错误/异常且未能完成。
失败
任务由于错误/异常而未能完成,且已被中止。
未注册
在缓存中未找到此任务,因此未能跟踪其进度状况。
启用导出/导入任务进度跟踪
可通过在服务调用中添加 trackTaskProgress=true 参数来启用此功能。导出 (“导入/导出” > “至文件”) 和导入 (“导入/导出” > “自文件”) 操作不会开启对相关任务的跟踪。
启用实体导出任务进度
以下是启用导出任务跟踪进度状况的示例调用:
http://localhost:8080/Thingworx/Exporter?repositoryName=SystemRepository&path=/&trackTaskProgress=true
在标题中添加 Accept=application/octet-stream
在响应中发送 taskID 以回复此 GET 请求。以下是一个示例响应:
“提交以进行处理的实体导出。请检查日志中任务 1493913609284 的完成状况。”
其中,taskID1493913609284。您必须从该响应中检索此 taskID,并使用它来跟踪任务的完成状况。
启用实体导入任务进度
以下是启用导出任务跟踪进度状况的示例调用:
http://localhost:8080/Thingworx/Importer?repositoryName=SystemRepository&path=/&trackTaskProgress=true&exportFileName=AllEntities.twx
在响应中发送 taskID 以回复此 GET 请求。以下是一个示例响应:
“提交以进行处理的实体导入。请检查日志中任务 1493913609285 的完成状况。”
其中,taskID1493913609285。您必须从该响应中检索此 taskID,并使用它来跟踪任务的完成状况。
使用跟踪获取任务完成状况
在导出/导入 GET 请求的响应中发送的 taskID 可用于跟踪该任务的进度。taskCacheKey=taskID 是服务调用中不可或缺的参数,以用于跟踪特定任务的完成状况。
跟踪导出进度任务
以下是通过跟踪获取已提交任务的完成状况的示例:
http://localhost:8080/Thingworx/Exporter/cache/?taskCacheKey=1493913609284
根据缓存中任务的状况,向您发送响应。响应包括上述任务进度状况之一。作为用户,您可以根据返回的任务状况定期跟踪,并最终获得已注册任务的状况。
跟踪导入进度任务
以下是通过跟踪获取已提交任务的完成状况的示例:
http://localhost:8080/Thingworx/Importer?taskCacheKey=1493913609285
根据缓存中任务的状况,向您发送响应。响应包括上述任务进度状况之一。您可以根据返回的任务状况定期跟踪,并最终获得已注册任务的状况。