Requisitos Mínimos
Informações |
---|
Para que o aplicativo possa se comunicar com o TOTVS Construção Obras e Projetos, são necessárias algumas configurações e também o cadastramento das informações que serão enviadas para o coletor. O tráfego de informações acontece via serviços REST que são acionados a partir do coletor móvel e para que os mesmos estejam disponíveis, é necessário ativar o WebService para que o sincronismo ocorra com sucesso. É importante se atentar as informações abaixo pois o app só funcionará se estiver atendendo as essas minimas especificações. - Android:
- Android 6.0 e superior
- Memória 2 GB
- Wi-Fi
GPS - Câmera 5.0 Mpixels
- Processador 1.5 GHz Quad Core
- Tela 5.0"
- Resolução Mínima 480 X 854
O App Minha Obra também pode ser utilizado com os seguintes pacotes: - TOP + BackOffice RM;
- TOP + BackoOffice RM + SIGAMNT (PROTHEUS);
- TOP + BackoOffice PROTHEUS;
- TOP + BackoOffice PROTHEUS + SIGAMNT (PROTHEUS)
|
Passo a passo de configuração Antes de inciar a sua configuração oficial você pode acessar a utilização de uma versão demontração onde informações fictícias são inseridas no banco de dados do aplicativo. 1 - Download Aplicativo: https://play.google.com/store/apps/details?id=com.totvs.topmobile 2 - Configuração Manual | 3 - Versão Lite ( Demonstração ) |
---|
| |
Para realizar a configuração oficial é importante seguir todos esses passos abaixo: 1 - Utilize o Acelerador de implantação 2 - Instale o app Minha Obra 3 - Login - Acessando o app Minha Obra 4 - Informações do app Minha Obra 5 - Cadastros básicos 6 - Funcionalidades
1 - Utilize o Acelerador de implantação Esta funcionalidade do TOTVS Construção Obras e Projetos está disponível a partir da versão 12.1.32 e possibilita que a configuração do ambiente de Integração com app Minha Obra seja realizado de forma simples e rápida. Para acessar basta navegar através do menu principal: Aba Projetos/Grupo Parâmetros/Aceleradores de Implantação/Aceleradores de Implantação Minha Obra:
![](https://tdn.totvs.com/download/attachments/603105707/image2021-3-26_11-49-34.png?version=1&modificationDate=1616770174627&api=v2)
Mas antes, é necessário conceder permissão de acesso ao usuário:
![](https://tdn.totvs.com/download/attachments/603105707/image2021-3-26_11-47-43.png?version=1&modificationDate=1616770063233&api=v2) ![](https://tdn.totvs.com/download/attachments/603105707/image2021-3-26_11-48-28.png?version=1&modificationDate=1616770108343&api=v2)
Após dada permissão, o usuário deverá acessar o projeto por onde deseja começar, pois o assistente usa o projeto do contexto para configuração:
![](https://tdn.totvs.com/download/attachments/603105707/image2021-3-26_11-45-22.png?version=1&modificationDate=1616769922383&api=v2)
Iniciando a implantação do App Minha Obra Será exibida a tela principal do wizard de implantação do App Minha Obra contendo algumas orientações:
![](/download/attachments/607612064/image2021-3-12_17-41-14.png?version=1&modificationDate=1636054913253&api=v2)
Na próxima etapa do wizard será possível escolher qual funcionalidade deseja configurar . Ao selecionar o checkbox "configurar" , iniciará os passos do wizard da opção selecionada. O link "Saiba Mais" direcionará para a documentação da funcionalidade caso queira consultá-la.
Exemplo: Selecionando a configuração da funcionalidade Avanço Físico o wizard direciona a página geral da documentação no tdn App Minha Obra (Para detalhes da funcionalidade selecionada nesse exemplo basta navegar no menu de opções : App Minha Obra\ Funcionalidade\ Avanço Físico )
Quando a funcionalidade já estiver configurada ela não aparecerá mais no wizard como opção para ser configurada.
Passo 1: Informe quais as funcionalidades deseja configurar:
![](/download/attachments/607612064/image2021-7-20_11-57-11.png?version=1&modificationDate=1636054913317&api=v2)
Passo 2: Após selecionar as funcionalidades que deseja configurar, o usuário será direcionado para a tela dos parâmetros gerais e globais conforme abaixo:
![](/download/attachments/607612064/image2021-3-18_17-42-26.png?version=1&modificationDate=1636054913347&api=v2)
Nesse momento o usuário implantador deve informar: - se utilizará mais de um projeto por coletor móvel (trata-se de um parâmetro geral e valerá para todos os projetos e coletores cadastrados);
- se utilizará mais de um coletor por usuário (também se trata de um parâmetro geral e assim como o primeiro, uma vez definido e cadastrado mais de um, não será permitido alterá-lo);
- e a chave de acesso para o Google Maps (opcional).
- Ao acessar o link de documentação "Porque utilizar essa chave e como ativa-la" navegue na opção "Parametrização do Mapa".
Passo 3: Na tela seguinte, deverá informar quais usuários terão acesso a quais funcionalidades no App:
![](/download/attachments/607612064/image2021-4-7_14-10-12.png?version=1&modificationDate=1636054913390&api=v2)
Após aplicar, será apresentada a tela abaixo, possibilitando ao implantador cadastrar vários usuários com diferentes permissões; ou avançar, dando continuidade na implantação do App:
![](/download/attachments/607612064/image2021-3-19_11-40-56.png?version=1&modificationDate=1636054913427&api=v2)
Passo 4: Após informar os usuários, será necessário cadastrar os coletores, para então associá-los aos usuários cadastrados no passo anterior:
![](/download/attachments/607612064/image2021-3-18_17-45-27.png?version=1&modificationDate=1636054913457&api=v2)
IMPORTANTE: O Identificador do coletor pode ser visualizado na tela inicial do App Minha Obra ou ao selecionar o tipo de configuração manual; por isso, é necessário ter o dispositivo com o App instalado.
![](/download/attachments/607612064/image2021-3-25_18-4-18.png?version=1&modificationDate=1636054913497&api=v2) ![](/download/attachments/607612064/image2021-3-25_18-4-58.png?version=1&modificationDate=1636054913533&api=v2)
Da mesma forma que o cadastro de usuários, será possível informar vários coletores nesse passo:
![](/download/attachments/607612064/image2021-3-19_11-50-37.png?version=1&modificationDate=1636054913570&api=v2)
A partir desse momento, as telas serão apresentadas de acordo com as funcionalidades selecionadas no Passo 1. Clique na funcionalidade desejada para expandir o conteúdo e conhecer a respeito:
Ao final das parametrizações, caso tenha optado por utilizar folha tarefa, o usuário terá a opção de cadastrar uma folha tarefa para o projeto corrente:
![](/download/attachments/607612064/image2021-4-1_16-5-37.png?version=1&modificationDate=1636054913613&api=v2)
Optando por cadastrar deverá preencher as seguintes informações:
![](/download/attachments/607612064/image2021-3-29_8-43-1.png?version=1&modificationDate=1636054913647&api=v2)
Ao clicar em avançar será apresentada tela para associar as tarefas que irão constar na folha tarefa:
![](/download/attachments/607612064/image2021-3-29_7-29-6.png?version=1&modificationDate=1636054913683&api=v2)
Em seguida deverá associar à folha tarefa que está sendo cadastrada, um coletor:
![](/download/attachments/607612064/image2021-3-29_7-30-47.png?version=1&modificationDate=1636054913720&api=v2)
Selecionar a equipe e as tarefas caso queira alocar mão de obra na folha tarefa:
![](/download/attachments/607612064/image2021-3-30_17-51-10.png?version=1&modificationDate=1636054913760&api=v2)
Após executar, o processo de criação de folha tarefa será concluído:
![](/download/attachments/607612064/image2021-4-1_16-43-47.png?version=1&modificationDate=1636054913793&api=v2)
Retornando para a tela do assistente, ao avançar, será exibida a tela abaixo:
![](/download/attachments/607612064/image2021-4-1_16-9-36.png?version=1&modificationDate=1636054913830&api=v2)
Clicando em "Gerar QR Code", após preenchimento dos campos, é exibido o QR Code para configuração automática dos dispositivos:
![](/download/attachments/607612064/image2021-4-1_16-19-50.png?version=1&modificationDate=1636054913863&api=v2)
Na tela seguinte, será possível enviar a todos os usuários de coletores, para que estes possam efetuar a correta configuração do App nos dispositivos:
![](/download/attachments/607612064/image2021-4-1_17-48-34.png?version=1&modificationDate=1636054913900&api=v2)
Pronto! A implantação do App Minha Obra foi concluída!
Instale o app Minha Obra Para seguir as instruções da instalação do app Minha Obra acesse o menu Instalação. Faça login acessando o app Minha Obra Na mesma pagina de instalação acesse as informações de como logar no app Minha Obra também. Acesse as Informações do app Minha Obra Na mesma pagina de instalação estão todas as informações do app.
Após esses passos já é possivel realizar os cadastros básicos , caso opte por não utilizar o acelerador de implantação. Cadastros BasicosAo optar por utilizar o acelerador de implantação ele já realiza todos esses cadastros básicos: Confira o Acelerador de Implantação do APP Minha Obra para facilitar seus cadastros e a configuração das funcionalidades. Saiba mais 1 - Parâmetros Gerais ![](https://tdn.totvs.com/download/attachments/624621846/image2020-6-19_15-34-27.png?version=1&modificationDate=1623863502987&api=v2)
2 - Utiliza Folha Tarefa
- Parâmetro para Habilitar a Utilização da Folha Tarefa:
![](https://tdn.totvs.com.br/download/attachments/490980092/image2019-5-13_16-4-22.png?version=1&modificationDate=1557774637067&api=v2&effects=drop-shadow)
- Opção de Menu: Projetos \ Construção e Projetos \ Controle \ Básico \ Mobilidade \ Folhas Tarefa;
![](https://tdn.totvs.com/download/attachments/624621846/image2020-6-19_19-49-4.png?version=1&modificationDate=1623863502950&api=v2)
![](https://tdn.totvs.com/download/attachments/624621846/image2020-6-19_19-49-50.png?version=1&modificationDate=1623863502910&api=v2)
- Uma Folha Tarefa, representada principalmente por suas tarefas, pode ser considerada como um planejamento em curto prazo. Através desta Folha será possível ter o conhecimento das tarefas a serem realizadas em um dado intervalo de tempo bem como distribuir estes “planejamentos” entre as equipes/usuários das diversas frentes de obra, receber/gerir os apontamentos para diversas funções que as tarefas podem representar;
Permite a alocação de equipes para a execução. Após o término da alocação, a mesma fica disponibilizada para ser sincronizado pelo coletor e posterior registro e envio dos apontamentos referente as frentes de execução; O objetivo desta funcionalidade é maior agilidade no direcionamento de tarefas nas frentes de obra e acompanhamento dos projetos através do envio/recebimento de informações sobre o andamento das tarefas (e atualização no TOP) com o uso de coletores móveis (a princípio smartphones). Para isso a folha tarefa a ser disponibilizada para o coletor deve ser a folha tarefa do tipo Coletor Móvel; - Permite o sincronismo de informações para o coletor móvel e o gerenciamento dos apontamentos realizados e sincronizados;
- Depende do cadastro do projeto;
- Uma Folha Tarefa poderá se encontrar em uma das seguintes situações:
Informações |
---|
Em Processamento: Folha Tarefa criada, porém ainda não disponibilizada para os dispositivos de coleta de dados; Disponível para Coletor (Gerada): Folha Tarefa cadastrada e disponível para o coletor; Pronta para Impressão: Folha Tarefa disponível para impressão e coleta através do leitor de código de barras; Encerrada: Folha Tarefa encerrada. O PERT já foi atualizado. Esta situação significa que todos os dados dos coletores já foram recebidos para todas as tarefas, validados e atualizados no PERT; Cancelada: Folha Tarefa cancelada. Não permite qualquer outra operação. Os dados das tarefas (por exemplo, oriundos de coletores) desta Folha não poderão gerar atualização no PERT e não poderão ser importadas informações dos coletores; Associada ao coletor: Folha Tarefa foi enviada ao coletor móvel; Apontada: Folha Tarefa possui apontamentos em seus itens após a mesma ter sido fechada no coletor. |
- A data fim da Folha é calculada conforme a periodicidade informada e o valor do parâmetro “Quebra por períodos do Cronograma”, exceto quando a periodicidade é definida como Personalizada;
- Primeiramente determina-se o valor da data fim de acordo com a periodicidade:
Informações |
---|
Semanal: Se Soma seis dias a data inicial; Quinzenal: Se Soma quatorze dias a data inicial; Mensal: Se Soma trinta dias a data inicial; - Personalizada: Permite a alteração manual das datas início e fim.
|
- Posteriormente, caso o parâmetro “Quebra por períodos do Cronograma” esteja selecionado, será verificado se existe algum fim de período no cronograma entre as datas inicial e final informadas na Folha. Caso exista, o valor encontrado será utilizado como data fim da folha e será exibida uma mensagem contendo informações sobre a quebra. Posteriormente, o usuário poderá cadastrar um novo item a fim de complementar o período. Caso contrário, será exibida uma mensagem de erro, informando que não foi possível encontrar um intervalo de cronograma. Esse parâmetro somente estará habilitado se a periodicidade padrão for diferente de Personalizada.
- Parâmetro da folha tarefa habilitado
Informações |
---|
- Ao habilitar o Parâmetro 'Utiliza Folha Tarefa', a Folha Tarefa será exibida no Menu de Mobilidade e em todos os locais no app Minha Obra.
- Ao realizar o sincronismo com o app Minha Obra, todas as Folhas Tarefas associadas ao coletor, serão enviadas para o mesmo e ficarão disponíveis para apontamento.
- Na associação de projeto ao coletor o usuário pode informar um filtro de tarefas adicionais, além da Folha Tarefa para apontamento de Equipamentos e apontamento avulso de Mão de Obra.
![](https://tdn.totvs.com/download/attachments/624621846/Evidencia%20de%20Teste%20-%20Projeto%20com%20Folha%20Tarefa.png?version=1&modificationDate=1623863502863&api=v2)
|
- Coletores Associados a Folha Tarefa
Informações |
---|
- Opção de Menu: Projetos \ Construção e Projetos \ Controle \ Básico \ Mobilidade \ Folhas Tarefa \ Anexos \ Coletores Associados a Folha Tarefa;
- Neste anexo o usuário deverá associar os coletores que a folha tarefa poderá ser sincronizada.
- Não será possível incluir novos coletores caso a folha tarefa esteja com status de cancelada ou Encerrada.
- Não será possível excluir coletores que já possuem status de ‘associado ao coletor’.
![](https://tdn.totvs.com/download/attachments/624621846/image2017-10-19_12-34-27.png?version=1&modificationDate=1623863502827&api=v2)
|
3 - Não utiliza Folha Tarefa
- Processo de Associar coletor a Folha Tarefa
Informações |
---|
Permite a associação de coletores à folha tarefa selecionada: - Para sua execução é necessário que o status da folha seja "Em Processamento", "Gerada" ou "Associada ao Coletor";
- São exibidos apenas os coletores que tem o projeto corrente associado;
- São exibidos apenas os coletores que tem usuários associados;
Image Added
|
Informações |
---|
- Opção de Menu: Projetos \ Construção e Projetos \ Controle \ Básico \ Mobilidade \ Folhas Tarefa \ Anexos \ Itens da Folha Tarefa;
- As tarefas de uma Folha Tarefa são as atividades que foram planejadas para serem executadas nas frentes de obra em dado intervalo de tempo. É do progresso destas tarefas que deve ser obtido os apontamentos através do uso de coletores móveis pelos responsáveis por tais funções;
- A inserção das tarefas da Folha Tarefa se baseará, única e exclusivamente, na planilha de atividades do TOP. Este anexo contém as tarefas da planilha de atividades e ainda possui campos adicionais;
- Para seleção das tarefas para a Folha Tarefa o sistema disponibiliza algumas formas de fazê-lo:
- Cadastro padrão inserindo uma tarefa por vez;
- Processo que permitirá selecionar várias tarefas ao mesmo tempo e inseri-las;
- “Drag-and-Drop”, o usuário deverá abrir a planilha de atividades e o anexo de itens da Folha tarefa lado a lado, arrastando e soltando as tarefas para o anexo de itens.
- Em qualquer situação de apresentação das tarefas da planilha de atividades, para seleção/inserção como tarefa da Folha, as tarefas da planilha de atividades são filtradas de acordo com as datas de início e fim da Folha previamente cadastrada;
- Este filtro deve ser aplicado nos campos início e fim programado das tarefas da planilha de atividades e serão exibidas (da Planilha de Atividades, Seleção múltipla, cadastro padrão) somente as tarefas que façam interseção com o período informado.
Image Added
A partir do APP Minha Obra é possível criar/alterar medições de itens de contrato através dos apontamentos de Avanço Físico dos itens da Folha Tarefa, sendo via coletor ou apontamento manual. Para que essa incidência ocorra, é necessário vincular o contrato desejado ao item associado à folha tarefa, porém é necessário considerar algumas premissas: - A tarefa deve ser definida antes do contrato;
- As datas início e fim do contrato devem fazer interseção com as datas início e fim da folha tarefa;
- A tarefa selecionada deve estar associada ao contrato;
- Ao salvar a associação do contrato ao item, caso o parâmetro de medição acima de 100% estiver diferente de SEMPRE PERMITIR, será verificado se a quantidade planejada do item da folha é maior que a quantidade do saldo do item no contrato, o que não deve ser permitido.
Image Added
Image Added
No processo de Validar Apontamento de Avanço Físico o parâmetro de medição acima de 100% também é verificado e se estiver diferente de SEMPRE PERMITIR, e a quantidade apontada do item da folha for maior que a quantidade do saldo do item no contrato, um alerta será exibido, não permitindo a execução.
Image Added
No processo de Atualizar PERT o parâmetro de medição acima de 100% também é verificado e se estiver diferente de SEMPRE PERMITIR, e a quantidade apontada do item da folha for maior que a quantidade do saldo do item no contrato, um alerta será exibido, não permitindo a execução. Caso as validações estejam aprovadas, a quantidade apontada do item será incorporada à medição do item no contrato, no respectivo período que corresponde à DATA DE APONTAMENTO do item da folha. Se o período do contrato estiver liberado, a medição não será inserida e o erro deverá ser exposto. Na tela de medição de itens, nos períodos do contrato, é possível consultar os apontamentos que influenciaram na medição do item corrente, basta selecionar o item no grid e clicar no botão Image Added.
Image Added
|
- Programado x Alocado
- Opção de Menu: Projetos \ Construção e Projetos \ Controle \ Básico \ Mobilidade \ Folha Tarefa \ Anexos \ Programado X Alocado;
Image Added
Esta visão exibe informações relacionadas com as quantidades programadas e quantidades alocadas de cada Tarefa. Exibe somente insumos do tipo mão de obra, necessários para a execução da tarefa; Na medida em que as Equipes forem alocadas na tarefa, será atualizado o campo de quantidade de horas alocadas por insumo. Estes dados ficarão disponíveis somente para consulta, para que o usuário tenha uma noção do quanto já foi alocado na tarefa e quanto ainda precisa ser alocado, ou mesmo se houve super alocação de horas na tarefa. - Recalcular Planejamento das Tarefas
Informações |
---|
- Opção de Menu: Projetos \ Construção e Projetos \ Controle \ Básico \ Mobilidade \ Folhas Tarefa \ Processos \ Recalcular planejamento das tarefas;
- Recalcular as quantidades planejadas utilizando o mesmo cálculo quando a tarefa é associada à folha.
Image Added
|
- Disponibilizar Folhas para Envio
Informações |
---|
- Opção de Menu: Projetos \ Construção e Projetos \ Controle \ Básico \ Mobilidade \ Folhas Tarefa \ Processos \ Disponibilizar Folha para Envio;
- Disponibiliza a folha tarefa do tipo de apontamento “coletor” para envio.
Image Added
|
Informações |
---|
- Opção de Menu: Projetos \ Construção e Projetos \ Controle \ Básico \ Mobilidade \ Folhas Tarefa \ Processos \ Copiar Folha Tarefa;
- Permite realizar a cópia de uma Folha Tarefa selecionada;
- Somente folhas com o status de Cancelada ou Encerrada podem ser copiadas;
- Cancelada: Serão copiados apenas os itens associados a folha tarefa origem respeitando as validações de associação de itens a folha;
- Encerrada: Serão copiados os itens associados a folha tarefa origem respeitando as validações e regras de associação de itens a folha e também as alocações de equipe respeitando as validações e regras de alocação de Equipe.
- Os Campos Periodicidade e Tipo de Apontamento exibem os valores definidos na folha origem da cópia;
- Os Campos Data Início e Descrição estão disponíveis para a criação da nova folha tarefa;
- Copiar Alocação de Equipe: esta flag estará visível somente quando a folha estiver com status Encerrada
Image Added
|
Informações |
---|
- Opção de Menu: Projetos \ Construção e Projetos \ Controle \ Básico \ Mobilidade \ Folhas Tarefa \ Processos \ Cancelar Folha Tarefa;
- Permite realizar o cancelamento da Folha Tarefa selecionada.
Image Added
|
Informações |
---|
- O relatório TOPREL0030 - Folha Tarefa por equipe (Mobilidade).TotvsReport pode ser encontrado no book de relatórios e sua geração disponibiliza os códigos de barras para serem utilizados no APP Minha Obra. A geração do relatório é através do menu Projetos \ Construção e Projetos \ Relatórios \ Mobilidade \ Folha tarefa.
Image Added
- Campos da Folha Tarefa impressa:
- Número da Folha Tarefa;
Nome da Folha Tarefa; Data de Criação; Data da Carga no Coletor; Data de Início da Execução; Coletor; Código da Tarefa; Nome da Tarefa; Centro de Custo; Quantidade no Período; Quantidade Total; Saldo a Executar; Unidade de serviço; Executado 100% (Checkbox); Código de barras; Responsável pela Execução.
- O código de barras contém informações suficientes para que em sua leitura o sistema consiga identificar de qual projeto/obra/tarefa está se referindo o valor do apontamento e seja capaz de gravá-lo.
Image Added
|
- Interface de coleta via código de barras
Informações |
---|
- Opção de Menu: Projetos \ Construção e Projetos \ Controle \ Básico \ Mobilidade \ Folhas Tarefa \ Anexos \ Interface de Coleta Via Código de Barras;
- O menu de acesso à Interface de Coleta via Leitura de Código de Barras somente está disponível para Folhas Tarefa com o status “Pronta para Impressão”, ou seja, ao selecionar na visão, uma folha com o status diferente do citado, o menu ficará desabilitado. Além disso, o processo só pode ser acessado caso a folha tenha o tipo de apontamento manual;
- O anexo de Tarefas da Folha Tarefa já possui uma série de informações sobre as tarefas e será disponibilizada uma área com controles e tratamentos específicos para se efetuar a leitura dos códigos de barra e atualização do sistema a partir dos dados informados nesta área;
- Nela contém um indicador de 100%, um campo para o código de barras e botões com percentuais de completude (0%, 25%, 50%, 75%);
- Esta interface será apresentada de acordo com perfil do usuário que indica os usuários que irão realizar a leitura do código de barras, direto no sistema, terão de ter permissão para fazê-lo;
- O usuário marca o indicador de 100% e realizará a leitura do código de barras. Em seguida, o sistema irá interpretar este código de barras identificado a qual tarefa se refere e atualizará o campo de apontamento com o 100%;
- Pode ocorrer da tarefa não estar com 100% de completude, então o usuário pode desmarcar o indicador de 100%, efetuar a leitura do código de barras e selecionar o percentual de completude (0%, 25%, 50%, 75%). Ao efetuar esta seleção o sistema irá interpretar este código de barras identificando a qual tarefa se refere e atualizará o campo de apontamento de acordo com o percentual selecionado. As informações serão gravadas em uma tela de validação, não atualizando diretamente o PERT.
Image Added
|
3 - Não Utiliza Folha Tarefa 4 - Coletores 4 - Coletóres Móveis 5 - Associação de projetos Projetos aos coletoresColetores 6 - Usuários de coletores móveis 7 - Associação de coletores a usuparios 8 - Associação de equipamentos a usúarios 9 - Sincronismo 10 - Mapa de apontamentos
|