O Portal do Fornecedor comunica com o ERP através de APIAPIs, desta forma é necessário garantir que o serviço de API esteja disponível e acessível de forma externa. Aviso |
---|
| Como o acesso do fornecedores é externo a rede da empresa, as portas configuradas abaixo para o serviço de API deverá estar liberadas para acesso externo. |
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 durante a instalação do Portal. Nota |
---|
| 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.
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 |
---|
| externo das | 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 Image Modified | Card |
---|
label | Usuário e autenticação |
---|
title | Parametrização de Acesso |
---|
| Para realizar a autenticação com as APIs utilizamos o usuário PORTALDOFORNECEDOR . Este usuário é criado automaticamente pelo sistema durante o processo de comunicar fornecedor exportando os dados para web na cotação, mas para isso, é necessário antes definir qual código de acesso e perfil serão associados a este usuário. Informações |
---|
| A cada nova exportação para web validamos a existência do usuário, caso o mesmo tenha sido excluído por engano, basta realizar uma nova comunicação que o mesmo será recriado. |
Perfil Cadastre um novo perfil, ou utilize um já existente que possua as permissões abaixo. Expandir |
---|
| title | Configuração do Perfil |
---|
| Nota | titleSugestão | Aconselhamos a criação de um perfil exclusivo para esta finalidade, pois qualquer manutenção indevida nas permissões, pode fazer com que o fornecedor visualize mensagens de erro ao acessar cadastrados que estão disponíveis no portal, como unidade, marca, condição de pagamento. | Acesso a menus → [01] Cadastros Image Removed
Acesso a menus → [03] Compras → [03.01] Gestão de Compras → [03.01.02] Cotação Image Removed
Parâmetros da cotação Informe o perfil e código de acesso que serão utilizado para realizar a autenticação das APIs, nos parametros da cotação na etapa Definições Gerais 6/6 Image Removed Informações |
---|
| Clientes que possuem o sistema configurado com LDAP ou Login Unificado utilizando usuário de rede, devem acessar o cadastro do usuário PORTALDOFORNECEDOR depois que o mesmo for criado, e informar um usuário de rede válido na pasta rede. | card | label | Configuração do Portal |
---|
| Configuração de Rotas, Paginação e Usuário RMNo diretório "C:\TOTVS\CorporeRM\FrameHTML\Web\App\Cmp\PortalDoFornecedor\config\" abra o arquivo de configuração do Portal "config.json". Nele serão possíveis de se efetuar as seguintes configurações: Bloco de código |
---|
firstline | 1 |
---|
title | config.json |
---|
linenumbers | true |
---|
| {
"rmApiServer": "http://192.168.10.12:8052/API/",
"pageSize": 8,
} |
- rmApiServer: Deve conter o endereço da URL de acesso ao RM. É para esta rota que serão direcionadas as requisições do portal, ela é a mesma que foi configurada anteriormente no RM.Host.exe.config ou RM.Host.service.exe.config , ou seja, http://Endereço (Ip ou nome da máquina onde o Host está instalado):APIPort.
- pageSize: Número de itens da paginação.
Caso esteja utilizando alguma regra no IIS com Rewrite , na tag rmApiServer deve ser informado o caminho do portal conforme publicado no IIS, exemplo: Bloco de código |
---|
firstline | 1 |
---|
title | config.json |
---|
linenumbers | true |
---|
| {
"rmApiServer": "http://localhost/FrameHTML/Web/App/Cmp/PortalDoFornecedor/API/",
"pageSize": 8,
} |
IMPORTANTE: Após configurar o arquivo config.json, é necessário limpar o cache do navegador, caso contrário, o arquivo de configuração antigo será mantido por um tempo. A Tag rmApiServer deve obrigatoriamente terminar com barra "/".
|