Histórico da Página
Objetivo
Este documento tem como objetivo explicar detalhadamente qual a configuração que deve ser utilizada no Automação Fiscal para uso dos novos painéis construídos em PO UI;
A TOTVS recomenda que seja utilizada a Porta Multiprotocolo para uso dos novos painéis, dessa forma apenas com uma atualização simples você já terá acesso a tudo de mais novo que existe no produto.
Como configurar a Porta Multiprotocolo no Automação Fiscal ? (Recomendado)
A configuração da Porta MPP no Automação Fiscal é muito simples, veja abaixo oque precisa ser feito:
- Dentro do Automação Fiscal pressione as teclas "SHIFT+F6", será aberta uma interface conforme abaixo, valide se a versão do "Appserver version" é igual a superior a 19.3.0.X, no exemplo abaixo a versão do servidor de aplicação do automação fiscal é a "19.3.1.7":
- Caso a sua versão do item acima esteja desatualizada é necessário realizar a atualização do Automação Fiscal para última versão do pacote acumulado do produto, mais detalhes em Novembro/2021 - Versão mais atualizada do produto;
- Após garantir que seu produto esteja atualizado, ao subir o serviço de aplicação do Automação Fiscal a porta MPP já será iniciada por DEFAULT, o único incremento que deve ser realizado no arquivo "appserver.ini" do Automação Fiscal é a inclusão da chave "app_environment" na seção "General", conforme exemplo abaixo:
Atenção: O nome "TAF" do exemplo acima informado na chave "app_environment" é o nome do ambiente do Automação Fiscal configurado no ambiente, ou seja, pode variar de acordo com a configuração do seu ambiente do produto.
Seguindo exatamente os passos acima o seu ambiente do Automação Fiscal já estará apto a acessar os novos painéis em PO UI.
Exemplo de um arquivo appserver.ini do Automação Fiscal utilizando a porta MPP, este arquivo deve ser utilizado apenas como consulta e nunca deve ser utilizado para substituir o "appserver.ini" vigente de seu ambiente:
Quando o acesso ao ambiente com porta multiprotocolo habilitado é feito fora do servidor de aplicação é necessário que as estações que irão acessar esse ambiente (smartclients) possuam um certificado TOTVS instalado. O certificado TOTVS precisa ser gerado dentro do servidor, conforme o passo a passo descrito nessa documentação: Porta Multiprotocolo - Geração de Certificado, utilizando o executável totvs_certificates.exe. Após essa geração, os certificados gerados devem ser copiados tanto para os appservers dentro do servidor e também para a pasta do smartclient que vai acessar o ambiente e aí sim, efetuar a instalação do certificado (somente nas estações, no servidor não é necessário instalar), conforme link a seguir Porta Multiprotocolo - Geração de Certificado
Como configurar os serviços REST e HTTP manualmente (Não Recomendado)
Este processo esta obsoleto e NÃO é recomendado para clientes que querem utilizar os painéis do Automação Fiscal em PO UI, o mais indicado é a utilização da PORTA MPP citado no item anterior.
Este documento tem como objetivo auxiliar nas configurações dos itens abaixo:
- Preencher o parâmetro MV_BACKEND com a URL do serviço REST;
- Preencher o parâmetro MV_GCTPURL com a URL do serviço HTTP;
- Preencher o parâmetro MV_TAFPO com .T. se possui mais módulos de Protheus além do TAF ou possui mais de uma placa de rede no servidor onde está sendo executado o serviço HTTP e com .F. se possui apenas o TAF e apenas uma placa de rede;
- Validar se a API rest está online;
- Validar se a pasta "http-root" está criada dentro do "Rootpath" do sistema e devidamente configurada no "Path" do serviço HTTP no "APPSERVER.INI". Exemplo abaixo:
6. Inserir o parâmetro MAXSTRINGSIZE=10 na seção do GENERAL do appserver.ini.
Vídeo "How To" do Processo:
Conector de Widget url https://www.youtube.com/watch?v=9Cq2ab_eKa0
Passo a passo
A tela será exibida para TODOS os usuários ao entrar no módulo SIGATAF ou ao acessar as rotinas novas em PO UI (TAFA552A, TAFA552B e TAFA552C), até que os parâmetros MV_BACKEND e MV_GCTPURL sejam configurados e a configuração do PATH HTTP esteja de acordo com a documentação. A tela possui funcionalidades distintas por tipo de usuário conforme abaixo:
Administradores
Apenas para usuários administradores de instalações novas do TAF ou que foram configuradas como único módulo do Protheus ( MV_TAFPO = .F. ) será exibido o botão "Configurar Parâmetros", onde é possível informar e validar as URLs de REST e HTTP conforme as instruções abaixo:
Passo 1: Clicar no botão "Configurar Parâmetros";
Após clicar no botão "Configurar Parâmetros", o sistema irá buscar as URLs dos serviços REST e HTTP no ambiente e o valor do parâmetro MV_TAFPO onde o sistema está executando.
Observação: As informações só serão carregadas automaticamente, caso o ambiente esteja com o padrão da instalação realizada pelo instalador. Para maiores detalhes sobre o instalador, acesso o link abaixo:
https://tdn.totvs.com/x/oUUAHw
Passo 2: Confirme as informações e clique no botão "Ok"
Caso sejam encontradas as informações com as URLs dos serviços de REST e HTTP, o sistema exibirá os campos preenchidos, de forma que basta clicar no botão "Ok" para validar as informações e salvá-las.
Caso as informações não sejam encontradas, o sistema exibe a tela com as informações em branco, onde é possível preencher, validar e por fim salvar as informações clicando no botão "Ok".
Ao final do processamento, caso as informações estejam corretas, os parâmetros serão gravados e a tela não será exibida novamente.
Usuários
O botão "Configurar parâmetros" não é exibido para usuários que não são administradores.
Neste contexto de usuários, a tela tem caráter informativo, a respeito das novidades do TAF FULL.
É possível cessar as mensagens por 7 dias, clicando no botão "Não ver esta mensagem nos próximos 7 dias".
Observação: Esta tela não será exibida após a configuração dos parâmetros MV_BACKEND, MV_GCTPURL e configuração do diretório "HTTP-ROOT" no PATH do serviço HTTP.
| Aviso | ||
|---|---|---|
| ||
A utilização do smartclient Electron ou webApp está disponível apenas quando o serviço está configurado para trabalhar utilizando a porta multi protocolo |
Mensagens de alerta / erros
- O 'PATH' do serviço HTTP deve ser um diretório com o nome 'http-root'. Verifique a documentação em: https://tdn.totvs.com/x/-RSLHg
Solução: O nome do diretório configurado no PATH do serviço HTTP, obrigatoriamente deve ser um diretório com o nome "http-root".
Exemplo:
- O 'PATH' do serviço HTTP não está configurado. Verifique a documentação em: https://tdn.totvs.com/x/apk4E
Solução: A configuração do serviço HTTP precisa conter o parâmetro PATH, configurado conforme o exemplo acima.
- O serviço HTTP não está configurado. Verifique a documentação em: https://tdn.totvs.com/x/apk4E
Solução: A configuração do serviço HTTP não foi realizada e é obrigatória para o funcionamento do TAF Full.
- Não foi possível acessar a URL do serviço REST, os parâmetros não serão gravados. Verifique suas informações.
Solução: O sistema não conseguiu acessar a URL do serviço REST, verifique se o endereço está correto e se o serviço está no online.
- Ambientes com Broker.
Sugerimos a leitura das documentações abaixo para entender como é o funcionamento do HTTP e do WebService para configurá-los em um ambiente com broker:
Para usar as inovações implementadas no projeto TAF do Futuro é necessário realizar algumas configurações no seu sistema, e com o objetivo de facilitar a realização destas configurações a TOTVS criou a interface descrita abaixo que possibilita ao administrador do sistema configurar o TAF do Futuro de forma simples e intuitiva.
Os Painéis POUI são desenvolvidos utilizando tecnologia web, o smartclient possui um navegador de internet embarcado e realiza a renderização das páginas HTML nas telas do produto (MDIs), com base neste conceito o desenvolvimento é divido em front-end e back-end sendo necessário a utilização de um servidor HTTP (para exibição das páginas) e de um servidor REST (para o envio e retorno de informações do back-end). Hoje existem 2 formas de realizar a configuração destes serviços, são elas:
...
...
- Full o cliente do RM pode realizar uma configuração que permite ao TAF consultar diretamente os valores de dentro da folha, deixando o relatório ainda mais completo para que os usuários da folha façam as conferências necessárias.
Link com os detalhes da configuração na folha RM: TAF - Como gerar as bases de INSS/FGTS no relatório do eSocial do futuro?
Importante: A configuração do TAF
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas