NOME DO REQUISITO

Características do Requisito

Descrição

Os desafios de um gestor de manutenção são imensos. Para manter o setor de manutenção em alta produtividade, é necessário contar com o que há de melhor em tecnologia e garantir a competitividade do negócio. O webservice é utilizado aplicativo MNT NG para poder proporcionar um auxílio a quem utiliza o módulo de Manutenção de Ativos (SIGAMNT) no Protheus 11 e 12, disponibilizando o produto em plataforma mobile. 

O webservice REST realiza a integração do Protheus com o aplicativo, possibilitando inclusão, alteração, cancelamento e finalização de ordens de serviço de uma forma fácil e prática a quem usa o aplicativo, além de o usuário poder consultar a qualquer momento suas ordens de serviço sem ter de se deslocar até um computador para poder apontar suas alterações, trazendo uma economia de tempo por se ter menos deslocamentos.

Algumas funcionalidades que o webservice proporciona ao aplicativo são :

• Visão intuitiva do backlog
• Abertura fácil de ordens de serviço
• Reporte rápido de trabalho executado, insumos e checklist
• Apontamento de trabalho com play/pause
• Upload de imagens
• Finalização de ordens de serviço
• Sincronização automática com o ERP Protheus

Obs: Para o correto funcionamento da aplicação, o update XXXXXXX deve ter sido aplicado antes do update desta liberação(U_UPDMNTMOBILE).

Importante

Antes de executar o compatibilizador U_UPDMNTMOBILE, é imprescindível:

• Realizar o backup da base de dados do produto que será executado o compatibilizador no diretório \PROTHEUS11_DATA\DATA e dos dicionários de dados SXs no diretório \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 Microsiga Protheus TOTVS Smart Client, digite o nome do compatibilizador no campo Programa Inicial. Descreva se o compatibilizador deve ter uma data específica ou superior para que a atualização nos dicionários seja efetuada corretamente. Importante: Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a ___/___/____.
2. Clique em OK para continuar.
3. Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado ou é apresentada a janela para seleção do compatibilizador. Selecione o programa xxxx().
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.

Após a aplicação do update, é necessário realizar algumas configurações para poder utilizar o aplicativo MNT NG. As configurações abrangem o Protheus, Portal Mobile e o próprio aplicativo. Como o objetivo aqui são as configurações para o Protheus, a explicação dos outros itens pode ser encontrados no TDN. 

No Protheus deve ser realizado o seguinte procedimento:

O Webservice é encarregado de realizar a integração entre o módulo SIGAMNT e o aplicativo Mnt NG, fazendo com que todas as operações realizadas no módulo e no aplicativo, passem pelo Webservice.

Existem dois tipos de Webservice disponíveis pela TOTVS. Mas neste projeto é utilizado o REST devido ao seu melhor desempenho. Informações de como configura-lo podem ser obtidas aqui e um exemplo básico sobre o que deve ser adicionado ao appserver.ini pode ser visto aqui. 

Algumas ressalvas devem ser feitas. Na última linha do exemplo do link anterior, há o trecho "ENVIRONMENT=environment", onde "environment" deve ser substituído pelo Ambiente do Servidor Protheus a ser utilizado. Você também deve retirar a linha "PrepareIn=All" que fica dentro do HTTPURI, além de adicionar duas configurações dentro do HTTPURI, os itens a serem adicionados são "CORSEnable=1" e o "AllowOrigin=*". Deve também ser trocado o valor da tag "SECURITY" de "1" para "0". Caso queira, você pode mudar a porta em que o serviço irá rodar trocando o valor "8080" na linha "Port=8080" pela porta desejada. 

No fim, sua área do HTTPURI estará parecida com o exemplo abaixo.

 
[HTTPURI]
URL=/rest
Instances=1,2
CORSEnable=1
AllowOrigin=*
 

 
[SSLConfigure]
HSM=0
SSL2=1
 

Para ter certeza de que a configuração do REST está funcionando, deverá aparecer a palavra REST escrita no console.log do seu appserver, como demonstrado abaixo.

Existe uma patch que deve ser aplicada no ambiente Protheus para a instalação dos fontes necessários para o funcionamento. Essa patch fica disponível como um anexo na página de cada release com suas respectivas alterações realizadas.

Abaixo está um exemplo da página do serviço do REST funcionando que pode ser acessada no endereço "http://localhost:[SUAPORTA]/rest". Nesta tela é exibido todos os Webservices disponíveis para uso.

PS: Se você tiver realizado as configurações descritas acima e não tenha aparecido o log do REST no appserver, tente pegar um RPO atualizado.

Atualizações do Compatibilizador

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

1. Criação ou Alteração (mantenha somente a instrução correspondente) de Campos no arquivo SX3 – Campos:

• Tabela BGD - Prod x Cob x Proc x Co-Part:

Procedimento para Utilização

• Descreva os procedimentos, passo a passo (caso de uso), que serão realizados pelos usuários para que a melhoria seja visualizada identificando as seguintes informações:
• Localização da rotina no menu;
• Localização dos novos campos e/ou perguntas e respectivas pastas de cadastro que são visualizadas pelo usuário;
• Caso seja necessário ter algum cadastro feito previamente, faça uma observação.

Exemplo:

       1.            No Plano de Saúde (SIGAPLS), acesse Atualizações / Produto Saúde / Produto Saúde (PLSA800).

O sistema apresenta a janela de produtos cadastrados.

       2.            Posicione o cursor em um produto e clique em Alterar.

       3.            Na pasta Cobertura/Carências selecione a subpasta Tipo de Prestador.

       4.            Dê duplo clique no campo TP Prestador (BCW_TIPPRE).

O sistema apresenta a janela Tipo de Prestador – Coparticipação – Alterar.

       5.            Informe os dados conforme orientação do help de campo e observe o preenchimento do novo campo:

                      Som. p/Compra (BCW_SOMCOM): selecione Sim para indicar se a coparticipação cadastrada será válida somente para efeito de compra de procedimentos ou Não, caso contrário.

       6.            Confira os dados e confirme.

COLOCAR CONFIGURAÇÃO PROTHEUS, PORTAL, MOBILE