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
PHP Manager é o software gerenciador do PHP para o IIS. Acessehttps://github.com/phpmanager/phpmanager/releasesvá para a opção Downloads e escolha o arquivo que correto para a versão do seu sistema operacional (32 ou 64 bits)
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 pastaC:\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.
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 ouRM.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 porta8052, caso esta seja utilizada para outra finalidade o departamento de TI deverá informar outra porta para uso.
Importante: Após alterar as configurações de portas é necessário reiniciar o serviço do Host.
Card
label
Configuração do Portal
Para configurar o Portal para comissão 2.0 será necessário configurar os itens:
config.json
API REST TOTVS: URL
web.config
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 amesma portainformada naconfiguraçã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
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
Configurando web.config do Portal de Imóveis
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\ Segue o padrão do Web.config
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:
PHP Manager é o software gerenciador do PHP para o IIS. Acessehttps://github.com/phpmanager/phpmanager/releasesvá para a opção Downloads e selecione o arquivo correto para a versão do seu sistema operacional (32 ou 64 bits)
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.
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.
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:
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: "405 URL: /api/login".
Solução: Acesse o IIS e em seguida ao selecionar o diretório do Portal (clique no ícone Gerenciador do PHP)
Image Added
Neste momento selecione a promeira configuração para registrar o PHP, Image Added
Selecione o caminho para carregar o PHP.exe e em seguida clique em abrir; Image Added
Em seguida selecione a opção Verificar PHPINFO
Image Added
Será apresentado a menasgem informando que o PHP encontra-se corretamente configurado.
Image Added
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