Histórico da Página

CONTEÚDO

1. Visão Geral
2. Exemplo Registro de utilização
3. Tela XXX
   1. Outras Ações / Ações relacionadas
      
4. Tela XXX
   1. Principais Campos e Parâmetros
      
5. uso do TSS
6. Processamento Telemetria de uso TSS
   
7. Configurações Internas
8. Tabelas utilizadas

01. VISÃO GERAL

Âncora
visao visao

...

Abaixo serão detalhados os fluxos desta nova ferramenta e suas possíveis configurações (que não deverão ser informadas aos clientes) sendo uteis apenas para controle e uso interno.

02. REGISTRO DE USO DO TSS

Âncora
uso uso

Aqui serão destacados o fluxograma da rotina de telemetria de uso do TSS que foram separados em 3 fluxos:

...

Segue fluxo do sistema de registro de uso do TSS:

03. PROCESSAMENTO TELEMETRIA DE USO TSS

Âncora
processamento processamento

Aqui será destacado o fluxo adotado pelo sistema para a realização da integração de telemetria dos registros de uso do TSS. 

O processo se inicia com o JOB TSSTASKPROC, que é o responsável por executar as tarefas presentes na tabela TSS0010, dentre elas a tarefa de ID 011 - TSSProcTLM:

Image Added

A função TSSProcTLM é a função principal do processamento de telemetrias do TSS. Sendo executada conforme periodicidade configurada na tabela TSS0010 no campo SLEEP, irá internamente validar o parâmetro MV_TSSTLM que possui a data do ultimo processamento da telemetria, ou seja, de acordo com esse parâmetro será determinado se passaram-se os dias necessários para a próxima execução. Por padrão, são esperados 15 dias para o próximo processamento. Desta forma mesmo o processo sendo executado com uma periodicidade de 3600 segundos (1 hora), somente é realizado o processamento dos registros de telemetria após o período de 15 dias. Mais adiante serão destacados as possíveis configurações de controle de tempo de processamento e logs da telemetria (que não deverão ser informadas aos clientes).

Caso tenham passado 15 dias do ultimo processamento, o sistema irá iniciar o processo de integração com a API dos registros presentes na base (tabela TSS0016) do cliente, onde primeiro será realizada seleção destes registros (query). Para cada registro selecionado, o sistema irá realizar a seguinte sequencia:

Token de autenticação da API: Para consumo da API, é necessário autenticação em JWT, com campos de credenciais (client_id e client_secret) que foram informados pelo time de framework e estão presentes nos fontes.  O token retornado pela API será utilizado para as demais requisições com um prazo de 15 min para troca.

TCODE e TENANTID: Com o CNPJ/CFP da entidade posicionada, consumimos a API que retorna o TCODE do cliente, que será necessário para se obter o TENANTID do cliente. Este por sua vez será utilizado na integração como o identificador do cliente no LS Discovery.

Após obter o TenantId do cliente, a rotina irá processar os dados do registro de log e adiciona-lo ao arquivo Json de integração. Apos adiciona-lo o registro será adicionado a um array de controle de registros a se deletar. Este processo se repete até que chegue ao limite máximo de registros definido para arquivo Json ou acabe os registros da tabela.

Com o arquivo json carregado, será realizado a integração com a API de LOGS do framework e apagados os registros adicionados no array, desta forma limpando a tabela TSS0016 dos registros já integrados.

Após integrar todos os registros da tabela o sistema grava no parâmetro MV_TSSTLM com a data atual.

O fluxograma ficou assim:

04. CONFIGURAÇÕES INTERNAS

Âncora
config config

Aqui serão detalhadas as configurações existente para manipulações de alguns fatores da rotina de telemetria. Este parâmetros não deverão ser externados aos clientes. Seu uso é apenas em situações de urgência ou necessidades do time de desenvolvimento, podendo ser alterados ou até excluídos sem aviso prévio.

Para configura os parâmetro da rotina de Telemetria, basta criar a sessão TSSTLM no appserver.ini do TSS onde é executado o JOB TSSTASKPROC. As possíveis manipulações são:

TLM_DIAS:  Quantidade de dias de intervalo entre os processamentos dos registros de telemetria (TSS0016).

...

Principais Campos e Parâmetros

...

TLM_HRINI: Hora inicial de processamento dos registros de telemetria (TSS0016), formato HH:MM:SS. Aqui é possível manipular a data de inicio de processamento da telemetria, visando que este processo seja realizada em melhor momento para o cliente.

TLM_OFF: Código da(s) entidade(s) separadas por virgula (,) que não terão o processamento da telemetria executada. Neste caso os registros de uso continuaram na tabela, ate que se habilite seu processamento. Indicado para testes ou necessidades pontuais.  Caso informado o numero '1' o processo será desligado para todas as entidades.

TLM_ON: Código da(s) entidade(s) separadas por virgula (,) que terão seu processamento de telemetria executada. Esta configuração sobressai à configuração do TLM_OFF, onde caso seja informada as duas TAGs, será mantida a configuração do TLM_ON. Exemplo: 

[TSSTLM]
TLM_OFF=00001
TLM_ON=000001

Neste exemplo o processo de telemetria será executado para a entidade 000001 normalmente.

Exemplo de configuração com seus valores padrões (informados nos fontes)

[TSSTLM]
TLM_DIAS=15
TLM_HRINI=01:00:00
TLM_OFF=00001
TLM_ON=000001

05. TABELAS UTILIZADAS

Âncora
tabelas tabelas

• TSS0010 - Tabela de agendamentos/tarefas do TSS
• TSS0016 - Tabela de Telemetrias do TSS