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 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çosServiço.

Sistemas Envolvidos

Os sistemas envolvidos na integração são:

• Aplicativo Minha Manutenção
• ERP Datasul

Pré-requisitos para instalação do APP

1. Smartphone ou tablet com Android a partir da versão 5.0;
2. Acesso à internet para baixar o aplicativo e para sincronizar as informações do APP com o ERP;
3. Usuário e Senha de acesso ao Datasul;
4. Cadastro do Alias de Acesso no Mingle (somente para conexão via Totvs Mingle).

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.1 -

1. Localizar o arquivo server.xml, que pode ser encontrado na instância do Jboss: ".\deploy\jboss-web.deployer\server.xml"

1. 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:

1. Na tela inicial em configurações, deve escolher o tipo de conexão:
   1. Acesso Direto: Ao selecionar essa opção, deverá ser informado o Servidor(IP), a Porta e o intervalo de sincronização

1. 1. ;
   2. Acesso via Mingle: Ao selecionar essa opção, deverá ser informado o Alias e o Intervalo de Sincronização

1. 1. .
2. Na tela inicial do App deve ser informado o mesmo Login e Senha que o usuário utiliza para acessar o ERP Datasul.

1. .

O login é realizado através do Basic Authentication, chamando o back end o fonte “profile.p”, para .

Pré-requisitos instalação do APP

1. Smartphone ou tablet com Android a partir da versão 5.0;
2. Acesso à internet para baixar o aplicativo e para sincronizar as informações do APP com o ERP;
3. Usuário e Senha de acesso ao Datasul;
4. Cadastro do Alias de Acesso no Mingle*.

*Para solicitar a criação do Alias, acesse o endereço https://mingle.totvs.com.br/landpage/.

Datasul

Insira aqui as informações pertinentes a Datasul.

Instalação/Atualização

Este tópico tem por objetivo orientar a instalação da integração, visando o seu funcionamento completo. Instalação de produtos ou ferramentas necessárias podem referenciar outros documentos existentes, desde que estejam disponíveis no repositório de documentação da TOTVS ou sejam enviados junto com o documento da integração em si. As informações mínimas necessárias para teste tópico são:

• Procedimentos que devem ser observados quando um dos produtos for atualizado.
• Configuração necessária que deve ser realizada em arquivos de configuração ou programas de parâmetros etc.
• Arquivos diversos que devem ser mantidos em determinados locais para o funcionamento da integração, exemplo: xml, xsd.
• Atualizações necessárias em banco de dados ou instruções para que elas sejam feitas.
• Processos, módulos ou programas que precisam ser instalados ou atualizados. Deve ser definida a versão mínima necessária dos programas envolvidos.
• Ferramentas, servidores ou serviços que precisam ser disponibilizados e configurados, o que pode gerar necessidade de novo hardware ou aumento de capacidade. Exemplo: serviço de WebService.
• Instruções para habilitar a comunicação da ferramenta EAI entre as partes, quais rotas devem ser definidas ou como as transações devem ser habilitadas.

Datasul

Insira aqui as informações pertinentes a Datasul.

Versão do Aplicativo Minha Manutenção

A versão atual da build do APP é a 1.0.17 e os fontes são versionados no TFS.

Programas rest chamados

nas rotinas

do APP

laborreport.p

logerror.p

mobile.p

order.p

ordercreate.p

profile.p

requestmaterial.p

servicerequest.p

taskdocument.p

validacontador.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/ordercreatemetodo

Método:Postparamametros obrigatorios
cdEquipe

Exemplo de chamado Criação da OM

"cdEquipe": "015" codigo da equipe,

"cdManut": "inspnsp"  codigo da manutenção,

"codEqpto": "040" codigo equipamento,

"dataCriacao": "2020-09-03T1904T13:2830:1100.524Z000Z",

"descricao": "testeTeste",

"dtManut": "2020-09-03T1604T13:2730:41-03:00.000Z",

"modulo": 1 modulo = 1 Manutenção industrial.

Criação de SS

http:// servidor : porta /api/mip/v1/servicerequest

metodo:Postparamametros obrigatorios

Exemplo de chamado Criação da SS

codEqpto: "040" Equipamento e descricao
descricao: "Jeffe"

Busca Perfil e Menu

Metodo Método get sem paramametrosparâmetros
http:// servidor : porta/mip/v1/profile/profile

depois a gente melhora mais 

pq tem que ser chamado no modelo de api novo do frame

ai tem uma doc deles pra isso

ai os cara que vão ler

nao vou detalhar algo que ja tem

Exemplo de chamado do rest profile.p

"ttPermissaoAcesso": {

                "ttPermissaoAcesso": [

                               {

                                               "permitePlayStop": true

                               }

                ]

},

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