Отслеживание экспорта и импорта
Можно отслеживать ход выполнения импорта и экспорта сущностей и данных в ThingWorx.
Статус хода выполнения задания
Для отслеживания хода выполнения отправленных заданий используется кэш. Задание может иметь следующие статусы:
|
Статус
|
Описание
|
|
REGISTERED
|
Задание отправлено в кэш для отслеживания хода выполнения.
|
|
ВЫПОЛНЯЕТСЯ
|
Задание в настоящее время выполняется.
|
|
SUCCESSFUL
|
Задание завершено успешно, без каких-либо исключительных ситуаций.
|
|
PARTIAL SUCCESSFUL
|
Задание завершено, но в некоторых подзадачах возникли ошибки или исключительные ситуации и подзадачи не были завершены.
|
|
FAILURE
|
Задание не завершено и прервано из-за ошибки или исключительной ситуации.
|
|
UNREGISTERED
|
Это задание не найдено в кэше, и ход его выполнения не отслеживается.
|
Включение отслеживания хода выполнения задания экспорта/импорта
Эта функция может быть активирована добавлением параметра trackTaskProgress=true в вызове сервиса. Действия экспорта ( > ) и импорта ( > ) не включают отслеживание связанных заданий.
• Включение хода выполнения задания экспорта сущности
Следующий пример демонстрирует вызов задания экспорта с включением отслеживания статуса хода выполнения:
http://localhost:8080/Thingworx/Exporter?repositoryName=SystemRepository&path=/&trackTaskProgress=true
Добавьте Accept=application/octet-stream в заголовок.
В ответ на этот запрос GET отправляется taskID. Ниже приведен пример ответа:
"Экспорт сущностей отправлен для обработки. Проверьте по журналу статус завершения задания 1493913609284."
Где taskID = 1493913609284. Необходимо загрузить это значение taskID из данного ответа и использовать его для отслеживания статуса выполнения задания.
• Включение хода выполнения задания импорта сущности
Следующий пример демонстрирует вызов задания импорта с включением отслеживания статуса хода выполнения:
http://localhost:8080/Thingworx/Importer?repositoryName=SystemRepository&path=/&trackTaskProgress=true&exportFileName=AllEntities.twx
В ответ на этот запрос GET отправляется taskID. Ниже приведен пример ответа:
"Импорт сущностей отправлен для обработки. Проверьте по журналу статус завершения задания 1493913609285."
Где taskID = 1493913609285. Необходимо загрузить это значение taskID из данного ответа и использовать его для отслеживания статуса выполнения задания.
Использование отслеживания для получения статуса завершения задания
Идентификатор taskID, отправленный в ответе на запрос экспорта/импорта GET, может использоваться для отслеживания хода выполнения этого задания. taskCacheKey=taskID является обязательным параметром в вызове сервиса для отслеживания статуса завершения конкретного задания.
• Отслеживание хода выполнения задание экспорта
Ниже приводится пример отслеживания для получения статуса завершения уже отправленного задания:
http://localhost:8080/Thingworx/Exporter/cache/?taskCacheKey=1493913609284
Ответ будет отправлен на основании статуса задания, находящегося в кэше. Ответ содержит одно из приведенных выше значений статуса выполнения задания. Пользователь может периодически вести отслеживание на основе возвращаемого статуса задания и в конечном счете получать статус зарегистрированного задания.
• Отслеживание хода выполнения задания импорта
Ниже приводится пример отслеживания для получения статуса завершения уже отправленного задания:
http://localhost:8080/Thingworx/Importer?taskCacheKey=1493913609285
Ответ будет отправлен на основании статуса задания, находящегося в кэше. Ответ содержит одно из приведенных выше значений статуса выполнения задания. Можно периодически вести отслеживание на основе возвращаемого статуса задания и в конечном счете получать статус зарегистрированного задания.