Variável de ambiente em QTP (UFT) com exemplo

Por: Thomas Hamilton Thomas Hamilton
Hours Atualização do

⚡ Resumo Inteligente

Variáveis ​​ambientais em QTP e UFT Um único repositório de valores que todas as ações, bibliotecas de funções e cenários de recuperação podem ler, permitindo que um único teste realize diversas tarefas. URLcredenciais, caminhos e strings de idioma sem codificá-los diretamente em nenhum lugar.

  • 🔘 Âmbito global: Uma única variável é visível para todas as ações, bibliotecas de funções e cenários de recuperação no teste.
  • ☑️ Duas famílias: As variáveis ​​internas são somente leitura; as variáveis ​​definidas pelo usuário podem ser criadas e alteradas por você.
  • ✅ Interno versus externo: As variáveis ​​internas são salvas dentro do teste, enquanto as variáveis ​​externas ficam armazenadas em um arquivo XML compartilhável.
  • 🧪 Um acessador: Environment.Value lê qualquer variável e escreve variáveis ​​definidas pelo usuário a partir do VBScript.
  • 🛠️ Carregamento em tempo de execução: O método `Environment.LoadFromFile` troca todo um conjunto de variáveis ​​em tempo de execução, permitindo que um único script controle vários ambientes.
  • 📌 Criado para localização: Swapping O arquivo XML altera as strings de idioma sem que nenhuma etapa seja alterada.
Saiba Mais

Variáveis ​​de ambiente integradas e definidas pelo usuário em QTP e UFT completa

O que é variável de ambiente?

Variáveis ​​ambientais São “objetos” dinâmicos em um computador que podem armazenar um valor, o qual, por sua vez, pode ser referenciado por um ou mais programas de software. Windows.

As variáveis ​​de ambiente são dinâmicas por natureza e podem ser alteradas. Existem diversas variáveis ​​de ambiente que podem ser referenciadas por programas e que podem ser úteis para obter informações sobre o ambiente computacional. A ferramenta de teste mantém sua própria lista, além das variáveis ​​padrão. Windows proporciona.

UFT Uma variável de ambiente

micro Focus UFT As variáveis ​​de ambiente podem ser acessadas por todas as ações, bibliotecas de funções e cenários de recuperação.

⚠️ Nota de versão: Este produto foi lançado como HP QuickTest Professional, teve seu nome alterado para Unified Functional Testing e é vendido atualmente como OpenText Testes funcionais (UFT Um)O objeto Ambiente e as telas abaixo permanecem inalterados — apenas o nome do produto foi alterado. referência oficial de objeto ambiental Contém a sintaxe atual.

Tipos de QTP variáveis ​​ambientais

Variáveis ​​de ambiente são aquelas variáveis ​​que podem ser usadas globalmente nos testes. Existem dois tipos de variáveis ​​de ambiente

  • Variáveis ​​incorporadas
  • Variáveis ​​definidas pelo usuário (tem 2 subtipos)
    • Interno
    • Externo

As variáveis ​​internas descrevem a máquina e a execução do teste e são somente leitura. As variáveis ​​definidas pelo usuário contêm seus próprios dados, e somente as internas podem ser alteradas por um script.

Variáveis ​​incorporadas

In QTP, variáveis ​​integradas são variáveis ​​predefinidas. Ele permite ao usuário recuperar as informações sobre o teste que está sendo executado e obter informações sobre o sistema operacional (Operating Systems) nos quais o teste está sendo executado. Algumas das variáveis ​​​​integradas são iteração de ação, Operasistema de configuração, diretório de teste, nomes de host locais, Operaversão do sistema etc.

Ir para o arquivo -> Configurações -> Na guia Ambiente, você pode visualizar a seção de variáveis ​​de ambiente e, em seguida, a lista de variáveis ​​de ambiente. O painel é aberto na lista integrada, conforme mostrado abaixo.

Painel Ambiente da caixa de diálogo Configurações de Teste listando as opções integradas. QTP variáveis ​​ambientais

Os valores das variáveis ​​de ambiente podem ser obtidos e usados ​​sempre que necessário durante a execução do programa. Esses são os nomes que os testadores mais utilizam.

Variável integrada O que retorna
OS Operafamília de sistemas de teste da máquina que executa o teste
Versão do SO Operaversão do sistema ting
Nome do teste Nome do teste em execução
TestDir Pasta onde o teste está armazenado
Nome da ação Nome da ação em execução
Iteração de ação Número da iteração da ação atual
NomeHostLocal Nome do host da máquina local
Diretório de resultados Pasta onde os resultados da execução são gravados

Exemplo:

MsgBox Environment.Value("OSVersion")

Essa única linha exibe a versão do sistema operacional diretamente da sessão de execução.

Caixa de mensagem exibindo o valor retornado pela variável de ambiente interna OSVersion.

Variáveis ​​definidas pelo usuário

Antes da execução do teste, estas são as variáveis ​​que são definidas pelo usuário. Ele pode ser usado globalmente em diferentes testes ou também pode ser restrito a um teste.

As variáveis ​​definidas pelo usuário foram classificadas em dois tipos

  • Interno
  • Externo
  1. Definido pelo usuário – Variáveis ​​InternasEssas variáveis ​​são definidas pelo usuário antes da execução do teste e estão disponíveis apenas para um teste específico.
  2. Definido pelo usuário - Variáveis ​​Externas: Essas variáveis ​​são definidas pelo usuário e podem ser usadas globalmente em diferentes testes.

As variáveis ​​externas podem ser carregadas de duas maneiras. Isso pode ser feito manualmente antes da execução do teste, através da aba de ambiente ou da tela definida pelo usuário, marcando a caixa de seleção "Carregar variáveis" e selecionando o arquivo XML. A segunda maneira é através de um comando de script, abordado mais adiante nesta página.

Você pode criar uma variável definida pelo usuário da seguinte forma: altere o tipo da variável para "definida pelo usuário" e adicione uma linha para nome e outra para valor.

Adicionando uma nova variável de ambiente definida pelo usuário no painel Ambiente de QTP Configurações de teste

A linha finalizada aparece então na lista definida pelo usuário.

Variável de ambiente definida pelo usuário Guru99 listado com seu valor no painel Ambiente

Você pode acessar a variável da seguinte maneira

MsgBox Environment.Value("Guru99")

A caixa de mensagem retorna o valor armazenado na variável com o nome indicado.

Caixa de mensagem exibindo o valor da variável de ambiente definida pelo usuário com o nome Guru99

Não perca:

Métodos e propriedades do objeto Ambiente

Ambas as listas são acessadas por meio de uma VBScript objeto chamado Ambiente. Ele expõe uma propriedade, um método e uma propriedade somente leitura, e essa é toda a superfície da API.

Vogal Formato O que ele faz
Valor Propriedade Recupera qualquer variável de ambiente e define as variáveis ​​definidas pelo usuário.
CarregarDoArquivo Forma Carrega um arquivo XML de variáveis ​​de ambiente externas em tempo de execução.
Nome do arquivo externo Propriedade Retorna o arquivo externo selecionado no painel Ambiente ou uma string vazia.

A leitura é permitida em todos os lugares. A escrita funciona apenas em variáveis ​​internas definidas pelo usuário, pois as variáveis ​​predefinidas e as variáveis ​​carregadas de um arquivo são somente leitura.

' Read any variable
strVersion = Environment.Value("OSVersion")

' Write a user-defined internal variable
Environment.Value("Guru99") = "SecondValue"

' Check which external file is active
If Environment.ExternalFileName = "" Then
    MsgBox "No external environment file is loaded"
End If

A mesma declaração se comporta de maneira idêntica em uma ação, uma biblioteca de funções ou um cenário de recuperação.

Como criar e carregar um arquivo XML de variáveis ​​de ambiente externas

Um arquivo externo transforma a lista de variáveis ​​em um recurso compartilhável, permitindo que um único teste seja executado em ambientes de desenvolvimento, teste e produção sem a necessidade de edição.

  1. Defina os valores primeiro como variáveis ​​internas definidas pelo usuário no painel Ambiente.
  2. Use o Exportar botão nesse painel, que escreve o correto XML estrutura para você.
  3. Salve um arquivo por ambiente, por exemplo, EnvDev.xml e EnvProd.xml.
  4. Aponte o teste para um arquivo com a caixa de seleção "Carregar variáveis" marcada ou carregue-o a partir do script.

O arquivo é uma lista simples de pares de variáveis ​​e valores, conforme a sintaxe abaixo.

<Environment>
  <Variable>
    <Name>This is the first variable name</Name>
    <Value>This is the first variable value</Value>
  </Variable>
</Environment>

O carregamento a partir do código consiste em uma verificação de duas linhas: verificar se um arquivo já está ativo e carregá-lo somente se não estiver.

fileName = Environment.ExternalFileName
If fileName = "" Then
    Environment.LoadFromFile "C:\testEnv.xml"
End If

Melhores Práticas e Erros Comuns

A maioria dos problemas decorre de escopo e ortografia, e não de sintaxe. A tabela lista as falhas mais frequentes encontradas pelos testadores.

Sintoma Causar Fixar
A variável retorna um valor vazio. O nome está escrito incorretamente ou nunca foi adicionado a este teste. Os nomes correspondem exatamente; verifique novamente a ortografia no painel Ambiente.
Erro de execução em uma linha de atribuição O script escreve uma variável interna ou carregada externamente. Somente variáveis ​​internas definidas pelo usuário podem ser atribuídas.
O arquivo externo é ignorado. A caixa de seleção não está marcada e a função LoadFromFile nunca foi chamada. Marque a caixa ou carregue o arquivo a partir do script.
Uma variável compartilhada está faltando em outro lugar. A variável foi definida como interna. Mova-o para um arquivo XML externo para que todos os testes possam carregá-lo.
  • Adote uma convenção de nomenclatura para que o painel permaneça legível à medida que a lista cresce.
  • Mantenha os arquivos XML sob controle de versão e nunca armazene senhas reais neles.
  • Reserve variáveis ​​de ambiente para valores que permaneçam constantes durante a execução e deixe os dados linha por linha para o Tabela de dados.

Perguntas Frequentes

Uma senha em texto simples em um arquivo XML pode ser lida por qualquer pessoa que o abra. Mantenha o nome de usuário em uma variável de ambiente e passe a senha por meio de um valor criptografado, conforme mostrado no exemplo. SetSecure guia.

Não. As variáveis ​​internas são somente leitura, portanto, uma atribuição gera um erro de execução. Somente variáveis ​​internas definidas pelo usuário aceitam um novo valor. Variáveis ​​carregadas de um arquivo externo também são somente leitura dentro do teste.

Um arquivo externo por idioma contém as strings de interface e os endpoints para essa localidade. Trocarping O arquivo altera todos os valores esperados de uma só vez, portanto, as mesmas etapas verificam uma versão em francês e uma versão em japonês.

Uma variável de ambiente mantém um valor para toda a execução e é visível para todas as ações. Um parâmetro de tabela de dados fornece um valor diferente em cada iteração e pertence a uma planilha, sendo adequado para casos orientados a dados.

Uma ferramenta de IA examina um conjunto de ferramentas em busca de erros codificados. URLO sistema identifica caminhos e credenciais, e então propõe variáveis ​​de ambiente para substituí-los. Os modelos de aprendizado de máquina também sinalizam valores que divergem entre ambientes, para que as entradas corretas sejam movidas para o arquivo externo.

O Copilot executa as chamadas Environment.Value e LoadFromFile de forma confiável porque o objeto possui uma API pequena. Considere a sugestão como um rascunho: ela não pode saber quais nomes existem no seu painel de Ambiente, portanto, verifique cada um antes de executar.

Sim. O objeto Environment é acessível a partir de ações, bibliotecas de funções e cenários de recuperação, portanto, um manipulador de recuperação pode ramificar com base em um sinalizador, como o nome do ambiente, sem necessidade de configurações adicionais.

O painel Ambiente da caixa de diálogo Configurações de Teste nomeia o arquivo selecionado. No código, a propriedade ExternalFileName retorna o mesmo nome ou uma string vazia quando nenhum arquivo externo foi carregado para a execução.

Resuma esta postagem com: