Histórico da Página

Nesta página você encontra o passo-a-passo para configuração do aplicativo MNT NG.

Requisitos:
Acesso à internet;
Acesso externo ao servidor estar liberado;
Acesso a uma porta do servidor somente para o REST Protheus;

1. Configuração de Webservice;
2. Configuração de Campo Log;
3. Configuração de Usuários;

Configuração de WebService REST Protheus

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

Algumas ressalvas devem ser feitas:

• Substituir o valor da chave "ENVIRONMENT" =P12127_MNTNG, onde "P12127_MNTNG" deve ser substituído pelo Ambiente do Servidor Protheus a ser utilizado;
• Incluir a linha "MAXSTRINGSIZE=10" na seção "[General]";
• Adicionar duas configurações dentro do HTTPURI, os itens a serem adicionados são "CORSEnable=1" e o "AllowOrigin=*";
• Substituir a porta "8086" na linha "Port=8086" pela porta desejada.

[HTTPV11]
Enable=1
Sockets=HTTPREST

[HTTPREST] 
Port=8086
IPsBind=
URIs=HTTPURI
Security=1

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

[ONSTART]
JOBS=HTTPJOB
RefreshRate=120

[HTTPJOB]
MAIN=HTTP_START
ENVIRONMENT=P12127_MNTNG

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:

Validar Conexão:

Aplicativo: acessar link do Google Play.

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.

Para compatibilizar os campos necessários, deve-se:

• Executar o compatibilizador de campos log, para isso basta acessar a documentação.

Cadastro de Usuários

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

• Portal Mobile onde você deve criar um usuário no site e realizar as configurações, assim como criação de usuários (informando e-mail) e seus grupos de usuários;
• 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 Single sign-on.

Para utilizar a autenticação Single sign-on, é necessário definir a integração do Protheus com o Single sign-on. Para definir a integração acesse o módulo Configurador (SIGACFG) e navegar pelos menus Usuário > Senhas > Política.

No campo Habilitar Single sign-on (USR_SSIGNON) selecione a opção 1 - Obrigatório ou 2 - Opcional e no campo Modalidade de Single sign-on (USR_SSOTYPE) a opção de acordo com a modalidade que deseja utilizar (Neste exemplo estamos utilizando a modalidade 3 - Active Directory). Ao parametrizar no configurador o campo Habilitar Single sign-on (USR_SSIGNON) como 1 - Obrigatório, este torna-se o único meio de autenticação do usuário, já na configuração na qual o campo Habilitar Single sign-on (USR_SSIGNON) é definido como 2 - Opcional, a utilização do usuário e senha padrão do Protheus também são permitidos.

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.

O próximo passo é realizar as configurações no Portal Mobile .

Informações adicionais:

• Requisitos; http://tdn.totvs.com/x/sofXDw
• Releases; http://tdn.totvs.com/x/_IHpDw
• Caso esteja ocorrendo algum problema, verificar a seção de dúvidas frequentes, no link http://tdn.totvs.com/x/J4HpDw;
• Conhecendo o Aplicativo; http://tdn.totvs.com/x/94DpDw