قبل أن تبدأ
- تحتاج دور مالك أو مشرف في مساحة عمل 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: الصق رمزًا شخصيًا، عيّن العنوان الأساسي، اربط المشاريع، وأضف ويب هوك للمشروع.
Jira
المسائل التي تنتقل إلى Done تصبح تذاكر مغلقة. يمكن أن تظهر المفتوحة في صفحة المنتج.
الإعداد
- الإعدادات ← التكاملات ← Jira.
- أدخل عنوان الموقع وبريد Atlassian ورمز API.
- اربط كل مفتاح مشروع بمنتج.
- أضف الويب هوك الذي يعرضه Marqab (Issue updated).
وإلا. إن كان تطبيق Marqab على Forge مثبّتًا، الصق أيضًا Cloud ID وأضف حقل منتج Marqab إلى الشاشة.
Sentry
المسائل الجديدة والعائدة والحلول تصل إلى المنتج. يمكن سرد المفتوحة مباشرة.
الإعداد
- الإعدادات ← التكاملات ← Sentry. ثبّت تطبيق Marqab إن ظهر، أو وصّل تكاملًا داخليًا.
- للتكامل الداخلي: امنح Project وIssue & Event وOrganization Read. فعّل ويب هوك المسائل.
- الصق الرمز وClient Secret. عيّن معرف المنظمة.
- اربط كل معرف مشروع Sentry بمنتج أو مكوّن.
وإلا. التكاملات الداخلية تستخدم عنوان الويب هوك لكل مساحة عمل الذي يعرضه Marqab.
Slack
ينشر Marqab ملخصات الإصدار وملخص الاثنين في قناة تختارها. لا يُسحب شيء إلى الداخل.
الإعداد
- ثبّت تطبيق Slack لـ Marqab وانسخ Bot User OAuth Token.
- الإعدادات ← التكاملات ← Slack: الصق الرمز وقناة (مثل #releases).
- اختياريًا عيّن مساحة Slack لتعمل أزرار «افتح في Slack» للمالك.
- اختبر الاتصال. تُنشر الإصدارات عند الإطلاق؛ الملخص يوم الاثنين 09:00 UTC.
وإلا. ما زال عنوان Incoming Webhook يعمل إن لم ترد رمز بوت.
تحتاج مساعدة؟
الإعدادات ← المساعدة والدعم، أو انظر Support. الصفحات القانونية في هذا الموقع بالإنجليزية. Support