قبل أن تبدأ
- تحتاج دور مالك أو مشرف في مساحة عمل Marqab.
- اربط مصدرًا بمنتج بعد الاتصال. المستودعات والمشاريع غير المربوطة تُتجاهل.
- اتصال أو ربط جديد يسترجع آخر 90 يومًا.
- أسرار الويب هوك تُعرض مرة واحدة. بدّلها فقط إن استطعت تحديث المزوّد في اليوم نفسه.
GitHub
طلبات السحب المدمجة والإصدارات المنشورة تصبح نشاطًا وملخصات وملاحظات إصدار.
الإعداد
- الإعدادات ← التكاملات ← GitHub. المالكون والمشرفون فقط.
- اختر Install GitHub App وحدّد المنظمة أو المستودعات.
- اربط كل مستودع (owner/repo) بمنتج.
- يسترجع Marqab آخر 90 يومًا من طلبات السحب المدمجة. الدمج والإصدارات الجديدة تصل فورًا.
وإلا. GitHub Enterprise، أو إن اختفى زر التطبيق: الصق رمزًا شخصيًا، عيّن عنوان الـ API إن لزم، وأضف ويب هوك لطلبات السحب والإصدارات.
قطع الاتصال
قطع الاتصال يزيل ربط التطبيق أو الرمز. تبقى ربطات المستودع → المنتج.
إعادة الاتصال
ثبّت التطبيق مجددًا (أو الصق رمزًا جديدًا). أعد الربط فقط إن حذفت الربوط.
GitLab
طلبات الدمج المدمجة والإصدارات ودفع الوسوم تغذي النشاط وملاحظات الإصدار نفسها.
الإعداد
- الإعدادات ← التكاملات ← GitLab.
- اختر Connect with GitLab وصرّح لـ Marqab على gitlab.com.
- اربط كل مشروع بمنتج. يسجّل Marqab ويب هوك المشروع نيابة عنك.
- يُسترجع آخر 90 يومًا من طلبات الدمج المدمجة.
وإلا. GitLab مستضاف ذاتيًا، أو إن اختفى Connect: الصق رمزًا شخصيًا، عيّن العنوان الأساسي، اربط المشاريع، وأضف ويب هوك للمشروع.
قطع الاتصال
قطع الاتصال يمسح OAuth أو الرمز. تبقى ربطات المشروع.
إعادة الاتصال
اتصل بـ GitLab مجددًا (أو الصق رمزًا). احفظ ربطًا إن أُزيل خطاف المشروع.
Jira
المسائل التي تنتقل إلى Done تصبح تذاكر مغلقة. يمكن أن تظهر المفتوحة في صفحة المنتج.
الإعداد
- الإعدادات ← التكاملات ← Jira.
- أدخل عنوان الموقع وبريد Atlassian ورمز API.
- اربط كل مفتاح مشروع بمنتج.
- أضف الويب هوك الذي يعرضه Marqab (Issue updated).
وإلا. إن كان تطبيق Marqab على Forge مثبّتًا، الصق أيضًا Cloud ID وأضف حقل منتج Marqab إلى الشاشة.
قطع الاتصال
قطع الاتصال يزيل رمز API من Marqab. حدّث أو أزل خطاف Jira إن لم تُعد الاتصال.
إعادة الاتصال
أدخل عنوان الموقع والبريد ورمز API جديد. الصق معرّف السحابة مجددًا مع Forge.
Sentry
المسائل الجديدة والعائدة والحلول تصل إلى المنتج. يمكن سرد المفتوحة مباشرة.
الإعداد
- الإعدادات ← التكاملات ← Sentry. ثبّت تطبيق Marqab إن ظهر، أو وصّل تكاملًا داخليًا.
- للتكامل الداخلي: امنح Project وIssue & Event وOrganization Read. فعّل ويب هوك المسائل.
- الصق الرمز وClient Secret. عيّن معرف المنظمة.
- اربط كل معرف مشروع Sentry بمنتج أو مكوّن.
وإلا. التكاملات الداخلية تستخدم عنوان الويب هوك لكل مساحة عمل الذي يعرضه Marqab.
قطع الاتصال
قطع الاتصال يلغي التثبيت أو الرمز. تبقى الربوط.
إعادة الاتصال
ثبّت تطبيق Sentry مجددًا، أو الصق رمزًا داخليًا وClient Secret جديدين.
Slack
ينشر Marqab ملخصات الإصدار وملخص الاثنين في قناة تختارها. لا يُسحب شيء إلى الداخل.
الإعداد
- ثبّت تطبيق Slack لـ Marqab وانسخ Bot User OAuth Token.
- الإعدادات ← التكاملات ← Slack: الصق الرمز وقناة (مثل #releases).
- اختياريًا عيّن مساحة Slack لتعمل أزرار «افتح في Slack» للمالك.
- اختبر الاتصال. تُنشر الإصدارات عند الإطلاق؛ الملخص يوم الاثنين 09:00 UTC.
وإلا. ما زال عنوان Incoming Webhook يعمل إن لم ترد رمز بوت.
قطع الاتصال
قطع الاتصال يوقف منشورات Marqab. يمكنك أيضًا إزالة التطبيق من Slack.
إعادة الاتصال
الصق رمز بوت أو رابط ويب هوك جديدًا وقناة، ثم اختبر الاتصال.
قطع الاتصال وإعادة الاتصال
- المالكون والمشرفون: افتح المزوّد ← قطع الاتصال. تُمسح بيانات الاعتماد. تبقى الربوط.
- أعد الاتصال عبر التثبيت / الاتصال (أو الصق من جديد). اتصال أو ربط جديد يسترجع 90 يومًا.
- مساحات العمل للقراءة فقط يمكنها قطع الاتصال والاختبار؛ الاتصال قد يتطلب خطة أعلى.
تحتاج مساعدة؟
الإعدادات ← المساعدة والدعم، أو انظر Support. الصفحات القانونية في هذا الموقع بالإنجليزية. Support