البيئة

تخزن متغيرات البيئة قيماً قابلة لإعادة الاستخدام يمكنك الإشارة إليها في الطلبات عبر إعادة الإرسال والأتمتة ومسارات العمل.

إنشاء المتغيرات وتحريرها

1. افتح البيئة من قائمة التنقل اليسرى.
2. انقر جديد.
3. أدخل اسماً يبدأ بحرف أو شرطة سفلية، تليها حروف أو أرقام أو شرطات سفلية أو واصلات، بحد أقصى 64 حرفاً.
4. أدخل القيمة.
5. فعّل سري إذا كانت القيمة حساسة، مثل مفاتيح API والرموز وكلمات المرور. تُخفى القيم السرية في الواجهة وتُستبعد من سياق الذكاء الاصطناعي.
6. انقر حفظ.

لتحرير متغير موجود، انقر صفه وحدّث الاسم أو القيمة.

استخدام المتغيرات في الطلبات

أشر إلى متغير بيئة باستخدام البادئة env.:

{{env.VARIABLE_NAME}}

أمثلة:

• حقل المضيف: {{env.TARGET_HOST}}، وخزّن اسم مضيف لا عنوان URL كاملاً.
• ترويسة التفويض: Bearer {{env.AUTH_TOKEN}}.
• متن الطلب: {"tenant": "{{env.TENANT_ID}}"}؛ فعّل معالجة قوالب المتن في إعادة الإرسال عند الرغبة في إجراء الاستبدالات داخله.

يحل Ogma العناصر النائبة الصالحة لمتغيرات البيئة وقت الإرسال. يؤدي غياب متغير إلى خطأ بدلاً من إرسال قيمة غير محلولة بصمت. تحافظ عمليات إعادة الإرسال الخام والسداسية عشرية على البايتات الدقيقة ولا توسّع العناصر النائبة.

نطاق المتغيرات

اختر عام للقيم المشتركة بين المشاريع في مساحة عمل Ogma هذه، أو المشروع للقيم التابعة للمشروع النشط. تتجاوز قيم المشروع القيم العامة التي تحمل الاسم نفسه. تدعم إعادة الإرسال أيضاً تجاوزات المجموعات والجلسات؛ والأولوية للجلسة ثم المجموعة ثم المشروع ثم النطاق العام.

التحويلات والقيم الديناميكية

ألحق التحويلات باستخدام رمز الأنبوب، مثل {{env.AUTH_TOKEN|base64_encode}} أو {{env.SEARCH|url_encode}}. تُطبق السلسلة من اليسار إلى اليمين. تحقق من المخرجات بطلب اختباري: يجري تخطي أسماء التحويلات غير المعروفة دون الإبلاغ عنها كأخطاء.

لا تحتاج القيم المدمجة إلى متغير محفوظ:

العنصر النائب	القيمة
{{$timestamp}}	وقت Unix الحالي بالمللي ثانية.
{{$timestamp_s}}	وقت Unix الحالي بالثواني.
{{$uuid}}	UUID جديد.
{{$random(16)}}	16 بايتاً عشوائياً ممثلة بالنظام السداسي عشري.
{{$date(%Y-%m-%d)}}	تاريخ UTC الحالي باستخدام نمط تنسيق تاريخ.

لا تُوسّع القيم المخزنة بصورة تكرارية. إذا احتوت قيمة على عنصر نائب آخر، يبقى ذلك النص المتداخل حرفياً.

وصول مساعد الذكاء الاصطناعي

يمكن لمساعد الذكاء الاصطناعي قراءة أسماء المتغيرات غير السرية وقيمها لتوفير سياق عندما تطلب منه تحليل طلب أو إعداد خطة اختبار. لا تُدرج المتغيرات السرية مطلقاً في سياق الذكاء الاصطناعي.

استخدامات شائعة

المتغير	قيمة مثال
BASE_URL	https://api.example.com
AUTH_TOKEN	eyJhbGci...، ضع علامة سري
TARGET_HOST	app.example.com
API_KEY	sk-...، ضع علامة سري
USER_ID	12345

صفحات ذات صلة

• إعادة الإرسال
• الأتمتة
• مسارات العمل