التكاملات
Jira
في هذه الصفحة
ما الذي يفعله
- حقل مهمة Jira في كل تغيير (مفتاح مثل
ABC-123)، مع رابط إلى المهمة وملخصها وحالتها. - تعليق على المهمة عند طلب الموافقة، وعند الموافقة على التغيير أو رفضه (مع تعليق المراجع)، وعند نشره (المراجعة والبيئة والأعلام). وتختار أنت أيّها.
- انتقال اختياري: مثل In Review عند طلب الموافقة وDone عند نشر التغيير.
ربط Jira Cloud
- اختر حساب Atlassian الذي يعمل NanoFlags باسمه. تظهر التعليقات باسمه، وحساب مخصّص (مثل NanoFlags bot) يجعلها سهلة التمييز. يحتاج الحساب صلاحيتي Browse projects وAdd comments في المشاريع التي تربطها، وTransition issues إن استخدمت الانتقالات.
- بعد تسجيل الدخول بذلك الحساب، أنشئ رمز API من id.atlassian.com ← Security ← API tokens.
- في NanoFlags، افتح الإعدادات ← التكاملات ← Jira بصفة مالك أو مسؤول، وأدخل موقعك (
https://your-team.atlassian.net) وبريد الحساب والرمز. - يتحقق NanoFlags من الرمز (يقرأ ملف الحساب نفسه) ويعرض النتيجة. ويعيد زر اختبار الاتصال الفحص.
يمكنك اختياريًا حصر الربط في بعض مشاريع Jira (مثل ABC, OPS): تُرفض مفاتيح المشاريع الأخرى. موقع Jira واحد لكل مؤسسة.
ربط مهمة بتغيير
افتح التغيير، ثم نظرة عامة ← مهمة Jira ← ربط مهمة، واكتب المفتاح. يستطيع كل من يملك إنشاء التغييرات أو تعديلها في تلك البيئة ربط المهمة أو تغييرها أو إلغاء ربطها؛ ويُسجَّل كل ذلك في سجل التغيير.
التعليقات والانتقالات
| متى | التعليق | الانتقال (اختياري) |
|---|---|---|
| عند طلب الموافقة | طُلبت الموافقة في NanoFlags على «New checkout» (Production، Shop) من منى. | الانتقال عند طلب الموافقة |
| عند الموافقة على التغيير أو رفضه | وافق عمر على «New checkout» في NanoFlags (Production، Shop). مع التعليق إن وُجد. | — |
| عند نشر التغيير | نُشر «New checkout» في Production بالمراجعة r42 (Shop) بواسطة منى. مع الأعلام. | الانتقال عند النشر |
- تُكتب التعليقات بلغة مؤسستك (العربية أو الإنجليزية) وتربط بالتغيير في NanoFlags.
- يُعثر على الانتقال باسمه أو باسم الحالة التي يؤدي إليها. وإن لم يتحه سير عمل المهمة من حالتها الحالية (مثل مهمة منجزة أصلًا)، يُتخطّى ويُدوَّن ذلك في سجل التسليم.
- تُعاد عمليات التسليم الفاشلة 5 مرات (بعد 1 و2 و4 و8 و16 دقيقة) عند تجاوز حد المعدل وأخطاء خوادم Jira وانتهاء المهلة. وتتحقق إعادة المحاولة أولًا من وجود التعليق السابق في المهمة، فلا يُنشر التعليق مرتين. ولا يُعاد الإرسال عند رفض الرمز أو عدم وجود المهمة.
حالة المهمة في صفحة التغيير
تعرض صفحة التغيير ملخص المهمة وحالتها وفئة الحالة (للتنفيذ، قيد التنفيذ، منجزة). يقرؤها NanoFlags من Jira عند فتح الصفحة، مرة في الدقيقة كحد أقصى لكل مهمة، ويحتفظ بها 10 دقائق. وإن كان Jira بطيئًا أو غير متاح، تُعرض آخر حالة معروفة مع وقتها.
الأذونات والتخزين
- يربط Jira أو يغيّره أو يفصله المالكون والمسؤولون فقط. ولا تُدخل بيانات الاعتماد إلا من جلسة مسجّلة في لوحة التحكم، لا برمز واجهة الإدارة البرمجية.
- تشفّر خدمة الإشعارات في NanoFlags رمز API (AES-256-GCM) بمفتاح لا تملكه قاعدة البيانات. لا يظهر مجددًا، ولا تعيده أي واجهة برمجية، ولا يُرسَل إلى أي متصفح.
- يخزّن NanoFlags مفتاح المهمة لكل تغيير، وللعرض فقط ملخص المهمة وحالتها ونوعها. ولا يقرأ شيئًا آخر من Jira.
- يحذف فصل Jira الرمز وبيانات المهام المخزّنة مؤقتًا. وتبقى مفاتيح المهام في التغييرات مراجع عادية. ألغِ الرمز أيضًا من id.atlassian.com.
لاحقًا: تطبيق OAuth
تستخدم المرحلة الأولى رمز API لحساب Atlassian واحد، دون تثبيت أي تطبيق. وستتيح نسخة لاحقة الربط عبر Atlassian بتطبيق OAuth 2.0 (3LO): يوافق المسؤول على صلاحيات مثل read:jira-work وwrite:jira-work، ويخزّن NanoFlags رمز تحديث مشفّرًا بدل رمز API شخصي، وتمر الطلبات عبر api.atlassian.com/ex/jira/<cloud id>. وتظهر التعليقات حينها بهوية التطبيق. ويمكن لتطبيق في Atlassian Marketplace إضافة لوحة NanoFlags داخل مهام Jira. وتنتقل الروابط والإعدادات الحالية كما هي.