Histórico da Página

Deck of Cards

id	Portal

Card

label	Instalação

Objetivo

Esta página tem como objetivo de aproximar o usuário ao conhecimento do processo instalação e configuração do Portal de Imóveis.

Procedimentos para Instalação do Portal de Imóveis

Para clientes novos o Portal de Imóveis deverá ser instalado através do instalador RM Portais (extensão MSI).

No video abaixo, demonstra a instalação dos itens:

PHP Manager
Instalação do Portal de Imóveis

Multimedia

name	Instalando portal de imóveis.mp4
autostart	true

Painel

titleColor	#FF9000
title	Nota

Finalizando o processo de instalação, se você manteve a pasta padrão de instalação o caminho onde os arquivos do Portal de Imóveis foram instalados será: C:\TOTVS\CorporeRM\FrameHTML\Web\App\Imb\PVI

Card

label	Configurando IIS

Objetivo

Esta página tem como objetivo descrever o processo de configuração do Portal de Imóveis utilizando IIS

Para configurar, siga os passos abaixo:

Deck of Cards

id	Etapas do Wizard

Card

label	Passo 1

Pré-requisitos e instalações do IIS
URLRewrite O URLrewrite é uma extensão para o IIS, que provê poderosos controles sobre as URL´s e facilitando a administração e busca de sites. Acesse o endereço http://www.iis.net/downloads/microsoft/url-rewrite#additionalDownloads e baixe a versão correspondente ao seu sistema operacional.
PHP Manager PHP Manager é o software gerenciador do PHP para o IIS. Acesse https://github.com/phpmanager/phpmanager/releases vá para a opção Downloads e escolha o arquivo que correto para a versão do seu sistema operacional (32 ou 64 bits)
Microsoft® ODBC Driver 17 for SQL Server Driver SQL 17 para conexão com banco de dados. Faça o download no link da Microsoft Acesse https://www.microsoft.com/en-us/download/details.aspx?id=56567 Selecione o idioma do seu SQL Server. E marque o arquivo para download.
Microsoft Visual C++ Redistributable Microsoft Visual C++ Redistributable, baixe a versão mais recente do microsoft visual c++ Acesse https://support.microsoft.com/pt-br/topic/os-downloads-do-visual-c-mais-recentes-com-suporte-2647da03-1eea-4433-9aff-95f26a218cc0 Baixe a versão de acordo com o seu sistema operacional.

Card

label	Passo 2

Configurando o Portal de Imóveis no IIS

Ao finalizar a instalação da Biblioteca do RM Portal, será criado um site no IIS com o nome PVI. O site é criado e toda a comunicação do IIS acontece na pasta C:\TOTVS\CorporeRM\FrameHTML\web\app\Imb\PVI caminho que foi definido durante o processo de instalação do Portal de Imóveis

Card

label	Passo 3

Alterando o Application Pool

Acesse o IIS (Internet Information Service - pode digitar INETMGR na pesquisa de programas do windows)

Expanda "Application Pools", selecione "Corpore.Net", clique "Advanced Settings" e altere "Load User Profile (carregar perfil do usuário)" para "True (verdadeiro)". Clique Ok para salvar.
Nota: Apesar de estar mostrando .Net 4.0 na configuração, é indiferente usar .Net 2.0 ou 4.0.

Ainda em Aplication Pools, devemos colocar o usuário administrador da máquina ou administrador do domínio no campo Modelo de Processo -> Identidade. Será exigido nome do usuário e senha.

Card

label	Passo 4

Permissão da pasta ao IIS

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 o controle total para o IIS: NOMEDAMAQUINA\IIS_IUSRS.
Acesse a pasta da instalação do portal, C:\TOTVS\CorporeRM\FrameHTML\Web\App\Imb\PVI

Card

label	Passo 5

Testando a comunicação do IIS

Uma das formas de se testar a comunicação do IIS é abrir o site clicando em Procurar Site:

Card

label	Configurando Portal de Imóveis

Objetivo

Esta página tem como objetivo de configurar o Portal de Imóveis.

A partir da versão 12.1.33, o wizard de instalação do Portal de Imóveis foi modificado, simplificando a instalação do portal e a configuração dos bancos de dados e webservices RM.

Deck of Cards

id	Etapas do Wizard

Card

label	Passo 1

Sobre o instalador

Esta etapa é apenas uma introdução que resume os procedimentos que deverão ser executados

Card

label	Passo 2

Conexão com WebService TOTVS

Neste momento deveremos definir o caminho público da URL dos webservices TOTVS que serão consumidos pelo Portal de Imóveis.

Informe a URL do WebService TOTVS: Endereço do webservice. Exemplo: http://url:porta/wsDataServerPVI/MEX?wsdl
Usuário: Usuário de acesso ao webservice;
Senha: Senha do usuário

Card

label	Passo 3

Caminho do banco de dados

Nesta etapa iremos configurar os dados do banco onde o Portal de Vendas de Imóveis será instalado

DBMS: MySql ou SQLServer;
Servidor: Selecionar o IP ou IP/Instância;
Porta: Usar a padrão do DBMS ou a definida no DBMS;
Nome do Banco de Dados: Por padrão o nome do banco de dados default é o Portal de Imóveis podendo ser alterado;
Usuário do Banco do Portal de Imóveis: Usuário de acesso do banco de dados;
Senha do Banco do Portal de Imóveis: Senha de acesso do usuário.

Card

label	Passo 4

Instalação concluída

Nesta etapa será apenas um informativo com as configurações de login para o primeiro acesso no Portal de Imóveis.

Card

label	Configurando Comissão 2.0

Objetivo

Esta página tem como objetivo de orientar a configuração da Comissão 2.0 dentro do portal de imóveis.

A comissão 2.0 está sendo construída utilizando o PO UI Biblioteca de componentes baseado em Angular e é hospedado de forma nativa no RM.Host, neste documento vamos abordar os procedimentos necessários para a configuração.

Informações

title	Informação!

A comissão 2.0 está disponível para versão TOTVS RM Portal - 12.1.2205 apenas para cliente piloto.

Deck of Cards

id	Configuracoes

Card

default	true
label	Configuração do Host

Para o correto funcionamento da comissão 2.0 dentro do Portal de imóveis, é necessário que o Host seja iniciado com privilégios de administrador e que o RM.Host.config ou RM.Host.Service.Config esteja devidamente configurado, pois o mesmo terá informações necessárias para o consumo de serviços do Portal.

Execução do Host como Administrador:

Caso o Host seja iniciado como aplicativo (RM.Host.exe), certifique-se que ao executá-lo, tenha selecionado a opção "Executar como Administrador".
Caso o Host tenha sido instalado como serviço, o usuário vinculado ao serviço deve ser um administrador do sistema. Esta configuração pode ser feita por meio dos serviços do Windows, informando um usuário específico ou utilizar a conta local do sistema, conforme imagem abaixo:

Arquivos de configuração do Host.

Para incluir/editar as portas pelo arquivo de configuração, acesse o diretório C:\totvs\CorporeRM\RM.Net, e edite os arquivos RM.Host.exe.config ou RM.Host.Service.exe.config.

Inclua/edite as tags abaixo, em ambos os arquivos, dentro do escopo das tags appSettings:

<add key="ApiPort" value="8052" /> Porta onde será realizada a comunicação da API
<add key="HttpPort" value="8051" />
<add key="DefaultDb" value="CorporeRM"/> Nome do alias que será utilizado por default ao acessar o Portal RM

Obs.: Neste exemplo utilizamos a porta 8052, caso esta seja utilizada para outra finalidade o departamento de TI deverá informar outra porta para uso.

Exemplo:

RM.Host.exe.config

RM.Host.Service.exe.config

Bloco de código

language	xml
theme	Eclipse

<?xml version="1.0" encoding="utf-8"?>
<configuration>
 <appSettings>
  <add key="JobServer3Camadas" value="false" />
  <add key="DefaultDB" value="CorporeRM" /> 
  <add key="Port" value="8050" />
  <add key="HTTPPort" value="8051" />
  <add key="ApiPort" value="8052" /> 
  <add key="Host" value="BHN050103554" />
  <add key="ActionsPath" 
       value="C:\RM\Legado\12.1.2205\Bin;
       C:\RM\Legado\12.1.2205\Corpore.Net\Bin" />
  <add key="LibPath" value="C:\RM\Legado\12.1.2205\Bin" />
  <add key="EnableDynamicLocalization" value="false" />
  <add key="EnableCompression" value="false" />
  <add key="LocalizationLanguage" value="pt-BR" />
 </appSettings>
 <runtime>
   <generatePublisherEvidence enabled="false" />
   <loadFromRemoteSources enabled="false" />
 </runtime>
</configuration>

Bloco de código

language	xml
theme	Eclipse

<?xml version="1.0" encoding="utf-8"?>
<configuration>
 <appSettings>
  <add key="JobServer3Camadas" value="false" />
  <add key="DefaultDB" value="CorporeRM" />
  <add key="Port" value="8050" />
  <add key="HTTPPort" value="8051" />
  <add key="ApiPort" value="8052" />
  
  <add key="ActionsPath" 
       value="C:\totvs\CorporeRM\RM.Net;
       C:\totvs\CorporeRM\Corpore.Net\Bin" />
  <add key="LibPath" value="C:\totvs\CorporeRM\RM.Net" />
  <add key="EnableDynamicLocalization" value="false" />
  <add key="LocalizationLanguage" value="pt-BR" />
 </appSettings>
 <runtime>     
  <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.6" />
  <gcServer enabled="true" />
  <generatePublisherEvidence enabled="false" />  </runtime>
</configuration>

Importante: Após alterar as configurações de portas é necessário reiniciar o serviço do Host.

Card

label	Configuração do Portal

Deck of Cards

id	Etapas do Wizard

Card

label	Passo 1

Configurando config.json do Portal que acessa o Serviço de API do Host

No diretório de instalação da biblioteca RM "C:\TOTVS\CorporeRM\RM.Net\wwwroot\config\" abra o arquivo de configuração do Portal "config.json". Nele serão possíveis de se efetuar as seguintes configurações:

Bloco de código

firstline	1
title	config.json
linenumbers	true

{
	"apiServer": "http://BHN050103554:8052/",
}

"apiServer": endereço da API do serviço do Host do RM

A porta da API deve estar preenchida com a mesma porta informada na configuração do Host: "ApiPort".
O endereço localhost limita o acesso no portal somente para ambiente de desenvolvimento. Para acessos externos o endereço deve ser alterado para o nome completo do computador (Exemplo: http://BHN050103554.bh01.local:8052) onde BHN050103554 é o nome da máquina, ou o IP, como exemplo da imagem anterior.

Informações

title	Importante

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

Card

label	Passo 2

Configurando parametro: API REST TOTVS: URL no Portal

Acesse o Portal de Imóveis - Backend - Parâmetros - TOTVS

Image Added

API REST TOTVS: URL
URL base para acessar as APIS da TOTVS

Informações

title	Importante

A porta será informada na TAG: ApiPort do arquivo de configuração do Host:
Exemplo: <add key="ApiPort" value="8052" />

Card

label	Passo 3

Card

label	Passo 4

Card

label	links úteis

Objetivo

Esta página tem como objetivo de armazenas os links dos pacote adicionais necessário para instalação Portal de Imóveis.

URLRewrite

O URLrewrite é uma extensão para o IIS, que provê poderosos controles sobre as URL´s e facilitando a administração e busca de sites.
Acesse o endereço http://www.iis.net/downloads/microsoft/url-rewrite#additionalDownloads e baixe a versão correspondente ao seu sistema operacional.

PHP Manager

PHP Manager é o software gerenciador do PHP para o IIS.
Acesse https://github.com/phpmanager/phpmanager/releases vá para a opção Downloads e escolha o arquivo que correto para a versão do seu sistema operacional (32 ou 64 bits)

Microsoft® ODBC Driver 17 for SQL Server

Driver SQL 17 para conexão com banco de dados. Faça o download no link da Microsoft
Acesse https://www.microsoft.com/en-us/download/details.aspx?id=56567 Selecione o idioma do seu SQL Server. E marque o arquivo para download.

Microsoft Visual C++ Redistributable

Microsoft Visual C++ Redistributable, baixe a versão mais recente do microsoft visual c++
Acesse https://support.microsoft.com/pt-br/topic/os-downloads-do-visual-c-mais-recentes-com-suporte-2647da03-1eea-4433-9aff-95f26a218cc0 Baixe a versão de acordo com o seu sistema operacional.

Card

label	Erros e soluções

Objetivo

Este documento visa listar alguns erros que podem ser encontrados durante a instalação, configuração do portal, bem como suas possíveis soluções.

Aviso

title	Importante

Antes de analisar os itens de erros e soluções, convido você executar o “ambiente-check” do portal de imóvel, cujo seu propósito é realizar checagem de ambiente, permitindo avaliar possíveis inconsistência.

Para acessar, basta informar ao seu endereço do portal /ambiente-check.php
Exemplo: http://localhost:2205/ambiente-check.php

Lista erros e soluções:

Expandir

title	404 Not Found

Mensagem de erro:

Problema:
Ao tentar logar no portal, é apresentado mensagem de erro:
Desculpe, não foi possível processar sua solicitação neste momento.
Se necessário, entre em contato com a equipe de TI ou administrador do sistema. Status: "404 Not Found".
URL: ./api/login

Solução:
Certifique a existência do arquivo web.config em seu ambiente de instalação do portal.
Geralmente, é adotado o caminho fisico, (C:\TOTVS\CorporeRM\FrameHTML\Web\App\Imb\PVI\API\ mas isso não é uma regra.

Segue o padrão do Web.config

Bloco de código

language	xml
theme	Eclipse
title	Web.config

<configuration>
<system.webServer>
    <rewrite>
        <rules>
          <rule name="ignore-ui" stopProcessing="true">
            <match url="^ui" />
            <action type="None" />
          </rule>
          <rule name="ignore-ui-json" stopProcessing="true">
            <match url="^pvi-openapi.json" />
            <action type="None" />
          </rule>
          <rule name="slim catch all" enabled="true">
              <match url=".*" />
              <action type="Rewrite" url="index.php" />
              <conditions>
                  <add input="{URL}" pattern="sync*" negate="true" />
              </conditions>
          </rule>
        </rules>
    </rewrite>
    <httpProtocol>
    <customHeaders>
      <add name="Access-Control-Allow-Origin" value="*" />
      <add name="Access-Control-Allow-Headers" value="*" />
    </customHeaders>
  </httpProtocol>
</system.webServer>
</configuration>

Painel

titleColor	#FF9000
title	Notas

Vale lembrar que, por padrão o compartilhamento de recursos com origens diferentes (CORS) vai liberado.
Caso seja necessário bloquear algumas destas configurações, o Web.config do portal de imóveis na pasta /PVI/api, deverá ser alterado. as tag's responsáveis são:

Bloco de código

language	xml
theme	Eclipse
title	Cors

<httpProtocol>
    <customHeaders>
      <add name="Access-Control-Allow-Origin" value="*" />
      <add name="Access-Control-Allow-Headers" value="*" />
    </customHeaders>
  </httpProtocol>

Expandir

title	SOAP-ERROR: Parsing Schema: can't import schema from

Mensagem de erro:

Problema:
Neste momento deveremos informar o caminho público da URL dos webservices TOTVS que serão consumidos pelo Portal de Imóveis.
Informe a URL do WebService TOTVS: Endereço do webservice. Exemplo: http://url:porta/wsDataServerPVI/MEX?wsdl
Usuário: Usuário de acesso ao webservice; Senha: Senha do usuário
Ao clicar em conectar, deparamos com a mensagem Erro retornado pelo TOTVS: SOAP-ERROR: Parsing Schema: can't import schema from 'http://url:porta/wsDataServerPVI/mex?xsd=xsd0'
Solução:
Para expor os WebServices para acesso externo, torna-se necessária a inclusão da tag ServicesHostName, onde seu valor deverá ser o DNS ou IP Público da instituição.
É provável que essa Tag no HOST do serviço RM esteja inconsistente.
<add key="ServicesHostName" value="DNS da instituição" />

Expandir

title	Function is not a valid method for this service

Mensagem de erro:

Problema:
Ao tentar tentar ativar /inativar o empreendimento é apresentado mensagem de erro:
Function
("SincronizaAtivacaoEmpreendimentoPortalDeImoveis") is not a valid method for this service
Solução:
Certifique a a informação do parâmetro WebService TOTVS: URL.
Esse parâmetro, você o encontra no portal de imovel>> Parâmetros - TOTVS >> WebService TOTVS: URLO dataserver utilizado deve ser o dataserverPVI, sendo assim o método SincronizaAtivacaoEmpreendimentoPortalDeImoveis será encontrado.
Exemplo do caminho WebService TOTVS

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 65

Nova versão 66

Chave

Pré-requisitos e instalações do IIS

URLRewrite

PHP Manager

Microsoft® ODBC Driver 17 for SQL Server

Microsoft Visual C++ Redistributable

Configurando o Portal de Imóveis no IIS

Alterando o Application Pool

Permissão da pasta ao IIS

Testando a comunicação do IIS

Configurando config.json do Portal que acessa o Serviço de API do Host

No diretório de instalação da biblioteca RM "C:\TOTVS\CorporeRM\RM.Net\wwwroot\config\" abra o arquivo de configuração do Portal "config.json". Nele serão possíveis de se efetuar as seguintes configurações:

Configurando parametro: API REST TOTVS: URL no Portal

URLRewrite

PHP Manager

Microsoft® ODBC Driver 17 for SQL Server

Microsoft Visual C++ Redistributable

Atalhos

Páginas filhas

Histórico da Página

Versões comparadas

Versão antiga 65

Nova versão 66

Chave

Pré-requisitos e instalações do IIS

URLRewrite

PHP Manager

Microsoft® ODBC Driver 17 for SQL Server

Microsoft Visual C++ Redistributable

Configurando o Portal de Imóveis no IIS

Alterando o Application Pool

Permissão da pasta ao IIS

Testando a comunicação do IIS

Configurando config.json do Portal que acessa o Serviço de API do HostNo diretório de instalação da biblioteca RM "C:\TOTVS\CorporeRM\RM.Net\wwwroot\config\" abra o arquivo de configuração do Portal "config.json". Nele serão possíveis de se efetuar as seguintes configurações:

Configurando parametro: API REST TOTVS: URL no Portal

URLRewrite

PHP Manager

Microsoft® ODBC Driver 17 for SQL Server

Microsoft Visual C++ Redistributable

Configurando config.json do Portal que acessa o Serviço de API do Host

No diretório de instalação da biblioteca RM "C:\TOTVS\CorporeRM\RM.Net\wwwroot\config\" abra o arquivo de configuração do Portal "config.json". Nele serão possíveis de se efetuar as seguintes configurações: