01. OBJETIVO

Executar relatórios construídos na solução TReports, independente da fonte de dados utilizada para o relatório.

02. COMO FUNCIONA?

Assim como os demais relatórios executados dentro do Protheus (como RM Reports, Crystal, etc), uma opção deve ser adicionada ao menu do usuário, por exemplo: SIGAFAT / Relatórios / TReports / Clientes - TReports.

Quando o usuário acionar esta opção no seu menu, os dados de comunicação com os serviços Totvs RAC e TReports serão recuperados e o pedido de execução do relatório será realizado no TReports.

Com o sucesso da execução, o Protheus enviará o comando de abertura da URL ao sistema operacional e então o navegador padrão da máquina do usuário se encarregará de exibir o relatório.

Em caso de falha será exibida mensagem para verificação dos parâmetros de comunicação e o relatório no TReports.

A exibição dos relatórios é feita externamente pelo navegador para que os usuários consigam imprimir e baixar os relatórios.

03. CONFIGURAÇÃO

A configuração no Protheus corresponde ao preenchimento das URLs e usuários para autenticação no Totvs RAC e TReports.

Para ambientes com dicionário no banco pode existir a necessidade de atualização de uma das tabelas de menu e para isso faz-se necessária a execução do UPDDISTR.

Essas informações devem ser preenchidas utilizando a opção de menu do configurador: SIGACFG / Cadastros / Configuração TReports (FWTREPPARM). Necessária atualização do menu do configurador para ter esta opção disponível.

Nessa tela as informações exigidas para preenchimento são:

URL Totvs RAC = url base do serviço do Totvs RAC

URL TReports = url base do serviço do TReports

ClientId do RAC = client oAuth para a autenticação no RAC (necessário que seja um client oAuth e tenha permissão "Resource Owner")

Secret do RAC = senha do client oAuth

Usuário do TReports = identificação do usuário para acesso aos relatórios

Senha do TReports = senha do usuário que executará e visualizará os relatórios

Tenant do TReports = identificação do tenant utilizado, o valor é padrão treports

...

Para criar o usuário Client Id, acesse o link a seguir: Como criar o usuário Client Id para autenticação no TOTVS.rac?

Quando utilizado tenant diferente do padrão a url base do TOTVS.rac e do TReports não devem ser precedidas com o tenant.
Por exemplo, ao invés de preencher com https://my_new_tenant.url-base/totvs.rac preencha com https://url-base/totvs.rac.

Faça o teste acionando o botão "Testar conexão" para saber se está válido.

Image Removed

04. CONFIGURAÇÃO DE MENU E EXECUÇÃO DOS RELATÓRIOS

Após a definição dos parâmetros de comunicação com o Totvs RAC e TReports é necessário adicionar os relatórios aos menus dos usuários para a execução.

Para isso foi adicionada a opção TReports no tipo dos programas na alteração/adição de um item de menu. Quando esta opção for selecionada, o botão "..." ficará habilitado e exibirá a lista de relatórios disponíveis para escolha e execução pelo menu do usuário.

...

<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>