Histórico da Página

• Web Service Rest
• Campos de log usuário
• Cadastro de usuário

Configuração de WebService REST 

Neste projeto é utilizado o REST como servidor. Informações de como configurá-lo podem ser obtidas aqui.

Algumas ressalvas devem ser feitas:

REST

Configure o REST para realizar a conexão entre aplicativo / Protheus. A seguir é apresentado um trecho da configuração REST

.

[ONSTART]
JOBS=HTTPJOB
Refreshrate=120

[HTTPJOB]
MAIN=HTTP_START
ENVIRONMENT=MntPadrao

[HTTPV11]
Enable=1
Sockets=HTTPREST

[HTTPREST] 
Port=80868389
IPsBind=
URIs=HTTPURI
Securitysecurity=1

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

[ONSTART]
JOBS=HTTPJOB
RefreshRate=120

[HTTPJOB]
MAIN=HTTP_START
ENVIRONMENT=P12127_MNTNG

OnConnect=REST_CONNECT
OnExit=REST_EXIT
OnStart=REST_START
preparein=all
Stateless=1

OBS: Para ter certeza de que a configuração do REST está funcionando, deverá aparecer a palavra REST escrita no console.log, conforme print abaixo:

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, verifique as configurações realizadas no arquivo appserver.ini e tente pegar um RPO atualizado.

OBS: Para saber as versões, seguir conforme abaixo:

MNT NG: acessar "http://ipexterno:porta/rest/MNTNG/version" ou clicar em "Validar conexão" em Configurações do Portal Mobile (Após o cadastro de usuários), conforme print's abaixo:

MNTNG/version:

Image Removed

Validar Conexão:

Image Removed

Configuração de Campo Log

Para o projeto funcionar corretamente, é necessário a criação de campos de Log de Usuário. Esses campos serão utilizados para o controle dos dados a serem enviados na etapa de sincronização do aplicativo MNT NG.

Mais informações na documentação.

Para que seja possível logar no aplicativo MNT NG, é necessário possuir um usuário ativo no Protheus com permissão de acesso ao módulo Manutenção de Ativos (SIGAMNT) e as Filiais por meio do Configurador.

• Para criar um novo usuário no Protheus, você deve acessar o módulo SIGACFG e navegar pelos menus Usuário > Senhas > Usuários.
  
                
  
  
• Selecione a opção incluir e preencha as informações necessárias. É obrigatório o preenchimento do e-mail do usuário pois esse campo é utilizado para a autenticação no processo de  login do aplicativo.
  
  
  

É possível vincular um usuário a um funcionário da manutenção. Para realizar essa integração, acesse o módulo Manutenção de Ativos (SIGAMNT) do módulo e navegue pelos menus Atualizações > Manutenção > Funcionários.

• Dentro do cadastro, escolha um funcionário existente ou crie um novo. 
• Escolhido o funcionário, preencha os campos de e-mail com o login que será utilizado no aplicativo e no campo código do usuário, selecione o Usuário Protheus que será vinculado ao cadastro.

É possível vincular um usuário a um executante de solicitações de serviço. Para realizar essa integração, acesse o módulo Manutenção de Ativos (SIGAMNT) do módulo e navegue pelos menus Atualizações > Manutenção > Solicitação Serviço > Executantes. Ao acessar a rotina, insira um executante ou altere um registro já existente. 

O vínculo com o usuário Protheus ocorre pelo campo e-mail, preencha-o com o mesmo e-mail do usuário Protheus.

Cadastro de Usuários

A configuração de usuários é realizada em duas etapas, sendo elas:

• Cadastro de usuário Protheus. É possível também realizar o vínculo do usuário Protheus com um Funcionário da Manutenção (para executar ordens de serviço), porém não é obrigatório. Esses cadastros são detalhados a seguir. Caso queira, há possibilidade também de utilizar a autenticação autenticação na modalidade Single sign-on ACTIVE DIRECTORY.
• Vínculo do funcionário à um Grupo de Usuários, através da rotina de Permissões (MNTA916).

• Registro da empresa
• Endereço do servidor e  Validação e Validação de ambiente
• Grupos de usuários (Permissões e Filtros e Filtros)
• Usuários

Registro da Empresa

Para realizar o cadastro da empresa no portal mobile será solicitado algumas informações como CNPJ, e-mail do responsável além de necessitar o aceite dos termos de uso, que podem e devem ser lidos no link do próprio portal. 

A licença de acesso do aplicativo MNTNG deve ser consumida via MINGLE.

Licença via MINGLE

Acesse as configurações e selecione o item Aplicativo MNT NG. No campo Alias Mingle, informe o Alias do ambiente que foi previamente cadastrado (link Mingle para cadastro).

Image Added

Endereço do servidor

Acione Configurações para definir o endereço do servidor Protheus. 

Essa informação deve ser preenchida corretamente para o bom funcionamento do produto. O botão Validar conexão (que é representado pela seta (→)) avalia se o serviço se encontra online.

Realize a autenticação com e-mail e senha.

Image RemovedImage Removed

Validação do Ambiente

Acione Validar Ambiente. Desta forma será validado se o ambiente está apto a utilizar o aplicativo. Pelo menos uma filial deve ser confirmada como apta para utilização.

Image Removed Image Added

Grupos de Usuários

Defina os grupos de usuários para diferenciar permissões e filtros.

Permissões:

Configure as permissões de cada grupo. 

Neste exemplo logo abaixo, o grupo Técnicos poderá apenas alterar a ordem de serviço, prever e realizar check list, apontar insumo. Além de incluir e alterar solicitações de serviço ficando sem acesso as demais funções, a não ser que sejam selecionadas. 

Image RemovedImage Added

Filtros

Nesta opção no Grupo de Usuários é É possível filtrar os itens apresentados de acordo com cada grupo.:

Filtros relacionados a usuários

• Somente O.S. relacionadas ao usuário:

Ao selecionar esta opção será exibida aos respectivos usuários cadastrados,  apenas Será exibido as ordens de serviço geradas por ele ou na qual ele esteja definido como pelo usuário conectado e as ordens que apresentem pelo menos um insumo de mão -de-obra.Sde obra com o código do usuário (necessário realizar o cadastro do usuário como um funcionário da manutenção (MNTA020) e vinculá-lo ao usuário Protheus);

• Somente O.S. relacionadas a especialidade ao usuário:

Será exibido No cadastro de usuários do Protheus, é possível relacionar a especialidade ao funcionário. Ao selecionar esta opção será exibida aos respectivos usuários cadastrados, apenas as ordens de serviço cujo há geradas pelo usuário conectado e as ordens que apresentem pelo menos um insumo de especialidade ao qual ele pertence . (necessário realizar o cadastro do usuário como um funcionário da manutenção (MNTA020) com especialidade e vinculá-lo ao usuário Protheus);

• Somente S.S. relacionadas ao usuário 

Para esta opção será exibida aos respectivos usuários cadastrados Será exibido apenas as solicitações de serviço geradas por ele pelo usuário conectado ou aquelas em que ele está definido como executante (necessário realizar o cadastro de executante).

Filtros relacionados a cadastros

Personalize os itens que serão apresentados para os usuários caso deseje restringir equipamentos, família de equipamentos, serviços etc.

Personalize os itens que serão apresentados para os usuários caso deseje restringir equipamentos, família de equipamentos, serviços etc.

Usuários

Defina quais usuários tem a permissão de logar no aplicativo e em que grupo de restrição de permissões e filtros a que pertencem.

• Instalação e preferências

Instalação

Para utilizar o aplicativo no seu dispositivo móvel, o primeiro passo é baixar o app na "Play Store" (Central de aplicativos para Android) . Após acessa-la, você deve pesquisar por "MNT NG", ou também pode acessar a esse link e ser direcionado ao download.

Encontrando o aplicativo MNT NG, é só clicar no botão "Instalar", aguardar o download ser concluído.

Preferências

No MNT NG, é possível escolher algumas preferências de visualização. Como por exemplo "Barra de Navegação", "Aba de Insumo", "Aba de Checklist", "Abrir O.S. durante a execução e "Irregularidade obrigatória"

Para fazer estas configurações, basta abrir o menu lateral deslizando o dedo da direita para a esquerda e clicando na engrenagem no topo da tela.

Com a tela de preferências aberta, basta marcar ou desmarcar as configurações que você deseja e em seguida clicar em "OK"  no campo superior direito.