Integração Aplicativo Minha Manutenção com ERP Datasul
O objetivo desta integração é permitir que usuários do ERP Datasul possam visualizar e editar os dados informados no Aplicativo Minha Manutenção, reduzindo assim o trabalho de inclusão manual de todas as informações dentro do ERP Datasul e a utilização de folhas de papel.
O Aplicativo Minha Manutenção facilita no processo de Criação da Ordem de Manutenção, Apontamento das Ordens de Manutenção, Acompanhar os Serviços em Andamento e na Solicitação de Serviço.
Pré-requisitos para instalação do APP
- Smartphone ou tablet com Android a partir da versão 5.0;
- Acesso à internet para baixar o aplicativo e para sincronizar as informações do APP com o ERP;
- Usuário e Senha de acesso ao Datasul;
- Cadastro do Alias de Acesso no Mingle (somente para conexão via Totvs Mingle).
Importante
Para solicitar a criação do Alias, acesse o endereço: https://mingle.totvs.com.br/landpage/.
Configurações para a integração do Aplicativo Minha Manutenção com ERP Datasul
Para a integração é necessário configurar o “valve” para o gerenciamento das conexões.
- Localizar o arquivo server.xml, que pode ser encontrado na instância do Jboss: ".\deploy\jboss-web.deployer\server.xml"
- Adicionar as linhas abaixo como elemento "filho" da tag <Host ...>:
<Valve className="com.datasul.framework.valve.DatasulValve"
allowHeaders="Content-Type,Accept,Accept-Language,Content-
Language,Authorization,returnformatversion"
contextsToValidate="/dts/datasul-rest,/api,/webexecbo,/josso"
allowOrigin="http://localhost:8100"
allowMethods="GET, POST, DELETE, PUT, PATCH, HEAD, OPTIONS"
allowCredential="true" />
Configurações para realizar o Login no APP
Para realizar o login é necessário que o usuário realize a seguinte configuração no App:
- Na tela inicial em configurações, deve escolher o tipo de conexão:
- Acesso Direto: Ao selecionar essa opção, deverá ser informado o Servidor(IP), a Porta e o intervalo de sincronização;
- Acesso via Mingle: Ao selecionar essa opção, deverá ser informado o Alias e o Intervalo de Sincronização.
- Na tela inicial do App deve ser informado o mesmo Login e Senha que o usuário utiliza para acessar o ERP Datasul.
O login é realizado através do Basic Authentication, chamando o back end o fonte “profile.p”.
Importante
Importante
Programas rest chamados nas rotinas do APP
laborreport.p
order.p
ordercreate.p
profile.p
requestmaterial.p
servicerequest.p
taskdocument.p
Parâmetros que as rotinas rest recebem
Todos os programas rest recebem como parâmetros JSON, e tem que ser chamados via Basic Authentication informando Usuário e Senha.
Criação de OM
Chamada rest
http:// servidor : porta /api/mip/v1/ordercreate
Método:Post
Exemplo de chamado Criação da OM
"cdEquipe": "015",
"cdManut": "nsp",
"codEqpto": "040",
"dataCriacao": "2020-09-04T13:30:00.000Z",
"descricao": "Teste",
"dtManut": "2020-09-04T13:30:00.000Z",
"modulo": 1
Criação de SS
http:// servidor : porta /api/mip/v1/servicerequest
metodo:Post
Exemplo de chamado Criação da SS
codEqpto: "040"
descricao: "Jeffe"
Busca Perfil e Menu
Método get sem parâmetros
http:// servidor : porta/mip/v1/profile/profile