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

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:

É 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 há 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 projetos);
    • "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 projetos, 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 há essas configurações inseridas no arquivo inseri-las para que o sistema funcione corretamente.

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

Clicar em Primeiros Passos:

Selecionar o projeto google:

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:

Informar a Etapa 1 e continuar.

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

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.

Agora adicione a sua Chave da API em Serviços Globais | Ambiente | Parâmetros | Parâmetros Globais | Google | Google Maps

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

• A última configuração que deve ser feita para o correto funcionamento do Portal TOTVS Obras e Projetos é informar o valor correto desejado no arquivo config.json (C:\totvs\CorporeRM\FrameHTML\Web\App\Prj\PortalTopWeb\config\config.json).
• O arquivo não possui muitas informações mas deve se manter atento ao preenchimento para que ele funcione corretamente.
  • Após a instalação o arquivo estará preenchido conforme abaixo:

• "apiServer": endereço da API para ser acessado no Portal TOTVS Obras e Projetos.
  • 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;
  • O endereço localhost limita o acesso no portal somente para quem está na máquina localmente. Para acessos externos o endereço deve ser alterado para o nome completo do computador (Exemplo: http://bhn050102752.bh01.local:8051)

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

A URL de acesso do Portal TOTVS Obras e Projetos é http://localhost:8080/web/app/Prj/PortalTOPWeb/index.html. Ressaltando que, nessa URL informada, http://localhost:8080 é apenas um exemplo e caso há alteração para o nome completo do computador no arquivo config.json essa URL deverá ser alterada. (Exemplo: http://bhn050102752.bh01.local:8080/web/app/Prj/PortalTOPWeb/index.html) 

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

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 

• Mão de Obra

Localização do Funcionário

• Funcionários Ociosos: Os membros da equipe estão presentes mas com improdutividade.
• Funcionários Presentes: Todos os membros da equipe estão trabalhando.
• Total de Funcionários: Funcionários Presentes + Funcionários Ociosos
• Horas apontadas: Total de horas apontadas em todas as folhas.
• Horas improdutivas: Total de horas improdutivas em todas as folhas.
• Ver detalhes: abre a página de detalhes do monitor de mão-de-obra.

• Equipamentos:

• Status Geral 
  • Equipamentos em Operação: Todos os Equipamentos que estão operantes.
  • Equipamentos não Apontados: Todos os Equipamentos que não tiveram apontamentos até o momento.
  • Equipamentos Parados: Todos os Equipamentos que tiveram apontamentos no dia porém não existe apontamento em aberto no momento e não possui Motivo de Improdutividade.
  • Equipamentos Improdutivos: Todos os Equipamentos que possuem apontamentos em aberto e que se encontram com motivo de improdutividade.
  • Total de Equipamentos: Total de equipamentos associados ao Projeto.
  • Horas Apontadas: Total  de horas apontadas.
  • Horas Trabalhadas: Total de horas Trabalhadas.
  • Horas Improdutivas: Total de horas Improdutivas.

• Dashboard
  • Serão exibidos os dados agrupado por Família de Equipamentos
  • Em Operação: Total de Equipamentos da família que se encontra com apontamento em aberto e sem Motivo de improdutividade
  • Não Apontados: Total de  Equipamentos da família que não tiveram apontamentos até o momento.
  • Parados: Total de Equipamentos da família que ja tiveram apontamentos o dia porém no momento não possui nenhum apontamento em aberto e não possui Motivo de improdutividade.
  • De Terceiros: Total de Equipamentos da família que são de Terceiros;

• Improdutividade
• Motivos de improdutividade: Total de Improdutividades agrupados por prioridades Normal, Alta e Crítica

• Ver detalhes:
  
  • Ao clicar em ver detalhes será aberto uma nova tela com os detalhes de apontamentos dos equipamentos da família.
  • Para os Equipamentos que não sem apontamentos no dia será exibido a mensagem "Não possui agendamentos"
  • Para os Equipamentos com Motivos de inatividade o mesmo será exibido e abaixo as seguintes informações:
    • Descrição da tarefa
    • Dados de Entrada e Saída do apontamento
    • Usuário
    • Centro de Custo
    • Observações do apontamento

• No Dashboard teremos duas formas de realizar buscas
  • Busca Simples: Esta busca será realizada no campo "Pesquisar por Descrição", e irá retornar as famílias que contiver o termo informado no campo
  • Busca Avançada: Esta estão definidos filtros por inatividade, por Prioridade e Apenas Famílias com equipamentos de terceiros

• Status/Alertas 
  • A exibição do Status/Alertas da família é realizada conforme descrito abaixo: 
  • Não Iniciado: Todos os Equipamento da família se encontram sem apontamentos até o momento
  • Conforme Esperado: Abaixo de 20% dos Equipamentos parados e/ou Improdutivos; 
  • Atenção: Percentual de 20% a 39% dos Equipamentos parados e/ou Improdutivos;
  • Crítico: Acima de 40% dos Equipamentos parados e/ou Improdutivos ou basta 1 Equipamento com Motivo de Improdutividade crítico;

• Localização dos Equipamentos
  • Localização geográfica dos Apontamentos realizados.

• Ciclo de Transporte:

• Nome do ciclo de transporte
• Iniciados: Total de cargas em aberto realizadas no ciclo de transporte
• Concluídos: Total de Ciclos concluídos (Carga e Descarga) realizados no ciclo

• Status
  
  • Os apontamentos concluídos (Carga e Descarga) será exibido na cor Verde
  • Os apontamentos que não possuem Descarga será exibido na cor Amarela 

• Ver Detalhes
  • Será exibido os detalhes dos apontamentos do ciclo
    • Carga: Data e hora em que foi realizado o apontamento inicial seguido do responsável pelo apontamento
    • Descarga: Data e hora em que foi realizado o apontamento inicial seguido do responsável pelo apontamento

• Observações
  • Observações da Carga/Descarga: Será exibido as observações informadas no momento do apontamento de Carga ou Descarga

• Mapa
  • No mapa serão exibidos as localizações dos apontamentos de Carga e Descarga

• Avanço Físico:
  • Últimas tarefas apontadas: Exibe a lista das 3 últimas tarefas apontadas na obra.
  • Ver detalhes: abre a página de detalhes do monitor de avanço físico.

Em detalhes do Apontamento é exibido as Tarefas onde foram realizadas os apontamentos, assim como o Percentual apontado. É exibido também a localização geográfica no mapa de onde foram feitos os apontamentos.

Ao selecionar uma ou mais das Tarefas, no mapa é exibidos somente os apontamentos referentes ao selecionado.

Nos detalhes das Tarefas é exibido:

• Código da Tarefa;
• Descrição da Tarefa;
• Unidade;
• Valor unitário;
• Quantidade;
• Valor total;
• Observações do apontamento;
• Fotos do Apontamento;

• Últimos acontecimentos: Mostra os últimos acontecimentos por avanço físico, mão-de-obra e equipamento.
• Coletores:
  • Número de coletores ativos na obra.
  • Número de coletores sem apontamento na última hora.
  • Informações dos coletores sem apontamento.

Observação: A página do monitor de obras será atualizada automaticamente de 30 em 30 segundos.