لغة استعلام الأصول
إدارة خدمات جيرا (JSM) تقدم ميزة مهمة تعرف باسم الأصول، والتي تهدف إلى مساعدة المؤسسات على إدارة وتتبع أصولها وعناصر التكوين بفعالية. إذا أرادت أي منظمة متابعة أصول الأجهزة والبرمجيات، فإن Jira Asset مفيد جدا. العنصر الأساسي في الاستفادة الكاملة من الإمكانيات للأصول هو لغة استعلام الأصول (AQL)، وهي ميزة قوية تتيح للمستخدمين إجراء عمليات بحث متقدمة، وتصفية الكائنات، وأتمتة العمليات داخل نظام إدارة الأصول الخاص بهم.
Owner = "Ted Anderson"
في هذا الاستعلام، المالك هو السمة، = هو المشغل، و"ديباك راي" هو القيمة. من المهم ملاحظة أن AQL ليست حساسة للحرف، ويجب تضمين السمات أو القيم التي تحتوي على فراغات في علامات اقتباس.
تدوين النقاط في AQL:
يدعم AQL تدوين النقاط، الذي يسمح للمستخدمين بالتنقل بين الكائنات. وهذا مفيد بشكل خاص عند التعامل مع الأصول المترابطة. على سبيل المثال، للعثور على جميع الموظفين التابعين لقسم الموارد البشرية، قد تستخدمها:
"Belongs to Department".Name = HR
هنا، "ينتمي إلى القسم" هو سمة مشار إليها تربط الموظف بقسم، و . الاسم يحدد اسم القسم.
تحسين استعلامات AQL:
تعد استعلامات AQL الفعالة ضرورية لتحقيق الأداء الأمثل، خاصة في مجموعات البيانات الكبيرة. إليك بعض التوصيات لتعزيز كفاءة الاستعلامات:
- تحديد نطاق الاستعلامات: تضييق نطاق البحث يمكن أن يقلل بشكل كبير من وقت المعالجة. على سبيل المثال، بدلا من البحث عن اسم في جميع الكائنات، حدد نوع الكائن:
objectType = Employees AND Label LIKE "John"
هذا النهج يقتصر البحث على نوع كائن 'الموظفين'، مما يجعل الاستعلام أكثر كفاءة.
2. دمج الدوال مع جمل AND: عند استخدام دوال مثل connectedTickets()، دمجها مع جمل AQL أخرى باستخدام عامل AND لتحديد عدد الكائنات التي تحتاج الدالة لمعالجتها:
objectType = Employee AND Label = John AND object HAVING connectedTickets(status = "In progress")
تقوم هذه الطريقة أولا بتصفية الموظفين المسمين جون ثم تتحقق من التذاكر المرتبطة بحالة "قيد التنفيذ"، مما يحسن الأداء.
صياغة الأحرف الخاصة
AQL لها بناء جملة محدد ويجب إدخاله بدقة.
- AQL هو ليس حساس للحروف العلمية.
- إذا كنت تستخدم تعبيرا يحتوي فيه القيمة أو السمة على مسافة، يجب عليك تضمين علامات اقتباس حول القيمة، كما في المثال أعلاه ل "تيد أندرسون".
- إذا كنت تستخدم تعبيرا تحتوي فيه القيمة أو السمة على علامات اقتباس، يجب عليك الهروب من علامات الاقتباس عن طريق تسميتها بعلامات ارتداد. على سبيل المثال، إذا كان لديك اسم كائن مثلشاشة 15"، للبحث عنها أدخل: شاشة 15\"
- يجب أن يكون اسم السمة الذي تحدده في AQL موجودا في مخطط الأصول الخاص بك. إذا لم يكن ك��لك، سيعتبر AQL غير صالح.
AQL لديه بناء جملة محدد يجب إدخاله بدقة. إليك بعض الإرشادات الرئيسية:
- AQL ليست حساسة للحالات.
- إذا كانت القيمة أو السمة تحتوي على مسافات، قم بتضمينها في علامات اقتباس. على سبيل المثال: "تيد أندرسون".
- إذا كانت القيمة أو السمة تحتوي على علامات اقتباس، فلتخرج منها باستخدام الخطوط العريضة العكسية. على سبيل المثال، لاسم كائن مثل شاشة 15"، استخدام: شاشة 15\".
- يجب أن يكون اسم السمة الذي تحدده في AQL موجودا في مخطط الأصول الخاص بك. إذا لم يكن كذلك، فسيكون قانون العقوبة الجزئي غير صالح.
الكلمات المفتاحية
على سبيل المثال، لإرجاع جميع الكائنات من نوع كائن معين، يمكنك استخدام كلمة objectType المفتاحية.
مثال: objectType = "الأجهزة"
الجدول أدناه يسرد الكلمات المفتاحية المدعومة والأمثلة:
استعلام AQL يعيد جميع الكائنات التي تحمل نوع كائن "المضيف":
مقترح من LinkedIn
objectType = "Host"
المشغلون
المشغلات في AQL تساعدك على إنشاء تعبيرات أكثر تفصيلا ومنطقية للاستعلام عن الكائنات. إليك جدول يصف المشغلات المدعومة:
مشغلات التركيب
يمكنك استخدام عوامل مثل و و أو لدمج شروط متعددة وإنشاء استعلامات AQL أكثر تعقيدا. إليك مثال:
objectType = "مضيف" و "نظام تشغيل" = "أوبونتو" (64-بت"
الوظائف
يمكنك استخدام دوال مختلفة لتوفير قيم ديناميكية لاستفسارات AQL. وهذا يمنح AQL قوة إضافية.
- التاريخ والوقت: الآن(), بداية يوم(), نهاية اليوم(), بداية الأسبوع()، نهاية الأسبوع(), بداية الشهر(), نهاية الشهر(), بداية العام(), نهاية العام()
- المستخدم: المستخدم الحالي()، المراسل الحالي()، المستخدم(user1، user2، ..)
- المجموعة: المجموعة(المجموعة 1، المجموعة 2,...)، المستخدم(user1، user2، ...)
- المشروع: المشروع الحالي()
استخدام التذاكر المرتبطة() الوظيفة
التذاكر المرتبطة() تستخدم الدالة في AQL لتصفية الكائنات التي تحتوي على عناصر عمل Jira متصلة بها. يمكنك تحديد استعلام JQL لتصفية العمل المحدد لجيرا الذي تريد تضمينه في بحثك. إذا لم يتم توفير استعلام JQL، ستعيد الدالة جميع الكائنات التي لديها مشاكل Jira متصلة.
أنتيجب أن يكونتوفير JQL كوسيطة لتلك الدالة AQL (مثلا: الكائن لديه connectedTickets(المشروع = VK)).
باستخدام objectTypeAndChildren() الوظيفة
الobjectTypeAndChildren() تستخدم الدالة في AQL لإرجاع كائنات من نوع كائن معين مع الكائنات الفرعية المرتبطة بها. هذه الدالة مفيدة عندما ترغب في استرجاع ليس فقط كائن أب بل أيضا الكائنات الفرعية المرتبطة به ضمن نفس الاستعلام.
هذا الاستعلام في AQL يعيد جميع الكائنات والكائنات الفرعية من نوع كائن "تفاصيل الأصول":
objectType في objectTypeAndChildren("تفاصيل الأصول")
دمج المراجع والدوال وAQL
يمكن دمج الوظائف والمراجع وAQL بطرق قوية. على سبيل المثال، يمكنك إضافة عدة مراجع للكائنات إلى حقل مخصص مرتبط بكائن، ثم البحث في تلك المراجع عن مفتاح محدد:
object HAVING inboundReferences(Key IN (${MyCustomField${0}}))
أو تسمية محددة، باستخدام تدوين النقاط:
object HAVING inboundReferences(Label IN (${Portfolios.label${0}}))
الترتيب
يمكنك ترتيب نتائج استفسار AQL الخاص بك عن طريق إضافة اللاحقة التالية:
pgsqlCopyEditorder بواسطة [اسم الصفة|العلامة التجارية] [ASC|DESC]
- إذا لم يتم تحديد ترتيب حسب جملة، فإن الترتيب الافتراضي يصعد حسب خاصية تسمية نوع الكائن.
- إذا كانت السمة في الترتيب حسب الجملة من نوع المرجع، يمكنك استخدام تدوين النقاط للترتيب حسب خاصية الكائن المشار إليه.
- ستظهر القيم المفقودة في أعلى القائمة عند استخدام الترتيب الصاعدي (ASC).
- يجب أن تكون السمة المستخدمة في الترتيب حسب الجملة موجودة في مخطط الأصول. إذا لم يكن كذلك، فسيكون AQL غير صالح.
- يمكنك استخدام العنوان المؤقت لترتيب الكائنات حسب التسمية المكونة لها.
- الترتيب حسب عدة خصائص غير مدعوم.
إذا لم يتم العثور على السمة المحددة في الترتيب حسب الجملة في النتائج، فسيكون الترتيب عشوائيا.
لغة استعلام الأصول هي أداة قوية في إدارة خدمات جيرا، تتيح إدارة أصول دقيقة وفعالة. من خلال فهم صياغته، واستخدام ميزات مثل تدوين النقاط، وتحسين الاستعلامات، يمكن للمستخدمين تحسين عمليات إدارة الأصول بشكل كبير. البقاء على اطلاع بالتغييرات القادمة يضمن قدرة المؤسسات على تعديل ممارساتها للحفاظ على الأداء الأمثل والامتثال لمنصة أتلاسيان المتطورة.