Histórico da Página

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

____________________________________________________________________________________________________________________________________________________________________________________________________

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.

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:

Observação: Essa opção deixa de existir a partir da versão 12.1.2406, vai se aplicado o host padrão na configuração do IIS.  

Image Added

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.

{
	"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/pageSize: Número de itens da paginação.

____________________________________________________________________________________________________________________________________________________________________________________________________

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)

Image Removed

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. Image Added

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).

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: "Pattern" inserir 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: "Pattern" inserir 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"
      
      

____________________________________________________________________________________________________________________________________________________________________________________________________

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.

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