Histórico da Página
Explicação geral
A Sascar provê os sinais através do webservice http://sasintegra.sascar.com.br:80/SasIntegra/SasIntegraWSService e do serviço: obterPacotePosicoes. Para nos conectarmos facilitar a conexão com este provedor, implementamos um artefato que de tempos em tempos irá que chamar este webservice e registrar os sinais retornados no para o Tracking Central. A instalação As instalações do TRE após corretamente configurada deve , após configuradas deverão acessar o Tracking Central de tempos em tempos e e 'baixar' estes sinais para ela.os sinais que lhe interessarem, sem deletar os registros da base do Tracking Central.
Para facilitar o acesso as informações, dividimos esta documentação em duas visões:
Page Tree | ||||
---|---|---|---|---|
|
Fluxo Sinais e macros
- O provedor Sascar chama o webservice
- O webservice retorna os sinais que ainda não foram lidos
- Provedor converte os sinais e envia para o tracking:
- Caso na resposta do serviço o campo 'nomeMensagem' não seja vazio:
- Cria uma ocorrência 'Pernoite' caso o valor seja 'PERNOITE' ou 'PARADA PARA PERNOITE'
- Caso contrário, cria uma ocorrência com o valor de 'nomeMensagem'
- Caso tenha 'eventos' de 'código' 5, cria uma ocorrência 'tracking.occurrence.max.speed'
Simulando sinais
1. Com o [SoapUI](https://www.soapui.org/) crie um mock do wsdl disponível em <http://sasintegra.sascar.com.br:80/SasIntegra/SasIntegraWSService?wsdl>.
2. Crie uma resposta do mock, seguindo o exemplo em Exemplo de retorno do webservice.
3. Configure a property 'sascar.url' para apontar para seu mock.
4. Suba o provedor. Por padrão, à cada 20 segundos, o mock criado será chamado e as posições serão enviadas para o rastreamento.
Exemplo de chamada para o webservice
Bloco de código | ||
---|---|---|
| ||
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"> <SOAP-ENV:Header/> <SOAP-ENV:Body> <ns3:obterPacotePosicoes xmlns:ns3="http://webservice.web.integracao.sascar.com.br/"> <!-- usuário e senha criados no sistema da sascar (configurado pelo application-tracking-sascar.properties) --> <usuario>Joaquim</usuario> <senha>S3nh4C0mLetr4sH4ck3r</senha> <!-- quantidade máxima de posições para adquirir (configurado pelo application-tracking-sascar.properties) --> <quantidade>300</quantidade> </ns3:obterPacotePosicoes> </SOAP-ENV:Body> </SOAP-ENV:Envelope> |
Exemplo de retorno do webservice
Bloco de código |
---|
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservice.web.integracao.sascar.com.br/"> <soapenv:Header/> <soapenv:Body> <web:obterPacotePosicoesResponse> <!-- uma ou mais repetições --> <return> <!-- Número do dispositivo --> <idVeiculo>10</idVeiculo> <!-- coordenadas do sinal --> <latitude>-22.735486359342058</latitude> <longitude>-47.64359927583132</longitude> <!-- horário do sinal --> <!-- é possível usar uma data variável usando o SoapUI: --> <!-- <dataPosicao>${=new Date().format("YYYY-MM-dd'T'HH:mm:ss.SSS-03:00")}</dataPosicao> --> <dataPosicao>2018-08-02T17:55:05-03:00</dataPosicao> <!-- Nome da macro. Esta tag tem que estar presente, mas pode ser vazia Valores esperados: - "PERNOITE", "PARADA PARA PERNOITE" -> Gera ocorrência "Pernoite" Qualquer outro valor não vazio: - Será gerado uma ocorrência com o valor fornecido --> <nomeMensagem>PERNOITE</nomeMensagem> <!-- campos opcionais --> <!-- endereço do sinal --> <rua>Rua visconde do rio branco</rua> <cidade>Piracicaba</cidade> <uf>SP</uf> <!-- velocidade (apenas valor inteiro) --> <velocidade>60</velocidade> <!-- temperatura dos sensores (apenas valor inteiro) --> <temperatura1>25</temperatura1> <temperatura2>30</temperatura2> <temperatura3>35</temperatura3> <!-- eventos --> <!-- esta tag pode ser repetida para indicar mais eventos num único sinal --> <eventos> <!-- código 5 indica que passou do limite de velocidade e será gerada uma ocorrência --> <!-- outros códigos serão ignorados --> <codigo>5</codigo> </eventos> </return> </web:obterPacotePosicoesResponse> </soapenv:Body> </soapenv:Envelope> |
Fluxo geral no código
> Esse fluxo será descrito de forma a evitar dificuldades de entendimento do fluxo por parte dos desenvolvedores. Portanto, será num formato técnico e serão referenciados nomes de classes, métodos, projetos, etc.
Os Tracking Providers (Provedores de Rastreamento) possuem um fluxo diferente um do outro. Porém, a maioria utiliza o 'tracking-provider-base' como um projeto suporte, ou seja, utilizam várias funcionalidades e fluxos do próprio projeto. O Sascar é um dos provedores que o utiliza.
No Sascar, existe uma classe 'SascarMain' que é a 'main' e as anotações de propriedades do 'Spring'. Pelas anotações é achado o método 'SascarRunner#run()', anotado com [*@Scheduled*](https://docs.spring.io/spring/docs/3.2.x/spring-framework-reference/html/scheduling.html#scheduling-annotation-support-scheduled) específico da Sascar. Esse método chama periodicamente o 'getSignals()' do 'SascarClient', fazendo com que o fluxo do Sascar seja executado constantemente.
FAQ
Suporta múltiplos clientes ao mesmo tempo?
Como toda vez que chamamos o WebService do Sascar, pegamos todos os novos sinais, não é possível compartilhar este provedor com vários clientes. Porém, deve ser possível reutilizá-lo se for feito um outro cadastro de usuário e senha para outro usuário.
Tratamento de erros
Não há nenhum tratamento de erros. Ou seja, caso algum sinal esteja inválido, por algum motivo, ele não será enviado para o tracking. Caso ocorra algum erro ao enviar para o tracking, também nada será feito e o sinal será perdido.