Projeto Mobilidade 

Características do Requisito

Descrição

Realizada implementação do Projeto Mobilidade (UPDMNT80) para atender a demanda de existência no produto Protheus Manutenção de Ativos e Gestão de Frotas (SIGAMNT) de rotinas que permitam gerenciar o controle diário de atividades executadas por um bem/equipamento, bem como a integração dos dados gerados a partir da gestão de suas atividades, com terceiros.

Integração de Bens (ST9) via Mensagem Única TOTVS (EQUIPMENT)

A mensagem de equipamentos é enviada pelo Protheus sempre que o cadastro de um Bem do Manutenção de Ativos for incluído/alterado/inativado (uma vez que a exclusão de bens não é permitida com o processo de mobilidade ativo) e/ou em caso de transferência entre filiais, onde o sistema procede da seguinte maneira:

Envia mensagem para integração com o bem inativado (SituationStatus = 2) para a filial atual e envia nova mensagem para a filial de destino, ativando o bem (SituationStatus = 1)

O processo de integração de Bens do Manutenção de Ativos está condicionado ao conteúdo do parâmetro MV_NGINTMB estar preenchido com ‘1’.

As condições necessárias para funcionamento da integração de Bens são:

• Conteúdo do parâmetro MV_NGINTMB deve ser ‘1’;
• Campo ‘Sincronismo’ (T6_SINCRON) deve estar como ‘Sim’.
  
  

Cadastro de Atividades (MNTA850) 

Foi desenvolvida rotina para cadastro de Atividades que podem ser relacionadas a um registro de Parte Diária para um bem, as atividades podem assumir os seguintes tipos: 

• 1 = Trabalhada;
• 2 = Chuva;
• 3 = Manutenção;
• 4 = Planejamento.

A mensagem de atividades (ACTIVITY) é enviada pelo Protheus sempre que realizado um cadastro ou atualização de dados no cadastro de atividades. O conceito de atividade faz referência aos motivos de improdutividade do BackOffice RM, contudo, não totalmente. O Protheus classifica atividades como produtivas e improdutivas, através do campo Tipo de Hora (TV0_TIPHOR), divergindo do BackOffice que apenas controla motivos de improdutividade. Considerando isso, a mensagem será apenas enviada quando o processo envolver uma atividade improdutiva.

A rotina que realiza a integração do cadastro de Atividades no Protheus é o MNTI850.

Rotina Parte Diária (MNTA851) 

Foi implementado implementada rotina para registrar as atividades diárias executadas por um Bem/Equipamento (ST9 - Bens), nesta rotina deverão ser informados o turno em que o bem/equipamento esteve trabalhando ou executando determinada atividade, o contador inicial e final para o registro de Parte Diária e o operador do equipamento enquanto este estava sendo ocupado para determinada atividade, é importante ressaltar que um bem só poderá ter registro de parte diária caso o mesmo este esteja com o campo ‘Parte Diária’ (T9_PARTEDI) igual a ‘Sim’. A rotina possui get dados para informar as atividades executadas em determinada data e cada uma das atividades relacionadas ao registro de Parte Diária , deverá possuir uma Frente de Trabalho atrelada (Centro de Custo).

Processo de Integração de Parte Diária de Bens/Equipamentos via Mensagem Única TOTVS 

Desenvolvida rotina Parte Diária (MNTA851) a fim de realizar o recebimento das apropriações diárias dos equipamentos para o módulo SIGAMNT, através por meio de Mensagem Única.

Em referência à rotina de cadastro de Parte Diária (MNTA851), o sistema irá receber os dados do apontamento, formará o cabeçalho (TV1 – Parte Diária) e itens (TV2 – Atividades da Parte Diária) da Parte Diária e consistirá os mesmos quanto às suas regras de negócio, as mesmas regras definidas pelo cadastro, alocando os registros às suas respectivas tabelas ao fim do processo.

Apontamentos produtivos, onde o motivo de produtividade (Atividade do apontamento) não for repassado, a rotina irá verificar o parâmetro MV_NGMBATV, que indica o código da atividade do tipo produtiva padrão utilizada pelo SIGAMNT para realizar a inclusão do apontamento.

Caso alguma inconsistência seja encontrada, o sistema ainda gravará os registros conforme o modelo (Mensagem Única/XML) recebido, entretanto, atualizará os campos ‘Possui Erro?’ definirá o conteúdo ‘1’ (Sim) e ao campo ‘Erro’, do tipo Memo, repassará todos os Erros encontrados durante a importação.

Os campos XXX_INDERR e XXX_MSGERR existem tanto para a TV1 – Parte Diária (TV1_INDERR, TV1_MSGERR) quanto para a TV2 – Registro das Atividades (TV2_INDERR, TV2_MSGERR) da apropriação e persistem respectivamente os problemas para cada processo, assim distinguindo as inconsistências entre os itens do cabeçalho.

Caso a parte diária importada possua inconsistências, o registros gerado a partir do(s) apontamento(s) recebido(s) será apenas mostrado na rotina de Acerto de Parte Diária (MNTA852). As inconsistências encontradas poderão ser tratadas nesta rotina de Acerto de Parte Diária (MNTA852) e assim que corrigidas, o os registros passarão a ser apresentados na rotina de Parte Diária (MNTA851).

Segue abaixo os erros catalogados: 

A apropriação recebida será interpretada como sendo a de um único dia, avaliando suas atividades e dados base do cabeçalho (Data, Turno, Horas Expediente) conforme essa regra.

O turno da apropriação será proveniente do cadastro do equipamento (MNTA080), mais precisamente do campo Turno (T9_CALENDA).

Rotina para Acerto de Parte Diária (MNTA852) importado com erro:

Foi desenvolvido desenvolvida a rotina Acerto de Parte Diária (MNTA852) para ajuste de apontamentos que foram importados com erros,  dessa forma, quando um apontamento de trabalho para um equipamento estiver inconsistente diante das regras de negócio validadas pelo ERP, o registro deverá ser ajustado por meio desta rotina para que possa finalmente se transformar em um apontamento válido, caso isso não seja feito, este apontamento de trabalho ficará ‘invisível’ para o ERP, portanto não será considerado em consultas,   relatórios nem em relacionamentos de tabelas do sistema.

Mensagem de Exclusão de Apontamento de Parte Diária (APPOINTMENT) 

Foi desenvolvido desenvolvida a mensagem APPOINTMENT ao excluir um registro por completo ou alterando-o e excluindo somente alguns dos apontamentos um , uma ou mais atividades através por meio das rotinas Parte Diária (MNTA851) e Acerto de Parte Diária (MNTA852), sendo assim, é enviado enviada uma mensagem contendo esses itens para serem processados pelo RM.

Processo para Exportação de Custos de Bens do Manutenção de Ativos – Custo Mensal (MNTA494) 

No módulo de Manutenção de Ativos, são registrados os custos de manutenção corretiva, preventiva, abastecimentos, despesas com multas e sinistros, parte diária, entre outros. Todas estas informações de custos estão disponíveis no sistema MNT e podem ser divididas conceitualmente entre Custos Diretos e Indiretos.

Custos diretos evolvem custos relacionados à parte diária e os Custos Indiretos são os custos dos demais processos controlados pelo sistema. O processo integrado visa enviar para o sistema Corpore/TOP da RM as informações referentes a esses custos.

Os parâmetros de entrada para essa rotina serão o código do equipamento e o mês de referência. Dessa forma, a exportação considerará custos mensais referentes a um equipamento. Para cada equipamento também será transferido, as informações relativas à parte diária (horas produtivas e improdutivas no mês), apuradas com base nas informações de apontamento da parte diária, seja manualmente ou por coletores de dados.

O processo de exportação de custos é baseado nas seguintes rotinas: 

• MNTA494: Chamada e cálculo de custos diretos e indiretos;
• MNTA494A: Mensagem Única de Custos Indiretos Mensais do bem;
• MNTA494B: Mensagem Única de Custos Diretos Mensais do bem.

Relatório de Código de Barras do Bem (MNTR601) 

Foi desenvolvido relatório para impressão do código de barras de Bens baseado no campo Cod Barras (T9_BARCODE). Onde , onde é possível selecionar um ou mais bens para a impressão do(s) mesmo(s).

Relatório de Eficiência Operacional (MNTR055) 

Este relatório apresentará apresenta as informações apontadas na Digitação da Parte Diária, considerando o período informado na tela dos parâmetros, separados por tipo Analítico, Sintético/Bem e Sintético/Família.

• No tipo Analítico as informações são apresentadas por Bem e dia do Serviço, totalizando a cada Frente de Trabalho e Filial.
• No tipo Sintético/Bem as informações são aglutinadas por Bens em cada Frente de Trabalho, totalizando a cada Frente de Trabalho e Filial.
• No tipo Sintético/Família as informações são aglutinadas por Famílias em cada Frente de Trabalho, totalizando a cada Frente de Trabalho, Família e Filial.

Relatório de Parte Diária (MNTR060)

Relatório para impressão de planilha com as atividades de Parte Diária para o bem, para preenchimento manual. Onde contém informações como Obra, Equipamento, Código/Placa, Data com preenchimento feito automaticamente pelo sistema, o restante é manualmente.

Relatório de Horas por Atividade (MNTR065)

Este relatório apresentará apresenta a relação entre as horas acumuladas no período filtrado de determinada atividade em relação às horas disponíveis, separado por tipo Sintético e Analítico.

• No tipo Sintético as informações são aglutinadas por Família de Bens em cada Atividade e a cada Atividade, Empresa ou Filial diferente é feita uma quebra de página.
• No tipo Analítico as informações são aglutinadas por Bens em cada Atividade e a cada Atividade, Empresa ou Filial diferente é feita uma quebra de página.

*O compartilhamento das tabelas no Protheus entre compartilhada/exclusiva deve seguir a regra definida pelo backoffice RM entre global/por filial, seguindo também as regras de integração entre tabelas do Protheus para que se mantenha a integridade relacional.

*O compartilhamento de Filial da tabela TV0 – Atividades deve estar como ‘C’ (Compartilhado). Esse é um requisito para implantar os processos do Projeto Mobilidade.

Importante

Antes de executar o compatibilizador UPDMNT80 é imprescindível:

• Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório \PROTHEUS11_DATA\DATA) e dos dicionários de dados SXs (\PROTHEUS11_DATA\SYSTEM).
• Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
• Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
• Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo nickname.
• O compatibilizador deve ser executado com a Integridade Referencial desativada*.

1. Em ByYou Smart Client, digite U_UPDMNT80 no campo Programa Inicial. 
2. Importante: Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a 11/09/2015.
3. Clique em OK para continuar.
4. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
   1. Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
      É apresentada uma mensagem explicativa na tela.
   2. Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
   3. Clique em Gravar para salvar o histórico (log) apresentado.
   4. Clique em OK para encerrar o processamento.
      
      

Atualizações do Compatibilizador

1. Criação de Tabelas no arquivo SX2 - Tabelas:

     2.  Alteração de Tabelas no arquivo SX2 - Tabelas:

     3.  Criação de Campos no arquivo SX3 - Campos:•   

• Tabela TV0 - Cadastro de Atividades

 •   

• Tabela TV1 - Parte Diária

 •   

• Tabela TV2 - Registro das Atividades

     4.  Alteração de Campos no arquivo SX3 - Campos:

• Tabela ST9 - Bem

(*) A Ordem será feita conforme a última disponível na tabela.

• Tabela ST6 -

• Família de Bens

(*) A Ordem será feita conforme a última disponível na tabela.

• Tabela TQR - TIPO MODELO

(*) A Ordem será feita conforme a última disponível na tabela.

     5.  Criação de Parâmetros no arquivo SX6 – Parâmetros:

     6.  Criação de Gatilhos no arquivo SX7 – Gatilhos:

•   

• Tabela TV1 - Parte Diária

• Tabela TV2 - Registro das Atividades

     7.  Criação de relacionamento no arquivo SX9 - Relacionamento:•   

• Tabela TV0 - Cadastro de Atividades

• Tabela ST9 - Bem

• Tabela CTT - Centro de Custo

• Tabela TV1 - Parte Diária

     8.  Criação de Índices no arquivo SIX - Índices:•   

• Tabela TV0 - Cadastro de Atividades

• Tabela TV1 - Parte Diária  

• Tabela TV2 - Registro das Atividades

• Tabela ST9 - Bem

     9.  Criação de Consulta Padrão no arquivo SXB - Consulta Padrão: •   

• Pesquisa TV0 - Atividades

• Pesquisa ST9PT - Bens

• Pesquisa NGEMFI - Empresa/Filial

• Pesquisa SM0MOB - Filiais

Procedimento para Configuração

CONFIGURAÇÃO DE PARÂMETROS

1. No Configurador (SIGACFG) acesse Ambiente/Cadastros/Parâmetros (CFGX017). Configure o(s) parâmetro(s) a seguir:

CONFIGURAÇÃO DE MENUS

1. No Configurador (SIGACFG) acesse Ambiente/Cadastro/Menu (CFGX013). Informe a nova opção de menu doManutenção de Ativos, conforme instruções a seguir:

CONFIGURAÇÃO DE ADAPTERS

1. No Configurador (SIGACFG) acesse Ambiente/Schedule/Adapter E.a.i (CFGA020). Configure o(s) adapter(s) a seguir:
   
   

• ASSETMONTHLYUNDIRECTCOSTS
  

• ASSETMONTHLYDIRECTCOSTS

• APPOINTMENT

• ACTIVITY

• EQUIPMENT

CONFIGURAÇÃO DO WEB SERVICE

A integração via canal EAI é realizada por Web Services, e deve ser utilizado o wizard de configurações do server para definir o serviço web do Protheus.

1. Acessar o TOTVS Wizard: esse aplicativo encontra-se na pasta SmartClient, dentro dos diretórios de instalação do TOTVS Protheus. Ao clicar duas vezes nesse aplicativo será exibido a tela inicial do TOTVS Wizard:
   
   
   
   
2. Configuração do Servidor Internet: antes de realizar a configuração dos Web Services é necessário definir o Servidor de Internet, como podemos observar na figura acima a esquerda, temos os wizards disponíveis, selecione o item Servidor Internet (HTTP/FTP), selecione o item HTTP e clique no botão Editar Configuração.
   
   

• Marque o campo ‘Protocolo Habilitado’;
• Defina o Path dos arquiviosarquivos;
• Defina o ambiente que terá o protocolo habilitado;
• Defina a porta de conexão.

 Após definir as configurações conforme acima, clique em ‘Finalizar’.

     3.  Módulos Web: é nesse ambiente que realizamos a configuração e ativação dos Web Services Protheus, selecione esse item e clique no botão ‘Novo Módulo’;

Configurar o módulo WEB conforme descrito abaixo:

• Configuração básica do módulo: selecione na lista de opções o item WS – Microsiga Protheus 11 WEB Services;
• Nome da Instância: defina o nome para a instância do WEB Service;
• Diretório Raiz das Imagens (WEB/Path): automaticamente será criado uma pasta com o nome da instância definida, é possível informar outro diretório para a instância;
• Selecione o ambiente: defina o ambiente que os WEB Services vão ser iniciados;
• Habilitar processos na inicialização do Servidor: marcando essa opação opção os WEB Services irão ser iniciados na inicialização do servidor;

Clicar em avançar, será direcionado para tela de configuração de HOSTS X Empresas/Filias .

• Defina no campo HOST (Porde Incluir o diretório Virtual) a url que o WEB Service irá utilizar, é possível definir a porta de conexão. Selecione a Empresa/Filial que irá relacionar com a url definida e clique no botão relacionar: