Ir para o conteúdo principal

O que saber para testes dos nossos sistemas Desktop?

Testar sistemas desktop vai além das regras de negócio e do conhecimento do próprio sistema. Envolve também uma compreensão básica de hardware e software.

Normalmente, esses testes exigem que o QA utilize recursos e comandos do Windows, como:

  • Criação de variáveis de ambiente.

  • Manipulação de chaves de registro.

  • Verificação do Gerenciamento de Tarefas.

  • Execução de comandos via Prompt de Comando (CMD) ou navegador.

Hoje a Divisão Alterdata possui os seguintes sistemas desktop: "Alterdata Backup, Alterdata Installer, Bunker, Prosoft Backup e Updater".

Abaixo, listamos algumas dicas importantes para testar nossos sistemas:

Prosoft Backup

 

A principal distinção entre o Prosoft Backup e o Alterdata Backup reside na forma como realizam o salvamento dos dados. O Prosoft Backup é desenhado para efetuar o backup de pastas.

Essa característica se faz necessária devido à arquitetura da Prosoft, que utiliza três bancos de dados distintos. Historicamente, os clientes da Prosoft habituaram-se a realizar o backup diretamente da pasta de dados do banco, em vez de depender de uma conexão direta entre a ferramenta de backup e o banco de dados em si.

Para auxiliar nos testes com o Prosoft Backup, listamos abaixo alguns comandos e verificações importantes:

Como Verificar o Ambiente ou o Funcionamento do Serviço?

Para saber qual ambiente está sendo utilizado ou se o serviço do Prosoft Backup está operando corretamente, siga estes passos:

  1. Abra o navegador na máquina onde o serviço do Prosoft Backup está instalado.

  2. Digite o seguinte endereço na barra de URL: http://localhost:8768/v1/info

A resposta da requisição será um JSON, similar ao exemplo abaixo, contendo informações sobre o serviço:

{
  "version": "1.0.0.0",
  "status": "Ativo",
  "data": "2025-06-11 12:08:09.048212",
  "report_url": "http://updatecenter-qa.alterdatasoftware.com.br/api/backup/",
  "backup_url": "http://backup-server-alterdata-backup-staging.alterdatasoftware.com.br",
  "environment": "homologacao",
  "is_alterdata": false
}

Sempre que o serviço estiver ativo, o navegador responderá com informações importantes, como a versão do serviço do Prosoft Backup e as URLs das estatísticas e do servidor da API. Nas nossas máquinas de teste, é importante notar que essas URLs podem alternar entre ambientes de teste e de produção.

(O exemplo JSON acima é genérico e deve ser substituído pelo JSON real retornado pela sua requisição.)

Como Apontar o Prosoft Backup para o Ambiente de Testes

Para direcionar o Prosoft Backup para o ambiente de testes (homologação), siga os passos abaixo:

  1. Criar Variável de Ambiente: No Windows, crie uma variável de ambiente com o nome BACKUK_ENV e atribua o valor STAGING;HML.

  2. Verificar Ambiente: Com a variável ativa, o serviço do Prosoft Backup passará a responder no ambiente de homologação. Para confirmar, basta observar na resposta da requisição http://localhost:8768/v1/info (mencionada abaixo) se o campo environment apresenta o valor homologação.

Alterdata Backup

 

Como Verificar o Ambiente ou o Funcionamento do Serviço?

Assim como o Prosoft Backup, para verificar se o Alterdata Backup está operando corretamente, siga estes passos:

  1. Abra o navegador na máquina onde o serviço do Alterdata Backup está instalado.

  2. Digite o seguinte endereço na barra de URL: http://localhost:8768/v1/info

A resposta da requisição será um JSON, similar ao exemplo abaixo, contendo informações sobre o serviço:

{
  "version": "1.0.0.0",
  "status": "Ativo",
  "data": "2025-06-11 12:08:09.048212",
  "report_url": "http://updatecenter-qa.alterdatasoftware.com.br/api/backup/",
  "backup_url": "http://backup-server-alterdata-backup-staging.alterdatasoftware.com.br",
  "environment": "homologacao",
  "is_alterdata": false
}

Sempre que o serviço estiver ativo, o navegador responderá com informações importantes, como a versão do serviço do Alterdata Backup e as URLs das estatísticas e do servidor da API. Nas nossas máquinas de teste, é importante notar que essas URLs podem alternar entre ambientes de teste e de produção.

(O exemplo JSON acima é genérico e deve ser substituído pelo JSON real retornado pela sua requisição.)

Como Apontar o Alterdata Backup para o Ambiente de Testes

Para direcionar o ALterdata Backup para o ambiente de testes (homologação), siga os passos abaixo:

  1. Criar Variável de Ambiente: No Windows, crie uma variável de ambiente com o nome BACKUK_ENV e atribua o valor STAGING;HML.

  2. Verificar Ambiente: Com a variável ativa, o serviço do Alterdata Backup passará a responder no ambiente de homologação. Para confirmar, basta observar na resposta da requisição http://localhost:8768/v1/info (mencionada abaixo) se o campo environment apresenta o valor homologação.

Alterdata Backup

Updater
Apontamento do Serviço 

NoO NavegadorAlterdata daUpdater máquinaé um componente chave em nossos sistemas desktop. Abaixo, detalhamos onde o Alterdata backup está rodando, cole esse link http://localhost:8768/v1/info 
O retornoele é esse:

instalado,

{"version":seus "12.16.0-0",serviços "status":e "Ativo",como "data": "2025-06-11 11:40:04.274531", "report_url": "https://api-stats-backup-statistics-qa.apps.production.clusters.alterdatasoftware.com.br/", "backup_url": "https://backup-server-alterdata-backup-staging.apps.production.clusters.alterdatasoftware.com.br", "environment": "homologacao", "is_alterdata": false}

Nesse retorno temos importantes informações, como:
Versão instalada que está chamando a API: "version": "12.16.0-0"
URL da Api que está sendo chamada: "https://backup-server-alterdata-backup-staging.apps.production.clusters.alterdatasoftware.com.br"
Environment (ambiente que está sendo chamado): "homologacao" 


Variável de ambiente:

Usamossuas variáveis de ambiente parasão definirconfiguradas.

1. Locais de Instalação

  • Software Principal: A instalação do Updater é encontrada nos seguintes diretórios:

    • C:\Program Files (x86)\Alterdata\Updater

    • C:\Program Files\Alterdata\Updater

  • Banco de Dados: O banco de dados do Updater é armazenado na pasta ProgramData. Você pode acessá-lo diretamente pelo caminho:

    • C:\ProgramData\Alterdata\AutoUpdater\dados

    • Alternativamente, você pode encontrar a pasta colando %programdata% na barra de pesquisa do Explorador de Arquivos do Windows.

    • Para acessar a base de dados do Updater, utilize a ferramenta SqLiteAdmin - disponível no nosso repositório em Ferramentas de teste. 
2. Serviços

O Alterdata Updater opera com dois serviços principais:

  • Alterdata Updater: Este é o serviço principal responsável por funções cruciais como a busca de licenças, o gerenciamento de atualizações e outras operações fundamentais.

  • Alterdata Updater Guardian: Atua como um "guardião" do serviço principal. Sua função é proteger o Alterdata Updater contra eventuais falhas, garantindo que o serviço principal permaneça ativo.

3. Variáveis de Ambiente (Regedit)

As variáveis de ambiente do Updater são configuradas diretamente no Registro do Windows (Regedit), no seguinte caminho:

  • Computador\HKEY_LOCAL_MACHINE\SOFTWARE\Alterdata\Updater

A variável de ambiente mais importante é endereco_api, que define para ondequal osendpoint sistemas estarão apontando,Updater seestá apontando. Para direcioná-lo para Produção,um Homologaçãambiente específico, como o ou Produção.

BACKUP_ENV : STAGING;HML

Para ter mais infos de funcionamentoQA do(Quality AlterdataAssurance), backup,basta podealterar observarseu novalor ajuda:para o endereço correspondente:

UPDATER:

Local de instalação:
  • O Software em sí fica geralmente nessa pasta: C:\Program Files (x86)\Alterdata\Updater ou C:\Program Files\Alterdata\Updater
  • O banco de dados do Updater, por sua vez, fica armazenado na Program dataProgramdata,  nesse endereço:caminho: C:\ProgramData\Alterdata\AutoUpdater\dados ou pode ser encontrado colando esse termo na pesquisa do Explorador de arquivos do windows: %programdata%
Serviços:
  • Alterdata Updater - É o serviço principal do Updater que executa a busca de licenças, chamadas de downloads automáticos e etc.
  • Alterdata Updater Guardian - É o guardião de funcionamento do Updater, criado para proteger o Alterdata Updater de qualquer eventual queda, forçando o serviço principal a ser iniciado sempre. 
Variável de ambiente

Variáveis de ambiente do updater são colocadas diretamente no Regedit, nesse caminho:
"Computador\HKEY_LOCAL_MACHINE\SOFTWARE\Alterdata\Updater"

A principal variável de ambiente é a endereco_api que direciona para onde o updater está apontando. 
Para apontá-lo para Q, por exemplo, basta colocar tal endereço assim: http://updatecenter-qa.alterdatasoftware.com.br/api
image.png

Ferramentas Importantes
Ferramenta importantes

Barrinha de Download -  \\10.0.0.36\e$\Temp\Team-Blue\geral\Ferramentas de teste\Barrinha de Download
Muito utilizado para fazer consulta de licenças do Updater.
Lá colocamos o CRM do cliente e qual sistema eu quero solicitar na chamada

image.png

Dll From - \\10.0.0.36\e$\Temp\Team-Blue\geral\Ferramentas de teste\Read Dll From
Utilizado para autenticaçao de licença do Updater que será usada naquela máquina. Fazemos a autenticação via passaporte e conseguimos validá-la. 

image.png