GitHub

GitHub هو المكان الذي تستضيف فيه فرق البرمجيات الشيفرة وتتابع المشكلات. يتيح ربط GitHub بـ Resool للموظفين فتح مشكلة في GitHub مباشرة من محادثة العميل، مع التصنيفات وبيانات جهة الاتصال ورابط يعيد إلى المحادثة، ثم معرفة إن كانت المشكلة ما زالت مفتوحة أو أُغلقت. ويمكن لمسارات العمل أيضًا فتح مشكلات GitHub تلقائيًا.

#ما الذي يمكنك فعله مع GitHub

في صندوق الوارد

• إنشاء مشكلة في مستودع من المحادثة، بعنوان ووصف وتصنيفات. تُضاف بيانات جهة الاتصال ورابط المحادثة إلى المشكلة.
• اعرض المشكلات التي فُتحت لجهة الاتصال من Resool، ولكل منها رقمها وتاريخها وحالتها (مفتوحة أو مغلقة).
• عرض في GitHub لفتح المشكلة في تبويب جديد.

في سير العمل

• تفتح خطوة إنشاء مشكلة GitHub مشكلة في مستودع مع رابط المحادثة.

#قبل أن تبدأ

• تحتاج إلى حساب GitHub لديه وصول إلى المستودعات التي ستفتح فيها المشكلات. المستودعات الخاصة مدعومة أيضًا.
• في Resool، يستطيع المالك والمسؤول فقط ربط التطبيقات.

#كيفية ربط GitHub بـ Resool

1. انتقل إلى الإعدادات › التطبيقات وافتح تبويب أدوات المطورين.
2. على بطاقة GitHub، انقر ربط.
3. تسرد نافذة ربط GitHub ما سيستطيع Resool فعله بعد موافقتك: عرض مستودعاتك وتصنيفاتها، وفتح المشكلات (صلاحية repo في GitHub، مطلوبة للمستودعات الخاصة)، ومعرفة إن كانت هذه المشكلات مفتوحة أو مغلقة. انقر متابعة.

مكان لقطة الشاشة

الإعدادات › التطبيقات › GitHub › ربط

نافذة «ربط GitHub» بالوصف وقائمة «بعد موافقتك على GitHub، سيتمكن Resool من:» (ثلاثة بنود) وزرَّي «إلغاء» و«متابعة».

الملف: screenshots/ar/github-connect-dialog.png

1. سجّل الدخول إلى GitHub في النافذة التي تُفتح وانقر Authorize.
2. تعود إلى Resool وتظهر رسالة تم ربط GitHub، وتعرض البطاقة زرَّي إدارة وإلغاء الربط.

#كيفية تحديد المستودع الافتراضي

1. انقر إدارة على بطاقة GitHub لفتح إعدادات GitHub.
2. ضمن الافتراضيات، اختر المستودع. يمكنك البحث إذا كانت لديك مستودعات كثيرة.
3. احفظ من شريط الحفظ في الأسفل.

يُستخدم المستودع الافتراضي في إنشاء مشكلة من صندوق الوارد وفي خطوات مسار العمل التي لا تحدد مستودعًا.

مكان لقطة الشاشة

الإعدادات › التطبيقات › GitHub › إدارة

لوحة «إعدادات GitHub» الجانبية بقسم «الافتراضيات» وقائمة «المستودع» مضبوطة على اسم بصيغة owner/repo.

الملف: screenshots/ar/github-settings-sheet.png

#كيفية إنشاء مشكلة GitHub من صندوق الوارد

1. افتح محادثة في صندوق الوارد وانقر أيقونة GitHub في شريط تفاصيل جهة الاتصال.
2. انقر إنشاء مشكلة. يُفتح نموذج مشكلة GitHub جديدة.
3. راجع أو غيّر المستودع، ثم أضف التصنيفات من ذلك المستودع عبر أضف تصنيفًا.
4. اكتب العنوان والوصف. تُضاف بيانات جهة الاتصال ورابط هذه المحادثة تلقائيًا.
5. انقر إنشاء. تظهر رسالة تم الإنشاء في GitHub وتظهر المشكلة في اللوحة.

مكان لقطة الشاشة

صندوق الوارد › افتح محادثة › أيقونة GitHub › إنشاء مشكلة

نموذج «مشكلة GitHub جديدة» وقد اختير مستودع، وتصنيفان (bug وcustomer)، والعنوان والوصف مملوءان، والتلميح «تُضاف بيانات جهة الاتصال ورابط هذه المحادثة.»، وزرا «إلغاء» و«إنشاء».

الملف: screenshots/ar/github-create-issue.png

تعرض اللوحة المشكلات التي فُتحت لجهة الاتصال برقمها وحالتها مفتوحة أو مغلقة. وإن لم توجد مشكلات بعد، تظهر رسالة لا توجد مشكلات GitHub لجهة الاتصال بعد. واللوحة نفسها تُفتح من بطاقة التطبيقات في صفحة جهة الاتصال.

#كيفية فتح مشكلات GitHub من سير العمل

1. افتح مسار عمل وأضف خطوة. ضمن المهام والمستندات، اختر إنشاء مشكلة GitHub.
2. اختر المستودع، أو اتركه على الافتراضي لاستخدام المستودع المحدد في إعدادات GitHub.
3. اكتب العنوان والنص، ويمكن أن يحتويا على متغيرات مثل اسم جهة الاتصال.
4. أضف التصنيفات إن أردت (حتى 20 تصنيفًا).
5. انشر مسار العمل.

إذا لم يكن GitHub مربوطًا، تعرض الخطوة ربط GitHub مع رابط إلى صفحة التطبيقات.

مكان لقطة الشاشة

سير العمل › افتح مسار عمل › خطوة «إنشاء مشكلة GitHub»

إعدادات الخطوة وقد اختير المستودع، والعنوان يحتوي متغير اسم جهة الاتصال، والنص، وتصنيفان، وملاحظة أن بيانات جهة الاتصال ورابط المحادثة يُضافان.

الملف: screenshots/ar/github-workflow-step.png

#كيفية إلغاء ربط GitHub

1. انتقل إلى الإعدادات › التطبيقات وانقر إلغاء الربط على بطاقة GitHub.
2. أكّد في نافذة إلغاء ربط GitHub؟.

تبقى المشكلات الموجودة في GitHub كما هي، وتتوقف خطوات سير العمل التي تفتح مشكلات GitHub حتى تعيد الربط.

#الأسئلة الشائعة وحل المشكلات

#لا يظهر مستودع في القائمة.

حساب GitHub الذي ربطته لا يستطيع رؤيته. في مستودعات المؤسسات، قد تحتاج المؤسسة إلى الموافقة على تطبيق Resool من إعداداتها في GitHub. ثم أعد فتح القائمة.

#ما المشكلات التي تعرضها اللوحة؟

المشكلات التي فُتحت لجهة الاتصال من Resool فقط. لا تظهر المشكلات المنشأة مباشرة في GitHub.

#لا أرى زر «إنشاء مشكلة».

دورك لا يسمح بإدارة جهات الاتصال. اطلب ذلك من المالك أو المسؤول.

#ما التالي؟

• Jira
• خطوات سير العمل
• البدء مع التطبيقات