لغة طلب البحث هي البنية التي تستخدمها لإجراء عمليات البحث عن المشاكل في أداة تتبُّع المشاكل من Google. يمكنك استخدام اللغة في طلبات البحث التي تدخلها في شريط البحث. يمكنك أيضًا استخدام أداة إنشاء البحث لاختيار المعايير بيانيًا، والتي يتم تحويلها بعد ذلك إلى لغة طلب البحث عند إغلاق أداة إنشاء البحث.
تتيح لك لغة طلب البحث إمكانية البحث حسب المعايير التالية:
- الكلمات الرئيسية
- أزواج الحقول/القيمة
يمكن أن تحتوي عمليات البحث التي تجريها على معايير متعددة، بما في ذلك مجموعة من الكلمات الرئيسية وأزواج الحقول/القيمة. تسمح لك بنية لغة طلب البحث بتحديد العلاقة والترتيب اللذين يتم بهما اعتبار المعايير باستخدام عوامل التشغيل المنطقية والأقواس وعلامات الاقتباس.
عمليات البحث باستخدام الكلمات الرئيسية
الكلمات الرئيسية هي سلاسل نصية يمكنك استخدامها للبحث عبر حقول معينة في المشكلات. هذه الحقول هي:
- العنوان
- التعليقات
- أسماء المرفقات
- الحقول التي تحتوي على المستخدمين (مثل المُسنَد إليه أو نسخة إلى)
- الحقول التي تحتوي على رقم تعريف داخلي (على سبيل المثال، الحقول التي تحدّد المكوِّن أو القوائم الساخنة التي تحتوي على مشكلة)
- الحقول التي تحتوي على أرقام الإصدارات
- الحقول المخصّصة
السلسلة configuration properties هي مثال على معايير البحث عن الكلمة الرئيسية.
عند إدخال هذه المعايير في بحث، تبحث أداة "تتبُّع المشاكل" بشكل عام عن المشاكل في جميع المكوّنات، وتعرض تلك التي تحتوي حقولها أعلاه على كلتا الكلمتين الرئيسيتين،
وفقًا لأذونات التحكم في الوصول. قد تكون الكلمات الرئيسية في
حقول مختلفة أو نفس الحقول.
تتعامل أداة "تتبُّع المشاكل" مع معايير البحث التي تفصل بين أحرف المسافات على أنّها عامل تشغيل ضمني AND. يمكنك استخدام علامات الاقتباس (") لتحديد
أن سلسلة مكونة من كلمات متعددة سيتم اعتبارها كلمة رئيسية واحدة. تُعد جميع عمليات البحث في "أداة تتبع المشكلات" غير حساسة لحالة الأحرف، سواء استخدمت علامات الاقتباس أم لا.
عمليات البحث عن زوج الحقل/القيمة
يمكنك أيضًا تحديد معايير البحث كزوج حقل/قيمة. البنية الأساسية
هي [field]:[value]. بالنسبة إلى الحقول النصية، تتطابق بنية هذه البنية مع المشاكل التي يحتوي الحقل المحدّد عليها على القيمة. وبالنسبة إلى أنواع الحقول الأخرى، تتطابق مع المشاكل التي تكون فيها قيمة الحقل تساوي.
على سبيل المثال، عند البحث عن title:latency، يتم العثور على مشاكل في كلمة latency في حقل العنوان. يؤدي البحث عن priority:p0 إلى العثور على مشاكل ذات أولوية p0.
لاحظ أنه بالنسبة لحقول الوقت والعدد، يمكنك استخدام رموز ارتباطية أخرى إلى جانب علامة النقطتين الرأسيتين. انظر العوامل الارتباطية أدناه.
عمليات البحث عن قيمة خاصة باستخدام "أي" و"بدون"
يمكن الاستعلام عن الحقول الاختيارية باستخدام القيمتين الخاصتَين any وnone. any مع أي قيمة غير فارغة. none يطابق القيم الفارغة. للحصول على قائمة بجميع تصنيفات الحقول المتوافقة في لغة طلب البحث، يُرجى الاطّلاع على مرجع طلب البحث.
العوامل المنطقية
تسمح لك العوامل المنطقية بتحديد أكثر من معيار واحد والإشارة إلى العلاقة بينها. كما هو موضح أعلاه، تعمل الأحرف المسافات خارج علامات الاقتباس كعوامل تشغيل AND ضمنية. تدعم أداة تتبع المشاكل ما يلي
من العوامل المنطقية الواضحة التالية:
| مُشغِّل | رمز بديل | الوصف | مثال |
|---|---|---|---|
| و | {whitespace} | يطابق إذا كانت المشكلة تتضمّن كلا المعيارَين. | star:true AND componentid:46046 |
| أو | | | مطابق إذا كانت المشكلة تتضمّن أيًا من المعيارَين | type:(Bug|feature_request) |
| NOT | - | يطابق إذا لم تتضمّن المشكلة المعايير | -assignee:jim |
| "..." | يطابق إذا كانت المشكلة تحتوي على عبارة مُقتبَسة (تظهر الكلمات في الاقتباس بالترتيب نفسه) | comment:"We have a problem" |
|
| ( ) | تجميع القيم أو معايير البحث معًا | status:open AND (priority:(p0|p1) OR severity:(s0|s1)) |
يُرجى ملاحظة ما يلي:
يجب استخدام أحرف كبيرة بالكامل للأحرف
ANDوORوNOT.يحمل عامل التشغيل
NOTالمعنى نفسه سواء كان يسبق اسم الحقل أو قيمة الحقل. وهذا يعني أنّ-assignee:jimوassignee:-jimمتساويان.استخدم الأقواس بشكل حر لتجميع العبارات في طلب البحث بوضوح. بشكل تلقائي، تربط أداة تتبُّع المشاكل
NOTبالمصطلح الذي يليه مباشرةً فقط، ويجمعORمع المصطلحَين الذي يوضعان بين قوسَين. على سبيل المثال، يعادل طلب البحثtitle:(a OR b NOT c AND d)title:((a OR b) AND (NOT c) AND d).
شرطات
يحمل حرف الشرطة (-) معانٍ مختلفة استنادًا إلى السياق في طلب البحث:
تتعامل أداة تتبُّع المشاكل مع الشرطة التي تسبق الكلمة في البحث باعتبارها عامل التشغيل
NOT. على سبيل المثال، يعرض معيارا البحث-assignee:noneأوassignee:-noneجميع المشاكل التي تم إسنادها.تتعامل أداة تتبُّع المشاكل مع السلاسل المرتبطة بحرف شرطة على أنّها مُحاطة بعلامات اقتباس. على سبيل المثال، تساوي معايير البحث
state-of-the-art"state of the art".تتعامل أداة تتبُّع المشاكل مع الكلمات المواصلة في حقل المشكلة باعتبارها كلمات مستقلة مفصولة بمسافة بيضاء. هذا يعني أنّه إذا كانت المشكلة تتضمن الكلمة
state-of-the-artفي عنوانها ونفّذت طلب البحثtitle:(of art state the)أوtitle:("state of the art")، سيتم عرض المشكلة كجزء من نتائج البحث.
العوامل الارتباطية
البنية الأساسية لمعايير البحث عن الحقل/القيمة هي [field]:[value]، حيث يشير رمز النقطتين الرأسيتَين (:) إلى أنّ الحقل المعني يجب أن يكون مساويًا للقيمة المحدّدة أو يحتوي عليها حتى يتم عرض مشكلة ضمن نتائج البحث.
تتيح الحقول التي تحتوي على قيمة زمنية (created وmodified وresolved وverified وحقول مخصّصة معيّنة) أو قيمة عدد (duplicatecount وvotecount
وcommentcount وcccount) عوامل التشغيل الارتباطية الإضافية التالية:
| الرمز | الوصف |
|---|---|
| < | تتطابق مع مشكلة إذا كانت قيمتها أقل من/قبل قيمة البحث. |
| <= | تتم مطابقة مشكلة إذا كانت قيمتها أقل من/قبل أو تساوي قيمة البحث. |
| > | تتم مطابقة مشكلة إذا كانت قيمتها أكبر من/بعد قيمة البحث. |
| >= | تتم مطابقة مشكلة إذا كانت قيمتها أكبر من/بعد أو مساوية لقيمة البحث. |
عمليات البحث عن الوقت
توفر لغة طلب البحث بناء جملة خاص لمطابقة الحقول التي تحتوي على قيمة زمنية. يسمح هذا لأداة تتبع المشاكل بالبحث في مجموعة من الأوقات أو الأوقات النسبية حسب الحاجة.
تنسيق الوقت المطلق
صيغة تحديد الوقت هي:
[yyyy]-[MM]-[dd]T[HH]:[mm]:[ss].
بهذا التنسيق، يكون [yyyy] هو العام المكوّن من 4 أرقام، و[MM] هو الشهر المكوّن من رقمَين، و[dd] هو اليوم المكوّن من رقمَين، و[HH] هو الساعة المكوّنة من رقمَين في نظام 24 ساعة، و[mm] هو الدقيقة، و[ss] هو الثاني. تكون جميع الأوقات حسب التوقيت العالمي المنسَّق.
يمكنك توفير مستوى الدقة الذي تريده عند البحث عن مشاكل
تم إنشاؤها في وقت معيّن أو قبله أو بعده. على سبيل المثال، يمكنك تحديد created:2014-06 للبحث عن المشاكل التي تم إنشاؤها في أي وقت في حزيران (يونيو) 2014. للحصول على مزيد من التفاصيل، يمكنك البحث في created:2014-06-03T04 للعثور على المشاكل التي تم إنشاؤها في 3 حزيران (يونيو) 2014 خلال الساعة الرابعة (بين 4 و5 صباحًا بالتوقيت العالمي المنسق).
النطاقات الزمنية
يمكنك استخدام حرفَي نقطة (..) لتحديد نطاق زمني في معايير البحث في الحقل/القيمة. البنية هي [field]:[start time]..[end time]. يمكن أن يكون لأوقات البدء
والانتهاء أي درجة من الدقة التي تحتاجها. على سبيل المثال،
يعرض verified:2013..2015 جميع المشاكل التي تم التحقّق منها في 2013 أو 2014 أو 2015.
تنسيق الوقت النسبي
يمكنك أيضًا تحديد الوقت من خلال الأيام التي تسبق اليوم. لإجراء ذلك، استخدِم التنسيق [days]d، حيث يكون [days] هو عدد الأيام السابقة التي تريد تضمينها في نتائج البحث. على سبيل المثال، يمكنك استخدام modified:5d للعثور على
المشاكل التي تم تعديلها في الأيام الخمسة الماضية.
عند استخدام تنسيق وقت نسبي، يجب أن يكون عامل التشغيل هو علامة النقطتين الرأسيتين
(:) مثل created:5d. إذا أردت العثور على مشاكل لا تندرج ضمن
هذا النطاق، يمكنك استخدام عامل التشغيل NOT أو -.
على سبيل المثال، يعرض -verified:10d المشاكل التي لم يتم التحقّق منها خلال آخر 10 أيام. وإذا أردت الاطّلاع على المشاكل التي تم التحقّق منها، ولكن ليس في آخر 10 أيام، يمكنك استخدام (-verified:10d) AND status:verified.
عمليات بحث "اليوم" باستخدام العمليات الحسابية اليومية
يمكنك استخدام الرمز المميّز today في عمليات البحث عن الوقت كبديل للتاريخ
الحالي. تتيح هذه الميزة استخدام العمليات الحسابية اليومية مثل today+10 وtoday-2.
يمكن أيضًا استخدام الرمز المميّز today مع نطاقات زمنية مثل today-2..today+3.
يساعد استخدام الرمز المميّز today في عمليات البحث المحفوظة في جعل طلب البحث قابلاً لإعادة الاستخدام.
أمثلة:
created:todaymodified<=today-10nearestslo:today+10resolved:2024-02-29..today+2customfield1002:today..today+5
تنبيه: كما هو مذكور في تنسيق الوقت المطلق، تكون عمليات البحث عن الوقت في أداة تتبُّع المشاكل بالتوقيت العالمي المنسَّق. وينطبق ذلك أيضًا على عمليات البحث التي تستخدم today.