Contextualização

Atualmente a solução dataplace contempla a comunicação do ERP x Equipamento SAT das seguintes maneiras:

1 – Porta serial: Através de porta serial é feito o envio de comandos para o equipamento, efetivando a comunicação. A porta serial pode também ser acessada via Terminal server, ou em casos de uso no cloud, pelo App client do TS plus.

2 – Aplicativo de gerenciamento de fila: Através de um broker do SQL server, o ERP se comunica com o equipamento SAT por intermédio do pSymSAT_queue.exe. O aplicativo que controla a fila de execução se comunica da mesma forma que o item 1, via porta serial.

Problema

1 – Há equipamentos que não se comunicam via porta serial, o que impede utlização via porta compartilhada nos casos de terminal server e App client do TS plus.

2 – Há clientes que querem utilizar o Dataplace ERP na solução cloud, via navegador, mas isso não é possível.

Solução adotada

Dataplace ERP

Nova camada
(Api REST) Criação de um intermediador Dataplace ERP x Equipamento site, com suporte a protocolo http, conforme diagrama, que exemplefica uma venda:

1 – O ERP, efetua a venda e com base no equipamento SAT selecionado (quando marcada a opção “SAT Ativo para funcionamento via API” e feitas as devidas configurações) envia para a API, hospedada na nuvem, a informação da venda, com os dados de autenticação e do destinatário, que é o equipamento SAT. Neste contexto, tanto equipamentos configurados com comunicação direta quanto os por fila, funcionarão.

2 – A requisição chega até a API, que identifica o usuário cadastrado (equipamento), verifica se o mesmo está na lista de equipamentos e se sim, envia para o equipamento, via client.

3- A mensagem é recebida pelo client que é um programa executável (Dataplace.Sat.Client.exe) que fica rodando na mesma máquina que está o equipamento SAT.

4 – Após receber a resposta do equipamento, o client encaminha a resposta para a API

5 – A reposta é finalmente entregue ao ERP, que segue o fluxo padrão.

Alterações no sistema

Dp.Library.01.dll: Toda comunicação SAT é feita passando pela dp.library.01, que agora, ao invés de encaminhar para o equipamento, pode enviar para a Nova camada (api).

Configurador Geral(psymCfg01);

No cadastro de equipamentos SAT, foi criado um novo campo: SAT Ativo para funcionamento via API.

Marcando este campo é possível abrir uma nova janela para configurar o funcionamento via API:

Nesta nova janela, há os seguintes dados que devem ser configurados com auxílio da equipe de suporte:

A – Endereço da API: Endereço onde a API vai ser hospedada;

B – Identificador do dispositivo: o usuário deve gerar um identificador clicando no botão ao lado do campo;

C – Senha: Uma senha forte para autenticação (mínimo 6 caracteres, 1 maiúscula, 1 minúscula e um número)

Cadastrados estes dados, o usuário deve salvar para habilitar o botão processar.

Após salvar, deve contactar o suporte, que irá gerar o hash de instalação.

D – Hash de instalação: Este hash de instalação será gerado por um aplicativo de uso restrito a alguns profissionais de Suporte (a definir ainda). E após inserido, deve processar.

Finalizado o processamento, o equipamento já estará cadastrado na API e pronto para a segunda etapa da configuração.

Dataplace.Sat.Client.exe

ste executável deverá ser instalado na máquina onde ficará o equipamento SAT. Ele não depende de instalação do Symphony, portanto, ideal criar uma pasta específica para ele no cliente.

As informações cadastradas no configurador geral, podem ser inseridas campo a campo, neste aplicativo, ou clicando em Copiar na janela de Gerenciar configurações do SAT, no configurador geral, e colando usando (Ctrl + V) no campo Endereço da API.

Após os dados preenchidos, e a Dll devidamente informada, basta clicar em Iniciar para que a comunicação com o equipamento SAT seja estabelecida e a comunicação com a API também.

Com o status Conectado ativo, pode-se usar o ERP normalmente.