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:
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.
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/
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)
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:
- Acessar o IIS -> Acessar o Portal do Fornecedor (FrameHTML | Web | App | Cmp | PortalDoFornecedor) Clicar no site Portal do professor-> URL Rewrite
- Dar um duplo click no ícone URL Rewrite e em seguida clicar em: Adicionar uma Rule do tipo Inboud Rule.
- Inserir as seguintes informações
- No campo "Name" informar um nome para a regra que está sendo criada
- Na opção: Match URL, no campo: "Pattern" inserir as informação: api/(.*)
- Na opção: "Actions", no campo: Rewrite URL informar o link: http://nome_da_maquina_do_host:porta/api/{R:1}
2ª Regra:
- Acessar o IIS -> Acessar o Portal do Fornecedor (FrameHTML | Web | App | Cmp | PortalDoFornecedor) Clicar no site Portal do professor-> URL Rewrite
- Dar um duplo click no ícone URL Rewrite e em seguida clicar em: Adicionar uma Rule do tipo Inboud Rule.
- Inserir as seguintes informações
- No campo "Name" informar um nome para a regra que está sendo criada
- Na opção: Match URL, no campo: "Pattern" inserir as informação: aliasname\.(.*)/api/(.*)
- Na opção: "Actions", no campo: Rewrite URL informar o link: http://{R:1}.nome_da_maquina_do_host:porta/api/{R:2}
- 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.
{ "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 "/"