Integração com driver SDK

O driver SDK deve ser instalado no cliente para que a integração com dispositivos que utilizam SDK ocorra com sucesso. Esse driver monitora a comunicação (on-line ou off-line) com todos os dispositivos conectados a ele, envia-lhes dados e informações e efetua os procedimentos necessários para sua integração com o sistema.

Para obter o driver SDK:

1. Realize o cadastro na tela de drivers e selecione o item SDK no campo Tipo do driver;
2. Em seguida, acesse a tela Downloads para baixar esse driver;
3. Descompacte o driver;
4. Para que o driver possa ser iniciado e parado através dos arquivos start-service.bat e stop-service.bat, respectivamente, crie esse serviço no Windows, utilizando o arquivo create-service.bat. A execução desse arquivo .bat deve ser feito com um usuário administrador do Windows.

Um driver SDK também pode exigir o cadastro de certas informações, dependendo dos dispositivos que ele atenderá. Esse cadastro deve ser feito na tela de propriedades extensíveis e, em seguida, selecionado na tela de drivers. Para mais informações sobre as propriedades exigidas, verifique a documentação do fabricante dos dispositivos.

A configuração do driver é feita no arquivo config.properties, que fica no diretório onde o driver foi descompactado. Esse arquivo também pode ser obtido pelo botão Baixar arquivo de configuração da tela de drivers. O arquivo possui as configurações padrão já preenchidas, mas, se for necessário alterar algum dos seus campos, utilize um editor de texto (Bloco de Notas, por exemplo) para abri-lo.

Links utilizados pelo Proxy SDK:

• http://sam.senior.com.br/download/driver_sdk/version.properties
• http://sam.senior.com.br/download/driver_sdk/last/SDKProxy.zip
• wss://sam-api.senior.com.br/websocket/pendency
• https://sam-api.senior.com.br/sdk/v1

• proxy.driver.port: porta que detecta as conexões do driver. Quando a propriedade não é encontrada no arquivo, o valor padrão é de 61000;
• sdk.connection.timeout: tempo máximo, em milissegundos, pelo qual o driver aguarda para estabelecer uma conexão com o Ronda senior X. O valor mínimo sugerido é de 5000 milissegundos. Ele pode ser ajustado conforme a preferência do cliente, respeitando esse limite mínimo, especialmente em casos de instabilidade ou lentidão na conexão que possam prejudicar a comunicação entre o proxy e o SDK. Quando a propriedade não é encontrada no arquivo, o valor padrão é de 5000;
• sdk.request.timeout: tempo máximo, em milissegundos, do intervalo da consulta de pendências do driver ao Ronda senior X. O valor mínimo sugerido é 5000 utilizando websocket, ou 120000 sem websocket. Quando a propriedade não é encontrada no arquivo, o valor padrão é de 5000;
• sdk.api_response.timeout: tempo máximo, em milissegundos, pelo qual o driver aguarda uma resposta de um serviço solicitado ao Ronda senior X. O valor mínimo sugerido é de 5000 milissegundos, podendo ser ajustado conforme a preferência do cliente, desde que esse limite seja respeitado. Essa propriedade pode influenciar o desempenho caso o cliente tenha cadastros complexos em seu ambiente, o que pode aumentar o tempo de processamento das requisições pelo SDK. Nesses casos, recomenda-se configurar um valor mais alto para evitar falhas de comunicação com o proxy. Quando a propriedade não é encontrada no arquivo, o valor padrão é de 5000;
• sdk.driver0.driver_key: token do driver (disponível no cadastro de drivers). O proxy utiliza esse token para identificar o driver dentro do Ronda senior X. Caso não encontre a chave sdk.driver0.driver_key, o proxy considera que não há driver configurado.

O proxy oferece suporte ao gerenciamento de múltiplos drivers, sempre começando pela chave sdk.driver0.driver_key, incrementando o índice para encontrar uma nova chave. Por exemplo, sdk.driver1.driver_key, sdk.driver2.driver_key, e assim sucessivamente, até que o índice seguinte não seja encontrado.

Essas configurações são enviadas aos dispositivos quando o driver SDK for iniciado e quando o comando Configurar dispositivo for enviado ao sistema.

Informações de pessoas, crachás, locais e permissões de acesso são enviadas ao dispositivo sempre que houver uma inclusão, alteração ou exclusão nesses dados. "Permissões de acesso" correspondem a todos os dados que definem se uma pessoa pode efetuar acesso em um dispositivo: papéis, níveis, faixas horárias e afins. Somente pessoas que possuam acesso permitido no dispositivo e não estejam bloqueadas são enviadas.

Ao enviar essas informações e configurações aos dispositivos, se a comunicação estiver off-line, esses dados serão enviados no momento em que a comunicação for restabelecida.

Os procedimentos efetuados pelo driver SDK (Software Development Kit) são registrados em arquivos de log, que podem ser acessados dentro da pasta onde o driver está instalado. Cada mensagem do log possui uma classificação dentre as seguintes:

• FATAL: mensagens que interrompem o funcionamento da aplicação, forçando o serviço ou o executável a ser reiniciado;
• ERROR: mensagens de mau funcionamento da aplicação, que deve ser analisada pela equipe técnica da Senior, porém, o serviço ou o executável continua executando;
• WARN: mensagens que indicam falha em cadastros ou nas configurações do sistema. Devem ser analisadas pelo administrador do sistema;
• INFO: mensagens de funcionamento normal do sistema, como evento recebido, pendência enviada etc., para efeitos informativos;
• DEBUG: mensagens de funcionamento interno de componentes do sistema (como timer iniciado, parâmetros lidos etc.) para efeitos informativos à equipe técnica da Senior. Esse nível de log deve ser habilitado somente em caso de problemas com o ambiente;
• TRACE: mensagens de funcionamento interno de componentes do sistema, com detalhes dos dados que estão sendo tratados.

Os aplicativos geram na pasta LOG um arquivo contendo os registros de log. Ao atingir 10 MB, esse arquivo é automaticamente compactado e alocado em uma pasta de backup, sendo criado um novo arquivo de registro na pasta de LOG.

A pasta de backup criada tem seu nome alterado para a data atual do compactamento do arquivo de log e, por ser cíclica, ela comporta um máximo de dez arquivos alocados, substituindo o arquivo mais antigo quando houver um novo arquivo que ultrapasse a capacidade máxima.