TOTVS Varejo Supermercados (Linha RMS)

Árvore de páginas

01. INTRODUÇÃO

Antecipando as futuras exigências da legislação já anunciadas, informamos que, a partir da versão 25.01, estará disponível o novo módulo chamado Configurador de Cenários Tributários no produto TOTVS Varejo Supermercados - Linha RMS, desenvolvido para atender às demandas da Reforma Tributária. Esse novo módulo foi criado com uma arquitetura web moderna, utilizando tecnologias atuais alinhadas aos padrões dos produtos TOTVS. Ele proporciona uma experiência inovadora na gestão tributária, abrangendo os novos impostos previstos na Reforma Tributária.

Destacamos que o novo módulo deve ser utilizado somente em ambiente de homologação durante o período que antecede a entrada em vigor da legislação da Reforma Tributária. Nesta documentação, será demonstrado o processo de instalação e publicação, simulando um ambiente de homologação.

02. PREMISSAS

Para utilizar o novo módulo, que será obrigatório conforme os prazos estabelecidos pela legislação da Reforma Tributária, será necessário configurá-lo em um servidor compatível, seguindo as orientações da nova documentação de pré-requisitos para ambientes web da Linha RMS. Para os clientes que já utilizam algum módulo web da linha RMS, é possível utilizar o mesmo ambiente de servidor, desde que ele atenda aos pré-requisitos do ambiente, os quais serão validados pela ferramenta de publicação web. Para os clientes que ainda não possuem nenhum módulo web da Linha RMS, será necessário configurar um novo ambiente de servidor para a instalação do novo módulo web. Recomenda-se fortemente a utilização de um novo ambiente de servidor dedicado exclusivamente para as aplicações web do RMS.

Antes de iniciar o processo, consulte a documentação da ferramenta Publica Web para entender seu funcionamento, o que proporcionará uma melhor experiência na leitura desta documentação. Por se tratar de uma ferramenta agnóstica em relação à linha de produto, os exemplos presentes na documentação podem não ser específicos para o produto em questão.

03. NOVO MODELO DE AMBIENTAÇÃO WEB

Ao executar o processo de publicação descrito no passo a passo abaixo, dois novos sites serão criados no IIS, conforme ilustrado no exemplo a seguir. O primeiro site, denominado RMS_Web-HML, corresponde à nova publicação do RMS Menu (Lite), que permitirá aos usuários finais acessar o novo módulo do Configurador de Cenários Tributários. Além do Configurador de Cenários Tributários, o RMS Menu (Lite) publicado permitirá o acesso às demais aplicações web da Linha RMS, incluindo aquelas que já estavam configuradas anteriormente no servidor IIS. O segundo site, denominado RMS_WEB-HML_API, hospedará as APIs do RMS Web instaladas via publicador web.

Para clientes que já utilizavam o RMS Menu (Lite) antes da versão 25.01, a publicação anterior do RMS Menu (Lite) dentro do site Default pode ser removida a fim de evitar duplicidade, conforme ilustrado abaixo.

Trabalharemos para que, nas versões futuras do RMS, todos os pacotes de aplicações web sejam instalados pelo publicador web, facilitando o processo de ambientação e atualização dos produtos.

04. PASSO-A-PASSO

Após realizar o download e extrair o pacote zipado, uma nova pasta chamada Web estará disponível, conforme ilustrado abaixo.

A pasta Web deve ser copiada para o ambiente de servidor destinado aos módulos web.

Após copiar a pasta para o ambiente de servidor web, execute a aplicação chamada PublicaWeb, presente na pasta, para iniciar a publicação dos projetos web disponibilizados no pacote, conforme ilustrado abaixo.

A tela inicial do publicador exibirá o resultado da validação dos pré-requisitos de ambiente, os quais devem ser totalmente atendidos ou atendidos com ressalva para que a aplicação permita prosseguir, caso contrário uma mensagem será exibida, conforme ilustrado abaixo.

A própria aplicação fornece orientações e links para que o usuário possa solucionar os itens não atendidos, bastando clicar sobre o item pendente para consultar as informações. Os itens com o status Atende com ressalva não são impeditivos, mas devem ser cuidadosamente avaliados, especialmente em ambientes produtivos.

Após atender a todos os requisitos, a aplicação permite o avanço para o processo de publicação, conforme ilustrado abaixo.

Na tela principal da ferramenta, clique no botão Nova Publicação em destaque, preencha os campos necessários e clique em OK, conforme ilustrado abaixo. Os campos possuem nomes padrão; recomenda-se manter os valores sugeridos, mas eles podem ser personalizados conforme as necessidades.

Por padrão, a porta instalada do novo site RMS Web é a 90. Caso deseje manter a porta 80, será necessário alterar a porta do site Default para outra, pois não é possível publicar sites na mesma porta sem o uso de DNS. Além disso, será necessário ajustar o parâmetro apiRotaAntiga no arquivo Config.json (C:\inetpub\wwwroot\TOTVS_Varejo_Supermercados\RMS_Web-HML\RMSMenuLight\assets), configurando a mesma porta definida para o site Default, onde, até então, as aplicações web da RMS são instaladas por padrão.

Em seguida, forneça os dados de conexão com o banco de dados, como o servidor (alias do tnsnames), usuário, senha e o IP do servidor de aplicação RMS, e clique em Avançar, conforme ilustrado abaixo.

Em seguida, a publicação será iniciada, exibindo os passos que estão sendo executados, conforme ilustrado abaixo.

Após a conclusão da instalação, uma mensagem será exibida sugerindo a abertura do site publicado para verificação, conforme ilustrado abaixo.

O acesso ao RMS Menu no servidor IIS deve ser realizado pelo endereço configurado na ferramenta Publica Web. Não utilize "localhost" ou "127.0.0.1", pois isso pode causar falhas ao abrir o Configurador de Cenários Tributários e demais aplicações.

O site RMS Web ainda não estará funcional para login, pois é necessário registrar a DLL RMSLicencas.dll e reiniciar o IIS para garantir o correto funcionamento do RMS Menu, caso ela ainda não esteja registrada no servidor. Para isso, abra o prompt de comando com elevação de administrador e execute os comandos a seguir de acordo com o nome e tipo de publicação, conforme ilustrado abaixo.

Homologação
regsvr32 C:\inetpub\wwwroot\TOTVS_Varejo_Supermercados\RMS_Web-HML_API\RMSNative\RMSLicencas.dll
Produção
regsvr32 C:\inetpub\wwwroot\TOTVS_Varejo_Supermercados\RMS_Web_API\RMSNative\RMSLicencas.dll

iisreset

O registro da DLL mencionado acima é necessário ser executado apenas uma vez por publicação (produção e/ou homologação), durante a ambientação inicial do RMS Web, realizada por meio da ferramenta de publicação.

Dessa forma, o site estará pronto para ser utilizado. Acesse a URL e realize o login para autenticação, conforme ilustrado abaixo.

Após realizar a autenticação, o novo módulo Configurador de Cenários Tributários estará disponível no menu, conforme ilustrado abaixo.