Importação de usuário não ocorrendo devido a filtro no SELECT
|
Cliente |
Berlanda |
|
Processo impactado |
Importação de usuários |
|
Usuário analisado |
Matrícula/numcad 16406 |
|
Ponto de análise |
Filtro de filial no SELECT de importação |
|
Filial identificada |
CODFIL 266 |
|
Status |
Ajuste aplicado e cadastro integrado com sucesso |
|
Resumo do caso Durante a análise de integração, foi identificado que o usuário informado no chamado não era retornado pela query de importação. Após validações, constatou-se que o colaborador estava vinculado à filial 266, porém esse código não constava na lista de filiais permitidas no filtro CODFIL do SELECT. |
O cliente possui uma query utilizada no processo de importação de usuários, consultando a view vw_joinin_funcionario. A consulta contém filtros responsáveis por definir quais colaboradores devem ser considerados para integração, incluindo situação do colaborador, tipo de colaborador, dados de eSocial e lista de filiais permitidas.
No chamado analisado, foi informado que o usuário de matrícula/numcad 16406 não estava sendo integrado. Ao executar a consulta com os filtros vigentes, o cadastro não era retornado.
2. Comportamento observado
- A query de importação foi executada considerando o usuário informado no chamado.
- Mesmo com o filtro específico de numcad = 16406, a consulta não retornava resultado.
- O usuário existia na base, porém não passava por todos os filtros aplicados no SELECT.
- A principal divergência encontrada estava relacionada ao filtro de filial, campo fun.codfil.
3. Trecho relevante da query
Abaixo estão os principais filtros que impactavam o retorno do usuário:
4. Análise realizada
- Foi realizada a validação da query original utilizada na importação do cliente.
- Ao consultar com todos os filtros, o usuário não era apresentado no resultado.
- Em seguida, foi feita uma validação isolando o filtro de filial para entender se o cadastro existia na base.
- Foi identificado que o usuário estava vinculado à filial 266.
- A filial 266 não estava presente na lista do filtro fun.codfil IN (...).
- Após validação no cadastro do cliente, foi confirmado que a filial 266 já estava configurada no ambiente.
5. Evidência da filial configurada
A imagem abaixo demonstra a filial 266 já cadastrada/configurada no ambiente do cliente:
6. Causa identificada
|
Causa raiz O usuário não era integrado porque a filial 266 não estava incluída no filtro de filiais permitido pela query de importação. Dessa forma, mesmo o cadastro existindo na base e a filial estando configurada no sistema, o SELECT impedia o retorno do usuário. |
7. Ajuste aplicado
Foi incluído o código 266 na lista de filiais do filtro fun.codfil IN (...).
8. Resultado
- Após a inclusão do código 266 no SELECT, o cadastro passou a ser retornado na consulta.
- A importação do usuário foi processada corretamente.
- O cadastro foi integrado com sucesso após o ajuste.
9. Recomendações
- Sempre que uma nova filial for criada ou habilitada para integração, validar se o código também consta na query de importação.
- Em casos de usuário não integrado, validar se o cadastro aparece na view sem o filtro de CODFIL.
- Comparar as filiais configuradas no sistema com a lista mantida no SELECT.
- Avaliar, se possível, uma forma de evitar lista fixa de filiais na query, utilizando uma regra dinâmica baseada nas filiais ativas/configuradas.
- Manter registro das alterações realizadas no SELECT para facilitar futuras auditorias e análises.
10. Checklist de validação para casos semelhantes
|
Etapa |
Validação |
|
1 |
Confirmar se o usuário existe na view vw_joinin_funcionario. |
|
2 |
Validar se o colaborador não está bloqueado pelo filtro de situação fun.sitafa <> 7. |
|
3 |
Verificar se o tipo de colaborador atende à regra de tipcol/fun_mateso. |
|
4 |
Consultar qual é o fun.codfil vinculado ao usuário. |
|
5 |
Conferir se o CODFIL está presente no filtro da query de importação. |
|
6 |
Confirmar se a filial está cadastrada/configurada no ambiente. |
|
7 |
Aplicar ajuste na query, se necessário. |
|
8 |
Executar novamente a importação e validar o cadastro integrado. |