Histórico da Página

Column

width	5%

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

O portal do fornecedor pode ser hospedado de forma nativa no RM.Host e também suporta ser hospedado no IIS, neste documento vamos abordar os procedimentos necessários para a instalação e configuração do “Portal do Fornecedor" através do Host e do IIS.

Image Added

Instalando o portal

1 - Inicie a instalação

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

Image Added

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.

Image Added

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.

Image Added

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

Image Added

Informando URL do serviço de API

No diretório de instalação do Portal C:

Deck of Cards

id	Instalação

O RM.Host.config ou RM.Host.Service.Config devem estar configurados conforme a documentação de Pré-requisitos.

Para testar abra o site pelo procurar site

Image Removed

Card

default	true
label	Configuração do Host

Card

label	Configuração do IIS

O instalador do Portal já faz a configuração inicial do IIS, mas caso você queira fazê-la manualmente ou entender mais sobre este processo, é só seguir os passos abaixo.

Instale o URL Rewrite.

Abra o IIS e dentro de: "[SEU COMPUTADOR] > Sites > Default Web Site" clique com o botão direito e vá na opção de adicionar uma nova aplicação.

Image Removed

Preencha os dados da seguinte forma:

Alias: PortalDoFornecedor

Caminho Físico: C:

\TOTVS\CorporeRM\FrameHTML\Web\App\Cmp\PortalDoFornecedor\

(Caminho onde está o Portal)

Selecione “Conectar como...”, marque “Usuário específico” e coloque as informações de um usuário adminitrador do computador.

Image Removed

Dentro da pasta onde se encontra o Portal (Correspondente ao caminho do passo 3.b. ) deverá ter um web.config da seguinte forma:

Web.config

Card

label	Configuração do IIS com Rewrite

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)

Image Added

Expandir

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

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.

Image Added

Card

id	Configuracao_Rewrite
label	Configuração Opcional (Rewrite)

Aviso

title	Importante

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 https://www.microsoft.com/en-us/download/details.aspx?id=47333.
Fazer a instalação

Microsoft Application Request Routing (ARR).

Realizar a instalação dos componente acima 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

Image Modified

Após a instalação é necessário configurar duas regras para o rewrite, onde

Configurando regras de 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

. Segue a configuração das duas regras:

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

1ª Regra:

Acessar o IIS -> Acessar o Portal do Fornecedor (FrameHTML | Web | App | Cmp | PortalDoFornecedor) Clicar no site Portal do professor-> URL Rewrite
Image Modified
Dar um duplo click no ícone URL Rewrite e em seguida clicar em: Adicionar uma Rule do tipo Inboud Rule.
Image Modified
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/(.*)
  Image Modified
3. Na opção: "Actions", no campo: Rewrite URL informar o link: http://nome_da_maquina_do_host:porta/api/{R:1}
  Image Modified

2ª Regra:

Acessar o IIS -> Acessar o Portal do Fornecedor (FrameHTML | Web | App | Cmp | PortalDoFornecedor) Clicar no site Portal do professor-> URL Rewrite
Image Modified
Dar um duplo click no ícone URL Rewrite e em seguida clicar em: Adicionar uma Rule do tipo Inboud Rule.
Image Modified
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/(.*)
  Image Modified
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"
  Image Modified

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.A ordem das regras deve ser respeitada.

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 33

Nova versão Atual

Chave