Manual Serviço AvaTracert | Praxio - AvaWiki
Manual Serviço AvaTracert
AvaTracert é um serviço cujo a finalidade é conseguir realizar o gerenciamento da frota. Utilizando os recursos de monitoramento do posicionamento de veículos e demonstrações de históricos das ocorrências com a rastreadora.
Deve ser utilizado quando for necessario contratar o serviço de Rastreamento para os veículos da sua empresa.
Para a utilização do Avatracert deve possuir os seguintes pré requisitos abaixo:
Possuir contrato com alguma das nossas Rastreadoras homologadas. Abaixo estão as Rastreadoras disponíveis:
Omnlink
Possuir o cadastro da Rastreadora no sistema Avacorp.
Possuir veículos com antenas cadastradas no sistema avacorp.
Possuir Programação da Exportação de relatório automático cadastrados.
Possuir o serviço AvatracertSvc instalado
Possuir o serviço Avatracert Web instalado
Possuir o Serviço AvaEdiSCV
Instalando o AvaTracertWeb
1. Para que o AvaTracert funcione corretamente, o mesmo precisa que alguns pacotes e programas estejam instalados corretamente. Para isso, cheque se a máquina no qual o serviço vai rodar já possui esses softwares instalados. Caso contrário, siga o passo a passo das instalações.
1.1. Instalar .NET 3.5
http://www.avaconsa.com.br/Avacon/Programas/dotnetfx35.exe
1.1.1. Instalar MySql.Data
http://www.avaconsa.com.br/Avacon/Programas/MySql.Data.msi
1.1.2. Instalar Devartpostgresql61Pro
http://www.avaconsa.com.br/Avacon/Programas/Devartpostgresql61pro-Novo.exe
1.2. Requisitos para utilizar modulo Avatracert Sistema Avacorp (Win 32bits):
1.2.1. Instalar dotnet 4.0
http://www.avaconsa.com.br/Avacon/Programas/dotNetFx40_Full_x86_x64.exe
1.2.2. Instalar C++ 2005
http://www.avaconsa.com.br/Avacon/Programas/vcredist_x86_2005.exe
http://www.avaconsa.com.br/Avacon/Programas/vcredist_x86_2005-sp1.exe
1.2.3. Instalar C++ 2008
http://www.avaconsa.com.br/Avacon/Programas/vcredist_x86_2008.exe
http://www.avaconsa.com.br/Avacon/Programas/vcredist_x86_2008-sp1.exe
1.2.4. Instalar Cruntime
http://www.avaconsa.com.br/Avacon/Programas/CrRuntime.rar
1.3. Requisitos para utilizar modulo Avatracert Sistema Avacorp (Win 64bits).
1.3.1. Instalar dotnet 4.0
1.3.2. Instal C++ 2008
1.3.3. SetupCristal
http://www.avaconsa.com.br/Avacon/Programas/CrRuntime-32.rar
2. Instalando AvaTracertWeb
2.1. O primeiro passo é a criação da estrutura de pastas para o serviço. O caminho deve ser "Unidade\inetpub\wwwroot\".
2.1.1. Dentro da pasta "wwwroot", extraía os arquivos contidos no link abaixo:
Para ter acesso ao download, entre em contato com a Avacon.
2.1.2. Dentro da pasta "Unidade\inetpub\wwwroot\avatracert", busque pelo arquivo "web.config" e edite-o. Na seção <connectionStrings>, substitua os itens entre colchetes pelos dados do seu servidor e banco de dados:
<add name="AvaTracertConnectionString" providerName="PostgreSqlDirect.NET" connectionString="User Id=postgres;Password=[SENHA_DO_BANCO];Host=[IP_DO_BANCO];Database=[NOME_DO_BANCO];Schema=public"/>
2.1.3. Agora basta salvar e fechar o arquivo.
2.2. Configuração do IIS
2.2.1. Abra o IIS e busque pela pasta do "AvaTracert" recém criada. Para isso, expanda as Connections (coluna da esquerda) até "NOME_DO_SERVIDOR\Sites\Default Web Site\AvaTracert". Com a pasta do "avatracert" encontrada, clique com o botão direito do mouse sobre ela e selecione a opção Converter para aplicativo:
2.2.2. A tela "Adicionar Aplicativo" irá aparecer. Nela, clique em "OK":
2.2.3. Com o Avatracert selecionado na coluna da esquerda, clique em "Exibição de conteúdo":
2.2.4. Em seguida, clique com o botão direito do mouse sobre o arquivo "Service.asmx" e selecione a opção "Procurar":
2.2.5. Uma tela no navegador, semelhante a essa, deve aparecer:
Lembrando que, caso surja uma tela de erro, confira de todos os procedimentos anteriores foram feitos corretamente."
3. Instalando AvaTracertSVC
3.1. O primeiro passo é a criação de estrutura de pasta dentro do servidor onde está a aplicação do Avacorp. O caminho deve ser "Unidade:\Avacorp\AvaTracert".
3.1.1. Dentro da pasta Avatracert, extraia os a arquivos contidos no link abaixo:
http://www.avaconsa.com.br/Avacon/Programas/AVATRACERT_SVC.ZIP
3.2. Com os arquivos extraídos, rode o arquivo AvaTracert Service.exe e confirme a instalação do serviço.
Instalando AvaTracertSVC
1. Baixe o serviço AvaTracertSVC.rar. e extraia na diretório de serviços. Logo após, identifique o Executavel AvaTracert e clique com o botão direito executar como Administrador. E logo após clique no botão Install da tela AvaTracert Service.
Lembrando que para que funcione corretamente o Avatracert, o ODBC de usuário e Sistema devem estar configurados corretamente.
Instalando AvaTracert
1.1 Será exibida uma tela de permissão para executar como administrador, na mesma clique na opção SIM.
1.2. Ao terminar a instalação será exibida uma mensagem avisando que o serviço foi instalado.
Serviço Instalado
Instalando AvaEDISVC
1. Ao realizar o download do Serviço AvaEdiSVC, extraia o mesmo no local onde se encontra todos os serviços instalados e logo após acesse a basta.
1.1. Ao abrir a pasta, encontre o arquivo AvaEDISVC.ini e logo após clique com o botão direito sobre o mesmo selecione a opção Edit whith Notapad++.
Editando Arquivo EDISVC.ini
1.2. Será aberto o arquivo e no mesmo adicione depois do "=" o local onde se encontra aplicação nos campos CAMINHOAVACORP E CAMINHOBASE. logo após alterar salve e confirme o arquivo.
Alteração do arquivo
1.3. Ao realizar o arquivo acima, clique com o botão direito e selecione opção Executar como Administrador.
Executando como Administrador.
1.4. Autorize a instalação do serviço e siga o próximo passo.
1.5. Será exibida a tela de AvaEdi Service, na mesma clique no botão Install.
Instalando serviço
1.6. Será exibida a tela serviço instalado, clique em OK e finalize o processo.
Serviço instalado.
2. Caso deseje iniciar o serviço ou parar, acesse o atalho Win + R e digite no campo de busca a palavra Services.msc e clique em OK.
2.1. Logo Após será aberta a tela de serviços, no mesmo identifique o serviço que deseja parar ou iniciar, e clique com o botão direito, parar. ou iniciar.
Cadastros de Programação da Exportação de relatório automático
2. Agora, acesse o Módulo Cadastros Básicos/EDI Padrão/Relatório/EDI/Rastreadora Automático/Manutenção:
2.1. Na tela Exportação e Importação de dados automáticos, clique na lista e selecione a opção Incluir:
Tela de Exportação e Importação de dados automáticos.
2.1.1. No campo código, dê dois cliques no campo Código ou clique no botão para abrir a tela de Cadastros, ou selecione o campo e aperte F9:
Incluindo Importação/Exportação de Dados Automáticos.
2.1.1.1. Na tela Cadastros, busque pela Rastreadora configurada anteriormente e selecione a mesma.
2.1.2. De volta a rela tela Incluindo Exportação/Importação de dados automáticos, preencha os seguintes campos:
Vínculo: preencha este campo com o número 22, que é o código para rastreadora no sistema.
Tipo: selecione a opção Integração rastreadora.
Configurando importação/exportação de dados.
2.1.2.1. Em seguida, basta clicar em Confirmar:
Confirmando configurações de importação/exportação.
2.2. De volta a tela Exportação Importação de dados automáticos, clique no cadastro recém feito com o botão direito do mouse e selecione a opção Programação:
Acessando programação de importação de dados.
2.2.1. A tela incluindo Programação de Exportação de relatórios automáticos, é onde serão cadastrados os intervalo e dias em que haverá comunicação entre a rastreadora e o sistema AvaCorp. Para isso, preencha os seguintes campos:
Dias da semana: na tela, existem todos os dias da semana. Deixe marcados como "Sim", aqueles dias em que deseja que haja o sincrinimos entre os sistemas.
Hora: determina a hora do dia em que será iniciado a comunicação com a rastreadora.
Adicionando programações
2.2.2. Agora, acesse a aba 2 – Inserir por intervalo, preencha os campos abaixo e clique em Confirmar:
Período de intervalo: o intervalo de tempo que se passará entre uma consulta e outra.
Hora final: a hora do dia em que a comunicação com a rastreadora será interrompida.
2.2.3. Logo após confirmar a inclusão de programações de exportação de relatório automático, será aberta a tela com todas as programações inclusas corretamente.
Lembrando que logo após incluir todas programações, verifique se os serviços, AvaEdiSvc e AvaTracertSvc estão iniciados.
Programações inclusas
1. Para realizar as configurações do veículo, acesse o caminho:
Cadastros Básicos > Veículos > Manutenção:
1.1. Identifique o veículo que o equipamento da Rastreadora foi instalado e vá até a aba 5 - Rastreamento.
1.2. Ao acessar a aba 5 - Rastreamento, preencha os campos com os dados fornecidos pela rastreadora.
Rastreadora: Nesse campo deve ser informado o CNPJ da Rastreadora que estará utilizando.
Número da Antena: Preencha o número da antena conforme fornecido pela Rastreadora.
Integrar posições: Informar Sim caso deseja que o veículo informe sua posição no mapa. Caso não deseje, informe Não.,
Logo após o termino de preenchimento das informações da Rastreadora, clique em confirmar.
As informações a baixos são fictícias. Foi utilizado a empresa AutoTrac apenas como exemplo de Rastreadora. A empresa Avacon possui contrato com 6 Outras Rastreadoras que estão sendo citadas nos pré requisitos do manual.
Aba 5 - Rastreadora
Configurações da Rastreadora
1. para realizar as configurações da Rastreadora, acesse o caminho:
Cadastros Básicos > Clientes, Fornecedores, Etc... > Manutenção
1.1. Será aberta a tela de cadastros, na mesma realize a busca pelo cadastro da Rastreadora, e clique com o botão direito selecionando a opção Vínculos.
1.2. Ao abrir a tela de vínculos, caso não possua o vínculo de Rastreadora, inclua o mesmo. Caso já exista, apenas clique com o botão direito e selecione opção Configuração de Parâmetros/ Alterar.
1.3. Será aberta a tela de Configuração de Parâmetro, na mesma preencha todos os campos com as informações que serão fornecidas pela Rastreadora.
Tipo de integração: Esse parâmetro tem as seguintes opções: Sql Server, Oracle, MySQL, PostgreSQL, WebService, Socket. Esses são os tipos de comunicações com a Rastreadora, o preenchimento deste campo dependerá da informação fornecida pela Rastreadora.
Banco de dados: Esse campo deve ser preenchido com o nome do banco de dados da Rastreadora.
Host: Esse campo deve ser preenchido com o endereço do banco de dados da Rastreadora caso o meio de comunicação seja SQLServer.
Porta: Informe a porta que será realizada a comunicação com a rastreadora e o Avacorp
Usuário: Informe os dados do usuário fornecidos pela Rastreadora.
Senha: Informe a senha do usuário fornecido pela Rastreadora.
Usuário Web: Informe os dados do usuário web fornecidos pela Rastreadora
Senha Web: Informe a senha do usuário web fornecido pela Rastreadora.
Separador Retorno: Informe o separador de retorno
Quantidade de minutos a integrar posicionamento de veículos: Informe a quantidade de minutos a integrar posicionamento de veículos
Integrar eventos: Informe se deseja informar eventos com a Rastreadoras.
Logos após o termino de preenchimento das informações, clique em confirmar.
Dados da Rastreadora
Processos AvaTracert
Como criar Macros para utilizar no AvaTracert e em jornada de motoristas?
• Integração do Avacorp com a rastreadora através do Avatracert.
• Configurações dos tempos, conforme a legislação local vigente.
1. Primeiramente deveremos verificar se algumas configurações foram previamente inseridas no sistema. A primeira delas diz respeito às configurações de tempos do motorista. Os tempos de: direção, descanso, intervalo interjornada, intervalo intrajornada, descanso semanal e tempo interjornada emissão manifesto, podem sofrer diferenças conforme legislação de trânsito vigente para cada estado. Portanto, acesse o módulo Cadastros/Estrutura da Holding/Manutenção:
1.2. Na tela empresas, selecione a sua empresa, clique com o botão direito sobre a mesma e no menu pop up exibido clique em Configurações:pl
Tela de manutenção da empresa
1.3. Na tela de configurações clique com o botão direito e no menu pop up exibido, selecione Alterar:
Selecionando as configurações da empresa para alterar
1.4. Na tela Alterando Configurações, clique na aba 3 – Continuação:
Alterando configurações da empresa
1.5. Identifique o agrupamento Motoristas e valide se os valores pertencentes a ele obedecem à regra identificada no Item 1. Se estiverem de acordo, clique no botão Confirmar. Caso contrário, insira os tempos manualmente conforme legislação de seu estado. Em seguida clique em Confirmar.
Alterando configuração da empresa
2. Vamos agora configurar o vínculo da rastreadora no cliente. Para tal selecione Cadastros Básicos/ Clientes, Fornecedores.../ Manutenção.
2.1. Identifique qual empresa será a rastreadora, clique com o botão direito sobre ela e selecione Vínculos:
Tela de manutenção de cadastro
2.2. Na tela de Vínculos do Cadastro, clique em Incluir.
Tela de manutenção de vinculos
2.3. Na tela de Vínculo do Cadastro, selecione no campo Vínculo a opção Rastreadora e clique em Confirmar.
Incluindo vinculo do cadastro
2.4. Na tela de Vínculos do Cadastro será então exibida a rastreadora vinculada, clique em no botão Fechar na tela:
3. Outra pré-configuração importante deve ser identificada no veículo que estará configurado para a realização do transporte. Para tanto, abra o módulo Cadastros/ Veículos/ Manutenção:
3.1. Na tela de veículos, identifique o veículo, selecione-o e clique em Alterar:
Tela de manutenção de veículo
3.2. Será exibida a tela Alterando Veículo. Nela, clique na aba Rastreamento:
Alterando veículo
3.3. Nesta aba, verifique se os campos Rastreadora, Número da antena e Integrar posições estão preenchidos, se não estiverem, preencha-os. Vale lembrar que o valor a ser inserido no drop down deste último campo deve ser "Sim". Em seguida, clique em Confirmar.
4. Mais um pré-requisito deve ser observado. Acesse o módulo Cadastros/ EDI Padrão/ Relatórios/ EDI/ Rastreadora Automáticos/ Manutenção.
4.1. Na tela Exportação e Importação de dados automáticos identifique se a rastreadora está configurada. Se estiver, clique no botão Fechar e siga para o passo 5. Caso contrário, clique no botão Incluir.
Tela de exportação e importação de dados automáticos
4.2. Na tela Incluindo Importação/Exportação de Dados Automáticos, preencha os campos Código com a empresa rastreadora, o campo Vínculo, deve ser preenchido com o Vínculo da Rastreadora e o campo Tipo deve ser preenchido com Integração Rastreadora. Após realizar essas configurações, clique em Confirmar.
Incluindo Importação/Exportação de Dados Automáticos
5. Encerradas as etapas de verificação das pré-configurações, podem-se iniciar as etapas de criação das macros. Sendo assim, vá para Operacional/ Cadastros Básicos/ Macros de Rastreamento/ Manutenção.
5.1. Na tela Comunicação com Rastreadoras de Veículos e Clientes, clique no botão Incluir.
Tela Comunicação com Rastreadoras de Veículos e Clientes
5.2. Na tela de Ocorrências, identifique a ocorrência Início de Jornada, selecione-a e clique no botão Selecionar (estamos considerando que todas as ocorrências estejam previamente cadastradas, caso não estejam, o manual para inclusão dessas deve ser observado).
Tela de manutenção de ocorrências
Atenção! Vale lembrar que: As Macros que serão inseridas aqui podem ser seguidas, porém servem apenas de exemplo e refletem a criação de macros mínimas para a Jornada de motoristas. Elas podem ser adaptadas conforme a complexidade das rotinas das Jornadas diárias já existentes em seu ambiente.
5.3. Na tela Incluindo Integração com a Rastreadora e Clientes, configure os campos conforme descrito a seguir. Os demais campos serão preenchidos automaticamente e devem manter seu valor default:
• Sentido: Veículo -> Central
• Tipo documento: Manifesto de carga
• Rastreadora: Nome da Rastreadora
• Código comando: Código alfanumérico
• Descrição: Início de Jornada
• Separador de campos: _ (underscore)
• Jornada do motorista: Início de Jornada
Incluindo Integração com Rastreadora e Clientes
Após ter inserido estas configurações, clique no botão Confirmar.
5.4. Novamente na tela Comunicação com Rastreadoras de Veículos e Clientes, clique no botão Incluir.
5.5. Na tela de Ocorrências, identifique a ocorrência Início de Direção, selecione-a e clique no botão Selecionar:
5.6. Na tela Incluindo Integração com a Rastreadora e Clientes, configure os campos conforme descrito a seguir. Os demais campos serão preenchidos automaticamente e devem manter seu valor default:
• Descrição: Início de Direção
• Jornada do motorista: Início de Direção
5.7. Novamente na tela Comunicação com Rastreadoras de Veículos e Clientes, clique no botão Incluir:
5.8. Na tela de Ocorrências, identifique a ocorrência Reinício de Viagem, selecione-a e clique no botão Selecionar.
5.9. Na tela Incluindo Integração com a Rastreadora e Clientes, configure os campos conforme descrito a seguir. Os demais campos serão preenchidos automaticamente e devem manter seu valor default:
• Descrição: Reinício de Viagem
• Jornada do motorista: Reinício de Viagem
5.10. De volta à tela Comunicação com Rastreadoras de Veículos e Clientes, clique no botão Incluir:
Tela Comunicação com Rastreadoras de Veículos e Cientes
5.11. Na tela de Ocorrências, identifique a ocorrência Parada para Descanso, selecione-a e clique no botão Selecionar:
5.12. Na tela Incluindo Integração com a Rastreadora e Clientes, configure os campos conforme descrito a seguir. Os demais campos serão preenchidos automaticamente e devem manter seu valor default:
• Descrição: Parada para Descanso
• Jornada do motorista: Parada para Descanso
5.13. Novamente na tela Comunicação com Rastreadoras de Veículos e Clientes, clique no botão Incluir:
5.14. Na tela de Ocorrências, identifique a ocorrência Parada para Refeição, selecione-a e clique no botão Selecionar:
5.15. Na tela Incluindo Integração com a Rastreadora e Clientes, configure os campos conforme descrito a seguir. Os demais campos serão preenchidos automaticamente e devem manter seu valor default:
• Descrição: Parada para Refeição
• Jornada do Motorista: Parada para Intervalo
5.16. Novamente na tela Comunicação com Rastreadoras de Veículos e Clientes, clique no botão Incluir:
5.17. Na tela de Ocorrências, identifique a ocorrência Parada para Espera, selecione-a e clique no botão Selecionar:
5.18. Na tela Incluindo Integração com a Rastreadora e Clientes, configure os campos conforme descrito a seguir. Os demais campos serão preenchidos automaticamente e devem manter seu valor default:
• Descrição: Parada para Espera
• Jornada do Motorista: Parada para Espera
5.19. Novamente na tela Comunicação com Rastreadoras de Veículos e Clientes, clique no botão Incluir:
5.20. Na tela de Ocorrências, identifique a ocorrência Fim de Direção, selecione-a e clique no botão Selecionar:
5.21. Na tela Incluindo Integração com a Rastreadora e Clientes, configure os campos conforme descrito a seguir. Os demais campos serão preenchidos automaticamente e devem manter seu valor default:
5.22. Novamente na tela Comunicação com Rastreadoras de Veículos e Clientes, clique no botão Incluir:
5.23. Na tela de Ocorrências, identifique a ocorrência Fim de Jornada, selecione-a e clique no botão Selecionar:
5.24. Na tela Incluindo Integração com a Rastreadora e Clientes, configure os campos conforme descrito a seguir. Os demais campos serão preenchidos automaticamente e devem manter seu valor default:
• Descrição: Fim de Jornada
• Jornada do Motorista: Fim de Jornada
5.25. Após ter inserido todas as macros, estas serão exibidas na tela de Comunicação com Rastreadoras de Veículos e Clientes, clique no botão Fechar:
Como visualizar histórico de ocorrências de Rastreamento do Avatracert
1. Para visualizar o histórico de ocorrências acesse o caminho:
Operacional > AvaTracert - Histórico Ocorrências de Rastreadoras > Manutenção.
1.1. Será aberta a tela de AvaTracert - Histórico de Ocorrência de Rastreamento, na mesma podemos visualizar todas as ocorrências listadas do Veículo para Central e da Central para o veículo na coluna Sentido. Ao lado será listado a Data da ocorrência, veículo, tipo de documento, número/Sequencia/Valor e evento, G.E.F.U, Comandando /Macro/Evento solicitado, Etc...