Solução de problemas: erros e alertas

Alertas do usuário

Para evidenciar problemas não críticos que os usuários podem encontrar durante a gravação de dados, Alertas estão disponíveis na coluna Detalhes na tabela Equipe.

Especificações de alertas:

• Os alertas não interrompem ou interferem com a gravação do usuário.
• Vários alertas podem ser exibidos ao mesmo tempo para uma conta de usuário.

Alertas definidos na plataforma:

• A fila foi encerrada — exibida quando o usuário fecha a Fila. Isso significa que o Gravador está capturando dados que não serão processados até o aplicativo ser reiniciado. Essa informação também é comunicada ao usuário por meio de uma mensagem de notificação.
• A fila está lenta — exibida quando um usuário gravou mais de 1.000 ações e menos de 15% delas também foram processadas.
• Falha no upload – o usuário tem alguns arquivos que não puderam ser carregados. As tentativas de upload serão continuadas, para forçar o upload, reinicie a Fila do usuário.

• A pasta compartilhada de rede não está acessível – exibida quando a fila não consegue acessar a Pasta compartilhada de rede, significando que os dados estão salvos no armazenamento do usuário. Observe que a última tentativa de acesso à pasta compartilhada de rede é marcada com um carimbo de data/hora.

  Observação: abrir a pasta de rede compartilhada na área de trabalho do usuário no explorador de arquivos deve ajudar a fila a se recuperar e restaurar o acesso.
• O objetivo de gravação do usuário foi atingido — exibido quando o usuário atinge a meta do usuário definida nas Configurações do projeto.

Erro ou Alerta se aplica a usuários para os quais o processo de captura registrou um problema.

Solução de problemas: erros e alertasOsalertas são exibidos para problemas não críticos e podem ser resolvidos usando a fila Redefinir ou Reiniciar. Se não resolvidos, alguns podem resultar em um Erro que interrompe a gravação do usuário.

A mensagem de erro específica é exibida quando o Administrador clica no ícone de Informações ao lado do status do erro.

Erros do usuário

Há diferentes mensagens de erro definidas para quando o status do usuário é Erro.

• Os erros RI indicam que algo está errado no processo inicial de gravação que cria os dados capturados.
• Os erros QS indicam que algo deu errado no início da Fila.
• Os erros QR indicam um erro durante a execução da Fila. Ele pode ser causado por problemas de conectividade se uma pasta compartilhada for usada.

Veja abaixo os erros mais comuns, seu código de erro completo, a possível origem e um hiperlink direcionando ao documento relevante.

RI0001: uma quantidade considerável de ações do usuário não foi capturada consequentemente. Isso pode ser causado por outros aplicativos que estão bloqueando capturas de tela ou a captura de metadados do sistema.

Dica de resolução: diferente de outro aplicativo intervindo no processo de gravação, esse erro pode ocorrer se não houver armazenamento para os dados capturados.

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

Dica de resolução: para resolver esse tipo de erro, selecione a conta do usuário > clique na opção Redefinir no conjunto de Ações > confirme sua ação > clique na opção Iniciar no conjunto de Ações.

Mais detalhes estão disponíveis na seção Gerenciamento de conta do usuário e gravação.

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

Dica de resolução: para resolver esse tipo de erro, selecione a conta do usuário > clique na opção Redefinir no conjunto de Ações > confirme sua ação > clique na opção Iniciar no conjunto de Ações.

Mais detalhes estão disponíveis na seção Gerenciamento de conta do usuário e gravação.

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

Dica de resolução: para resolver esse tipo de erro, entre em contato com o usuário e peça para que ele acesse em seu PC a ferramenta Gerenciador de Tarefas > Finalizar tarefa para todas as instâncias do Task Mining. Depois disso, acesse o Console de Administração > Usuários > selecione a conta do usuário > clique na opção Iniciar no conjunto de Ações.

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

Dica de resolução: para resolver esse tipo de erro, selecione a conta do usuário > clique na opção Redefinir no conjunto de Ações > confirme sua ação > clique na opção Iniciar no conjunto de Ações. Se isso não resolver o problema, reinstale o Aplicativo Cliente no PC do usuário.

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

Dica de resolução: essa mensagem indica que há problemas com a pasta de rede compartilhada. Verifique se ela foi configurada corretamente conforme as etapas da seção Configurar repositório de dados local. Se isso não resolver o problema, verifique se o caminho da pasta compartilhada aponta para o local correto acessando Configurações > Definir próxima saída > verifique o caminho inserido no campo Pasta de rede compartilhada.

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

Dica de resolução: essa mensagem indica que há problemas com a pasta de rede compartilhada. Verifique se todos os usuários receberam acesso à pasta compartilhada conforme as etapas da seção Habilitar o compartilhamento de pasta pública.

RC0101: o estado do aplicativo do Task Mining foi corrompido.

Dica de resolução: isso normalmente significa que o aplicativo está num estado de erro, sendo a causa mais comum a reinicialização “forçada”, embora outras opções sejam possíveis.

Há duas maneiras de resolver esse problema:

Opção 1: redefinir o processo de gravação

Isso é aplicável quando a quantidade de dados capturados armazenados localmente não é significativa. Isso não afeta os dados que já foram carregados, mas reinicializa a telemetria no painel do Portal do Administrador.

1. Certifique-se de fechar o aplicativo
2. No Explorador de Arquivos, navegue até o %AppData%\Task Mining\Projects\{projectId}\{userId}
3. Exclua o arquivo chamado user.settings.json
4. Inicie o aplicativo

Opção 2: enviar os dados para a equipe de engenharia para recuperar o arquivo manualmente.

Essa abordagem requer um pouco mais de esforço — deve ser usada em casos em que a perda de dados não é aceitável.

O estado pode ser corrigido manualmente com a ajuda da equipe de engenharia e duas coisas são necessárias para ajudar:

• Logs do usuário afetado: ficam localizados no caminho a seguir %AppData%\Task Mining\Projects\logs . Para a maioria dos erros, é possível obter os logs por meio de uma funcionalidade dentro do produto, no entanto, neste caso isso não ocorre.
• Dois arquivos, user.settings.json e user.settings.json.backup, que podem ser encontrados aqui: %AppData%\Task Mining\Projects\{projectId}\{userId}.
  Após o arquivo ser corrigido, você precisa substituir user.settings.json pela versão correta como na Opção 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.

Dica de resolução: baixe e compartilhe os arquivos de log com o suporte para receber informações detalhadas sobre o erro e a fila de reinicialização para que o usuário restaure o processamento. Veja se o problema foi resolvido quando o usuário aparecer online.

Observação: para erros não listados acima ou se as etapas fornecidas não resolverem o problema, entre em contato com a equipe de suporte.

Para obter detalhes ou se isso for uma solicitação vinda da equipe de suporte, você pode Baixar logs correspondentes ao usuário.

Observação: a opção Baixar logs está disponível somente se você acessar o ícone de três pontos de Ações, correspondente à conta do usuário e está habilitada para usuários cujo status é rotulado como Erro.

Arquivos ignorados

Arquivos ignorados em análise: esse erro informa que alguns aplicativos estão corrompidos ou não podem ser capturados corretamente. É recomendável tentar novamente ou se esse erro ocorrer em mais de 5 arquivos, entre em contato com a equipe de suporte.