Índice
Índice |
---|
exclude | .*ndice |
---|
printable | false |
---|
|
Objetivo
O objetivo deste documento é detalhar o funcionamento do consumo de licenças pelo TReports, quando os recursos são consumidos por ERPs, e explicar quais informações devem ser enviadas para o TReports a fim de permitir o abono das licenças.
Introdução
Para realizar a pré-visualização e exibição de relatórios, ou o design e visualização dos demais recursos via interface, é necessária a disponibilidade de uma Licença TOTVS I. Essa exigência também ocorre quando é solicitada a geração de relatórios via API pública. Dessa forma, quando os recursos do TReports são consumidos pelo ERP que implementou a integração, é necessário enviar algumas informações para o TReports a fim de possibilitar o abono de licenças e evitar consumo duplicado. Caso essas informações não sejam enviadas, será criado um contexto de licença sob demanda para continuação do fluxo de execução
Abono de Licenças
Para realizar o abono de licenças é necessário enviar algumas informações para o TReports, a fim de evitar consumo duplicado de licenças. Existem três formas de realizar esse processo: via API, via corpo da requisição(Relatório Legado) e através do Hyperlink de integração com Viewer Externo.
Representação JSON do contexto de licença
Bloco de código |
---|
language | js |
---|
theme | RDark |
---|
title | License Context |
---|
|
{
"federalId": "11111111111111",
"mainThreadId": <MainThread do Produto TOTVS>,
"threadId": 999999,
"moduleId": "<Modulo do Produto TOTVS>",
"actionName": "<Rotina do Produto TOTVS>",
"licenseServer": {
"hostname": "<Ip do License Server>",
"port": <Porta do License Server>
},
"client": {
"hostname": "<Ip do Produto TOTVS>",
"port": <Porta do Produto TOTVS>
},
"user": {
"name": "<Usuário do Produto TOTVS>",
"isFullDeterminado": false,
"credentials": null
}
} |
Bloco de código |
---|
language | js |
---|
theme | RDark |
---|
title | Contexto de Licença em base64 |
---|
|
eyJmZWRlcmFsSWQiOiIxMTExMTExMTExMTExMSIsIm1haW5UaHJlYWRJZCI6IjxNYWluVGhyZWFkIGRvIFByb2R1dG8gVE9UVlM+IiwidGhyZWFkSWQiOjk5OTk5OSwibW9kdWxlSWQiOiI8TW9kdWxvIGRvIFByb2R1dG8gVE9UVlM+IiwiYWN0aW9uTmFtZSI6IjxSb3RpbmEgZG8gUHJvZHV0byBUT1RWUz4iLCJsaWNlbnNlU2VydmVyIjp7Imhvc3RuYW1lIjoiPElwIGRvIExpY2Vuc2UgU2VydmVyPiIsInBvcnQiOiI8UG9ydGEgZG8gTGljZW5zZSBTZXJ2ZXI+In0sImNsaWVudCI6eyJob3N0bmFtZSI6IjxJcCBkbyBQcm9kdXRvIFRPVFZTPiIsInBvcnQiOiI8UG9ydGEgZG8gUHJvZHV0byBUT1RWUz4ifSwidXNlciI6eyJuYW1lIjoiPFVzdeFyaW8gZG8gUHJvZHV0byBUT1RWUz4iLCJpc0Z1bGxEZXRlcm1pbmFkbyI6ZmFsc2UsImNyZWRlbnRpYWxzIjpudWxsfX0=== |
Informações |
---|
title | Como é concedido o abono? |
---|
|
O abono é concedido pela combinação do mainThreadId + moduleId + client:hostname + client:port + user:name. Esses valores devem ser preenchidos com os mesmos valores utilizados pelo ERP que está solicitando a geração/visualização do recurso para que ocorra o abono pelo License Server. |
Abono de licenças via API
Quando o ERP consumir as APIs públicas de geração de relatórios, deverá passar as seguintes informações via cabeçalho da requisição:
Header | Value |
---|
X-License-Context | License Context codificado em base64 |
Abaixo um exemplo de envio de requisição de geração de relatório (api/reports/v2/generate) via Postman, com as informações do contexto de licença em formato JSON convertido para base64:
Abono de licenças via Hyperlink de Integração com Viewer Externo
O TReports disponibiliza uma API para cada recurso (Relatório, Tabela Dinâmica e Visão de dados) que retorna as rotas de integração por interface com as funcionalidades de cada recurso. A seguir está o link para mais detalhes sobre a integração usando hyperlink de cada recurso:
Todas essas APIs tem o parâmetro "licenseContext" para ser informado seguindo a estrutura JSON do contexto de licença codificado em base64.
Segue um exemplo da resposta de uma requisição à API para obter a rota de integração com o recurso Relatório informando o licenseContext e sua respectiva resposta:
Nota: Os demais parâmetros foram omitidos para destacar o licenseContext.
codeImage Added
Informações |
---|
É importante entender que a API de |
language | js |
---|
theme | RDark |
---|
title | Resposta API Hyperlink de Integração com Viewer Externo | {
"viewer": "http://framework-bh.localhost:7027/reports/9ac2b84b-a6c2-46c2-b0c8-1cfd7ef92f29/view?licenseContext=contextoDeLicencaEmBase64",
"viewer-pdf": "http://framework-bh.localhost:7027/reports/9ac2b84b-a6c2-46c2-b0c8-1cfd7ef92f29/view-pdf?licenseContext=contextoDeLicencaEmBase64"
} foi criada para facilitar a integração com o visualizador do ERP TOTVS ou o acesso direto pelo navegador. Seus parâmetros são opcionais e, se omitidos, a API retornará apenas a máscara do parâmetro da query string, conforme exibido na imagem acima. Caso o contexto de licença não seja enviado, um novo contexto será criado sob demanda ao executar a busca de dados para o recurso selecionado, permitindo que o fluxo de execução do viewer continue. |