ربط الشيفرة من GitHub أو GitLab بالمهام

يمكن للمطورين ربط شيفرتهم بالمهام دون مغادرة GitHub أو GitLab. عندما تذكر رسالة commit أو اسم فرع أو طلب دمج (pull request، ويسمى merge request في GitLab) رقم مهمة مثل CBS-74-T357، يظهر في تبويب الشيفرة المرتبطة لتلك المهمة. هذا جزء من باقة Business، ولا يستطيع الربط إلا المسؤولون.

ربط مستودع

1. افتح الإعدادات واختر التكاملات.
2. تحت GitHub وGitLab اكتب الاسم (مثلًا Mobile app)، واختر GitHub أو GitLab، ثم اضغط ربط.
3. يعرض Kaam360 عنوانًا وسرًّا. انسخهما الآن: لا يظهر السر إلا مرة واحدة.
4. في GitHub افتح المستودع (أو مؤسستك)، ثم Settings ثم Webhooks ثم Add webhook. الصق العنوان في Payload URL، واختر application/json، والصق السر في Secret، واختر Let me select individual events، وحدّد Pushes وPull requests، ثم اضغط Add webhook.
5. في GitLab افتح المشروع (أو مجموعتك)، ثم Settings ثم Webhooks ثم Add new webhook. الصق العنوان في URL والسر في Secret token، وحدّد Push events وMerge request events، ثم اضغط Add webhook.

يرسل GitHub رسالة اختبار فورًا. بعدها يعرض الربط نشط وما فعلته الرسالة الأخيرة.

اذكر مهمة

انسخ رقم المهمة من أعلى المهمة (مثلًا CBS-74-T357) إلى:

• رسالة commit، مثل Fix the login button (CBS-74-T357)؛
• اسم فرع، مثل feature/CBS-74-T357-login؛
• عنوان طلب دمج أو وصفه.

يجب أن يتضمن الرقم رمز مشروعه، فلا يُربط رقم من مشروع آخر خطأً أبدًا. افتح المهمة واختر تبويب الشيفرة المرتبطة لترى كل commit وفرع وطلب دمج مرتبط، مع المستودع والمؤلف، ولطلب الدمج هل هو مفتوح أو مدموج أو مغلق. اضغط سطرًا لفتحه في GitHub أو GitLab. ويُظهر سجل المهمة أيضًا متى رُبطت الشيفرة.

إنهاء المهام عند دمج طلب الدمج

حدّد وضع علامة منتهية على المهام التي يذكرها لربط ما. عندما يُدمج طلب دمج يذكر مهمة، تصبح المهمة منتهية، كأن المسؤول الذي أنشأ الربط قام بذلك.

حافظ على الأمان

• يتحقق Kaam360 من السر في كل رسالة ويرفض كل ما لا يحمله.
• إذا احتمل أن السر تسرّب، اضغط زر المفتاح (سر جديد) وضع السر الجديد في إعدادات الـ Webhook. يتوقف السر القديم عن العمل فورًا.
• اضغط إيقاف مؤقت لإيقاف الربط مدة من الزمن، أو إزالة لحذف الربط والروابط التي أنشأها. وأزل الـ Webhook في GitHub أو GitLab أيضًا.

إذا حدثت مشكلة

• لا يُربط شيء: تأكد أن الرقم يتضمن رمز المشروع ورقم المهمة الصحيح، وأن الـ Webhook يرسل الـ pushes وطلبات الدمج.
• يُظهر GitHub علامة حمراء على إرسال: العنوان أو السر خطأ. اضغط سر جديد والصقه مرة أخرى.