01. INTRODUÇÃO

A abertura de relatórios TReports no menu do Protheus acontece seguindo as instruções desta documentação TReports - Protheus como consumidor de relatórios.

Os relatórios do TReports podem ser adicionados no menu, independentemente da fonte de dados usada na sua construção. Considerando essa possibilidade de fontes distintas como, diretamente um banco de dados ou uma outra aplicação como provedor integrado, a situação para avaliar ou aplicar o abono é complicada pois somente é possível quando a fonte de dados é o próprio ambiente abrindo o relatório a partir do menu do Protheus.

Com a evolução do TWebEngine para permitir o download de arquivos e a mudança para priorizar a abertura do relatório com este navegador internamente no Protheus (TReports - Visualização de relatório a partir do menu no Protheus), tornou-se possível realizar o abono das licenças do Rest Protheus quando o ambiente que for a fonte de dados para o relatório for o mesmo ambiente do Protheus, mais detalhes são apresentados nos tópicos a seguir.

Antes de seguir para os próximos tópicos, é preciso estabelecer a convenção sobre alguns termos:

1. consumo de licença - é o ato de verificar no Totvs License Server se há licenças disponíveis para o produto em uso, quando há uma LICENÇA É MARCADA COMO EM USO.
2. abono de licença - é o ato de consumo de licença com a prioridade para não ocupar uma licença nova e sim, aplicar um abono em função de uma outra licença que AINDA ESTÁ EM USO.

Quando não existe licença disponível ou não foi possível aplicar e não há licença disponível, o processo de consumo de licença falha e a execução da funcionalidade no produto pedindo a licença é cancelada. Um exemplo para a situação de falha é configurar para subir 10 threads de processamento no REST Protheus tendo somente 6 licenças, 4 das 10 threads indicadas irão falhar o consumo de licenças e não serão preparadas. 

02. COMO ACONTECE O CONSUMO DAS LICENÇAS COM PROTHEUS E TREPORTS

Os momentos de avaliação para o consumo de licenças são:

1. Protheus Menu - no acesso a um programa no menu do Protheus neste caso, ao acionar um programa de menu que exibirá um relatório TReports;
2. Rest Protheus - por padrão ao preparar as threads de resposta do REST, é possível configurar o modo de consumo das licenças por demanda veja a documentação de assuntos relacionados;
3. TReports - no momento da geração de relatório.

O tipo da licença consumida varia conforme o contrato e produtos envolvidos, portanto não será um tópico a ser abordado neste artigo.

Com o demonstrado acima uma execução sem qualquer aplicação de abono exigiria o consumo de 3 licenças para uma execução adequada.

Desde a liberação da abertura de relatórios TReports a partir do menu do Protheus, o pedido de execução do relatório no TReports vai com o comando para tentar abono considerando o uso da licença no menu do Protheus, portanto o que acontecia era: (1) o consumo da licença no Protheus Menu e (2) o abono da licença na geração do relatório no TReports.

Em um cenário onde o ambiente do Protheus usado no menu é o mesmo que os dados serão recuperados para o relatório, exige o consumo de uma terceira licença que é para o serviço Rest. Este cenário é para o qual esta funcionalidade foi desenvolvida, pois antes dela não era possível gerar relatórios TReports a partir do menu do Protheus tendo abono na licença do Rest.

No tópico seguinte a explicação de como fazer o abono das licenças serem aplicados no Rest Protheus quando requisitados como provedor integrado ao TReports.

03. QUANDO FUNCIONARÁ O ABONO NO REST

Para este abono acontecer no Rest Protheus existem várias dependências de outros recursos, sendo:

• TReports - versão/release 12.1.29 com os patches da própria release 29;
• License Server - versão 3.2.2 ou superior;
• Lib do Protheus - versão com label igual ou superior a 20210217.
• Protheus menu - relatórios TReports configurados para exibição no navegador interno no Protheus;
• Rest Protheus - configurado no modo de consumo das licenças por demanda.

A tabela a seguir exibe algumas situações de configurações e assumem que os produtos envolvidos possuem o mesmo License Server configurado.

Caso o Protheus Menu, Protheus Rest e o TReports tenham configurações diferentes de License Server, ou seja, não usem o mesmo servidor de licenças o abono NÃO FUNCIONARÁ.

04. COMO OBSERVAR SE O ABONO ACONTECEU

Acesse o monitor do License Server e navegue por Histórico de Consumo / Usuários.

A coluna do browse Tipo de Operação irá indicar se aconteceu um Uso, Abono ou Consulta.

Mais informações consulta a documentação do TOTVS License Server.