Dépannage : erreurs et alertes

Alertes utilisateur

Pour mettre en évidence les problèmes non critiques que les utilisateurs peuvent rencontrer lors de l'enregistrement des données, les alertes sont disponibles dans la colonne Détails (Details) du tableau Équipe (Team).

Spécifications des alertes :

• Les alertes n'arrêtent pas et n'interfèrent pas avec l'enregistrement de l'utilisateur.
• Plusieurs alertes peuvent être affichées en même temps pour un compte utilisateur.

Alertes définies dans la plate-forme :

• La file d’attente est fermée (Queue is shut down) : s’affiche lorsque l’utilisateur ferme la file d’attente. Cela signifie que l’enregistreur capture des données qui ne seront pas traitées tant que l’application n'aura pas été relancée. Ces informations sont également communiquées à l’utilisateur via un message de notification.
• La file d’attente est ralentie (Queue is slowed) : s’affiche une fois qu’un utilisateur a enregistré plus de 1 000 actions et que moins de 15 % d’entre elles ont également été traitées.
• Échec du téléchargement (Upload Failed) : l'utilisateur a quelques fichiers qui n'ont pas pu être téléchargés. Les tentatives de téléchargement seront poursuivies. Pour forcer le téléchargement, redémarrez la file d'attente de l'utilisateur.

• Le dossier partagé sur le réseau n’est pas accessible (Network Shared Folder is not accessible) - s’affiche lorsque la file d’attente ne peut pas accéder au dossier partagé sur le réseau, ce qui signifie que les données sont enregistrées dans le stockage de l’utilisateur. Notez que la dernière tentative d’accès au dossier partagé sur le réseau est signalée par un horodatage.

  Remarque : l'ouverture du dossier partagé en réseau sur le bureau de l'utilisateur dans l'explorateur de fichiers devrait permettre de réduire la file d'attente et de restaurer l'accès.
• L'objectif d'enregistrement de l'utilisateur est atteint (User recording goal is reached) : affiché lorsque l'utilisateur atteint l'objectif utilisateur défini dans les paramètres du projet.

L'erreur ou l'alerte s'applique aux utilisateurs pour lesquels le processus de capture a enregistré un problème.

Dépannage : erreurs et alertesLesalertes sont affichées pour les problèmes non critiques et peuvent être résolues à l'aide des options Réinitialiser (Reset) ou Redémarrer la file d'attente (Restart queue). Si elles ne sont pas surveillées, certaines peuvent entraîner une erreur qui arrête l'enregistrement de l'utilisateur.

Le message d'erreur spécifique s'affiche lorsque l'administrateur clique sur l'icône Info en regard de l'état de l'erreur.

Erreurs utilisateur

Différents messages d'erreur sont définis lorsque le statut de l'utilisateur est défini sur Erreur (Error).

• Les erreurs RI indiquent que le processus d'enregistrement initial à l'origine de la création des données capturées ne fonctionne pas correctement.
• Les erreurs QS indiquent que le démarrage de la file d'attente présente des erreurs.
• Les erreurs QR indiquent une erreur lorsque la file d'attente est en cours d'exécution. Cela peut être dû à des problèmes de connectivité si un dossier partagé est utilisé.

Retrouvez ci-dessous les erreurs les plus courantes, leur code d'erreur complet, la source possible et un lien hypertexte vers le document concerné.

RI0001 : un nombre considérable d'actions de l'utilisateur n'a pas pu être capturé par conséquent. Cela pourrait être causé par le blocage de la capture de métadonnées système ou des captures d’écran par d’autres applications.

Conseil de résolution : en plus de se produire lorsqu'une autre application intervient dans le processus d'enregistrement, cette erreur peut avoir lieu s'il n'y a pas de stockage disponible pour les données capturées.

QS0001: Configuration settings are not received by the user. Reset and Start to send configuration.

Conseil de résolution : pour résoudre ce type d'erreur, sélectionnez le compte d'utilisateur > cliquez sur l'option Réinitialiser (Reset) dans l'ensemble d'actions > confirmez votre action > cliquez sur l'option Démarrer (Start) dans l'ensemble d'actions.

Plus de détails sont disponibles dans la section Compte d'utilisateur et gestion des enregistrements (User Account and Recording Management).

QS0002: Configuration settings sent incorrectly. Reset and Start to re-send configuration.

Conseil de résolution : pour résoudre ce type d'erreur, sélectionnez le compte d'utilisateur > cliquez sur l'option Réinitialiser (Reset) dans l'ensemble d'actions > confirmez votre action > cliquez sur l'option Démarrer (Start) dans l'ensemble d'actions.

Plus de détails sont disponibles dans la section Compte d'utilisateur et gestion des enregistrements (User Account and Recording Management).

QS0003: The user has another Task Mining application already running.

Conseil de résolution : pour résoudre ce type d'erreur, contactez l'utilisateur et demandez-lui d'accéder à son outil PC de gestion de tâches > Terminer la tâche (End Task) pour toutes les instances de Task Mining. Après cela, accédez à la console d'administration > Utilisateurs (Users) > sélectionnez le compte d'utilisateur > cliquez sur l'option Démarrer (Start) dans l'ensemble d'actions.

QS0011: Path to screenshot folder can't be found. (Captured data can't be written to the User folder).

Conseil de résolution :  pour résoudre ce type d'erreur, sélectionnez le compte d'utilisateur > cliquez sur l'option Réinitialiser (Reset) dans l'ensemble d'actions > confirmez votre action > cliquez sur l'option Démarrer (Start) dans l'ensemble d'actions. Si cela ne résout pas le problème, réinstallez l'application cliente sur le PC de l'utilisateur.

QS0012: Path to archiving folder can't be found. (Processed data can't be written to the archiving folder).

Conseil de résolution : ce message indique que le dossier partagé du réseau présente des problèmes. Veuillez vérifier qu'il a été correctement configuré selon les étapes de la section Configuration du magasin de données local (Setup Local Data Store). Si cela ne résout pas le problème, veuillez vérifier si le chemin du dossier partagé pointe vers le bon emplacement en accédant à Paramètres (Settings) > Configurer la sortie à venir (Configure Upcoming Output) > vérifiez le chemin entré dans le champ Dossier partagé sur le réseau (Network Shared Folder).

QS0013: User doesn't have 'write' permission to the archiving folder.

Conseil de résolution : ce message indique que le dossier partagé du réseau présente des problèmes. Veuillez vérifier si tous les utilisateurs ont eu accès au dossier partagé selon les étapes de la section Activer le partage de dossiers publics (Enable Public Folder Sharing).

RC0101 : l’état de l’application Task Mining est corrompu.

Conseil de résolution : cela signifie généralement que l'application est dans l'état d'erreur ; la cause la plus courante est due au redémarrage « forcé », bien que d'autres options soient possibles.

Il existe deux manières de résoudre ce problème :

Option 1 : Réinitialiser le processus d'enregistrement

Cela s'applique lorsque la quantité de données capturées stockée localement n'est pas importante. Cela n'affectera pas les données déjà téléchargées, mais réinitialisera la télémétrie sur le tableau de bord du portail d'administration.

1. Assurez-vous de fermer l'application
2. Dans l'explorateur de fichiers, accédez au %AppData%\Task Mining\Projects\{projectId}\{userId}
3. Supprimez le fichier nommé user.settings.json
4. Démarrez une application

Option 2 : Envoyer les données à l'équipe technique pour récupérer le fichier manuellement.

Cette approche demande un peu plus d'efforts - elle doit être utilisée dans les cas où la perte de données n'est pas acceptable.

L'état peut être corrigé manuellement avec l'aide de l'équipe technique, et deux éléments sont nécessaires pour faciliter le processus :

• Les journaux de l'utilisateur concerné : ceux-ci sont situés sous le chemin suivant %AppData%\Task Mining\Projects\logs . Pour la plupart des erreurs, il est possible d'obtenir les journaux via la fonctionnalité intégrée au produit, mais pas dans ce cas particulier.
• Deux fichiers user.settings.json et user.settings.json.backup qui se trouvent ici : %AppData%\Task Mining\Projects\{projectId}\{userId}.
  Une fois le fichier corrigé, vous devez remplacer user.settings.json par la version correcte, comme dans l'option 1.

QS0022: Too many actions have failed in Queue processing. Please download and review logs for details and Restart the Queue to resolve this error.

Astuce de résolution : téléchargez et partagez les fichiers journaux avec l'assistance pour recevoir des informations détaillées sur l'erreur et redémarrer la file d'attente afin que l'utilisateur puisse restaurer le traitement. Déterminez si le problème est résolu une fois que l'utilisateur apparaît en ligne.

Remarque : contactez l'équipe d'assistance dans le cas des erreurs non répertoriées ci-dessus ou si les étapes fournies ne permettent pas de résoudre le problème.

Pour en savoir plus ou s'il s'agit d'une demande de l'équipe d'assistance, vous pouvez Télécharger les journaux (Download logs) correspondant à l'utilisateur.

Remarque : l'option Télécharger les journaux (Download logs) est disponible uniquement si vous accédez à l'icône Actions (Actions) à trois points correspondant au compte d'utilisateur et n'est activée que pour les utilisateurs dont l'état est labellisé Erreur (Error).

Fichiers ignorés

Fichiers ignorés lors de l'analyse : cette erreur indique que certaines applications sont corrompues ou n'ont pas pu être capturées correctement. Il est recommandé de réessayer ou si cette erreur se produit dans plus de 5 fichiers, de contacter l'équipe d'assistance.