Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Deck of Cards
idInstalação
Card
defaulttrue
labelInstalaçã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

Nota
titleImportante

Recurso

...

disponível a partir da

...

release 12.1.34

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
titleInformaçõ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
idInstalação
Card
defaulttrue
labelConfiguração do Host

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




Card
labelConfiguraçã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.

  1. Instale o URL Rewrite.
  2. 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.

  3. Preencha os dados da seguinte forma:
    1. Alias: PortalDoFornecedor
    2. Caminho Físico: C:\TOTVS\CorporeRM\FrameHTML\Web\App\Cmp\PortalDoFornecedor\  (Caminho onde está o Portal)
    3. Selecione “Conectar como...”, marque “Usuário específico” e coloque as informações de um usuário adminitrador do computador.

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

  5. Para testar abra o site pelo procurar site

Card
labelConfiguraçã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
titleAtençã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:

  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: "Patterninserir 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: "Patterninserir 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
titleAtençã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.




...