# Переменные окружения

Механизм переменных окружения позволяет создавать переключаемые переменные, например, для переключения **stage** и **prod** сред.

### Создание переменных окружения

В примере мы создадим одну переменную serverUrl для сред stage и prod.

1. Нажмите на значок настройки переменных окружения.
2. Во всплывающем окне создайте новое окружение нажав на "Add enviroment" с именем stage.
   * Создайте переменную serverUrl, в качестве значения переменной укажите адрес stage сервера.
3. Добавьте prod окружение  нажав на "Add enviroment".
   * Создайте переменную serverUrl, в качестве значения переменной укажите адрес prod сервера.

![](https://1540441421-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lh_FaVh9XfQJ0p1KqZ1%2F-Lw32I1lpXmtP-V0-0gV%2F-Lw36M04DRhYnS7EIAJ5%2Fvariables-1.gif?alt=media\&token=3e103a91-a52e-45e7-99a8-5302a08afb43)

### Импорт окружения из Postman

TestMace позволяет импортировать окружения из [Postman](https://learning.getpostman.com/docs/postman/environments_and_globals/manage_environments/). Для этого необходимо нажать на кнопку **+ Import environment**, которая находится в диалоге редактирования переменных окружения под списком доступных окружений

![](https://1540441421-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lh_FaVh9XfQJ0p1KqZ1%2F-Lw32I1lpXmtP-V0-0gV%2F-Lw35HccvbqOv0bptu3-%2Fvariables-1.jpg?alt=media\&token=887caff0-136d-45eb-8da1-12458c8a520a)

После нажатия на кнопку **+ Import environment** всплывает диалог, в котором необходимо ввести путь до файла. 

### Использование переменных окружения

Для использования переключаемых переменных обращайтесь к`${$env.%VARIABLE%}.`Заменим во всех узлах значение url нашей переменной:`${$env.serverUrl}` Теперь в любой момент, вы можете переключить значения этой переменной.

![](https://1540441421-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lh_FaVh9XfQJ0p1KqZ1%2F-Lw32I1lpXmtP-V0-0gV%2F-Lw371UcbBqemftuSRCb%2Fvariables-2.gif?alt=media\&token=bb24aa6b-3c2c-45da-a28b-97bc9e59c908)

#### Где можно использовать переменные?

Переменные окружения (также, как и обычные переменные) можно использовать в любом строковом поле узла.

### Локальные окружения

Локальные окружения отличаются от обычных только тем, что не сохраняются в файлы проекта, а хранятся в локальном хранилище приложения. Данный вид окружений рекомендуется использовать для локальных и приватных данных. К таким данным могут относиться логины, пароли, API-токены и т.д. 

В сайдбаре локальные окружения находятся в нижней части. Каждое локальное окружение имеет  префикс `local`, чтобы явно отличать их от обычных окружений.

![Диалог переменных окружения с локальными окружениями](https://1540441421-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lh_FaVh9XfQJ0p1KqZ1%2F-Lw32I1lpXmtP-V0-0gV%2F-Lw37yvINxl36WrnEWbG%2Fvariables-2.jpg?alt=media\&token=379432bb-8a68-4fe5-97fd-a267a606e1f5)

Используя механизм drag-and-drop локальные окружения можно превращать в обычные и наоборот.

![](https://1540441421-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lh_FaVh9XfQJ0p1KqZ1%2F-Lw32I1lpXmtP-V0-0gV%2F-Lw38Lr-TZRVnb04OZUQ%2Fvariables-3.gif?alt=media\&token=03226776-a66f-45e6-a8f7-5a3f7fccb56e)