Projetos#
A tela Projetos reúne logs de eventos e configurações de análise. Um projeto define como os dados são coletados, quais aplicativos são incluídos e como os usuários dos logs são associados aos funcionários.
1. Visualizar projetos#
A tabela permite encontrar um projeto e abrir suas configurações. É necessário selecionar "Projects" no menu esquerdo.
Exemplo: a tabela está filtrada para mostrar o projeto de demonstração "Обработка заявок". A linha mostra o tipo "Task Mining", o modo "Black List" e as datas de criação e atualização.

Tela Projetos: projeto de demonstração "Обработка заявок" (interface em russo)
A tabela contém as seguintes colunas:
- "Name".
- "Description".
- "Project type".
- "Filters mode".
- "Created".
- "Updated".
Filtros de colunas, ordenação e tamanho de página facilitam a busca entre muitos projetos.
A barra contém "Create", "Refresh" e "Delete selected". "Refresh" recarrega a tabela. As caixas de seleção das linhas selecionam projetos para exclusão em grupo.
2. Criar um projeto#
Um novo projeto define o método de coleta e análise de dados para uma tarefa separada.
Botão "Create"#
É necessário clicar em "Create" para abrir a janela "Project" e configurar o registro em "General".
Elementos obrigatórios:
- Campo "Name*" — nome usado em outras telas.
- Lista "Project type*" — método de análise. Ao criar um projeto, "Process Mining" é selecionado por padrão. Pode ser alterado antes de salvar.
Elementos adicionais:
- Campo "Description" — finalidade do projeto.
- Lista "Access folder" — pasta de acesso do projeto.

Janela "Project", aba "General": "Process Mining" selecionado por padrão (interface em russo)
Tipos disponíveis:
- "Process Mining" — análise de processos com logs de sistemas externos, como 1C ou Bitrix24. O CSV é carregado em Processos.
- "Task Mining" — análise de ações de usuários coletadas pelo Sherpa PD Agent. Os dados chegam em tempo real ou são carregados manualmente de um CSV.
- "Deep Task Mining" — análise de tarefas com imagens das ações coletadas junto com os eventos.
A tabela distingue esses três tipos de projeto.
Exemplo: informe Учебные события — QA 20261106 em "Name*" e Открытые синтетические события для проверки документации. em "Description". Selecione "Task Mining" em "Project type*" e deixe "Access folder" vazio. "OK" cria o projeto e o exibe na tabela. "Cancel" cancela a criação do projeto e fecha a janela.

Janela de criação do projeto, aba General (interface em russo)
Aba "Agent settings"#
Esta aba define quais ações um agente instalado coleta para um projeto do tipo "Task Mining" ou "Deep Task Mining". As configurações do agente não estão disponíveis para "Process Mining".
Elementos obrigatórios:
- Lista "Filters mode*" — exclui entradas de Black List ou inclui somente entradas de White List.
Elementos adicionais:
- Campo "Black List" ou "White List" — aplicativos, janelas e sites do modo selecionado.
- Indicadores "Yes" e "No" de "Do not show the agent icon in the tray (hidden recording)" — ocultam ou mostram o ícone do agente em execução. "No" é selecionado por padrão em um projeto novo.
- Indicadores "Yes" e "No" de "Record selectors from applications" — ativam ou desativam a gravação de seletores. "Yes" é selecionado por padrão em um projeto novo.
Exemplo: selecione Black List em "Filters mode*" e mantenha *SomeApplication.exe*, *Some Window Title* e *SomeWebSite.com* em "Black List". Selecione "No" em "Do not show the agent icon in the tray (hidden recording)" e "Yes" em "Record selectors from applications". "OK" salva as configurações do projeto.

Aba Agent settings da janela Project (interface em russo)
3. Editar e excluir#
Editar um projeto permite atualizar sua descrição mantendo os dados e as configurações.
Botão "Edit"#
O botão de edição
da linha abre a ficha completa. Em "General", nome, descrição e pasta de acesso podem ser alterados. GUID e "Project type*" são somente leitura. "OK" salva as alterações e "Cancel" fecha a janela sem salvar as alterações de "General" e "Agent settings". As alterações de "Employees" são salvas separadamente.
Nome e descrição também podem ser editados com um clique duplo nas células. Enter salva o texto e Esc cancela a edição.
Exemplo: a janela "Project" de Учебные события — QA 20261106 mostra o nome, a descrição Открытые синтетические события для проверки документации. e "Access folder" vazio. O tipo "Task Mining" não pode ser alterado. "OK" salva os novos valores do projeto e "Cancel" descarta as alterações de "General".

Janela de edição do projeto (interface em russo)
Botões de exclusão#
A exclusão oculta um projeto desnecessário da tabela. Trata-se de exclusão lógica: o registro do projeto permanece no servidor. A interface não oferece um comando para restaurar o projeto. "Delete" em uma linha
abre a confirmação para esse registro. Para excluir vários projetos, é necessário selecionar suas caixas e clicar em "Delete selected". Os registros selecionados devem ser conferidos antes da confirmação.
Exemplo: a janela solicita a exclusão de Учебные события — QA 20261106. "Yes" confirma a exclusão desse projeto. "No" cancela a exclusão e mantém o projeto na tabela.

Confirmação para excluir o projeto de exemplo (interface em russo)
4. Funcionários do projeto#
A associação de funcionários a usuários permite analisar o trabalho de uma pessoa que utiliza vários computadores ou nomes de acesso. É necessário abrir "Employees" em um projeto existente. Um usuário só pode pertencer a um funcionário dentro desse projeto.
Botão "Pull users from logs"#
A obtenção de usuários dos logs adiciona associações e preserva os nomes de funcionários informados manualmente.
Para preparar os dados manualmente, abra um editor de texto, como o Bloco de Notas no Windows, e crie um arquivo local employees-example.csv com codificação UTF-8. Insira o cabeçalho e os cinco eventos:
Time,Activity,UserName,ComputerName,AppName,CaseId
2026-11-06 09:00:00,Прием заявки,qa.operator,QA-PC,Requests.exe,CASE-001
2026-11-06 09:01:00,Проверка данных,qa.operator,QA-PC,Requests.exe,CASE-001
2026-11-06 09:03:00,Закрытие заявки,qa.operator,QA-PC,Requests.exe,CASE-001
2026-11-06 10:00:00,Прием заявки,qa.reviewer,QA-PC-2,Requests.exe,CASE-002
2026-11-06 10:02:00,Закрытие заявки,qa.reviewer,QA-PC-2,Requests.exe,CASE-002
Na tela Processos, selecione o projeto de teste separado Учебные события — QA 20261106 do tipo "Task Mining" e marque a linha Unlabeled Process. Clique em "Upload CSV logs", escolha o arquivo local criado e mapeie as colunas:
Time→Timestamp.Activity→Action.UserName→User Name.ComputerName→Computer Name.AppName→App Name.CaseId→Case ID.
Confirme a importação e aguarde os cinco eventos. O artigo Processos descreve as etapas de importação. Para verificar que nomes já associados são ignorados, primeiro adicione Оператор поддержки com o usuário qa.operator usando "Add employee" em "Employees".
Este botão cria um funcionário para cada nome de usuário exclusivo nos logs do projeto que ainda não está associado. Nomes já associados são ignorados e os funcionários e vínculos existentes são preservados. Pode ser executado novamente quando surgirem novos nomes.
Exemplo: qa.operator já pertence ao funcionário Оператор поддержки. O projeto recebe eventos de qa.operator e qa.reviewer. Ao clicar em "Pull users from logs", somente qa.reviewer é adicionado. O nome Оператор поддержки permanece. Uma segunda execução não cria duplicatas.

Aba Employees após adicionar usuários dos logs (interface em russo)
Botão "Add employee"#
A criação manual associa vários usuários a um nome de funcionário compreensível. É necessário preencher "Employee name", adicionar um ou mais Usernames from logs e clicar em "Add employee". Uma sugestão pode ser selecionada ou um nome novo confirmado com Enter.
Campos obrigatórios:
- Campo "Employee name" — define o nome exibido na análise.
Campos adicionais:
- Campo
Usernames from logs— associa o funcionário aos usuários dos eventos do projeto. Para analisar suas ações, é necessário adicionar os nomes correspondentes.
Exemplo: é informado Оператор поддержки e adicionado qa.operator. A imagem mostra os campos preenchidos antes de clicar em "Add employee". Esse botão salva o funcionário separadamente de "OK" na janela "Project".

Criação manual de um funcionário para qa.operator (interface em russo)
Controles de edição do funcionário#
O botão de edição
da linha abre os campos "Employee name" e Usernames from logs. O botão com uma marca de verificação
salva as alterações e o de exclusão
remove o registro do funcionário e suas associações com nomes de usuário.
A exclusão marca o registro do funcionário como excluído e remove definitivamente suas associações com nomes de usuário. A interface não oferece um comando para restaurar essas associações. Se necessário, adicione o funcionário e seus nomes de usuário novamente.
Exemplo: para o funcionário com o usuário operator, informe Оператор поддержки em "Employee name". Mantenha o usuário e deixe vazio o campo para adicionar outro nome. A alteração ainda não foi salva. "Save"
aplica o novo nome e "Cancel"
cancela a edição do registro.

Janela "Project", aba "Employees": edição do nome de um funcionário (interface em russo)
Em Gráfico e Esquema BPMN, o filtro "Employee" limita o resultado a uma pessoa. Filtros de dashboards podem usar {{employee_usernames}} e {{employee_username_filter}}.
5. Permissões de acesso#
As permissões controlam separadamente a consulta, criação, atualização e exclusão de projetos.
As permissões são configuradas na tela Papéis. Um administrador as configura. Se uma ação não estiver disponível, é necessário conferir "Read", "Create", "Update" e "Delete" de "Projects" em "Access" da janela "Role".
Exemplo: um administrador prepara o papel Просмотр Проектов e marca apenas "Read" para "Projects" em "Access". "Create", "Update" e "Delete" permanecem desmarcados. Essa configuração permite consultar projetos sem modificá-los.

Janela "Role", aba "Access": permissão "Read" para projetos (interface em russo)