استخدام حقول القوالب في إجراءات الاختبار

نظرة عامة

حقول القوالب (template fields) هي عناصر نائبة ديناميكية تُحلَّل إلى قيم من سياق تنفيذ الاختبار وقت التشغيل. تتيح لسكربتات الإجراءات ورسائل البريد الإلكتروني وقيم البيانات الوصفية الإشارة إلى اسم الاختبار ونتيجته وعدادات النتائج وروابط URL وغير ذلك، دون الحاجة إلى ترميز هذه القيم يدويًا.

تستخدم حقول القوالب صياغة Handlebars: {{field_name}}. عند تنفيذ خطوة إجراء، يستبدل Validatar كل حقل قالب بالقيمة الفعلية من تنفيذ الاختبار المكتمل.

أين تُدعم حقول القوالب

حقول القوالب المتاحة

حقول السياق (Context Fields)

توفر هذه الحقول معلومات عن الاختبار وموقعه ضمن المشروع.

حقول النتيجة (Result Fields)

حقول التوقيت (Timing Fields)

حقول الأخطاء (Error Fields)

حقول العدّ — المستوى الأعلى

حقول العدّ — مستوى الصفوف

حقول العدّ — الصفوف المتطابقة

تنطبق هذه الحقول على اختبارات المقارنة حيث تتم مطابقة الصفوف بين مجموعتَي بيانات الاختبار والتحكم.

حقول العدّ — صفوف الاختبار غير المتطابقة

الصفوف من مجموعة بيانات الاختبار التي لم تتطابق مع أي صف في مجموعة بيانات التحكم.

حقول العدّ — صفوف التحكم غير المتطابقة

الصفوف من مجموعة بيانات التحكم التي لم تتطابق مع أي صف في مجموعة بيانات الاختبار.

المراجع المساعدة (Helper References)

بالإضافة إلى حقول القوالب، يوفر محرر السكربت في خطوات الإجراءات إمكانية الوصول إلى المراجع المساعدة (helper references) — وهي نفس دوال Handlebars المساعدة المتاحة في نصوص القوالب الاختبارية (template test scripting). تتيح هذه المراجع منطقًا أكثر تقدمًا داخل سكربتات الإجراءات.

للاطلاع على القائمة الكاملة للدوال المساعدة المتاحة، راجع مقال Template Test Functions.

استخدام الإكمال التلقائي

يدعم كل من محرر السكربت ومحرر نص البريد الإلكتروني الإكمال التلقائي لحقول القوالب والمراجع المساعدة:

1. 1اكتب { في المحرر.
2. 2تظهر نافذة منبثقة تعرض جميع حقول القوالب والمراجع المساعدة المتاحة.
3. 3استخدم مفاتيح الأسهم للتنقل في القائمة، أو استمر بالكتابة للتصفية.
4. 4اضغط Enter أو Tab لإدراج الحقل المحدد.

يُدرج الإكمال التلقائي تعبير Handlebars الكامل (مثل {{test_name}}) عند موضع المؤشر.

يمكنك أيضًا فتح مساعد حقول القوالب بالنقر على أيقونة المساعدة بجانب الحقول النصية التي تدعم حقول القوالب. يفتح ذلك لوحة مرجعية كاملة تضم جميع حقول القوالب والدوال المساعدة ومحرر أكواد.

مرِّر لأسفل في لوحة المساعدة لرؤية جميع حقول القوالب البالغ عددها 28 حقلًا المتاحة للإدراج:

أمثلة

سكربت SQL: تسجيل نتائج الاختبار في جدول تدقيق

خطوة "Run a Script" تُدرج نتيجة الاختبار في جدول تدقيق مخصص بعد كل تنفيذ:

INSERT INTO dq_audit.test_execution_log (
    project_name,
    test_name,
    result,
    started_at,
    completed_at,
    duration,
    passed_count,
    failed_count,
    error_count,
    execution_url
)
VALUES (
    '{{project_name}}',
    '{{test_name}}',
    '{{result}}',
    '{{start_date}}',
    '{{complete_date}}',
    '{{duration}}',
    {{passed_count}},
    {{failed_count}},
    {{error_count}},
    '{{execution_url}}'
);

سكربت Python: إنشاء تذكرة في نظام خارجي عبر API

خطوة "Run a Script" باستخدام Python لاستدعاء واجهة JIRA API عندما تتغيّر حالة اختبار حرج إلى "Now Failing":

import requests
import json

url = "https://your-domain.atlassian.net/rest/api/2/issue"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Basic YOUR_API_TOKEN"
}

payload = {
    "fields": {
        "project": {"key": "DQ"},
        "summary": "Data Quality Alert: {{test_name}} is Now Failing",
        "description": (
            "Test *{{test_name}}* in project *{{project_name}}* "
            "has changed status to Now Failing.\n\n"
            "Result: {{result}}\n"
            "Failed Count: {{failed_count}}\n"
            "Execution: {{execution_url}}"
        ),
        "issuetype": {"name": "Bug"},
        "priority": {"name": "High"}
    }
}

response = requests.post(url, headers=headers, data=json.dumps(payload))

بريد إلكتروني: إشعار عند تغيّر الحالة

خطوة "Send an Email" تحتوي على حقول قوالب في الموضوع والنص. الموضوع:

Data Quality Alert: {{test_name}} — {{result}}

النص:

The test {{test_name}} in project {{project_name}} has changed status.

Result: {{result}}
Started: {{start_date}}
Completed: {{complete_date}}
Duration: {{duration}}

Passed: {{passed_count}}
Failed: {{failed_count}}
Errors: {{error_count}}

View the execution details: {{execution_url}}

قيمة بيانات وصفية: تحديث عنصر مرتبط

خطوة "Set Linked Object Metadata Value" على حقل مخصص نصي بعنوان "Last Test Result". القيمة:

{{result}} — {{test_name}} ({{complete_date}})

يضبط هذا حقل العنصر المخصص المرتبط إلى قيمة مشابهة لـ: Failed — Hub Customer BK Uniqueness (3/27/2026 2:15 PM).

نصائح

• القيم النصية تحتاج إلى علامات اقتباس في SQL. عند استخدام حقول القوالب داخل سلاسل نصية في SQL، ضعها بين علامتَي اقتباس مفردتين: '{{test_name}}'. أما الحقول الرقمية مثل {{passed_count}} فلا تحتاج إلى علامات اقتباس.
• عاين قبل الحفظ. لخطوات "Run a Script" و"Run a Macro"، استخدم زر Preview لرؤية السكربت بعد تحليل حقول القوالب والتحقق من المخرجات.
• تعمل حقول القوالب في قيم البيانات الوصفية فقط مع الحقول المخصصة من نوع نصي؛ أما حقول Dropdown أو Tag List أو User/Group List فتختار فيها من خيارات محددة مسبقًا بدلًا من إدخال نص حر.
• حقل المستلمين في خطوات البريد الإلكتروني لا يدعم حقول القوالب — أدخل عناوين البريد الإلكتروني مباشرة.

الخطوة التالية

• What are Test Actions — نظرة عامة على إجراءات الاختبار والمُحفّزات والخطوات
• Configuring Simple Test Actions — دليل خطوة بخطوة لإنشاء المُحفّزات والخطوات