Entre as principais atualiza\u00e7\u00f5es podemos destacar:<\/p>\n\n\n\n
- \n
- Disponibilidade para vers\u00e3o 12.1.2210<\/li>\n\n\n\n
- Implementa\u00e7\u00e3o do uso dos campos I_N_S_D_T_ e S_T_A_M_P_ para o controle incremental (em substitui\u00e7\u00e3o aos campos LGI e LGA)<\/li>\n\n\n\n
- Evolu\u00e7\u00e3o continua da finAPI<\/li>\n<\/ul>\n\n\n\n
Nova Vers\u00e3o PROTHEUS 12.1.2210<\/h2>\n\n\n\n
A atual vers\u00e3o 12.1.33 tem data de expira\u00e7\u00e3o em 30\/06\/23, sendo que a partir de ent\u00e3o a vers\u00e3o ativa e com manuten\u00e7\u00e3o gratuita ser\u00e1 a vers\u00e3o 12.1.2210. <\/p>\n\n\n\n
Confira aqui<\/a> o CICLO DE VIDA das vers\u00e3o do ERP TOTVS PROTHEUS.<\/p>\n\n\n\n
![\"API](\"https:\/\/www.intergate.net.br\/blog\/wp-content\/uploads\/2023\/06\/image-1024x341.png\")
<\/figure>\n\n\n\nPara clientes atuais e futuros clientes, informamos que a API PROTHEUS by INTERGATE j\u00e1 est\u00e1 dispon\u00edvel e funcional para a vers\u00e3o 12.1.2210. Entre em contato e solicite seu pacote de atualiza\u00e7\u00e3o.<\/p>\n\n\n\n
Campos I_N_S_D_T_ e S_T_A_M_P_<\/h2>\n\n\n\n
Um dos recursos mais utilizados na API ConectorGate<\/a> \u00e9 o recurso de Consulta Incremental<\/strong>, utilizando o QueryParam “updatedAt”. A Consulta Incremental permite consultar\/filtrar no ERP TOTVS PROTHEUS<\/a> apenas registros criados ou alterados ap\u00f3s determinada data.<\/p>\n\n\n\n
At\u00e9 ent\u00e3o nossa API utilizava os Campos Reservados LGI LGA para o recurso de Consulta Incremental. Este recurso, al\u00e9m de n\u00e3o permitir o uso de hora no filtro de consulta, acabou apresentando ISSUE TOTVS no final de maio\/2023.<\/p>\n\n\n\n
Afim de termos menos incertezas com os campos LGI e LGA e uma melhor gest\u00e3o de inclus\u00f5es e altera\u00e7\u00f5es de registros no ERP TOTVS PROTHEUS, que afetam as consultas incrementais na API ConectorGate, optamos por migrar a solu\u00e7\u00e3o para uso dos campos I_N_S_D_T_ e S_T_A_M_P_<\/strong>.<\/p>\n\n\n\n
Estes 2 campos s\u00e3o gerenciados diretamente pelo DBAccess, e registram um datetime e\/ou timestamp para cada registro inserido e\/ou alterado na base de dados. Veja aqui a documenta\u00e7\u00e3o TOTVS.<\/p>\n\n\n\n
A ativa\u00e7\u00e3o para a cria\u00e7\u00e3o destes 2 campos \u00e9 pelo dbaccess.ini, e a cria\u00e7\u00e3o ocorre quando a tabela desejada \u00e9 aberta pelo PROTHEUS. Recomenda-se realizar esta opera\u00e7\u00e3o em modo exclusivo.<\/p>\n\n\n\n
- \n
- Segundo a TOTVS, a recomenda\u00e7\u00e3o para tabelas que j\u00e1 possuam dados \u00e9 a de realizar a recria\u00e7\u00e3o da tabela, o que vai envolver: realizar backup, drop table, recriar a tabela e realizar append do backup realizado. <\/li>\n\n\n\n
- H\u00e1 ainda a possibilidade de cria\u00e7\u00e3o dos 2 campos via ADVPL, e o uso da function TCConfig().<\/li>\n<\/ul>\n\n\n\n
A API ConectorGate conta com request que realiza a cria\u00e7\u00e3o dos 2 campos via ADVPL. Basta realizar um GET {{endpoint}}\/apiTimestamp?table={{table}}. <\/p>\n\n\n\n
![\"\"](\"https:\/\/www.intergate.net.br\/blog\/wp-content\/uploads\/2023\/06\/image-2-1024x544.png\")
<\/figure>\n\n\n\nCom o uso destes campos, a API ConectorGate agora tem a capacidade de usar hora al\u00e9m de data nas consultas incrementais. <\/strong>Al\u00e9m disso, os campos “createdAt” e “updatedAt” agora exibir\u00e3o data e hora, ao inv\u00e9s de apenas data como ocorria na vers\u00e3o anterior.<\/p>\n\n\n\n
![\"\"](\"https:\/\/www.intergate.net.br\/blog\/wp-content\/uploads\/2023\/06\/image-1-1024x544.png\")
<\/figure>\n\n\n\nCampos Reservados LGI e LGA<\/h2>\n\n\n\n
Desde o lan\u00e7amento do ERP TOTVS PROTHEUS ainda como MICROSIGA, uma das op\u00e7\u00f5es para o controle de inclus\u00f5es e altera\u00e7\u00f5es em registros do ERP eram os campos reservados LGI e LGA. Estes campos de 17 caracteres eram habilitados pelo Configurador\/SIGACFG, e eram gravados utilizando caracteres ASCII para representar o usu\u00e1rio e a data de inclus\u00e3o ou altera\u00e7\u00e3o de determinado registro. <\/p>\n\n\n\n
Uma das principais limita\u00e7\u00f5es destes campos reservados em rela\u00e7\u00e3o \u00e0 auditoria \u00e9 que eles n\u00e3o registravam o hor\u00e1rio, apenas a data de inclus\u00e3o ou altera\u00e7\u00e3o.<\/p>\n\n\n\n
Como recursos padr\u00e3o para os campos reservados LGI e LGA a TOTVS disponibilizava:<\/p>\n\n\n\n
- \n
- Rotina “Log de Registros” – CFGX025: rotina acessada pelo Configurador\/SIGACFG e que permitia selecionar a tabela que continha os campos reservados LGI e LGA e visualizar os dados descriptografados de usu\u00e1rio e dada de inclus\u00e3o e altera\u00e7\u00e3o<\/li>\n\n\n\n
- Function FWLeUserlg: function dispon\u00edvel em ADVPL que permitia descriptografar o conte\u00fado dos campos LGI e LGA em customiza\u00e7\u00f5es<\/li>\n<\/ul>\n\n\n\n