إنشاء مشكلات Linear من سير العمل
افتح مشكلة في Linear من سير عمل — في الفريق الذي تختاره، مع أولوية — ودع إجراء Polzy يُغلق نفسه عند إنجاز المشكلة. اربط Linear مرة واحدة بمفتاح API شخصي.
في هذه الصفحة
عندما تحتاج الملاحظات إلى فريق المنتج أو الهندسة لديك، يمكن لسير العمل أن يفتح مشكلة في Linear لها — في الفريق الذي تختاره، بعنوان ووصف وأولوية مبنية على ما يعرفه Polzy. وإذا أنشأ سير العمل أيضًا إجراءً في Polzy، فإن الإجراء يتابع المشكلة ويُغلق نفسه بمجرد إنجازها أو إلغائها. في نهاية هذا الدليل سيكون Linear مربوطًا، وسير عمل يفتح المشكلات.
يتوفر Linear في خطة أعمال ويُستخدم من سير العمل. لا يستطيع ربطه وبناء سير العمل إلا المسؤول.
قبل أن تبدأ
تحتاج إلى:
- مساحة عمل على خطة أعمال، ودور مسؤول فيها.
- تفعيل التكاملات وسير العمل لمساحة العمل، من الإعدادات ← عام ← ما تقوم به مساحة العمل هذه.
- حساب Linear يمكنه إنشاء المشكلات في الفرق التي ستستخدمها. تُنشأ المشكلات باسم هذا الحساب، لذا فإن الحساب المخصص يمنع ارتباطها بشخص واحد.
- مفتاح API شخصي لهذا الحساب (أدناه).
إنشاء مفتاح API شخصي
- في Linear، افتح Settings → Account → Security & access.
- ضمن Personal API keys، اختر New key وسمِّه Polzy.
- امنحه وصولًا كاملًا، أو على الأقل صلاحية قراءة المشكلات وإنشائها، مع الوصول إلى الفرق التي يجب أن يصل إليها Polzy.
- انسخ المفتاح. يبدأ بـ
lin_api_.
إذا لم يسمح لك Linear بإنشاء مفتاح، فربما عطّل أحد مسؤولي Linear مفاتيح الأعضاء من Settings → Administration → API. يشرح Linear المفاتيح في Linear: API and webhooks.
ربط Linear بـ Polzy
- في الشريط الجانبي، ضمن الأتمتة، افتح التكاملات واختر علامة التبويب متاحة.
- ابحث عن Linear واختر ربط.
- الصق المفتاح في مفتاح API شخصي.
- اختر اختبار الاتصال. يرد Polzy بـ Connected as متبوعًا باسم الحساب.
- اختر ربط.
يُحفظ المفتاح مشفّرًا. وبعد الربط، يعرض صف Linear ضمن التكاملات الخيار إعداد النطاق لاستبدال المفتاح، وإدارة لفتح صفحته.
فتح مشكلة من سير عمل
- افتح سير العمل ثم سير العمل المطلوب، أو أنشئ واحدًا جديدًا.
- ضمن الموصلات في الخطوات المثبتة، اسحب إنشاء مشكلة في Linear · Linear إلى لوحة العمل، بعد الخطوة التي يجب أن تليها. الصف الذي يحمل قفلًا يعني أن Linear لم يُربط بعد أو يحتاج إلى انتباه.
- ضمن الفريق، اختر الفريق. تعرض القائمة كل فريق يستطيع المفتاح رؤيته، باسمه ومفتاحه.
- اكتب العنوان، حتى 255 حرفًا. اكتب
{{لإدراج قيمة من التشغيل، مثل عنوان الإجراء. - إن أردت، اكتب الوصف.
- اختر الأولوية: بلا أولوية أو عاجلة أو عالية أو متوسطة أو منخفضة.
تمرّر الخطوة معرّف المشكلة، مثل CS-142، باسم {{connector.issueKey}} وعنوانها باسم {{connector.url}}. أما تشغيل تجريبي فيمر بسير العمل دون فتح المشكلة؛ ولا ينشئها إلا تشغيل حقيقي. يشرح سير العمل المشغّلات والخطوات.
إغلاق الإجراء عند إنجاز المشكلة
عندما تعمل إنشاء مشكلة في Linear بعد إنشاء عنصر إجراء في تشغيل سير العمل نفسه، تُربط المشكلة بذلك الإجراء:
- متابع في. تعرض لوحة الإجراء معرّف المشكلة، مع رابط إلى Linear، وآخر حالة أبلغ عنها Linear.
- يُغلقه Linear. يسأل Polzy Linear عن المشكلة مرة كل 10 دقائق على الأكثر. وعندما تكتمل — أو تُلغى، لأن العمل لن يُنجز هناك — ينتقل الإجراء إلى منجز.
- الحالة فقط. تبقى التعليقات والتغييرات الأخرى في Linear. والإجراء الذي يُغلق في Polzy أولًا لا يُسأل عنه بعد ذلك.
ما يرسله Polzy إلى Linear
ما تحدده الخطوة فقط: الفريق والعنوان والوصف والأولوية، بالقيم التي تدرجها. ولا يغادر Polzy أي شيء آخر عن الإجابة أو الشخص. الإجابة المجهولة لا شخص فيها، لذا تكون القيم مثل بريد المجيب فارغة؛ وما كتبه أحدهم لا يُرسل إلا بعد فحص السلامة. لا يحجب الحد الأدنى لحجم المجموعة الإجابات المفردة، لذا فكّر في من يستطيع قراءة مشكلات الفريق قبل أن تضع فيها كلمات الناس.
حل المشكلات
- Linear refused the credentials (401). المفتاح خاطئ أو أُلغي. أنشئ مفتاحًا جديدًا، واختر إعداد النطاق في صف Linear ضمن التكاملات، والصقه، ثم اختر حفظ. والتشغيل الذي يصادف ذلك يضع Linear في حالة يحتاج إلى انتباه.
- Linear: متبوعة بكلمات Linear (في تشغيل). رفض Linear الطلب — غالبًا لأن المفتاح لا يملك وصولًا إلى ذلك الفريق أو لا يُسمح له بإنشاء المشكلات. تحقق من صلاحيات المفتاح.
- Linear did not create the issue. ردّ Linear دون مشكلة. شغّل سير العمل مجددًا؛ وإذا تكرر ذلك، فتحقق من أن الفريق لا يزال موجودًا.
- This step names no team أو The issue has no title. املأ الفريق والعنوان في الخطوة.
- قائمة الفريق مجرد حقل. لا يرى المفتاح أي فريق، أو تعذّر الوصول إلى Linear.
- لا يُغلق الإجراء. لم تعمل خطوة Linear بعد إنشاء عنصر إجراء في التشغيل نفسه، أو أن المشكلة لم تكتمل ولم تُلغَ، أو أن الاتصال يحتاج إلى انتباه — وتتوقف الاستعلامات حتى يُحل ذلك.
معلومات مفيدة
- اتصال واحد لكل الفرق. تختار كل خطوة فريقها مما يراه المفتاح.
- من ينشئها؟ الحساب الذي يعود إليه المفتاح.
- هل يمكن لخطوة أن تفتح المشكلة نفسها مرتين؟ لا. الخطوة التي تُعاد بعد تعطل تستخدم ما أنشأته في المرة الأولى.
روابط مفيدة
مقالات ذات صلة
يمكن للأعضاء المسجّلين سؤال Polzy أو مراسلة الفريق من صفحة الدعم. تعتمد سرعة ردّنا على خطتك.