Portal de Imóveis - Instalação e configuração

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

  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>
  
  

  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:
    

    Cors

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

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

Mensagem de erro:

• Problema:
  Ao informar o caminho público da URL dos webservices TOTVS que serão consumidos pelo Portal de Imóveis. (usuário e senha) ao clicar em "Conectar" o sistema apresenta a mensagem:
  Ocorreu uma exceção no sistema: Erro retornado pelo TOTVS: Unauthorized
  DataServer: ReadView
  Parâmetros
  Array
  (
      [DataServerName] => ImbStatusLicencasTodosAppsData
      [Filtro] => 1=1
      [Contexto] => CODCOLIGADA=0;CODUSUARIO=mestre
  )
  
  
  
• Solução:
  Será necessário avaliar se o nome do Alias informado nas configurações do RM possui um espaço no campo. Veja este exemplo abaixo:
  
  
• Após salvar, reinincie novamente os serviços do RM.Host e valide novamente o acesso ao Portal de Imóveis.
• Dica 2: Apague os aliases existentes e inclua um novo (tomando cuidado para não deixar espaço no campo nome do Alias).
• Dica 3: Validar se o arquivo CONFIG Host possui as TAG´s abaixo: (caso não tenha, após adiciona-las, será necessário parar o serviço do RM.Host e inicia-lo novamente).
      <add key="Port" value="8050" />
      <add key="Host" value="nome do servidor" />
      <add key="HttpPort" value="8051" />
      <add key="ApiPort" value="8051" />
      <add key="DefaultDb" value="CorporeRM"/>

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

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
  
  

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:

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.

Mensagem de erro:
Não há licença disponível para continuar acessando o sistema. Favor entrar em contato com o suporte.

• Problema:
  

Ao informar o WebServices e em seguida clicar em conectar, o sistema apresenta falha de licenças.

• Possível solução:
  

 Acesse o RM e em perfis, selecione o sistema: Gestão de Imóveis e em seguida edite o perfil associado ao usuário que está realizando a conexão com o Webservices, habilitando a opção: Acesso Irrestrito aos Dados dos Web Services.

Após salvar, acese novamente o configurador do Portal de imóveis e ao realizar o mesmo processo (informando o WebServices) o sistema possibilitará conectar sem apresentar falhas de Licença.
Observação: é importante lembrar que a COLIGADA da base de dados deve ter a devida autorização para acessar as licenças necessárias a fim de utilizar os utilitários para realizar os processos de conversão.

Conforme demonstrado na arquitetura o Portal de Imóveis usa a estrutura de WebServices da TOTVS para troca de informações e para que este processo funcione é necessário parametrizar alguns dados no TOTVS RM e no Portal de Imóveis.

Parametrização no TOTVS RM

Para realizar o sincronismo dos dados entre Portal de Imóveis e RM devemos habilitar os WebServices conforme documentação do link a seguir:

Como Expor os Web Services do RM através do Host

Ainda no RM devemos agora habilitar as actions usadas no processo de comunicação de dados, para isto vamos seguir os passos abaixo:

1. Iniciamos o processo com a atualização das actions do sistema. Para isto devemos acessar o menu de "Serviços Globais" e depois selecionar "Actions do Sistema";
   
   
2. Ao abrir a tela de actions, selecione o menu de "Processos" e selecione "Atualização de Actions Cadastradas";
   
   
   
   
3. Ainda no menu de "Serviços Globais", acesse a opção de "Servidores de Aplicação" e no menu "Processos" selecione "Carregar dados de descrição dos serviços". Este procedimento pode demorar até 5 minutos, favor acompanhar a janela de mensagens no rodapé do TOTVS;
   
   
   
   
4. Feito este processo podemos chamar a URL do portal de vendas – Portal de Imóveis acessar a opção backend > Sincronizar. Ao clicar nesta opção, caso haja alguma action para ser parametrizada o sistema informará o nome destas. Estes serão os nomes usados nas etapas seguintes do processo de parametrização das actions; 
   
   
   
   
5. Se ao tentar sincronizar o Portal de Imóveis com o RM apareceu a tela acima com os nomes das actions que necessitam parametrização, então acesse novamente o RM em Serviços Globais > Servidores de Aplicação. Clique no botão para adicionar um novo registro e ao abrir a tela de inclusão, clique no botão para listar os ID´s dos servers cadastrados. Ao abrir a janela de pesquisa, digite no campo descrição o nome de uma das actions listadas na tela do Portal de Imóveis (vide nomes no quadro vermelho). Selecione o registro que aparecer com esta descrição e tecle OK;
   
   
6. Na tela de cadastro, coloque o valor "-1" no campo "Número máximo de registros" e clique em Salvar;
   
   
7. Repita este processo a partir da etapa 5 enquanto houverem nomes na janela vermelha da tela de sincronismo do Portal de Imóveis.
   
   Saiba mais acessando: Sincronizando o Portal de Imóveis com o TCGI