إنشاء مشكلات Jira من سير العمل
افتح مشكلة في Jira من سير عمل — لدرجة منخفضة أو تعليق أو إجراء — ودع إجراء Polzy يُغلق نفسه عند إنجاز المشكلة. اربط Jira Cloud مرة واحدة برمز API.
في هذه الصفحة
عندما يتطلب شيء في الملاحظات تدخّل فريق — درجة تنخفض، أو شكوى من منتج، أو إجراء له مسؤول — يمكن لسير العمل أن يفتح مشكلة في Jira له، مملوءة بما يعرفه Polzy. وإذا أنشأ سير العمل أيضًا إجراءً في Polzy، فإن الإجراء يتابع المشكلة ويُغلق نفسه بمجرد إنجازها. في نهاية هذا الدليل سيكون Jira مربوطًا، وسير عمل يفتح المشكلات في المشروع الذي تختاره.
يتوفر Jira في خطة أعمال ويُستخدم من سير العمل. لا يستطيع ربطه وبناء سير العمل إلا المسؤول.
قبل أن تبدأ
تحتاج إلى:
- مساحة عمل على خطة أعمال، ودور مسؤول فيها.
- تفعيل التكاملات وسير العمل لمساحة العمل، من الإعدادات ← عام ← ما تقوم به مساحة العمل هذه.
- Jira Cloud — موقع تفتحه على عنوان مثل
https://acme.atlassian.net. لا يمكن ربط Jira Data Center ولا Jira Server. - حساب Atlassian الذي ستُنشأ المشكلات باسمه. الحساب المخصص، مثل
automation@acme.com، يمنع ارتباط المشكلات بشخص واحد. ويجب أن يملك صلاحية عرض المشكلات وإنشائها في المشاريع التي ستستخدمها — تسمي شاشات Jira الأحدث المشاريع مساحات (spaces) والمشكلات عناصر عمل (work items). - رمز API لهذا الحساب (أدناه).
إنشاء رمز API
- بعد تسجيل الدخول إلى Atlassian بالحساب الذي سيستخدمه Polzy، افتح صفحة رموز API الخاصة به:
id.atlassian.com/manage-profile/security/api-tokens. - اختر Create API token — وليس Create API token with scopes. يسجل Polzy الدخول على عنوان موقع Jira الخاص بك مباشرة، وهو ما لا يستطيع الرمز ذو النطاقات فتحه.
- سمِّه Polzy، واختر موعد انتهاء صلاحيته — سنة على الأكثر — ثم اختر Create.
- انسخ الرمز. لن تعرضه Atlassian مرة أخرى.
تشرح Atlassian الرموز في Atlassian: Manage API tokens for your Atlassian account. عند انتهاء صلاحية الرمز يرفضه Jira: أنشئ رمزًا جديدًا والصقه في Polzy قبل ذلك الموعد.
ربط Jira بـ Polzy
- في الشريط الجانبي، ضمن الأتمتة، افتح التكاملات واختر علامة التبويب متاحة.
- ابحث عن Jira واختر ربط.
- في موقع Jira، أدخل العنوان الذي تفتح عليه Jira، بدءًا بـ
https://. - في البريد الإلكتروني للحساب، أدخل البريد الإلكتروني لحساب Atlassian الذي يعود إليه الرمز.
- الصق الرمز في رمز API.
- اختر اختبار الاتصال. يرد Polzy بـ Connected as متبوعًا باسم الحساب.
- اختر ربط.
يُحفظ الرمز مشفّرًا. وبعد الربط، يعرض صف Jira ضمن التكاملات الخيار إعداد النطاق لتغيير الحساب أو الرمز، وإدارة لفتح صفحته.
فتح مشكلة من سير عمل
- افتح سير العمل ثم سير العمل المطلوب، أو أنشئ واحدًا جديدًا — مثلًا بالمشغّل إجابة الاستطلاع أو عتبة الدرجة.
- ضمن الموصلات في الخطوات المثبتة، اسحب إنشاء مشكلة في Jira · Jira إلى لوحة العمل، بعد الخطوة التي يجب أن تليها. الصف الذي يحمل قفلًا يعني أن Jira لم يُربط بعد أو يحتاج إلى انتباه: واختياره يفتح صفحة Jira.
- ضمن المشروع، اختر المشروع. تعرض القائمة كل مشروع يستطيع الحساب رؤيته، باسمه ومفتاحه.
- ضمن نوع المشكلة، اختر النوع. تعرض القائمة أنواع هذا المشروع، دون المهام الفرعية؛ والنوع Task محدد في البداية.
- اكتب الملخص: سطر واحد، حتى 255 حرفًا. اكتب
{{لإدراج قيمة من التشغيل، مثل عنوان الاستبيان أو الدرجة الإجمالية. - إن أردت، اكتب الوصف. السطر الفارغ يبدأ فقرة جديدة.
- إن أردت، أضِف التسميات مفصولة بفواصل. لا يمكن أن تحتوي تسميات Jira على مسافات، لذا تتحول المسافة إلى شرطة.
تمرّر الخطوة مفتاح المشكلة، مثل CS-142، باسم {{connector.issueKey}} وعنوانها باسم {{connector.url}}، لكي تربط بها خطوة لاحقة — رسالة على Slack مثلًا. أما تشغيل تجريبي فيمر بسير العمل دون فتح المشكلة: إذ تذكر الخطوة ما كانت ستفعله. ولا ينشئها إلا تشغيل حقيقي. يشرح سير العمل المشغّلات والخطوات.
إغلاق الإجراء عند إنجاز المشكلة
عندما تعمل إنشاء مشكلة في Jira بعد إنشاء عنصر إجراء في تشغيل سير العمل نفسه، تُربط المشكلة بذلك الإجراء:
- متابع في. تعرض لوحة الإجراء مفتاح المشكلة، مع رابط إلى Jira، وآخر حالة أبلغ عنها Jira.
- يُغلقه Jira. يسأل Polzy Jira عن المشكلة مرة كل 10 دقائق على الأكثر. وعندما تصل إلى حالة ضمن فئة «تم» في Jira — أيًا كان الاسم الذي يطلقه فريقك عليها — ينتقل الإجراء إلى منجز.
- الحالة فقط. تبقى التعليقات والتغييرات الأخرى في Jira. والإجراء الذي يُغلق في Polzy أولًا لا يُسأل عنه بعد ذلك.
راجع الإجراءات للوحة التي يعيش عليها الإجراء.
ما يرسله Polzy إلى Jira
ما تحدده الخطوة فقط: المشروع ونوع المشكلة والملخص والوصف والتسميات، بالقيم التي تدرجها. ولا يغادر Polzy أي شيء آخر عن الإجابة أو الشخص. الإجابة المجهولة لا شخص فيها، لذا تكون القيم مثل بريد المجيب فارغة؛ وما كتبه أحدهم لا يُرسل إلا بعد فحص السلامة، والإجابة المحجوبة للمراجعة تُرسل نصًا بديلًا. لا يحجب الحد الأدنى لحجم المجموعة الإجابات المفردة، لذا فكّر في من يستطيع قراءة المشروع قبل أن تضع كلمات الناس في مشكلة.
حل المشكلات
- The Jira site must start with https://. أدخل العنوان الكامل، مثل
https://acme.atlassian.net. - The account email is required. أدخل البريد الإلكتروني للحساب الذي يعود إليه الرمز.
- Jira refused the credentials (401). البريد الإلكتروني والرمز غير متطابقين، أو انتهت صلاحية الرمز أو أُلغي، أو أنه رمز ذو نطاقات. أنشئ رمزًا جديدًا كما سبق، واختر إعداد النطاق في صف Jira ضمن التكاملات، والصقه، ثم اختر حفظ. والتشغيل الذي يصادف ذلك يضع Jira في حالة يحتاج إلى انتباه.
- Jira refused the credentials (403). لا يُسمح للحساب بذلك في هذا المشروع. امنحه صلاحية عرض المشكلات وإنشائها هناك.
- Jira answered 400: مع حقل is required. يتطلب نوع المشكلة حقلًا لا تملؤه الخطوة، مثل مكوّن. اجعل الحقل اختياريًا لهذا النوع في Jira، أو اختر نوعًا آخر.
- Jira answered 404. حُذف المشروع، أو لم يعد الحساب يستطيع رؤيته.
- قائمة المشروع مجرد حقل. لا يرى الحساب أي مشروع، أو تعذّر الوصول إلى Jira. تحقق من صلاحيات الحساب.
- This step names no project أو The issue has no summary. املأ المشروع والملخص في الخطوة.
- Jira is needs_attention and cannot be used (في تشغيل). يحتاج الاتصال إلى انتباه. أعد ربطه، ثم شغّل مرة أخرى.
- لا يُغلق الإجراء. لم تعمل خطوة Jira بعد إنشاء عنصر إجراء في التشغيل نفسه، أو أن حالة المشكلة ليست ضمن فئة «تم» في Jira، أو أن الاتصال يحتاج إلى انتباه — وتتوقف الاستعلامات حتى يُحل ذلك.
معلومات مفيدة
- اتصال واحد لكل المشاريع. تختار كل خطوة مشروعها مما يراه الحساب، فيخدم اتصال واحد كل الفرق.
- من يظهر كمبلّغ؟ الحساب الذي يعود إليه الرمز.
- هل يمكن لخطوة أن تفتح المشكلة نفسها مرتين؟ لا. الخطوة التي تُعاد بعد تعطل تستخدم ما أنشأته في المرة الأولى.
روابط مفيدة
مقالات ذات صلة
يمكن للأعضاء المسجّلين سؤال Polzy أو مراسلة الفريق من صفحة الدعم. تعتمد سرعة ردّنا على خطتك.