Histórico da Página
Índice
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 é o incremento 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:
Como configurar os serviços REST e HTTP manualmente (Não Recomendado)
Este processo 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.
Passo a passo
A tela será exibida para TODOS os usuários ao entrar no módulo SIGATAF ou ao acessar as rotinas relacionadas ao TAF do Futuro (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:
Vídeo "How To" do Processo:
Conector de Widget url https://www.youtube.com/watch?v=9Cq2ab_eKa0
Administradores
Apenas para usuários administradores 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 do Futuro.
É 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.
Requisitos para utilização do TAF do Futuro
- Estar com binário LG (Logo Guará);
- Possuir o último pacote acumulado do eSocial (TAF e GPE);
- Possuir um servidor HTTP configurado (O PATH do serviço de http deve ser nesta estrutura <ROOTPATH\http-root>. Exemplo: C:\Totvs\protheus\protheus_data\http-root);
- Possuir um servidor REST configurado (Web Service REST - Integração);
- Possuir a configuração do "TAF_CFGJOB" ativa no appserver onde está executando o serviço REST (Web Service REST - Integração);
- 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 e com .F. se possui apenas o TAF;
- Possuir no menu do TAF a opção TAFA552A para o contexto de eSocial, e TAFA552B para o contexto de REINF;
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 do Futuro.
- 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.
- Não foi possível gerar o ticket de processamento no Protheus.
Solução: Verificar se a "TAF_CFGJOB" está configurada no appserver onde o serviço REST está sendo executado. Verifique a documentação abaixo:
Para usar as inovações implementadas do TAF Full em PO UI é 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 ambiente 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 html) 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, sendo elas:
1 - Configuração utilizando os serviços REST e HTTP apartados
2 - Configuração utilizando os serviços REST e HTTP com porta Multi Protocolo (MPP)
Informações | ||
---|---|---|
| ||
No caso das duas configurações estarem presentes na configuração dos arquivos appserver.ini, o sistema irá priorizar a configuração da MPP (porta multi protocolo), desta forma o sistema irá ignorar a configuração dos serviços REST e HTTP apartados. |
Vídeo "How To" demonstrando o processo:
...
Consulta da base de cálculo INSS/FGTS da Folha RM:
...