내보내기 및 가져오기 추적
ThingWorx에서 엔티티 및 데이터를 가져오고 내보내는 작업의 진행률을 추적할 수 있습니다.
작업 진행률 상태
제출된 작업의 진행률을 추적하는 데 캐시가 사용됩니다. 작업의 상태는 다음 중 하나일 수 있습니다.
|
상황
|
설명
|
|
등록됨
|
진행률을 추적하기 위해 작업이 캐시에 제출되었습니다.
|
|
진행 중
|
작업이 현재 진행 중입니다.
|
|
성공
|
예외 없이 작업이 완료되었습니다.
|
|
부분 성공
|
작업이 완료되었지만 일부 하위 작업에서 오류/예외가 발생하여 완료되지 않았습니다.
|
|
실패
|
오류/예외 때문에 작업이 완료되지 않고 중단되었습니다.
|
|
등록 취소됨
|
이 작업이 캐시에 없으며 해당 진행률 상태가 추적되지 않았습니다.
|
내보내기/가져오기 작업 진행률 추적 사용
이 기능은 서비스 호출에 trackTaskProgress=true 매개 변수를 추가하여 사용할 수 있습니다. 내보내기( > ) 및 가져오기( > ) 작업은 관련 작업의 추적을 켜지 않습니다.
• 엔티티 내보내기 작업 진행률 사용
다음은 내보내기 작업 추적 진행률 상태를 사용하는 호출의 예입니다.
http://localhost:8080/Thingworx/Exporter?repositoryName=SystemRepository&path=/&trackTaskProgress=true
머리글에 Accept=application/octet-stream을 추가합니다.
이 GET 요청에 대한 회신으로 응답에서 taskID가 보내집니다. 다음은 응답 샘플입니다.
"처리를 위해 제출된 엔티티 내보내기입니다. 로그에서 Task-1493913609284의 완료 상태를 확인하십시오."
여기서 taskID는 1493913609284입니다. 이 응답에서 이 taskID를 읽어들이고 이를 사용하여 작업의 완료 상태를 추적해야 합니다.
• 엔티티 가져오기 작업 진행률 사용
다음은 내보내기 작업 추적 진행률 상태를 사용하는 호출의 예입니다.
http://localhost:8080/Thingworx/Importer?repositoryName=SystemRepository&path=/&trackTaskProgress=true&exportFileName=AllEntities.twx
이 GET 요청에 대한 회신으로 응답에서 taskID가 보내집니다. 다음은 응답 샘플입니다.
"처리를 위해 제출된 엔티티 가져오기입니다. 로그에서 Task-1493913609285의 완료 상태를 확인하십시오."
여기서 taskID는 1493913609285입니다. 이 응답에서 이 taskID를 읽어들이고 이를 사용하여 작업의 완료 상태를 추적해야 합니다.
추적을 사용하여 작업 완료 상태 가져오기
내보내기/가져오기 GET 요청의 응답에 보낸 taskID는 해당 작업의 진행률을 추적하는 데 사용될 수 있습니다. taskCacheKey=taskID는 특정 작업의 완료 상태를 추적하기 위한 서비스 호출의 필수 매개 변수입니다.
• 내보내기 진행률 작업 추적
다음은 이미 제출된 작업의 완료 상태를 얻는 추적의 예입니다.
http://localhost:8080/Thingworx/Exporter/cache/?taskCacheKey=1493913609284
캐시에 있는 작업의 상태를 기반으로 응답이 사용자에게 전송됩니다. 이 응답에는 위에서 언급한 작업 진행률 상태 중 하나가 포함됩니다. 이러한 응답을 받은 사용자는 반환된 작업 상태를 기반으로 정기적으로 추적하고 결국 등록된 작업의 상태를 얻을 수 있습니다.
• 가져오기 진행률 작업 추적
다음은 이미 제출된 작업의 완료 상태를 얻는 추적의 예입니다.
http://localhost:8080/Thingworx/Importer?taskCacheKey=1493913609285
캐시에 있는 작업의 상태를 기반으로 응답이 사용자에게 전송됩니다. 이 응답에는 위에서 언급한 작업 진행률 상태 중 하나가 포함됩니다. 반환된 작업 상태를 기반으로 정기적으로 추적하고 결국 등록된 작업의 상태를 얻을 수 있습니다.