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.
Aviso
title
Instalação em Bases Oracle
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
Notas
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
A conexão com o Portal de Imóveis está homologada para ser configurada utilizando apenas o protocolo http:
Card
label
Pré Requisitos Oracle
Aviso
title
Importante
Esta seção destina-se apenas aos clientes que utilizam base migrada do RM para utilização no Portal de Imóveis. Para clientes não migrados, ainda não é possível a utilização de banco de dados Oracle no portal.
Objetivo
Esta página tem como objetivo listar os pré-requisitos para o acesso ao Portal de Imóveis utilizando banco de dados Oracle.
Para clientes que utilizam banco de dados Oracle, será necessário realizar uma modificação no arquivo INI do PHP. Essa alteração permitirá que o servidor IIS liste os drivers OCI (Oracle Call Interface) do Oracle, permitindo a integração adequada com o banco de dados.
Para fazer essa alteração, siga os passos abaixo:
Localize o arquivo INI do PHP no seu servidor. Geralmente, ele está localizado na pasta de instalação do PHP ou em um subdiretório chamado "conf" ou "php.ini".
Abra o arquivo INI do PHP utilizando um editor de texto.
Procure a seção do arquivo INI relacionada à extensão OCI do Oracle. Pode ser chamada de "oci8" ou similar (são eles): extension=php_pdo_oci.dll extension=php_oci8.dll extension=php_oci8_12c.dll
Verifique se as linhas correspondentes ao driver OCI está comentada (iniciada com ponto e vírgula ";"). Se estiver, remova o ponto e vírgula para habilitar a extensão.
Certifique-se de que a configuração correta para o driver OCI esteja definida. Isso inclui informações como o caminho para a biblioteca do cliente Oracle (por exemplo, "oci.dll" ou "oci.so") e outros parâmetros relevantes.
Salve o arquivo INI modificado.
Para conferência, as linhas abaixo no arquivo .ini precisam estar habilitadas.
Bloco de código
language
php
extension=php_oci8.dll
extension=php_oci8_12c.dll
oci8.privileged_connect = Off
oci8.max_persistent = -1
oci8.persistent_timeout = -1
oci8.ping_interval = 60
oci8.connection_class =
oci8.events = Off
oci8.statement_cache_size = 20
oci8.default_prefetch = 100
oci8.old_oci_close_semantics = Off
Após realizar essas alterações, reinicie o servidor IIS para que as modificações tenham efeito. Agora, o IIS será capaz de listar e utilizar os drivers OCI do Oracle (conforme imagem abaixo), permitindo a integração adequada com o banco de dados Oracle.
Caso a extensão não esteja habilitada como mostra a imagem acima, recomendados que faça as seguintes conferências
Arquivos php_oci8_12c.dll e php_oci8.dll presentes no diretório ext da pasta do PHP.
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)
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 AcesseODBC Driver 17 for SQL Server,selecione o idioma do seu SQL Server. E marque o arquivo para download.
Durante a instalação do IIS, através do recurso "Ativar ou desativar recursos do Windows", recomendamos que a opção "Publicação WebDAV" seja desmarcada para evitar possíveis restrições na realização de chamadas PUT via API. Esse cuidado é especialmente importante para desenvolvedores que precisam alterar dados no portal por meio da API.
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 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
Passo 6 - ORACLE
Configurando o arquivo de configuração do PHP para listar drivers do ORACLE.
Para clientes que utilizam banco de dados Oracle, é necessário realizar uma modificação no arquivo INI do PHP. Essa alteração permitirá que o servidor IIS liste os drivers OCI (Oracle Call Interface) do Oracle, permitindo a integração adequada com o banco de dados.
Para fazer essa alteração, siga os passos abaixo:
Localize o arquivo INI do PHP no seu servidor. Geralmente, ele está localizado na pasta de instalação do PHP ou em um subdiretório chamado "conf" ou "php.ini".
Abra o arquivo INI do PHP utilizando um editor de texto.
Procure a seção do arquivo INI relacionada à extensão OCI do Oracle. Pode ser chamada de "oci8" ou similar (são eles): extension=php_pdo_oci.dll extension=php_oci8.dll extension=php_oci8_12c.dll
Verifique se a linha correspondente ao driver OCI está comentada (iniciada com ponto e vírgula ";"). Se estiver, remova o ponto e vírgula para descomentá-la.
Certifique-se de que a configuração correta para o driver OCI esteja definida. Isso inclui informações como o caminho para a biblioteca do cliente Oracle (por exemplo, "oci.dll" ou "oci.so") e outros parâmetros relevantes.
Salve o arquivo INI modificado.
Após realizar essas alterações, reinicie o servidor IIS para que as modificações tenham efeito. Agora, o IIS será capaz de listar e utilizar os drivers OCI do Oracle (conforme imagem abaixo), permitindo a integração adequada com o banco de dados Oracle.
Card
label
Configurando o 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, SQLServer ou Oracle
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 a 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)
Neste momento selecione a promeira configuração para registrar o PHP,
Selecione o caminho para carregar o PHP.exe e em seguida clique em abrir;
Em seguida selecione a opção Verificar PHPINFO
Será apresentado a menasgem informando que o PHP encontra-se corretamente configurado.
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
Expandir
title
Erro ao atualizar as páginas do módulo de Aluguel
Mensagem de erro:
Problema: Ao atualizar as páginas do módulo de Aluguel é apresentado a mensagem de erro: 404 - Arquivo ou diretório não encontrado O recurso que você está procurando pode ter sido removido, ter tido seu nome alterado ou estar temporariamente indisponível.
Solução: Acesse o diretório de instalação do Portal de Imóveis (C:\...\CorporeRM\FrameHTML\web\app\Imb\PVI) e verifique na raiz da pasta o arquivo Web.config. Caso o arquivo não exista, o mesmo deve ser criado. Abra o arquivo e informe a seguinte linha no atributo da principal regra:
<action type="Rewrite" url="/aluguel/" />
Exemplo:
Expandir
title
O processo FastCGI excedeu o tempo limite de atividade solicitado
Mensagem de erro:
Erro HTTP 500.0 - Internal Server Error C:\php\php-cgi.exe - O processo FastCGI excedeu o tempo limite de atividade solicitado
Problema:
Ao executar alguns processos dentro do portal e exceder o tempo de resposta do servidor. Como exemplo, o processo de sincronização ou impressão de relatórios.
Solução:
Acesse o IIS e em seguida selecione no servidor principal a opção de configuração de FastCGI
Ao acessar esta tela (ainda no IIS) marque o caminho de configuração do FastCGI e clique em Editar...
Observe que na tela em aberto existem algumas informações com valores já pré determinados na instalação nativa do IIS. Dentre estas opções altere o valor da propriedade "Tempo de Espera de Atividade" default 300 (esse valor padrão refere-se a segundos) dividindo o valor de tempo por 60 = 5 minutos. Este valor poderá ser definido pelo usuário. Uma vez alterado (clique em salvar).
Feito estes ajustes, selecione novamente o servidor principal e clique na opção para reiniciar os serviços do IIS;
Após realizar os ajustes via IIS, ainda deverá ser realizado outra parametrização, acessando no explorer o diretório onde encontra-se instalado o PHP. Uma vez acessando o diretório edite o arquivo de inicialização PHP.INI(OBS: Por padrão o arquivo é encontrado no diretório: $:\totvs\PHP) Com o arquivo editado localize a TAG "max_execution_time" (que possui o valor padrão 300) podendo ser aumentado de acordo com a necessidade do usuário, lembrando que este valor também refere-se a segundos.
Card
label
Migrar versão 3.7.X para superiores
Objetivo
Realizar a migração da versão 3.7.x para versões atualizadas acima da 12.1.x
Procedimentos:
Acesse o diretório de instalação do portal 3.7.x e copie as pastas: tmp e uploads;
Estas pastas (tmp e Uploads) deverão ser copiadas para o diretório onde o Portal de Imóveis encontra-se instalado no servidor, neste nosso exemplo, o portal encontra-se instalado em um diretório padrão de instalação: C:\totvs\CorporeRM\FrameHTML\web\app\Imb\PVI
Ao acessar o IIS será necessário parar o serviço do site da versão 3.7.x, mantendo iniciado somente o site da Versão 12.1.x que será o novo site que será parametrizado. Ao selecionar o novo site PVI (realize a configuração do PHP Manager para comunicaçao com esse novo portal).
PHP conectado com sucesso:
Quando selecionado o Site do PVI é necessário incluir a Permissão para o usuário IIS_IURS com as permissões totais para este usuário.
Validar a autenticação do usuário no Application pool, neste parametrização (Basic Settings) informar o usuário Administrador do IIS;
Realizar a instação do Conversor Word e Conversor PDF;
Acesse o diretório de instalação do Portal: C:\TOTVS\CorporeRM\FrameHTML\web\app\Imb\PVI\api (apague o arquivo: licença.lic). Em seguida acesse o Portal de Imóveis onde será necessário realizar as configurações conforme solicitadas na tela.
Neste momento deveremos definir o caminho público da URL dos webservices TOTVS que serão consumidos pelo Portal de Imóveis.