[Progic] Log de integração da base de colaboradores

O Histórico de Operações de Colaboradores na Central de Adutoria reúne informações sobre as alterações realizadas na base de colaboradores por integrações, importações por planilha e ações manuais.

Com esse recurso, administradores podem acompanhar os resultados de cada operação, identificar sua origem e consultar quais informações foram alteradas. Isso facilita a auditoria da base e a investigação de problemas relacionados ao cadastro ou ao acesso de colaboradores.

Importante: o histórico registra as operações realizadas a partir da disponibilização do recurso. Alterações anteriores não são apresentadas retroativamente.

📑 Neste artigo

• O que é registrado no histórico
• Como interpretar os resultados
• Como consultar as alterações de um colaborador
• Como identificar a origem de uma alteração
• Como investigar inconsistências
• Perguntas frequentes

O que é registrado no histórico

O histórico registra alterações realizadas na base de colaboradores por diferentes origens:

• integrações via API;
• processamentos realizados em lote;
• importações por planilha;
• inclusões e alterações manuais realizadas na plataforma.

Cada operação gera um registro que permite acompanhar o processamento e os colaboradores envolvidos.

Nas alterações manuais, também é possível identificar o usuário responsável pela ação.

Como consultar uma operação

A página apresenta as operações realizadas na base de colaboradores. Cada registro indica a origem da operação e seus respectivos resultados.

Ao abrir uma operação, é possível consultar:

• os colaboradores processados;
• os colaboradores adicionados;
• os colaboradores atualizados;
• os registros que não tiveram alterações;
• os registros bloqueados ou excluídos, quando aplicável;
• as falhas identificadas durante o processamento;
• os campos modificados em cada cadastro.

Como interpretar os resultados

Os indicadores ajudam a entender o resultado de cada importação, integração ou ação manual.

Adicionados

Indica os colaboradores incluídos na base durante a operação.

Atualizados

Indica os colaboradores que já estavam cadastrados e tiveram alguma informação modificada.

Sem alteração

Indica os colaboradores processados cujas informações permaneceram iguais às que já estavam registradas na plataforma.

Bloqueados

Indica os colaboradores bloqueados durante a operação, quando aplicável.

Excluídos

Indica os colaboradores excluídos durante a operação, quando aplicável.

Falhas

Indica os registros que não puderam ser processados corretamente.

Como visualizar os campos alterados

Ao consultar os detalhes de um colaborador atualizado, o histórico apresenta os campos que sofreram alteração.

Para cada campo modificado, é possível comparar:

• o valor anterior;
• o novo valor registrado.

Essa comparação ajuda a identificar, por exemplo, quando houve alteração de e-mail, nome, sobrenome, cargo ou outra informação do cadastro.

Como consultar as alterações de um colaborador

Além da visão geral das operações, o histórico permite pesquisar um colaborador específico pelo nome ou pelo identificador.

A consulta individual reúne as operações que processaram aquele cadastro e permite acompanhar eventos como:

• inclusão do colaborador;
• alterações em seus dados;
• processamentos que não modificaram o cadastro;
• bloqueios ou exclusões, quando aplicável;
• falhas relacionadas ao registro.

Com essa consulta, é possível entender como o cadastro foi atualizado ao longo do tempo e em qual operação ocorreu determinada mudança.

Importante: são apresentadas somente as operações registradas após a disponibilização do Histórico de Operações de Colaboradores.

Como identificar a origem de uma alteração

Cada registro informa como a operação foi realizada. A origem pode indicar, por exemplo:

• API;
• processamento em lote;
• importação por planilha;
• alteração manual.

Nas alterações manuais, o histórico também pode apresentar o usuário que realizou a ação.

Essa informação ajuda a determinar se uma mudança foi feita diretamente na plataforma ou se veio de uma integração ou importação.

Como investigar inconsistências

O histórico pode ser utilizado para investigar situações em que os dados de um colaborador não correspondem ao esperado.

Exemplo: colaborador não consegue acessar a plataforma

Consulte o histórico individual do colaborador para verificar:

1. Se o cadastro foi incluído ou atualizado;
2. Qual operação processou o colaborador;
3. Se houve alguma falha;
4. Quais campos foram modificados;
5. Se a alteração teve origem manual, por planilha ou por integração;
6. Qual usuário realizou a ação, caso a alteração tenha sido manual.

Essas informações ajudam a identificar o que aconteceu com o cadastro antes de acionar outras equipes para a investigação.

Exemplo: informação alterada após uma integração

Abra a operação correspondente e consulte os campos modificados no cadastro. Compare o valor anterior com o novo valor para entender qual informação foi atualizada.

Se um campo precisa ser mantido manualmente e não deve ser substituído por futuras integrações ou importações, utilize a proteção de campos do cadastro.

Todos os Campos tem a Opção de Proteger

Perguntas frequentes

O histórico apresenta alterações antigas?

Não. De acordo com a demonstração do recurso, o histórico registra as operações realizadas a partir de sua disponibilização. As alterações anteriores não são recuperadas retroativamente.

Quais operações aparecem no histórico?

O histórico contempla operações realizadas via API, processamentos em lote, importações por planilha e ações manuais.

Posso consultar o histórico de apenas um colaborador?

Sim. É possível pesquisar pelo nome ou pelo identificador do colaborador para consultar as operações relacionadas ao seu cadastro.

É possível saber exatamente o que foi alterado?

Sim. Nos registros de atualização, o histórico apresenta os campos modificados e permite comparar o valor anterior com o novo valor.

É possível identificar quem realizou uma alteração manual?

Sim. As alterações manuais apresentam o usuário responsável pela ação.

Operações sem mudanças também aparecem?

Sim. O histórico pode indicar que um colaborador foi processado em uma operação, mesmo quando nenhuma informação de seu cadastro foi modificada.

✅ Boas práticas

• Consulte os indicadores gerais após realizar uma importação ou integração;
• Verifique os detalhes sempre que uma operação apresentar falhas;
• Use o histórico individual para investigar problemas relacionados a um colaborador específico;
• Compare os valores anteriores e novos antes de corrigir manualmente um cadastro;
• Identifique a origem da alteração para evitar que uma correção manual seja novamente substituída por uma integração;
• Utilize a proteção de campos quando uma informação precisar ser mantida manualmente.