01. Portal do Fornecedor | Configuração

Column

width	5%

Section

25px

Column

width

90%

Deck of Cards

id	Configuracoes

Card

default	true
accessKey	API
id	API
label	API
title	API

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

title	Importante

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

title	Importante

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

Expandir

title

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.

	Validação de acesso

externo das

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

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

title	Informação

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.

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

Expandir

title	Configuração do Perfil

note

title	Sugestã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.

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

title	Importante

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 RM

No 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 "/".

HTML

<style>
#title-text {
	display: none !important; 
}

.columnLayout.three-equal{
    width: 100%;
    margin: 0 auto;
    padding-top: 32px;
    text-decoration: none;
	background-image: url(http://tdn.totvs.com/download/attachments/500299134/banner_home_process2.png?version=5&modificationDate=1562936005807&api=v2);
    //background-image: url(http://tdn.totvs.com/download/attachments/500299134/banner_home_process1.png?api=v2);
    height: 100%;
    background-size: contain;
    background-repeat: no-repeat;
    background-position: center;
    height: 230px;
}

div.panelContent{
	margin: 0 auto;
	padding-top: 32px;
	width: 1100px;
	height: 1340px; //altura da pagina
}

.custom-button{
font-weight: bold}

.ul {
list-style: square inside url('http://tdn.totvs.com/download/attachments/500299134/seta1.gif?api=v2');
}

.composition-banner-overlay{
background:rgba(0,0,0,0.0);min-height:inherit;position:relative;border-radius:5px;
}

.aui-button.aui-button-primary, .aui-button.aui-button-primary:visited {
background-color: #000000;
color: #111111;
display: block;
margin-left: 20px;
margin-right: auto;

}
.composition-banner-title{
color: #000000!important;
}

.composition-banner-desc{
color: #000000!important;
}

.composition-banner-content {
width:100%;
}
</style>

Painel

01. Portal do Fornecedor | Configuração

Abaixo estão agrupadas as etapas de configurações necessárias para o correto funcionamento do Porta do Fornecedor.

Deck of Cards

id	Configuracoes

Card

default	true
label	API

O Portal do Fornecedor comunica com o ERP através de API, desta forma é necessário garantir que o serviço de API esteja disponível e acessível de forma externa.

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

title	Importante

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

title	Validação de acesso

externo das APIs

ao banco de dados através da API

Para validar se

as configurações

a configuração da comunicação com o banco de dados das APIs

foram realizadas

foi realizada corretamente, acesse

o browser e digite a URL http://{IP ou domínio}:{porta}/api/swagger/

a API via browser.

Exemplo: http://10.173.17.242:8051/api/est/v1/

swagger

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

Verifique se a página abaixo foi carregada

Image Removed

Unitofmeasures

Neste exemplo estamos usando o cadastro de Unidade de Medidas, ao acessar será solicitado um usuário do sistema que tenha acesso a este cadastro dentro do sistema.

Image Added

Você deverá ter um resultado semelhante a este, onde lista os registros do cadastro de unidade de medida.

Image Added

cardcard

Card

id	Usuario_e_autenticacao


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

Aviso

title	Atenção

O usuário PORTALDOFORNECEDOR é 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.

"Comunicar Fornecedor" selecionando a opção "Exportar Orçamento p/Web".

O mesmo jamais deve ser criado manualmente, pois irá causar erros ao tentar acessar o portal.

Durante o processo de comunicação com o fornecedor o sistema identifica

Informações

title	Informação

A cada nova exportação para web validamos a existência do usuário, e caso o mesmo tenha sido excluído por engano, basta realizar uma nova comunicação que o mesmo será recriado, um novo usuário será criado.

Para que o usuário sejá criado corretamente com as devidas permissões, é necessário antes definir qual código de acesso e perfil serão utilizados.

Perfil

Cadastre um novo perfil, ou utilize um já existente que possua as permissões abaixo.

Expandir

title	Configuração do Perfil

Nota

title	Sugestã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

Acesso a menus → [03] Compras → [03.01] Gestão de Compras → [03.01.02] Cotação

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

Informações

title	Importante

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.

label

Painel

borderWidth	0
borderStyle	solid

Configuração de Rotas, Paginação e Usuário RM

No 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:

Column

width	560px

Image Added Voltar para o Menu Principal

Configuração do Portal

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 "/".

HTML

HTML

<style>

div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 40

Nova versão Atual

Chave

Configuração de Rotas, Paginação e Usuário RM

01. Portal do Fornecedor | Configuração

Configuração de Rotas, Paginação e Usuário RM

Image Added Voltar para o Menu Principal

Atalhos

Páginas filhas

Histórico da Página

Versões comparadas

Versão antiga 40

Nova versão Atual

Chave

Configuração de Rotas, Paginação e Usuário RM

01. Portal do Fornecedor | Configuração

Image Added Voltar para o Menu Principal

Configuração de Rotas, Paginação e Usuário RM