Implementando o Mobile (MNT NG) - Protheus

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

Configuração de WebService 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
TimeOut=120

[HTTPREST]
Port=8389
IPsBind=
URIs=HTTPURI
security=1

[HTTPURI]
URL=/rest
Instances=1,5,2,1
CORSEnable=1
AllowOrigin=*
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.

Para utilizar o MNT NG é necessário possuir licenças do aplicativo assim como um alias Mingle. Solicite um alias pelo link https://mingle.totvs.com.br. 

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 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 de ambiente
• Grupos de usuários (Permissões 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).

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.

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. 

Filtros

É possível filtrar os itens apresentados de acordo com cada grupo:

Filtros relacionados a usuários

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

Será exibido as ordens de serviço geradas pelo usuário conectado e as ordens que apresentem pelo menos um insumo de mão de 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 as ordens de serviço 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 

Será exibido apenas as solicitações de serviço geradas 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.

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.