Histórico da Página

...

O que é TSI?

• É o novo serviço de integração do SIGATAF com o ERP-Protheus.
• O TAF Service Integration ( TSI ) foi criado exclusivamente para clientes que usam o TAF como módulo do ERP-Protheus, ou seja, ambos no mesmo banco de dados.

Pré Requisitos

• 1. Requer um banco de dados homologado.
• 2. Requer um TOTVS Application Server build 7.00.170117A com geração superior a 23/09/2019.
• 3. Requer um TOTVS DbAccess  igual ou superior a 19/11/2019
• 4. Executar o UpdDistr ( sdfbra.txt referente ao pacote acumulado do SIGATAF ).
• 5. Aplicar a patch com os fontes atualizados do acmulado ( .ptm da expedição contínua ).

Banco de Dados Homologados

• A integração com TSI depende do novo campo S_T_A_M_P_ e sua criação está disponível para os Banco de Dados MSSQL, ORACLE e  POSTGRES.

O que é stamp?

• Um campo interno para tabelas do DBAccess, não visíveis na estrutura de acesso pelo AdvPL, que registre um datetime e/ou timestamp para cada registro inserido e/ou alterado na base de dados.
• O tipo do campo criado na tabela é DATETIME (para MSSQL) e TIMESTAMP (para Postgres e Oracle)
• Para recuperar o campo de controle S_T_A_M_P_ com a informação completa ( data e horário ), por exemplo no formato yyyy-mm-dd hh:MM:ss.mmm,
  deve ser feito um CAST, confira mais sobre stamp na documentação do DbAccess: Implementação - Campo de controle adicional no DBAccess - S_T_A_M_P_

Exemplo de STAMP em uma tabela no TAF:

Image Removed

Exemplo de STAMP em uma tabela do ERP:
Image Removed

Configuração

Dicionário

• Já foi incorporado no segregado e agora está disponível no portal através do pacote acumulado 21/01/2022.
• No dicionário constam os campos stamp nas tabelas do TAF, a criação da tabela de log V5R ( logs ) e V80 ( data e hora de corte ), conforme:
  

...

O que é TSI?

• É o novo serviço de integração do SIGATAF com o ERP-Protheus.
• O TAF Service Integration ( TSI ) foi criado exclusivamente para clientes que usam o TAF como módulo do ERP-Protheus, ou seja, ambos no mesmo banco de dados.

Pré Requisitos

• 1. Requer um banco de dados homologado.
• 2. Requer um TOTVS Application Server build 7.00.170117A com geração superior a 23/09/2019.
• 3. Requer um TOTVS DbAccess  igual ou superior a 19/11/2019
• 4. Executar o UpdDistr ( sdfbra.txt referente ao pacote acumulado do SIGATAF ).
• 5. Aplicar a patch com os fontes atualizados do acumulado ( .ptm da expedição contínua ).

Banco de Dados Homologados

• A integração com TSI depende do novo campo S_T_A_M_P_ e sua criação está disponível para os Banco de Dados MSSQL, ORACLE e  POSTGRES.

O que é stamp?

• Um campo interno para tabelas do DBAccess, não visíveis na estrutura de acesso pelo AdvPL, que registra um datetime e/ou timestamp para cada registro inserido e/ou alterado na base de dados.
• O tipo do campo criado na tabela é DATETIME (para MSSQL) e TIMESTAMP (para Postgres e Oracle).
• Para recuperar o campo de controle S_T_A_M_P_ com a informação completa ( data e horário ), por exemplo no formato yyyy-mm-dd hh:MM:ss.mmm,
  deve ser feito um CAST. Confira mais sobre stamp na documentação do DbAccess: Implementação - Campo de controle adicional no DBAccess - S_T_A_M_P_

Exemplo de STAMP em uma tabela no TAF:

Image Added

Exemplo de STAMP em uma tabela do ERP:
Image Added

Exemplo de query em MSSQL realizando o cast para converter o campo em string:

Select cast( to_char(SA1.S_T_A_M_P_,'DD.MM.YYYY HH24:MI:SS.FF') AS VARCHAR2(23) ) From SA1T10

Configuração

Dicionário

• Já foi incorporado no segregado e agora está disponível no portal através do pacote acumulado 21/01/2022.
• No dicionário constam os campos stamp nas tabelas do TAF, a criação da tabela de log V5R ( logs ) e V80 ( data e hora de corte ), conforme:
  
  
• Campos C/ STAMPS

• V80

• V5R

V80:

V5R:

Wizard Configuração TAF

...

Wizard Configuração TAF

• Para que a opção do "TSI - TAF SERVICE INTEGRATION" seja exibida no Wizard do TAF, é necessário ter executado os pré-requisitos e que exista ao menos uma nota escriturada no fiscal ( SF3/SFT ).
• A wizard de configuração do TAF ganhou uma nova opção para criação dos campos S_T_A_M_P_, basta executar marcando a nova opção, [X] TSI - TAF Integration Service
  
  

Image Added

Execute a wizard, resultando em sucesso, será apresentada a tela com a mensagem conforme abaixo.

Image Added

Tabelas Afetadas ( Criação STAMP )

• As tabelas do Protheus que sofrerão a criação do campo S_T_A_M_P_ são:
  SB1, SFT, SF4, SB5, SA1, SA2, SA4, SAH, CT1, F2Q, CDN, SE1, SE2, CCF, SF1, SF2, SF3, CCE, SYD, CDH, SON e CKX.
  Obs: Em breve a CDT e CDG serão disponibilizadas com S_T_A_M_P_.
  

...

...

Image Removed

Execute a wizard, resultando em sucesso, será apresentada a tela com a mensagem conforme abaixo.

Image Removed

Tabelas Afetadas Criação STAMP

...

...

...

Schedule Configurador

• O TSI deverá ser incluído no agendamento ( schedule do SIGACFG ) como um serviço ( job ) sempre ativo.
  Desta maneira, ao incluir ou alterar um novo cadastro ou movimento no ERP, o JOB se encarregará de executar a integração automaticamente de forma transparente ao usuário.
  O controle é feito através da comparação dos campos do ERP-Protheus S_T_A_M_P_  Vs  XXX_STAMP do TAF.
  Exemplo de configuração:

...

• Através desta rotina é possível  visualizar o detalhamento das mensagens de integração que apontaram falhas no processamento ( tabela V5R ) e não foram integradas ao TAF. tabela V5R ) e não foram integradas ao TAF. 

Browse com Log
Image Added

Detalhamento dos Erros

Image Added

Menu Filtro Data de Corte

• Através desta rotina é possível  visualizar o último processamento por layout, a tabela V80 foi criada para melhorar o desempenho do filtro, referente ao registros que ainda não foram processados.

Browse com LogImage RemovedDetalhamento dos Erros
Image Removed

Menu Filtro Data de Corte

...

Image Added

Como identificar erros

Quando acionar o TAFCONOUT para verificar possíveis falhas

...

• Consultar o console para verificar se o serviço está em execução ou se ocorreu alguma falha.
• Pode ser verificado na tabela V5R, através da chave do registro (  TAFA564 - Cadastro de Log de integração ).
• Consulte a aba "Erros de Integraçãode Integração" na documentação TSI - TAF Service Integration, para maiores informações sobre as mensagens de erros e suas possíveis soluções
• Consulte a aba "Análise Técnica" na documentação TSI - TAF Service Integration, para maiores informações sobre as mensagens de erros e suas possíveis soluções.Pode ser verificado na tabela V5R, através da chave do registro (  TAFA564 - Cadastro de Log de integração )..

Image Added

Image Added

Image Added

Estrutura de Log na V5R

• Os erros são aglutinados e gravados em uma única linha na V5R (por chave do cadastro) por registro, substituindo o erro anterior caso exista.
• A filial é gravada no campo V5R_CODFIL e não na V5R_REGCHAVE.
• Caso seja realizado o ajuste

...

• no registro e o mesmo seja integrado no TAF, o log é apagado na sequência.
  
  

...

• Por tipo de dados, ex: data, numérico, lógico ou caractere (FWNOSTRUCT);
• Obrigatório (OBRIGAT);
• Se código existe na consulta padrão F3 (NOTFOUND);
• Se o tamanho é excedido (FWNOWIDTH);
• Se o conteúdo consta no combox (FWNOLIST);
• Se o registro existe na origem (NOTEXIST);
• Se o conteúdo pode ser editado (FWWHEN);
• Regra de modelo específico, exemplo: Se a nota necessita de item (TAFHLPNF017);
• Se o commit do modelo é válido e não estoura o uniqline (UNIQUELINE);
• Se o formato de data é válido (DATE);
• Se é válido apagar uma chave estrangeira (FWFORMCANCEL);
• Se houve falha na atribuição de conteúdo (LOADVALUE)

...

Quais tabelas são utilizadas

Índice do Banco de Dados Sugeridos ( Performance )

...

CREATE NONCLUSTERED INDEX SFTT10ESP ON SFTT10(FT_FILIAL, [FT_NFISCAL] ,[FT_SERIE], [FT_CLIEFOR], [FT_LOJA],[FT_IDENTF3], [FT_ENTRADA],[FT_ESPECIE],[FT_PRODUTO], R_E_C_N_O_, D_E_L_E_T_)

...

...