قضايا Jira لا تُنشأ: أصلح الربط أولًا ثم الصلاحيات
إنشاء قضية Jira من خطأ AllStak يفشل، أو إغلاق قضية Jira لا يحل الخطأ المرتبط أبدًا. ولكلٍّ منهما قائمة فحص قصيرة ومحددة.
كيف تبدو المشكلة
تفتح خطأ في AllStak وتختار إنشاء قضية Jira من قائمة إجراءاته، وتعبّئ مفتاح المشروع والملخص ونوع القضية — ويفشل الإنشاء. أو ينجح، لكن إغلاق قضية Jira لاحقًا لا يحل خطأ AllStak المرتبط كما يفترض.
هذان مساران مختلفان للفشل: يعتمد إنشاء القضية على ربط OAuth الذي أعدّه مدير المؤسسة وعلى الصلاحيات داخل Jira؛ بينما يعتمد الحل التلقائي عند الإغلاق على أن يكون webhook الوارد المضبوط لكل تكامل قابلًا للوصول من موقع Jira.
الأسباب الجذرية الشائعة
Jira غير مربوط (أو الرمز ملغى)
يُربط Jira عبر OAuth من Atlassian، ويعدّه مدير المؤسسة من صفحة التكاملات. فإذا لم يُربط أصلًا — أو ألغى طرف Atlassian التفويض — يفشل كل إنشاء.
صلاحيات المشروع من جهة Jira
يجب أن يستطيع حساب Atlassian المربوط إنشاء قضايا في مشروع Jira المستهدف. فمفتاح مشروع خاطئ، أو مشروع لا يراه الحساب، أو غياب صلاحية إنشاء القضايا — كلها تفشل من جهة Jira.
نوع قضية غير صالح للمشروع
تختلف أنواع القضايا بين مشاريع Jira. واختيار نوع لا يقدّمه المشروع المستهدف (أو نوع له حقول مخصصة إلزامية) يجعل Jira ترفض الإنشاء.
webhook الحل التلقائي غير قابل للوصول
إغلاق قضية Jira يحل الخطأ المرتبط فقط عندما يصل انتقال فئة done من Jira إلى webhook الوارد المضبوط لكل تكامل. وإذا تعذّر الوصول إليه، تتقادم الروابط بصمت.
التشخيص خطوة بخطوة
أصلح الإنشاء أولًا، ثم تحقّق من حلقة الحل-عند-الإغلاق على حدة.
- 1
تأكد أن التكامل مربوط
اطلب من مدير المؤسسة فتح صفحة التكاملات وفحص بطاقة Jira. إذا كانت غير مربوطة أو تُظهر مشكلة تفويض، أعد تدفّق OAuth من Atlassian ووافق على الطلب.
- 2
أعد المحاولة من قائمة إجراءات الخطأ
افتح خطأ في AllStak وأنشئ القضية من قائمة إجراءاته، مع التدقيق في مفتاح مشروع Jira والملخص والوصف ونوع القضية. ولاحظ رسالة الخطأ بالضبط إن فشل — فهي غالبًا تسمّي السبب من جهة Jira.
- 3
افحص الصلاحيات داخل Jira
في Jira، تأكد أن الحساب المربوط يستطيع تصفّح المشروع المستهدف وإنشاء قضايا فيه، وأن نوع القضية المختار موجود فيه دون حقول مخصصة إلزامية. صحّح مخطط الصلاحيات أو اختر مشروعًا/نوعًا آخر.
- 4
أعد الربط بعد تغييرات من جهة Atlassian
إذا غادر المدير الذي ربط، أو تغيّر الحساب، أو حُذفت تطبيقات في إدارة Atlassian، فقد يكون التفويض المخزّن ميتًا. وإعادة الربط عبر OAuth من صفحة التكاملات تعيده.
- 5
تحقّق من حلقة الحل التلقائي
أنشئ قضية تجريبية من خطأ تجريبي، وانقلها إلى حالة من فئة done في Jira، وتأكد أن خطأ AllStak المرتبط يُحل. وإن لم يحدث، تحقّق أن webhook الوارد المضبوط للتكامل قابل للوصول من موقع Jira.
كيف تمنع تكرارها
- اربط Jira بحساب خدمة بدل حساب شخصي، حتى لا تكسر المغادراتُ التكامل.
- وثّق مفتاح مشروع Jira ونوع القضية اللذين يستخدمهما فريقك لأخطاء الإنتاج.
- بعد أي تغيير في مخطط صلاحيات Jira، اختبر إنشاء قضية واحدة من خطأ قبل الاعتماد عليه.
- أغلق دوريًا قضية تجريبية مرتبطة للتأكد أن webhook الحل التلقائي ما زال يعمل.
ما زلت عالقًا؟
إذا فشل الإنشاء مع سلامة الربط وتأكيد صلاحيات Jira، راسلنا على [email protected] باسم مؤسستك ومفتاح مشروع Jira ورسالة الخطأ التي تراها — وتحقّق أولًا من صفحة حالة AllStak لأي مشاكل من جهة المنصّة.
الأسئلة الشائعة
من يستطيع ربط تكامل Jira؟
يربط مدير المؤسسة Jira عبر تدفّق OAuth من Atlassian في صفحة التكاملات. وبعد الربط يستطيع أعضاء الفريق إنشاء قضايا من الأخطاء.
ليش إغلاق قضية Jira ما يحل خطأ AllStak؟
يتطلب الحل التلقائي أن يكون الخطأ مرتبطًا بالقضية وأن يصل انتقال فئة done من Jira إلى webhook الوارد المضبوط لكل تكامل. تحقّق أن الـ webhook قابل للوصول وأن القضية انتقلت فعلًا إلى حالة من فئة done.
هل ينشئ AllStak قضية Jira لكل خطأ تلقائيًا؟
لا — إنشاء القضية فعل مقصود من قائمة إجراءات الخطأ. وهذا يُبقي Jira للعمل الذي يحتاج ملكية هندسية بينما تبقى الأخطاء الصاخبة أو العابرة في AllStak كإشارات فرز فقط.
أي نسخة Jira مدعومة؟
يربط التكامل موقع Jira Cloud عبر OAuth من Atlassian، مع إبقاء الرموز على الخادم.
استكشف المزيد
من التنبيه إلى عمل متابَع
اربط Jira مرة واحدة، وأنشئ قضايا من الأخطاء المهمة، ودع انتقالات فئة done تحلها في AllStak. ابدأ مجانًا.