Baixando o instalador

Acesse o portal de downloads, baixe o arquivo TOTVS RM Portal de acordo com a versão desejada na extensão .msi

Importante

Recurso disponível a partir da release 12.1.34





Instalando o portal

1 - Inicie a instalação

2 - Durante a instalação, selecione o tipo Personalizada


3 - Na instalação personalizada são apresentados todos portais disponíveis da Linha RM, por default todos os recursos serão instalados, neste momento deixe habilitado apenas o Portal do Fornecedor.

Informações

Durante a instalação você pode selecionar mais de um portal para ser instalado ao mesmo tempo.


4 - Nas configurações, habilitamos o serviço de API. Se você pulou esta etapa, acesse este link para realizar a configuração, antes de seguir.

É nesse momento que precisamos informar as portas do Host (Port) e do serviço de API (ApiPort) da Biblioteca RM.

As informações preenchidas na primeira linha desta tela serão utilizadas para a configuração da webconfig que contém as regras do rewrite, porém também é possível editá-las posteriormente.

Após isso, será aberta uma tela para que seja informado a Url do servidor de Api que será preenchida no arquivo config.json dentro da pasta config do portal do fornecedor:


5 - Conclua a instalação


Ao finalizar a instalação do Portal, será criado um site no IIS com o nome FrameHTML.

O site é criado e toda a comunicação do IIS acontece na pasta C:\TOTVS\CorporeRM\FrameHTML


Informando URL do serviço de API

No diretório de instalação do Portal C:\TOTVS\CorporeRM\FrameHTML\Web\App\Cmp\PortalDoFornecedor\config\ abra o arquivo de configuração config.json.

config.json
{
	"rmApiServer": "http://{IP ou domínio}:{porta}/API/",
	"pageSize": 8,
}

Na opção "rmApiServer" informe a URL do servido de API configurada anteriormente na etapa de configuração da API.

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


Importante

A URL informada precisa ser de acesso externo, informando IP ou domínio, nunca usar localhost, pois caso contrário o portal estará acessível apenas na própria máquina.

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





Definindo permissão

O IIS realiza interações com a pasta do site e ele deve ter permissão total de acesso a pasta.

É necessário inserir nas propriedades da pasta C:\TOTVS\CorporeRM\FrameHTML o controle total para o usuário IIS_IUSRS do IIS (NOMEDAMAQUINA\IIS_IUSRS)

Uma das melhores formas de testar a comunicação do IIS com a pasta é abrir o site logo após essas configurações através da opção Procurar Site.

Se o site for aberto confome demonstrado abaixo é porque a comunicação entre a pasta e o IIS está corretamente configurada.

Caso encontre algum erro nesse passo vá até a seção de Erros e Soluções.



Importante

Esta configuração deve ser utilizada apenas quando a instalação do Portal do Fornecedor e o Host estão em domínios diferentes

Esse componente permite que a URL do site seja reescrita durante a navegação. 


Instalando o Rewrite e o ARR

Se você utilizou o instalador, já foi solicitado a instalação do Rewrite 

Fazer o download do Microsoft Application Request Routing (ARR)

Realizar a instalação dos componente acima no mesmo servidor do Portal do Fornecedor





Habilitando o proxy do ARR

Acessar o recurso Application Request Routing Cache, nas ações clicar em Server Proxy Settings e marcar a opção Enable proxy







Configurando regras de Rewrite


Existem duas regras, a primeira é utilizada para direcionamento de APIs onde NÃO é necessário passar o alias selecionado, e a segunda é utilizada para as api's onde é necessário passar o alias selecionado (Ambiente Multi Tenant).

Atenção

Caso já existam regras no Rewrite diferentes das regras especificadas a seguir, favor avaliar a possibilidade de removê-las, pois pode impactar as requisições ao Host.


1ª Regra:

  1. Acessar o IIS -> Acessar o Portal do Fornecedor (FrameHTML | Web | App | Cmp | PortalDoFornecedor) Clicar no site Portal do professor-> URL Rewrite


  2. Dar um duplo click no ícone URL Rewrite e em seguida clicar em: Adicionar uma Rule do tipo Inboud Rule.
  3. Inserir as seguintes informações
    1. No campo "Name" informar um nome para a regra que está sendo criada
    2. Na opção: Match URL, no campo: "Patterninserir as informação: api/(.*)

    3. Na opção: "Actions", no campo: Rewrite URL informar o link: http://nome_da_maquina_do_host:porta/api/{R:1}



2ª Regra:

  1. Acessar o IIS -> Acessar o Portal do Fornecedor (FrameHTML | Web | App | Cmp | PortalDoFornecedor) Clicar no site Portal do professor-> URL Rewrite

  2. Dar um duplo click no ícone URL Rewrite e em seguida clicar em: Adicionar uma Rule do tipo Inboud Rule.

  3. Inserir as seguintes informações
    1. No campo "Name" informar um nome para a regra que está sendo criada
    2. Na opção: Match URL, no campo: "Patterninserir as informação: aliasname\.(.*)/api/(.*)

    3. Na opção: "Actions", no campo: Rewrite URL informar o link: http://{R:1}.nome_da_maquina_do_host:porta/api/{R:2}
    4. Marcar a opção: "Stop processing of subsequent rules"


Atenção

A porta utilizada deve ser a mesma que está configurada na tag ApiPort na etapa de configuração de API.





Ajustando URL do serviço de API

No diretório de instalação do Portal C:\TOTVS\CorporeRM\FrameHTML\Web\App\Cmp\PortalDoFornecedor\config\ abra o arquivo de configuração config.json.

config.json
{
	"rmApiServer": "http://{IP ou dominio}:{porta}/FrameHTML/Web/App/Cmp/PortalDoFornecedor/API/",
	"pageSize": 8,
}

Na opção "rmApiServer" informe o caminho do portal conforme publicado no IIS.

Exemplo: http://10.173.17.242:8051/FrameHTML/Web/App/Cmp/PortalDoFornecedor/API/


Importante

A URL informada precisa ser de acesso externo, informando IP ou domínio, nunca usar localhost, pois caso contrário o portal estará acessível apenas na própria máquina.

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