Tempo aproximado para leitura: 00:03:00 min
Dúvida
Como filtrar os dados que serão enviados para Plataforma Carol?
Ambiente
TOTVS CAROL - Carol Connect (2C) - Todas as versões
Solução
Na Carol Connect (2C) é possível realizar filtros nos dados que deseja enviar para Plataforma Carol, por exemplo, supondo que use o App do Clock In e talvez não faça sentido enviar os dados dos seus demitidos, dessa forma você consegue construir filtros diretamente na configuração das tabelas (entities).
Para construir esses filtros acesse o Database Manager da Carol Connect (2C) e clique em Configure na conexão que deseja:
Observação: Caso tenha dúvidas em como acessar seu ambiente da Carol Connect (2C), verifique o acesso com a equipe que realizou a implantação ou, em caso de clientes TOTVS CLOUD, abra um Ticket diretamente ao Suporte CLOUD para verificar esses acessos, para mais informações do endereço de acesso verifique o artigo TOTVS CAROL - Carol Connect (2C) - É possível alterar a porta ou endereço de acesso da Carol Connect (2C)?
Dentro do Configure será exibido uma lista das tabelas (entities), clique sobre a que deseja realizar o filtro, você precisará desabilitá-la para conseguir ajustar o filtro.
No campo Condition for initialization você pode definir o filtro da forma que desejar seguindo o padrão SQL ANSI.
No exemplo abaixo, ao selecionar a tabela SRAT20, aparecem 124 registros. Quero filtrar apenas os com data de demissão "em branco". Fiz um filtro para o campo RA_DEMISSA igual a "em branco" e, ao realizar o Test Conditional (teste condicional), ele indica que 94 registros atendem a essa condição.
Você pode verificar o filtro com a mesma query no seu banco de dados e checar o total de registros. Se estiver tudo certo, clique em Apply e depois em Enable para sincronizar os dados.
Importante: Ao clicar em Enable, a tabela será ativada e o envio de dados será iniciado. Se o filtro não for aplicado antes, o processo não poderá ser revertido automaticamente. Nesse caso, será necessário um saneamento na Plataforma Carol para excluir esses registros, em seguida no Carol Connect aplicar o filtro correto e reenviar os dados. Para garantir que tudo seja feito corretamente, recomendamos que esse processo seja acompanhado pelo time de Suporte da Plataforma Carol, podendo envolver um serviço adicional de consultoria paga, se necessário.
Filtro no SQL Server Manegement:
Exemplo de filtro no Carol Connect (2C):
Exemplo prático de como adicionar/editar um filtro na Carol Connect (2C) na tabela desejada:
Filtro no SQL Server Manegement:
Importante: O Carol Connect (2C) não remove dados que já estão na Plataforma Carol. Isso significa que, se dados sem filtro já foram sincronizados, será preciso "tratar/apagar" esses dados diretamente na Plataforma Carol.
Sobre os filtros, é importante que você estude as condições configuradas para garantir que elas atendam às suas necessidades tanto na primeira carga de dados quanto no uso diário da ferramenta. Por exemplo: se for necessário desconsiderar os demitidos, é preciso verificar que muitas vezes no ERP já existe o campo de data de demissão preenchido. No entanto, não recomendamos suspender o acesso do funcionário imediatamente, então é essencial considerar isso de alguma forma no filtro.
Seguem alguns exemplos de Condition for initialization (filtros):
Filtrar e enviar os registros de só uma coligada da tabela do RM, nesse caso, a junção do envio de coligadas para a plataforma é feito pela tabela GFILIAL e PSECAO:
--GFILIAL
CODCOLIGADA = 1
--PSECAO
CODCOLIGADA = 1
Filtrar e enviar os registros da tabela PFUNC do RM que estejam com o CODSITUACAO diferente de D ou que a DATADEMISSAO esteja entre 60 dias maior ou menor que a data atual e que esteja vinculado ao CODCOLIGADA 2 ou 3:
--PFUNC
(CODSITUACAO <> 'D' OR DATADEMISSAO BETWEEN GETDATE()-60 AND GETDATE()+60)
AND CODCOLIGADA IN ('2','3')
Exemplo de filtro na tabela PFUNC do RM para o banco de dados Oracle:
(CODSITUACAO <> 'D' OR DATADEMISSAO BETWEEN SYSDATE - 60 AND SYSDATE + 60)
Filtrar e enviar os registros da tabela SRA do PROTHEUS que estejam com o ra_sitfolh diferente de D ou que o campo RA_DEMISSA esteja entre 60 dias maior ou menor que a data atual e que esteja vinculado ao RA_FILIAL 'L MG 01' ou 'L MG 02':
--SRA
(RA_SITFOLH <> 'D' OR RA_DEMISSA BETWEEN GETDATE()-60 AND GETDATE()+60) AND RA_FILIAL IN ('L MG 01','L MG 02')
Exemplos de filtros na tabela SRA do Protheus para o banco de dados Oracle:
Exemplo 1
(RA_SITFOLH <> 'D' OR RA_DEMISSA BETWEEN TO_CHAR(SYSDATE, 'YYYYMMDD') - 60 AND TO_CHAR(SYSDATE, 'YYYYMMDD') + 60 )
Exemplo 2
(RA_SITFOLH <> 'D' OR RA_DEMISSA BETWEEN TO_CHAR(SYSDATE-30, 'YYYYMMDD') AND TO_CHAR(SYSDATE+30,'YYYYMMDD'))
Exemplo de Filtro na tabela SRA do Protheus para banco de dados PostgreSQL:
--SRA
(RA_SITFOLH <> 'D' or cast (RA_DEMISSA as date) between current_date - interval '60days' and current_date + interval '60days')
Filtrar e enviar os registros da tabela FUNCIONARIO do DATASUL que estejam ativos ou que a data de desligamento seja superior a um dia específico:
--FUNCIONARIO
dat_desligto_func>='2024-01-01' or dat_desligto_func is NULL
IMPORTANTE: Os filtros acima são apenas exemplos, deve ser considerado a necessidade de cada empresa para implementar os filtros de acordo com a sintaxe do banco de dados utilizado.
Saiba Mais
CLIQUE AQUI para acessar mais artigos e FAQs sobre a TOTVS Carol
CLIQUE AQUI para acessar a documentação técnica da TOTVS Carol no TDN
CLIQUE AQUI para acessar a documentação técnica da TOTVS Carol do LABS
6 Comentários