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

...

Através de consumo de API disponibilizada pelo time de Framework (License Server Cloud) será possível identificar quais clientes utilizam o TSS para transmissão de documentos (em produção ou homologação). Os dados são computados conforme ocorrem transmissões de documentos no TSS do cliente, gerando registros de logs de uso, que com uma periodicidade, serão integrados através da API e disponibilizados na ferramenta LS Discovery.

Nesta etapa, somente será identificado o uso do produto, porem com esta ferramenta poderemos monitorar ou medir outros tipos de necessidades do produtos de forma estratégica, sem que dados pessoais ou sensíveis sejam obtidos.

O processo é executado em background no TSS, com o intuito de não influenciar ou ter impactos na rotina dos clientes.

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.

...

03. TELA XXXXX

Outras Ações / Ações relacionadas

...

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:

1. Registro de uso de requisições síncronas

A seguir é mostrado de forma resumida o fluxo adotado na rotina de registros de uso do produto em requisições síncronas realizadas pelo ERP.

Após a requisição chegar ao TSS e o TSS por sua vez realizar toda a operação da requisição, será realizada o registro de seu uso após seu processamento. Este registro ocorre apenas uma vez, ou seja, caso já haja um registro de uso para a entidade de processamento (independente do modelo de documento ou operação) as demais requisições (até este registro ser integrado) serão ignoradas, pois já temos o registro de uso do produto necessário.

Segue fluxo do sistema de registro de uso do TSS:

Image Added

2. Registro de uso de requisições assíncronas.

A seguir é mostrado de forma resumida o fluxo adotado na rotina de registros de uso do produto TSS em requisições assíncronas realizadas pelo ERP.

Após a requisição chegar ao TSS e o TSS por sua vez realizar todo o processamento da fila de transações (TSSTR1), conforme padrão, o sistema irá realizar a copia do registro da TSSTR1 para a tabela de histórico (TSSTR2). Neste momento entra o novo fluxo de registro de uso do produto TSS, que conforme modelo anterior, tal registro ocorre apenas uma vez, ou seja, caso já exista um registro de uso para a entidade de processamento (independente do modelo de documento ou operação) as demais requisições (até estes registros serem integrados) serão ignoradas, pois já temos o registro de uso do produto necessário.

Segue fluxo do sistema de registro de uso do TSS:

Image Added

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:

Image Added

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).

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

04. TELA XXXXX

Principais Campos e Parâmetros

...

...