Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Deck of Cards
idConfiguracoes
Card
idAPI
labelConfiguração API

Com o objetivo de otimizar as ações do Módulo de Caixa, as novas rotinas utilizam a integração da MDI atual da Linha RM com telas em HTML, tudo isso de forma transparente ao usuário. 

Para utilizar esse novo recurso, é necessária a realização de algumas configurações que irão habilitar o uso das APIs que fazem a execução das ações e processos da nova interface. Nesse documento você encontrará orientações de como configurar o seu ambiente para começar a utilizar o Novo Módulo de Caixa.


Configurando as portas da API

O aplicativo RM.Host é responsável por hospedar e expor os serviços de APIs.

Veja mais sobre a configuração da porta webApi.

A tag ApiPort configurada nesta etapa será utilizada para acessar as APIs que fazem parte das rotinas do Novo Módulo de Caixa.


Nota
titleImportante

A execução do Host precisa ser como administrador:

  • Caso o Host seja iniciado como aplicativo (RM.Host.exe), certifique-se que ao executá-lo, tenha selecionado a opção "Executar como Administrador".
  • Caso o Host tenha sido instalado como serviço, o usuário vinculado ao serviço deve ser um administrador do sistema.
Expandir
titleValidação de acesso as APIs

Para validar se as configurações de portas das APIs foram realizadas corretamente, acesse o browser e digite a URL  http://{IP ou domínio}:{porta}/api/swagger/.

Exemplo: http://10.173.17.242:8051/api/swagger

Importante na validação usar o IP, nome da máquina ou domínio.

Verifique se a página abaixo foi carregada


       


Conectando com o banco de dados

Para que a API saiba em qual banco de dados conectar quando for acionada pelo Portal, devemos configurar a tag DefaulDB.

Veja mais em Configurando DefaultDB.


Expandir
titleValidação de acesso ao banco de dados através da API

Para validar se a configuração da comunicação com o banco de dados das APIs foi realizada corretamente, acesse a API via browser.

Exemplo: http://10.173.17.242:8051/api/financial/v1/paymenttypes/1

Neste exemplo estamos buscando do cadastro de Meios de Pagamento todos os que são pertencentes à coligada 1, ao acessar será solicitado um usuário do sistema que tenha acesso a este cadastro dentro do sistema.


Você deverá ter um resultado semelhante a este, onde lista os registros do cadastro de meios de pagamento da coligada 1.

Card
idjson
labelConfiguração do Arquivo JSON

Após configurar a API é necessário ajustar o arquivo de configuração do Portal Financeiro.

Para isso, acesse o arquivo config.json que está disponível no caminho padrão do instalador do Portal Financeiro:  “C:\totvs\CorporeRM\FrameHTML\Web\App\Fin\PortalFinanceiro\config”.

No arquivo, alterar as informações a seguir:

  • "apiServer": "http://INFORME_NOME_DA_MAQUINA_QUE_ESTA_EXECUTANDO_O_HOST:PORTA",
  • "basePath": "/FrameHTML/Web/App/Fin/PortalFinanceiro",
  • "defaultAlias": "infome_o_nome_do_Alias",
  • "urlCorpore": "",
  • "multitenant": "false" (Alterar para para TRUE, se utilizar MultiTenacyMultiTenancy)
  • "subDomainMask": "[ALIAS].localhost", (se utilizar MultiTenancy deve alterar o localhost pelo nome da máquina que está executando o host)

Exemplo após a configuração

Card
idUsuario
labelUsuário e Permissões

A validação de acesso continua considerando o usuário que está logado no TOTVS Gestão Financeira no momento da ativação da Sessão de Caixa.

Nota
titleDocumentação em elaboração

Em breve, mais detalhes sobre as permissões do Novo Módulo de Caixa serão descritas aqui e o texto definido abaixo será revisado contemplando o novo cenário.

O sistema permite que seja atribuído a cada operador um nível de acesso aos recursos através das definições do perfil. É possível criar um perfil para Supervisor, esse deve ser atribuído ao usuário que irá gerenciar as Sessões e um perfil para Operador, com acesso limitado às operações da Sessão do Caixa.
 
Para configurar o perfil acesse: Serviços Globais | Segurança | Perfis - Usuários.

Operador Supervisor

É necessário cadastrar um perfil que tenha acesso aos principais menus do Módulo de Caixa, cadastrar o usuário definindo que o mesmo será supervisor, indicar a coligada e associá-lo ao perfil criado.

Operador de Caixa

Será necessário cadastrar um perfil para o Operador, permitindo ou restringindo acesso aos principais menus do Caixa, cadastrar o usuário e associá-lo ao perfil criado.

...