Deck of Cards |
---|
|
Card |
---|
default | true |
---|
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 extesão .msi |
|
...
...
Image Added |
|
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.
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 |
---|
| 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.
Image Added
5 - Finalizada a instalação, no IIS (Gerenciador do Serviço de Informações da Internet) terá sido criado a seguinte estrutura de Default Web Site. Image Added
Validação da instalação Para validar a instalação, dentro do IIS clique no procurar que a tela do Portal do Fornecedor deve ser aberta |
|
Deck of Cards |
---|
|
Card |
---|
default | true |
---|
label | Configuração do Host |
---|
| O RM.Host.config ou RM.Host.Service.Config devem estar configurados conforme a documentação de Pré-requisitos.
|
Card |
---|
| 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.
- 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.
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 |
---|
<configuration> <system.webServer> <staticContent> <remove fileExtension=".woff" /> <!-- In case IIS already has this mime type --> <mimeMap fileExtension=".woff" mimeType="application/x-font-woff" /> </staticContent> <rewrite> <rules> <rule name="Main Rule" stopProcessing="true"> <match url=".*" /> <conditions logicalGrouping="MatchAll"> <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" /> <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" /> </conditions> <action type="Rewrite" url="./" /> </rule> </rules> </rewrite> </system.webServer> </configuration> |
- Para testar abra o site pelo procurar site
|
Card |
---|
label | Configuração do IIS com Rewrite |
---|
| 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.
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 no mesmo servidor do Portal do Fornecedor e, ao final da instalação, deve ser habilitado o proxy do ARR conforme imagens abaixo:
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 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 |
---|
| 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
- 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"
Aviso |
---|
| 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. |
|
|
...