understanding variable scopes
Este tutorial cobrirá diferentes tipos de variáveis suportadas pela ferramenta Postman e como elas podem ser usadas ao criar e executar solicitações e coleções do Postman:
Também abordaremos o conceito de arquivos de ambiente e veremos como eles podem ser aproveitados durante a criação e execução de coleções.
=> Confira o guia de treinamento do carteiro perfeito aqui.
O que você aprenderá:
O que são variáveis no Postman?
As variáveis, como qualquer outra linguagem de programação, nada mais são do que espaços reservados para conter algum valor ou resultado de algumas expressões.
Por exemplo , Considere uma declaração de variável em C # / Javascript que contém o valor da string “hello world!”. Agora, sempre que esta string for necessária, alguém pode simplesmente usar o nome da variável para obter o valor substituído pela string real.
var z='hello world!'Vamos tentar aprofundar nas variáveis do Postman.
As variáveis aqui são normalmente usadas em um contexto onde você precisa substituir valores em corpos de solicitação, fazer asserções para o corpo de resposta e usá-las em scripts de pré-solicitação para lidar com a lógica de pré-processamento conforme necessário.
Em primeiro lugar, vamos tentar entender os diferentes escopos de variáveis no Postman. O escopo nada mais é do que o tempo de vida e a acessibilidade de uma variável. É semelhante ao conceito de escopo que temos em linguagens de programação como Java.
Por exemplo , uma variável pode ter um escopo global, ou seja, qualquer classe / método pode acessar / modificar a variável até que o método ou programa esteja ativo.
Da mesma forma, podem haver vários tipos que possuem um escopo específico, pois as variáveis locais declaradas no método podem ser utilizadas somente até o momento em que a função está em execução. Da mesma forma, as variáveis declaradas em loops for só podem ser usadas enquanto o loop está em execução.
Aqui está um tutorial em vídeo:
Postman oferece 5 tipos diferentes de escopos de variáveis, conforme indicado abaixo:
software de quadro de horários grátis para pequenas empresas
- Global
- Coleção
- Ambiente
- Dados
- Local
Observação: É importante entender que todos os diferentes tipos de variáveis do Postman podem ser adicionados / removidos usando o console do Postman e a maioria delas pode ser acessada e atualizada usando scripts também.
Vamos tentar entender cada um desses tipos de variáveis e escopo em detalhes !!
Tipos de variáveis no carteiro
# 1) Global
O que são variáveis globais e quando devem ser usadas?
Variáveis globais são variáveis de propósito geral e devem ser evitadas e usadas apenas para requisitos de prototipagem rápida. Essas variáveis estão disponíveis para todas as solicitações disponíveis no console do Postman, independentemente da coleção a que pertencem.
Essas variáveis são análogas às variáveis de escopo global em linguagens de programação como Java, C #, etc., onde as variáveis globais são acessíveis a todas as partes do programa. No entanto, essas variáveis são altamente confiáveis, pois cada seção do código pode acessar / modificar o valor da variável global.
Trabalhando com Variáveis Globais
Para trabalhar com variáveis globais, elas podem ser controladas por meio do console do Postman, bem como pelos scripts nas solicitações do Postman.
Através do console do Postman, clique no ícone “Olho” próximo ao seletor de ambiente, e isso abrirá uma janela pop-up / contexto com detalhes sobre as variáveis globais atuais.
Agora crie uma nova variável inserindo o nome da variável e seu valor inicial.
O valor inicial é algo que é persistido por padrão para aquela variável e o valor atual continua mudando à medida que é definido ou atualizado nas solicitações que estão usando essas variáveis.
Usando o script, as variáveis de ambiente podem ser acessadas usando “pm. globais ”
Use o comando abaixo para obter o valor de uma variável global chamada ‘testVar’.
pm.globals.get('testVar');Use o comando abaixo para definir o valor de uma variável global chamada ‘testVar’.
pm.globals.set('testVar', 'Hello Postman tutorial!');Se você deseja remover uma variável global por meio de um script, pode usar a função unset conforme mencionado abaixo.
pm.globals.unset('testVar');Para limpar todas as variáveis globais por meio do script, você pode usar a função abaixo.
pm.globals.clear();# 2) Coleção
O que são variáveis de coleção e quando devem ser usadas?
Variáveis de coleção são usadas para definir variáveis no escopo da coleção. Como sabemos, uma coleção no Postman nada mais é do que um grupo de solicitações do Postman.
Variáveis de coleção não mudam durante a execução de uma coleção ou solicitação dentro de uma coleção dada. Essencialmente, as variáveis de coleção podem ser apenas recuperadas e não atualizadas durante a execução da solicitação.
Observe que as variáveis da coleção podem ser acessadas apenas pelas solicitações que fazem parte da coleção e não por quaisquer outras solicitações.
Como eles são criados?
Variáveis de coleção podem ser criadas e / ou removidas apenas usando o console do aplicativo Postman.
# 1) Selecione a coleção à qual deseja adicionar uma variável. Clique com o botão direito e selecione editar.
#dois) Agora selecione o 'Variáveis' guia e adicione as variáveis de coleção que devem ser adicionadas.
Trabalho com variáveis de coleção
Para usar dentro de uma solicitação, variáveis de coleção podem ser referenciadas usando script Postman genérico e dependendo da regra de escopo mais próximo, se não houver outra variável que seja mais próxima do que o escopo de coleção, então a variável de coleção é retornada.
pm.variables.get('testCollectionVar');Para usar variáveis Postman como parte do construtor de solicitação, simplesmente use a sintaxe de chaves duplas conforme mostrado abaixo.
# 3) Meio Ambiente
Quais são as variáveis de ambiente?
Variáveis de ambiente são os tipos de variáveis mais usados no Postman.
qual é o melhor adblock para cromo
Eles estão vinculados a um ambiente selecionado que está sendo usado para executar a solicitação. Eles têm um escopo mais restrito do que as variáveis globais, mas mais amplo do que as variáveis de coleção.
Quando usar as variáveis de ambiente?
- Variáveis de ambiente são ideais ao trabalhar com servidores diferentes. Por exemplo , geralmente, ao trabalhar em um projeto, você trabalha com vários ambientes diferentes, como dev, test, stage e prod, etc., que diferem principalmente apenas pela URL e o resto das coisas na URL de solicitação de endpoint da API permanecem as mesmas.
Nesse tipo de cenário, você pode criar um arquivo de ambiente que corresponda aos diferentes ambientes que seu aplicativo suporta. Por exemplo, variáveis de ambiente para diferentes ambientes, como dev, test, etc. - Quando há necessidade de passar dados ou informações de uma solicitação para outra, as variáveis de ambiente são uma boa escolha, pois têm um escopo mais amplo do que as variáveis locais e escopo mais restrito do que as variáveis globais.
Como eles são criados?
Ao contrário das variáveis de coleção, as variáveis de ambiente podem ser criadas por meio do console e também por meio do próprio script.
Para criar variáveis de ambiente por meio do console, um ambiente ativo precisa ser criado, que nada mais é que um contêiner de variáveis de ambiente. Consulte as imagens abaixo para criar um novo ambiente e adicionar variáveis de ambiente a ele.
Agora você pode clicar 'Adicionar' para salvar o novo ambiente. Depois de salvo, você pode simplesmente clicar no 'Configurações' ícone para gerenciar / adicionar novos ambientes.
Para usar o ambiente criado, você precisará escolher o ambiente a ser usado, selecionando o ambiente certo na lista suspensa de ambientes.
Trabalho com variáveis de ambiente
Semelhante às variáveis Collection e Global, as variáveis de ambiente podem ser agidas de forma programática por meio do script e podem ser usadas diretamente como parte dos URLs ou do corpo da solicitação por meio da sintaxe de chaves duplas.
Quando um ambiente apropriado é selecionado no seletor de ambiente, você pode simplesmente usar a sintaxe de chaves duplas para acessar uma variável de ambiente conforme ilustrado na captura de tela abaixo.
Para usar variáveis de ambiente por meio do script, você pode usar pm.environment.get e pm.environment.set para buscar e adicionar / modificar variáveis de ambiente, respectivamente.
pm.environment.get('testEnvVar') pm.environment.set('testEnvVar',10)Observe que aqui, estamos usando pm.environment e não pm.variables, ou seja, o escopo é sempre definido para o ambiente e o Postman tentará descobrir a variável apenas no ambiente selecionado.
# 4) Local
O que são variáveis locais?
As variáveis locais estão disponíveis apenas no contexto de execução de uma solicitação específica. Isso é uma analogia com as variáveis de nível de função em linguagens de programação modernas como Java e C #. Elas são exatamente semelhantes às variáveis de função nas quais as variáveis apenas têm acesso dentro do contexto da execução da função.
Um caso de uso importante de variáveis locais é que elas podem ser usadas quando você deseja substituir os valores de uma variável que é definida em qualquer outro escopo, como Global, Coleção ou Ambiente.
ou seja, suponha que haja uma variável global chamada ‘testVar’ e agora você deseja substituir o valor sem afetar a variável global, você pode criar uma variável local com o mesmo nome e usá-la com o valor que desejar.
Quando usar as variáveis locais?
Variáveis locais podem ser usadas da mesma maneira que variáveis de coleção, globais e de ambiente que discutimos nas seções anteriores deste tutorial.
É importante notar aqui que, para usar as variáveis locais de forma programática, você deve usar pm.variables.get / pm.variables.set diferente pm.environment ou pm.global que foi usado para as variáveis de Meio Ambiente e Globais.
pm.variables.get('testVar') pm.variables.set('testEnvVar',10)# 5) Dados
O que são variáveis de dados?
As variáveis de dados vêm no contexto da execução da solicitação por meio do executor de coleta.
O Postman nos permite executar solicitações em uma coleção por meio do executor de coleção e, durante a execução, podemos fornecer um conjunto de dados na forma de JSON ou CSV que são usados durante a execução das solicitações dentro da coleção.
É importante observar aqui que a fonte das variáveis de dados é o arquivo de dados fornecido pelo usuário no formato JSON ou CSV e, durante a execução da solicitação, as variáveis de dados só podem ser buscadas, mas não atualizadas / modificadas ou adicionadas.
Quando usar variáveis de dados?
Variáveis de dados são usadas enquanto estamos trabalhando com múltiplos conjuntos de dados e existem apenas durante a execução de uma iteração do arquivo de dados.
Como usar uma variável de dados?
Vamos ver um cenário de ponta a ponta de execução de solicitações por meio do executor de coleta e fornecimento de um arquivo de dados cujo valor é substituído enquanto a solicitação está sendo executada.
Vamos adicionar uma solicitação GET simples a uma nova coleção para ilustrar o conceito de variáveis de dados. Usaremos o mesmo endpoint GET https://reqres.in/api/users/{userId}
Buscaremos o {userId} por meio de uma variável Data que será apoiada por um arquivo CSV contendo os valores para o userId.
Siga as etapas abaixo para entender o fluxo.
# 1) Altere o URL de solicitação no construtor de solicitações Postman para https://reqres.in/api/users/{{testDataVar}}.
#dois) Aqui, {{testDataVar}} é a nossa variável de dados cujo valor será obtido da fonte de dados que será usada com o executor de coleta.
# 3) Crie um novo arquivo de dados no formato CSV com o nome da coluna como “testDataVar”.
Defina os dados no arquivo CSV conforme abaixo:
testDataVar 1 2 3 4 5# 4) Salve o arquivo no sistema de arquivos local e use este arquivo enquanto executa a coleção por meio do executor de coleção.
# 5) Agora selecione a coleção e clique em Executar para executar as solicitações de coleção por meio do executor de coleção.
# 6) Selecione o arquivo de dados csv criado na configuração do executor de coleta e o tipo de arquivo como text / csv.
# 7) Agora clique em “Executar coleção do Postman” e consulte a janela “Executar resultados”. Há um detalhe de execução para a solicitação configurada para cada iteração realizada. O número de iterações depende do número de entradas de dados que foram configuradas no arquivo CSV.
Você pode ver mais detalhes sobre as URLs de solicitação, etc., nos resultados do executor de coleta, para validar se os valores das variáveis de dados foram passados corretamente para as URLs de solicitação. Geralmente, as variáveis de dados são usadas quando as solicitações de coleta devem ser executadas em vários conjuntos de dados de acordo com os valores configurados nos arquivos de dados.
Acessando Variáveis Postman
As variáveis do Postman podem ser acessadas de 2 maneiras conforme declarado abaixo.
- Na solicitação, as variáveis do construtor podem ser acessadas usando um formato de chave dupla. Observe que ao resolver a variável, o valor da variável de escopo mais próximo será substituído antes que a solicitação seja executada.
- No script, como o script de pré-solicitação, testes, asserções, etc, as variáveis podem ser acessadas / modificadas usando a sintaxe abaixo.
Para buscar uma variável:
pm.variables.get( ‘variable-name’ )Para definir um valor de variável.
melhor software de clonagem de disco rígido grátis 2017
pm.variables.set( ‘variable-name’ , ’variable-value’ )É importante notar aqui que, quando uma variável é definida, ela tentará encontrar a variável de escopo mais próxima e definir ou modificar essa variável. Caso não seja encontrada nenhuma variável durante o set, o script Postman simplesmente criará uma nova variável Local.
Notas e dicas
# 1) É aconselhável ter nomes de variáveis diferentes em escopos diferentes, para evitar confusão, pois o sandbox do Postman escolherá a variável com o escopo mais próximo quando tentar resolver variáveis no construtor de solicitação com formato de chave dupla ou quando o pm.variables.get / O script pm.variables.set foi resolvido.
#dois) Para as variáveis de ambiente, apenas o ambiente selecionado é eficaz, ou seja, ao resolver as variáveis, o Postman examinará apenas o ambiente selecionado.
# 3) Observe uma regra geral - uma variável com o escopo mais próximo tem precedência sobre outras. Por exemplo, se houver uma variável global chamada ‘input1’ e houver uma variável local com o mesmo nome e se a variável for referenciada no escopo de uma variável local, então a variável no escopo local tem mais precedência quando comparada à variável global.
Conclusão
Neste tutorial, abordamos vários conceitos relacionados a variáveis no Postman, juntamente com as diferentes maneiras de usá-los. Discutimos os tipos de variáveis como Global, Coleção, Ambiente, Local e Dados e quando usar cada uma delas.
Resumindo, as variáveis do Postman adicionam muito poder à maneira como a ferramenta pode ser usada e configurada para executar solicitações e testes de maneira eficaz. Poucas referências da documentação oficial do Postman puderam ser obtidas Aqui.
=> Visite aqui para ver A-Z dos tutoriais de treinamento de carteiro aqui.
Leitura recomendada
- Variáveis em C ++
- Variáveis Python
- Variáveis de VBScript: como declarar e usar variáveis - VBScript Dim
- Tipos de dados e variáveis C # com exemplos
- Tutorial POSTMAN: Teste de API usando POSTMAN
- Variáveis e funções do JMeter
- Configuração do ambiente de desenvolvimento para C ++
- Qualificadores de tipo e classes de armazenamento em C ++