Histórico da Página

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

Ao informar a tarefa no campo de pesquisa é exibida uma tela com o resultado:

Nome da tarefa: Nome da tarefa pesquisada (caso a opção selecionada for insumo será exibido o nome do mesmo).

Código da tarefa / Código do insumo

Status: Esse quadro informa em percentual o quanto a tarefa já está finalizada.

Custo: No quadro custo é exibido uma barra percentual enfocando o valor que foi planejado para a tarefa e o valor que já foi apropriado para a mesma durante a execução do projeto.

Planejado: Valor orçado para a tarefa no seu planejamento (API busca quantidade valor )

Apropriado: Valor que já foi executado da tarefa

Saldo: Exibe quanto ainda tenho de saldo para realização da tarefa.

Pedido

No pedido o Cockpit reflete o resultado do que já foi pedido proporcionalmente ao que já foi de fato entregue.

Pedido: Total que foi pedido e apropriado na tarefa

Entregue: Total do que realmente foi entregue da tarefa.

O total entregue é calculado com base nos tipos de movimento de entrega/devolução informados por projeto, e será exibido de acordo com a parametrização do projeto selecionado no contexto do portal. Os movimentos gerados através de movimentos de devolução, são subtraídos do total dos movimentos de entrega.
 
Para definir os tipo de movimento de entrega/devolução, acesse os parâmetros do projeto, em Integração>Suprimentos/Faturamento>Movimentações Backoffice:

Valor Pago RM: Considera os movimentos que foram gerados no backoffice pelo TCOP , ou seja , que sejam de origem do Totvs Obras e Projetos. Busca apenas valor pago referente a pedido , pedido extra , contrato de fornecimento de material e pedido de faturamento direto.

Em caso de notas fiscais de faturamento direto (que tem contrato e projeto/tarefa informado) e entraram diretamente pelo nucleus, sem pedido de faturamento direto do Totvs Obras e Projetos , serão consideradas no valor pago.

Valor Pago Protheus : Considera os valores nas baixas dos títulos financeiros onde existem rateio de tarefa/projeto originados pelo pedido, extra e contratos . Lançamentos feitos manualmente não vão ser considerados pois não partem de origem Totvs Obras e projetos é considerado apenas como apropriação e não como valor pago. 

Para auxiliar na conferência dos números exibidos no cockpit foi disponibilizada, no módulo de projetos, a tela de Movimentações do Backoffice. 

Seu acesso é feito através do menu Executar:

Exibirá:

Insumos que estão ligados diretamente a tarefa (Insumos para contratação).

Insumos que fazem parte de uma composição vinculada a tarefa.

Insumos que fazem parte a uma composição auxiliar utilizada na composição ligada a tarefa.

Insumos não planejados mas que não foram consumidos na tarefa através de contrato extra e histograma.

(incluir imagem tarefa selecionada com seus respectivos insumos)

Image Added

O Cockpit permite também a busca de insumos , utilizando o mesmo padrão de pesquisa da tarefa .

Na lupa de pesquisa é possível filtrar qual insumo deseja ver o detalhamento no cockpit.

Ao informar o código do insumo ou descrição o cockpit carrega as informações do mesmo na tela.

Planejado: Valor orçado para a tarefa no seu planejamento (API busca quantidade valor )

Apropriado: Valor que já foi executado do insumo

Saldo: Exibe quanto ainda tenho de saldo para realizaçãodo insumo

Pedido

No pedido o Cockpit reflete o resultado do que já foi pedido proporcionalmente ao que já foi de fato entregue.

Pedido: Total que foi pedido e apropriado no insumo

Entregue: Total do que realmente foi entregue  do insumo

Saldo da quantidade e valor do insumo