Praxio - AvaWiki | Instalando o AvaGetMail

Pesquisar na AvaWiki



Instalando o AvaGetMail

  O que é?

O AvaGetMail é um serviço que conecta nas contas de e-mails configuradas nas filiais do sistema para fazer o download dos arquivos XML para uso no Avacorp.

  Quando utilizar?

Deve-se utilizar este serviço quando a empresa utilizar arquivos XML ao gerar documentos.

  Como fazer?

1. Pré-Requisitos:

ASP .NET 2.0;

IIS 6 ou superior;

Web Service AvacorpVirtual.

2. As atualizações do serviço AvaGetMail serão disponibilizadas junto com as patchs do sistema quando sua atualização for necessária. Se sua empresa utiliza este serviço fique atento quando estiver realizando atualizações de patch, se a tela abaixo aparecer durante a atualização verifique se o serviço AvaGetMail está disponível para download.

Para mais informações sobre o download de serviços acesse o manual clicando aqui.

Download AvaGetMail.

Download AvaGetMail.

Observação: O download das atualizações de serviços da tela acima não é obrigatória, então fique atento, pois se o download não for realizado aqui e a empresa utiliza o serviço será necessário acessar o este link para realizar o download.

2.1. Se você já utiliza o serviço AvaGetMail o mesmo deve ser desinstalado antes de executar a nova instalação, para isso execute o processo “Appwiz.cpl” no Windows.

Executando Appwiz.

Executando Appwiz.

2.2. Na tela de Programas e Recursos, selecione o AvaGetMail, e clique no botão Desinstalar na parte superior da tela ou clique com o botão direito no AvaGetMail e selecione a opção Desinstalar como mostra a imagem abaixo:

Desinstalando AvaGetMail.

Desinstalando AvaGetMail.

3. Para iniciar a instalação, após o download do serviço AvaGetMail faça a extração do arquivo AvaGetMail_”versão”.zip e inicie a instalação pelo arquivo “Setup.exe“.

Iniciando Instalação.

Iniciando Instalação.

Observação: Quando a instalação é realizada através do arquivo “Setup.exe”, o instalador verifica e instala os pré-requisitos do sistema e depois executa a instalação do arquivo de extensão “msi” automaticamente.

3.1 Nas telas abaixo clique no botão Avançar:

Instalando AvaGetMail.

Instalando AvaGetMail.

3.2 Durante a instalação aparecerá a tela abaixo, onde devem ser informados os dados da conexão com o banco de dados nos campos: • Servidor: Informe o endereço onde se encontra o banco de dados do Avacorp; Porta: Informe a porta de conexão do banco de dados do Avacorp; Banco de dados de produção: Informe o nome do banco de dados do Avacorp; Banco de dados de Homologação (opcional): O preenchimento do banco de dados de Homologação é opcional.

Configurando conexão.

Configurando conexão.

3.3. As informações referentes a Servidor e Banco de dados podem ser verificadas no rodapé do Sistema AvaCorp conforme figura abaixo.

Verificando servidor e banco.

Verificando servidor e banco.

3.4. Continuando a instalação, clique em Avançar e aguarde enquanto a instalação é realizada, ao final da instalação clique no botão Fechar.

Continuação da Instalação.

Continuação da Instalação.

4. Depois de instalado, o serviço requer a inicialização manual para sua primeira execução, depois o serviço será iniciado automaticamente quando o Windows for reiniciado. 4.1. Para iniciar o serviço execute o processo “Services.msc” no Windows como mostra a imagem abaixo.

Executando Services.

Executando Services.

4.2. Feito isso a tela de serviços será aberta, selecione o serviço AvaGetMail e clique no “play” na parte superior da tela ou clique com o botão direito no serviço e selecione a opção Iniciar.

Iniciando serviço AvaGetMail.

Iniciando serviço AvaGetMail.

4.3. Neste ponto a instalação está concluída. 5. Havendo necessidade de alterar ou adicionar novas conexões com o banco de dados, utilize o aplicativo “QuickConfig.exe”. O mesmo encontra-se no diretório onde o serviço foi instalado, por default o sistema instala na pasta Arquivos de programas\Avacorp\AvaGetMail (sistema 32bits) ou Arquivos de programas (x86)\ Avacorp\AvaGetMail (sistema 64bits), não há limite para o número de conexões permitidas. 5.1. Para alterar a conexão com o banco de dados abra o aplicativo “QuickConfig.exe”, selecione o registro e realize a alteração nos campos necessários e clique no botão Alterar conexão.

Alterando conexão.

Alterando conexão.

5.2. Para criar uma nova conexão realize o mesmo processo mostrado para alteração, informe o nome da sua conexão preenchendo o campo Nome da conexão, os demais campos preencha com as informações relativas à sua nova conexão com banco.

Criando nova conexão.

Criando nova conexão.

5.3. Para salvar a sua nova conexão clique no botão Adicionar conexão.

Salvando nova conexão.

Salvando nova conexão.

6.0. Após adicionar a conexão, também existe a opção de ativação dos Logs, afim de verificar monitorar os registros do serviço, porém, para que os Logs sejam ativados, primeiramente, é necessário que o serviço esteja parado, portando, acesse os serviços novamente e pause o AvaGetmail.

Pausando serviço

Pausando serviço

6.1. Feito isso, deverá ser acessada a pasta onde foi instalado o AvaGetMail para buscarmos pelo arquivo AvaGetMail.exe.config esse arquivo é do tipo Arquivo CONFIG e para ativermos os logs do serviço, devemos acessá-lo com algum editor de texto, utilize um de sua preferência.

Alterando o arquivo CONFIG

Alterando o arquivo CONFIG

6.2. Será aberto o arquivo de configuração, e nele, procuraremos pelas tags assinaladas na imagem abaixo, as mesmas possivelmente estará com o value = “false”, para que os logs sejam ativados de fato, deve-se apenas alterar o false para true.

Alterando os valores para "True"

Alterando os valores para “True”

6.3. Após definir as configurações de log para “true“, inicie novamente o serviço.

Iniciando novamente o serviço

Iniciando novamente o serviço

6.4. Após alterar os valores para “true“, acesse novamente a pasta onde está instalado o AvaGetMail, deverá ter sido criada uma nova pasta chamada “Log”.

Nova pasta criada

Nova pasta criada

6.5. Dentro de uma subpasta dessa nova pasta criada, estarão os arquivos de log que foram gerados pelo serviço.

Arquivo de log

Arquivo de log

Conteúdo Relacionado:

Como configurar e-mail para o AvaGetMail no Avacorp?

 

  Erros conhecidos:
1. Erro na execução do service: Unable to read data from the transport connection.

Erro na conexão do serviço.

Erro na conexão do serviço.

1.1. Este erro ocorre quando o serviço AvaGetMail não consegue conectar ou perde a conexão inesperadamente com o servidor de e-mails. Em alguns servidores, pode ocorrer também quando já existe uma conexão aberta na mesma conta de e-mail. Uma forma de evitar este tipo de problema é sempre configurar contas de e-mail diferentes para cada filial.

Print Friendly, PDF & Email
Top