Histórico da Página

...

Column

width	90%

Deck of Cards

id	Instalação

Card

default	true
id	Instalacao
label	Instalação

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

Nota

title	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

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

Image Added

5 - Conclua a instalação

Card

id	Configuracao_IIS
label	Configuração Obrigatória (IIS)

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.

Bloco de código

firstline	1
title	config.json
linenumbers	true

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

Aviso

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

____________________________________________________________________________________________________________________________________________________________________________________________________

Expandir

title	Validando comunicação IIS x Pasta instalação

Uma das melhores

forma

formas de testar a comunicação do IIS com a pasta é abrir o site logo após essas configurações

é abrir o site pelo

através da opção Procurar Site.

Image Removed

Se o site for aberto

sem nenhum erro

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

aba desse documento com nome

seção de Erros e Soluções.

Image Added

Erros e Soluções

Card

id	Configuracao_Rewrite
label	Configuração Opcional (Rewrite)

Aviso

title	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 Passo a passo:

Fazer o download do ARR no link Microsoft Application Request Routing (ARR).

Realizar a instalação dos componente acima https://www.microsoft.com/en-us/download/details.aspx?id=47333.
Fazer a instalação no mesmo servidor do Portal do Fornecedor e, ao final da instalação, deve ser habilitado

Habilitando o proxy do ARR conforme imagens abaixo:

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 Instale o URL Rewrite.
Após a instalação é necessário configurar a regra para o rewrite. Existem duas regras, a primeira é utilizada para direcionamento de api's 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).

Aviso

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

Segue a configuração das duas regras:

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

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

Aviso

title	Atenção

A porta utilizada deve ser a mesma que está configurada na chave "ApiPort" no arquivo de host (RM.Host.Service.exe.config, se utilizar o Host Service e RM.Host.exe.config, se utilizar o Host local). Ver a aba Configuração do Host.

Card

label

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.

Bloco de código

firstline	1
title	config.json
linenumbers	true

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

Aviso

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

Painel

borderWidth	0
borderStyle	solid

Column

width	560px

Image Added Voltar para o Menu Principal

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 42

Nova versão Atual

Chave