Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Deck of Cards
idPortal



Card
labelInstalação
  • Na instalação da biblioteca do RM deve-se atentar a porta informada para o host para que seja utilizado nas configurações posteriores.

  • É obrigatório que esteja instalado o URL Rewrite como componente do IIS. Esse componente permite que a URL do site seja reescrita durante a navegação.

  • É importante verificar também em Tipos de MIME se o tipo de mime ".json" está inserido.

Observação: O cadastro do Tipo de MIME é necessário para que o IIS consiga ler os arquivos ".json" do Portal. A verificação é necessária pois caso o MIME não estiver cadastrado o portal pode apresentar erros na leitura dos arquivos.

Card
labelConfigurando IIS

Ao finalizar a instalação da Biblioteca do RM Portal, será criado um site no IIS com o nome FrameHTML. O site é criado e toda a comunicação do IIS acontece na pasta C:\TOTVS\CorporeRM\FrameHTML

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

  • Uma das melhores formas de se testar a comunicação do IIS com a pasta é abrir o site logo após essas configurações é abrir o site pelo Procurar Site:

  • Se o site for aberto sem nenhum erro é porque a comunicação entre a pasta e o IIS está corretamente configurada. Caso encontre algum erro nesse passo vá até a aba desse documento com nome Erros e Soluções.

Site aberto:

  • Com o site aberto navegue entre as pastas RM/Login/Login.aspx ou simplismente insira na URL do navegador dessa forma http://localhost:8080/RM/Login/Login.aspx. Ressaltando que, no caso a minha porta de comunicação do IIS é :8080 conforme exibido no IIS na etapa Procurar site. Caso a porta cadastrada no IIS seja diferente deve ser informada a porta  correta para realizar esse segundo teste de validação. Se a página de login aparecer com sucesso sem exibir nenhum erro é porque a comunicação do IIS com a pasta está correta.

Página de Login:

Card
labelConfiguração Web.config e Host

É de extrema importância que o arquivo Web.config (C:/TOTVS/CorporeRM/FrameHTML/Web.config) e a configuração do RM.Host ou RM.Host.Service (C:/TOTVS/CorporeRM/RM.Net) estejam corretamente preenchidos pois eles carregarão a informação da base de dados para o Portal. 

  • RM.Host ou RM.Host.Service (Não use os dois ao mesmo tempo e com a mesma porta para que não ocorra conflito de comunicação)
    • Antes de qualquer alteração, o Host deve estar desativado.
    • Os valores para "DefaultDb", "Port" e "ApiPort" deve estar informados corretamente:
      • "DefaultDB": é o nome do alias que será utilizado por default ao acessar o Portal RM. (Extremamente importante para acesso no Portal TOTVS Obras e projetosda Obra);
      • "Port": é a porta do host;
      • "ApiPort": é a porta onde será realizada a comunicação da API. (Extremamente importante para acesso no Portal Obras do TOTVS Obras e projetosda Obra, caso não exista essa tag no host o sistema utiliza o valor 8051 como default).

Lembrando que, as portas informadas para o host na chave Port e a porta informada na chave ApiPort deve estar permitidas no Firewall para que a comunicação funcione corretamente.

  • Web.config
    • Os valores para "Port", "Host" e "ServiceAlias" deve estar informados corretamente.:
      • "Port": o valor da porta informada é o valor da porta do Host, seja ele RM.Host ou RM.Host.Service;
      • "Host":  é o nome da máquina;
      • "ServiceAlias": é o nome do alias que será utilizado.

Caso não tenha essas configurações inseridas no arquivo, aconselhamos inseri-las para que o sistema funcione corretamente.

É possível armazenar a geolocalização dos apontamentos realizados pelos coletores móveis. Para isso é necessário informar a chave de identificação do Google Maps conforme demonstrado logo abaixo:

Acessar a plataforma de mapas do google : https://cloud.google.com/maps-platform/?hl=pt

Clicar em Primeiros Passos:

Image Removed

Selecionar o projeto google:

Image Removed

Caso não há nenhum projeto criado, ao clicar sobre a seta é possível inserir um novo projeto.

Ao avançar, será exibida a página para configurar o faturamento do Google Maps Plataform:

Image Removed

Informar a Etapa 1 e continuar.

Image Removed

Informar corretamente todos os dados na Etapa 2 e clicar em "INICIAR MINHA AVALIAÇÃO GRATUITA".

Image Removed

Ao avançar na Etapa 2, será exibida a ativação da Plataforma do Google Maps e clicando em "PRÓXIMA" será exibida a chave do Google Maps criada.

Image RemovedImage Removed

Agora adicione a sua Chave da API no respectivo campo do acelerador de implantação do App Minha Obra, caso esteja implantando, ou vá em Serviços Globais | Ambiente | Parâmetros | Parâmetros Globais | Google | Google Maps:

Image Removed     Image Removed

Caso seu ambiente possua proxy, preencha as configurações do proxy.

Card
labelParametrização do Mapa

Incluir Página
Parametrização de Mapas
Parametrização de Mapas

Card
labelConfiguração Portal da Obra
Card
labelConfiguração Monitor de Obras
  • A última configuração que deve ser feita para o correto funcionamento do Portal TOTVS Obras e Projetos da Obra é informar o valor correto desejado no arquivo nos arquivos config.json (C:\totvs\CorporeRM\FrameHTML\Web\App\Prj\PortalTopWeb\config\config.json) e (C:\totvs\CorporeRM\Bin\wwwroot\config\config.json).
  • O arquivo Os arquivos não possui possuem muitas informações mas deve é necessário se manter atento ao preenchimento para que ele funcione corretamenteo correto funcionamento do portal.
    • Após a instalação o arquivo estará preenchido conforme abaixo, onde destacamos um exemplo do IP e a porta da API:


Image RemovedImage Added


  • "apiServer": endereço da API para ser acessado no Portal TOTVS Obras e Projetosda Obra.
    • Devem ser informados os valores corretamente;
    • A porta da API deve estar preenchida com a mesma porta informada na configuração do Host:  "ApiPort". Se a tag estiver com valor 8052 a porta deve ser alterada (conforme destacado na aba Configuração Web.config e Host;
    • O endereço localhost limita o acesso no portal somente para quem está na máquina localmenteambiente de desenvolvimento. Para acessos externos o endereço deve ser alterado para o nome completo do computador (Exemplo: http://bhn050102752.bh01.local:8051) onde BHN050102752 é o nome da máquina, ou o IP, como exemplo da imagem anterior.

  • "apiKeyGoogleMaps": chave gerada pelo google maps para que as localizações dos apontamentos provenientes do TOP Mobile sejam visualizadas no Portal TOTVS Obras e Projetosno Porta da Obra.


Card
labelAcessando o Monitor de ObrasPortal da Obra

A URL de acesso do Portal TOTVS Obras e Projetos é da Obra é http://localhost:8080/web/app/Prj/PortalTOPWeb/index.html se estiver configurado pelo IIS. Ressaltando que, nessa URL informada,  http://localhost:8080 é é apenas um exemplo e caso há é necessário a alteração para o nome completo do computador ou IP no arquivo arquivo config.json essa (Conforme destacado na aba "Configuração Portal da Obra") e essa URL deverá ser alterada também de acordo com a definição desse arquivo. (Exemplo:   http://bhn050102752.bh01.local:8080/web/app/Prj/PortalTOPWeb/index.html) 

Pelo host a URL segue o exemplo http://bhn019401325:8051/portalTopWEb/login:


Image AddedImage Removed


  • A base que estiver informada no alias cujo o valor está informado no "DefaultDB" será a base acessada no login.
  • O usuário para login deve ser o usuário de login no RM.

Image Modified


Card
labelErros e Soluções
  1. Um dos primeiros erros que podem acontecer no teste da comunicação do IIS é relacionado a configuração "directoryBrowse". Em alguns casos ele está definido como "false" e o Portal necessita que a configuração esteja "true".

1.1. Para realizar o ajuste é necessário entrar no editor de configurações e alterar o "directoryBrowse" para true e aplicá-la

2. Erro 403 - Forbidden: Acess is denied

2.1. Esse erro na maioria das vezes pode acontecer pois a configuração de Autenticação Anônima do IIS está incorreta. Para alterar deve-se acessar a Autenticação → Selecionar a Autenticação Anônima com um clique → Editar → Informar a Identidade de usuário anônimo: Identidade de pool de aplicativos

3. Erro por ausência do arquivo ou ausência de informação no arquivo Alias.dat (C:/TOVS/CorporeRM/RM.Net/Alias.dat)

3.1. Para corrigir esse erro o arquivo deve existir na pasta. Esse erro não é tão comum de acontecer quando se instala a Biblioteca RM e em seguida o Portal, pois na instalação da Biblioteca RM já se informa uma base de dados e automaticamente essa base será preenchida no arquivo Alias.dat