---
url: https://docs.ogmabox.com/uk/app/environment.md
description: >-
  Керуйте змінними середовища Ogma для повторного надсилання, автоматизації,
  робочих процесів і контексту тестування.
---

# Середовище {#environment}

Змінні середовища зберігають значення для повторного використання в запитах у розділах «Повторне надсилання», «Автоматизація» й «Робочі процеси».

## Створення й редагування змінних {#creating-and-editing-variables}

1. Відкрийте **Середовище** в лівій панелі навігації.
2. Натисніть **Додати змінну**.
3. Введіть ім’я, що починається з літери або підкреслення й далі містить літери, цифри, підкреслення або дефіси (не більше ніж 64 символи).
4. Введіть значення.
5. Увімкніть **Секретна**, якщо значення конфіденційне (ключі API, токени, паролі). Секретні значення приховуються в інтерфейсі й не потрапляють у контекст ШІ.
6. Натисніть **Зберегти**.

Щоб змінити наявну змінну, натисніть її рядок і оновіть ім’я або значення.

## Використання змінних у запитах {#using-variables-in-requests}

Посилайтеся на змінну середовища з префіксом `env.`:

```
{{env.VARIABLE_NAME}}
```

Приклади:

* Поле хоста: {{env.TARGET\_HOST}} (зберігайте ім’я хоста, а не повний URL).
* Заголовок Authorization: Bearer {{env.AUTH\_TOKEN}}.
* Тіло запиту: {"tenant": "{{env.TENANT\_ID}}"}; увімкніть шаблонізацію тіла в розділі «Повторне надсилання», якщо потрібні підстановки всередині тіла.

Ogma підставляє коректні змінні середовища під час надсилання. Відсутня змінна спричиняє помилку замість непомітного надсилання непідставленого значення. Надсилання в режимах «Необроблений» і «Шістнадцятковий» зберігає точні байти й не підставляє значення змінних.

## Область дії змінних {#variable-scope}

Виберіть **Глобальна** для значень, спільних для проєктів цього робочого простору Ogma, або **Проєкт** для значень активного проєкту. Значення проєкту перевизначають однойменні глобальні значення. Повторне надсилання також підтримує перевизначення на рівні колекції й сеансу; пріоритет такий: сеанс, колекція, проєкт, глобальна змінна.

## Перетворення й динамічні значення {#transforms-and-dynamic-values}

Додавайте перетворення через вертикальну риску, наприклад {{env.AUTH\_TOKEN|base64\_encode}} або {{env.SEARCH|url\_encode}}. Ланцюжок виконується зліва направо. Перевіряйте результат тестовим запитом: нерозпізнані назви перетворень пропускаються без повідомлення про помилку.

Для вбудованих значень не потрібна збережена змінна:

| Підстановка | Значення |
| --- | --- |
| {{$timestamp}} | Поточний час Unix у мілісекундах. |
| {{$timestamp\_s}} | Поточний час Unix у секундах. |
| {{$uuid}} | Новий UUID. |
| {{$random(16)}} | 16 випадкових байтів у шістнадцятковому поданні. |
| {{$date(%Y-%m-%d)}} | Поточна дата UTC за заданим шаблоном формату дати. |

Збережені значення не розгортаються рекурсивно. Якщо значення містить іншу підстановку, її текст залишається незмінним.

## Доступ ШІ-помічника {#ai-assistant-access}

ШІ-помічник може читати імена й значення несекретних змінних для контексту, коли ви просите проаналізувати запит або скласти план тестування. Секретні змінні ніколи не потрапляють у контекст ШІ.

## Типові випадки використання {#common-uses}

| Змінна | Приклад значення |
| --- | --- |
| `BASE_URL` | `https://api.example.com` |
| `AUTH_TOKEN` | `eyJhbGci...` (позначте як секретну) |
| `TARGET_HOST` | `app.example.com` |
| `API_KEY` | `sk-...` (позначте як секретну) |
| `USER_ID` | `12345` |

## Пов’язані сторінки {#related-pages}

* [Повторне надсилання](./replay.md)
* [Автоматизація](./automate.md)
* [Робочі процеси](./workflows.md)