Suivi des exportations et des importations
Vous pouvez suivre le déroulement de vos importations et exportations d'entités et de données dans ThingWorx.
Statut d'avancement de la tâche
Un cache est utilisé pour suivre l'avancement des tâches soumises. Les statuts possibles d'une tâche sont les suivants :
|
Status
|
Description
|
|
REGISTERED
|
Tâche soumise au cache pour suivi de son avancement.
|
|
IN PROGRESS
|
Tâche en cours d'exécution.
|
|
SUCCESSFUL
|
Tâche exécutée sans survenue d'aucune exception.
|
|
PARTIAL SUCCESSFUL
|
Tâche exécutée, mais certaines sous-tâches ont rencontré des erreurs/exceptions et n'ont pas pu être menées à bien.
|
|
FAILURE
|
Tâche non menée à bien en raison d'erreurs/d'exceptions et abandonnée.
|
|
UNREGISTERED
|
Tâche non trouvée dans le cache, suivi d'avancement impossible.
|
Activation du suivi de l'avancement des tâches d'exportation/importation
Cette fonctionnalité peut être activée par ajout du paramètre trackTaskProgress=true dans l'appel du service. Les actions d'exportation ( > ) et d'importation ( > ) n'activent pas le suivi des tâches associées.
• Activer le suivi de l'avancement d'une tâche d'exportation d'entités
Voici un exemple d'appel pour activer le suivi de l'avancement d'une tâche d'exportation :
http://localhost:8080/Thingworx/Exporter?repositoryName=SystemRepository&path=/&trackTaskProgress=true
Ajoutez Accept=application/octet-stream dans l'en-tête.
Un ID de tâche (taskID) vous est renvoyé dans la réponse à cette requête GET. Voici un exemple de réponse :
“Entities Export submitted for processing. Please check the log for completion status of Task-1493913609284.”
Dans cet exemple, l'ID de tâche (taskID) est 1493913609284. Récupérez l'ID de tâche fourni dans la réponse et utilisez-le pour suivre le statut d'avancement de la tâche.
• Activer le suivi de l'avancement d'une tâche d'importation d'entités
Voici un exemple d'appel pour activer le suivi de l'avancement d'une tâche d'exportation :
http://localhost:8080/Thingworx/Importer?repositoryName=SystemRepository&path=/&trackTaskProgress=true&exportFileName=AllEntities.twx
Un ID de tâche (taskID) vous est renvoyé dans la réponse à cette requête GET. Voici un exemple de réponse :
“Entities Import submitted for processing. Please check the log for completion status of Task-1493913609285.”
où taskID correspond à 1493913609285. Récupérez l'ID de tâche (taskID) fourni dans la réponse et utilisez-le pour suivre le statut d'avancement de la tâche.
Utilisation du suivi pour obtenir le statut d'avancement de la tâche
L'ID de tâche (taskID) renvoyé dans la réponse à la requête GET d'exportation/importation peut être utilisé pour s'informer du statut d'avancement de la tâche. taskCacheKey=taskID est un paramètre obligatoire dans l'appel du service mis en oeuvre pour s'informer du statut d'avancement de la tâche concernée.
• Obtenir le statut d'avancement d'une tâche d'exportation
Voici un exemple d'appel pour obtenir le statut d'avancement d'une tâche précédemment soumise :
http://localhost:8080/Thingworx/Exporter/cache/?taskCacheKey=1493913609284
La réponse qui vous est renvoyée vous indique le statut de la tâche dans le cache (l'un des statuts d'avancement de tâche répertoriés ci-avant). Vous pouvez renouveler périodiquement l'opération au besoin, en fonction du statut renvoyé, pour suivre l'évolution de la tâche enregistrée.
• Obtenir le statut d'avancement d'une tâche d'importation
Voici un exemple d'appel pour obtenir le statut d'avancement d'une tâche précédemment soumise :
http://localhost:8080/Thingworx/Importer?taskCacheKey=1493913609285
La réponse qui vous est renvoyée vous indique le statut de la tâche dans le cache (l'un des statuts d'avancement de tâche répertoriés ci-avant). Vous pouvez renouveler périodiquement l'opération au besoin, en fonction du statut renvoyé, pour suivre l'évolution de la tâche enregistrée.