Praxio – AvaWiki

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

http://www.avaconsa.com.br/Avacon/Programas/dotNetFx40_Full_x86_x64.exe

1.3.2. Instal 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.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.

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. 

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.

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

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.

1.3. Ao realizar o arquivo acima, clique com o botão direito e selecione opção Executar 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.

1.6. Será exibida a tela serviço instalado, clique em OK e finalize o processo.

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.

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:

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:

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.

2.1.2.1. Em seguida, basta clicar em Confirmar:

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:

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.

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.

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.

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.

Pré-requisitos:

• 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

1.3. Na tela de configurações clique com o botão direito e no menu pop up exibido, selecione Alterar:

1.4. Na tela Alterando Configurações, clique na aba 3 – Continuação:

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.

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:

2.2. Na tela de Vínculos do Cadastro, clique em Incluir.

2.3. Na tela de Vínculo do Cadastro, selecione no campo Vínculo a opção Rastreadora e clique em Confirmar.

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:

3.2. Será exibida a tela Alterando Veículo. Nela, clique na aba Rastreamento:

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.

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.

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.

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

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

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:

• 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 Direção
• Separador de campos: _ (underscore)
• Jornada do motorista: Início de Direção

Após ter inserido estas configurações, clique no botão Confirmar.

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:

• Sentido: Veículo -> Central
• Tipo documento: Manifesto de carga
• Rastreadora: Nome da Rastreadora
• Código comando: Código alfanumérico
• Descrição: Reinício de Viagem
• Separador de campos: _ (underscore)
• Jornada do motorista: Reinício de Viagem

Após ter inserido estas configurações, clique no botão Confirmar.

5.10. De volta à tela Comunicação com Rastreadoras de Veículos e Clientes, clique no botão Incluir:

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:

• Sentido: Veículo -> Central
• Tipo documento: Manifesto de carga
• Rastreadora: Nome da Rastreadora
• Código comando: Código alfanumérico
• Descrição: Parada para Descanso
• Separador de campos: _ (underscore)
• Jornada do motorista: Parada para Descanso

Após ter inserido estas configurações, clique no botão Confirmar.

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:

• Sentido: Veículo -> Central
• Tipo documento: Manifesto de carga
• Rastreadora: Nome da Rastreadora
• Código comando: Código alfanumérico
• Descrição: Parada para Refeição
• Separador de campos: _ (underscore)
• Jornada do Motorista: Parada para Intervalo

Após ter inserido estas configurações, clique no botão Confirmar.

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:

• Sentido: Veículo -> Central
• Tipo documento: Manifesto de carga
• Rastreadora: Nome da Rastreadora
• Código comando: Código alfanumérico
• Descrição: Parada para Espera
• Separador de campos: _ (underscore)
• Jornada do Motorista: Parada para Espera

Após ter inserido estas configurações, clique no botão Confirmar.

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:

• Sentido: Veículo -> Central
• Tipo documento: Manifesto de carga
• Rastreadora: Nome da Rastreadora
• Código comando: Código alfanumérico
• Descrição: Parada para Espera
• Separador de campos: _ (underscore)
• Jornada do Motorista: Parada para Espera

Após ter inserido estas configurações, clique no botão Confirmar.

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:

• Sentido: Veículo -> Central
• Tipo documento: Manifesto de carga
• Rastreadora: Nome da Rastreadora
• Código comando: Código alfanumérico
• Descrição: Fim de Jornada
• Separador de campos: _ (underscore)
• Jornada do Motorista: Fim de Jornada

Após ter inserido estas configurações, clique no botão Confirmar.

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:

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