الربط مع Jira

في مستند المساعدة هذا

اربط Jira بـ Notion للحصول على تجربة سلسة تبقيك أنت وفريقك على اطلاع دائم 🔗


يتيح ربط Notion بـ Jira لك القيام ببعض الأشياء المختلفة. يمكنك إدراج روابط Jira في صفحات Notion للوصول إليها أو معاينتها بسرعة، أو يمكنك مزامنة مشاريع Jira وعناصر العمل الخاصة بك مع قواعد بيانات Notion حتى تتمكن من تتبع كل أعمالك في مكان واحد. تابع القراءة للتعرف على نماذج الربط المختلفة وكيفية إعدادها.

يوفر Notion عمليتي ربط لـ Jira هما: Jira و Jira Sync. فكّر فيهما كخيارين، أحدهما خفيف والآخر كامل الميزات.

إذا كنت بحاجة فقط إلى مزامنة مشروع Jira واحد مع قاعدة بيانات Notion مرة واحدة ولا تخطط لإعداد مزامنات إضافية، فقد تكون معاينات روابط Jira، وذكر الروابط، وقاعدة البيانات المتزامنة القديمة من خلال ربط Jira كافية. فقط ضع في اعتبارك: أنها تستخدم رموز المستخدمين، والتي تميل إلى أن تكون أقل موثوقية من رموز المسؤول التي يستخدمها Jira Sync.

للمزامنة المستمرة والمرنة عبر مشاريع وقواعد بيانات متعددة، يُعد Jira Sync الخيار الأحدث والأكثر قوة. فقط لاحظ: أنه يتطلب مسؤول Jira لإعداده.

Note: There’s no one-click migration from the legacy Jira connection to Jira Sync. They are separate connections, so setting up the new Jira Sync will require a full reinstallation.

Jira

مزامنة Jira

يُستخدم لـ

• معاينات الروابط
• إشارات الروابط
• [قديم] قواعد البيانات المتزامنة

• [جديد ومحسّن] قواعد البيانات المتزامنة

الإعداد

ربط المستخدم الفردي

مالك مساحة العمل ومسؤول Jira

مكان الإعداد

الإعداداتعمليات الربط

الإعداداتاستيراد

تحديث قواعد البيانات المتزامنة القديمة

تبدو قاعدة البيانات المتزامنة القديمة بهذا الشكل تقريبًا. إذا كانت لديك قاعدة بيانات متزامنة قديمة، يمكنك اتباع الخطوات أعلاه لإعادة إنشاء قواعد بيانات مشاريعك ومهامك في Notion باستخدام ميزة Jira Sync الجديدة والمحسّنة.

إنشاء معاينات الروابط

Note: Link previews work with all Jira Software deployment models (Jira Cloud, Jira Data Center, and Jira Server).

لمعاينة الروابط من Jira:

  1. انتقل إلى الإعداداتعمليات ربط.

  2. إذا كنت تستخدم Jira Cloud، فابحث عن مربع Jira. وإذا كنت تستخدم Jira Data Center أو Jira Server، فابحث عن مربع Jira preview (Data center). قد تضطر إلى التمرير لأسفل قليلاً للعثور على مربع مركز البيانات. ثم حدد Connect أسفل المربع.

  3. في النافذة التي تظهر، حدد إصدار Jira الخاص بك. ثم أدخل عنوان URL للموقع واسم المستخدم وكلمة المرور وحدد Authenticate.

بمجرد المصادقة بنجاح، سترى Jira أو Jira preview (Data center) في أعلى قائمة اتصالاتك. أي رابط Jira يتم لصقه في Notion يجب أن يظهر تلقائياً كمعاينة للرابط.

بدلاً من ذلك، يمكنك إعداد معاينات الروابط مباشرة من صفحة Notion. للقيام بذلك:

  1. في صفحة Notion، الصق رابط Jira.

  2. في النافذة التي تظهر، حدد إصدار Jira الخاص بك إذا طُلب منك ذلك. أدخل رابط موقعك، واسم المستخدم، وكلمة المرور، وحدد Authenticate.

إنشاء إشارات للروابط

Note: Link mentions work with all Jira Cloud products.

  1. الصق رابط Jira في Notion.

  2. حدد إشارات الروابط في القائمة التي تظهر للإشارة بسهولة إلى مشروع أو مسألة في مستنداتك.

    • إذا لم تكن قد ربطت Jira بـ Notion بالفعل، فسيُطلب منك القيام بذلك عند لصق رابط Jira في Notion. تعرف على المزيد حول إشارات الروابط في هذه المقالة →

يربط اتصال مزامنة Jira مشاريع Jira الخاصة بك بـ Notion باستخدام رمز API للمسؤول (بدلاً من رمز المستخدم)، مما يوفر تجربة مزامنة أكثر اتساقاً ومركزية.

لضمان مزامنة موثوقة، نوصي بإنشاء رمز مميز (token) بدون نطاق عن طريق تحديد Create API token، وليس Create API token with scopes.

الآن يمكنك الاستفادة الكاملة من ميزات Notion بما في ذلك الأتمتة، والتجميعات (rollups)، وNotion AI. استخدم Notion AI للإجابة بسرعة على الأسئلة المتعلقة بمشاريع Jira الخاصة بك.

تعرض ميزة مزامنة Jira مشاريع Jira وعناصر العمل الخاصة بك كقواعد بيانات للمشاريع وعناصر العمل في Notion. يسمح لك هذا الإعداد برؤية وتتبع مشاريع متعددة باستخدام مجموعة متنوعة من طرق العرض، وعوامل التصفية، وعمليات الفرز المفيدة.

يمكنك حتى استخدام تعيين الهوية لربط هويات Jira بملفات تعريف Notion حتى تتمكن من معرفة المسؤول عن ماذا في قواعد بيانات Notion المتزامنة.

في الخطة المؤسسية من Notion، تدعم مزامنة Jira المزامنة ثنائية الاتجاه، مع احترام أذونات كل من Notion وJira للوصول والتحرير الآمن. من خلال مزامنة Jira، يمكنك الاستفادة الكاملة من ميزات Notion بما في ذلك العلاقات والتجميعات، وخصائص قاعدة بيانات Notion فقط، وNotion AI. استخدم Notion AI للإجابة بسرعة على الأسئلة المتعلقة بمشاريع Jira الخاصة بك.

The Jira Sync connection connects your Jira projects to Notion using an Admin API token (rather than a user token), providing a more consistent and centralized syncing experience. To ensure reliable syncing, we recommend creating a scopeless token by selecting Create API token, not Create API token with scopes.

Note:

  • A workspace owner must set up Jira Sync first using a Jira Admin token. After that, any member can utilize the connection.

  • You can create a Jira service account to set up Jira Sync — just make sure the service account has access to any projects you want to sync into Notion beforehand.

  • Synced databases work with Jira Cloud products (Jira Software, Jira Product Discovery, Jira Work Management, and Jira Service Management), with support for Jira Server coming soon!

إعداد مزامنة Jira

Note: If you’ve already set up a Jira Sync and you’re on Notion’s Enterprise Plan, you can update your Jira synced database to the new two-way sync functionality by clicking the Synced badge at the top of the database and toggling on 2-way sync. You’ll be prompted to re-authenticate. Once you’re authenticated, you can click into a Notion database cell and update any supported field in the work items synced database or add comments and attachments to the Jira synced database.

على الرغم من أن أي عضو يمكنه إنشاء مزامنات، ستحتاج إلى أن تكون مالك مساحة العمل لإعداد مزامنة Jira في البداية.

  1. انتقل إلى الإعدادات في الشريط الجانبي → استيرادJira Sync.

    • يمكنك أيضاً لصق رابط قاعدة بيانات Jira أو استخدام أمر الشرطة المائلة /jira sync.

    • إذا كنت قد أنشأت سابقاً قاعدة بيانات متزامنة مع Jira في Notion، فافتح قاعدة البيانات تلك وحدد Improve your Jira sync في الأعلى.

  2. في النافذة التي تظهر، حدد Get started.

  3. أدخل بريدك الإلكتروني كمسؤول في Jira، وعنوان URL لموقع Jira، ورمز API الخاص بك، ثم حدد التالي.

Tip: When creating an admin token for Jira Sync, we strongly recommend setting the expiration date as far in the future as possible.

Jira Sync relies on this token to maintain a stable connection. If it expires, the sync can break and updates may be missed.

إضافة مزامنة جديدة

Note: Members need to authenticate their Jira to add or remove projects. They can only add projects they have access to in Jira.

  1. انتقل إلى الإعدادات في الشريط الجانبي → استيرادJira Sync.

    • يمكنك أيضاً لصق رابط قاعدة بيانات Jira أو استخدام أمر الشرطة المائلة /jira sync.

  2. في النافذة التي تظهر، حدد Get started.

  3. حدد موقع Jira الذي تريد المزامنة منه.

  4. حدد إنشاء مزامنة جديدة أو حدد أي مزامنة موجودة قد تكون لديك بالفعل في القائمة المنسدلة. إذا اخترت مزامنة موجودة، فستتم إضافة مشاريعك إلى مشاريعك المتزامنة وقواعد بيانات مهام العمل الحالية.

  5. في قاعدة البيانات التي تفتح، ستحتاج إلى ربط حساب Jira الخاص بك (ما لم تكن مالك مساحة العمل الذي قام بإعداد الربط). من هنا، حدد البيانات التي تريد مزامنتها مع Notion. أولاً حدد المشاريع للمزامنة، ثم حدد الخصائص للمزامنة.

كرر الخطوات أعلاه إذا كنت ترغب في إعداد مزامنة Jira أخرى لموقع أو مساحة فريق أو مساحة عمل أخرى. ستتم أيضًا مزامنة التعليقات والمرفقات (بحد أقصى خمسة ملفات لكل مهمة، وبحجم لا يتجاوز 1 ميجابايت).

يمكنك تطبيق الأذونات على صفحة قاعدة بيانات لجعل قاعدة البيانات المتزامنة في متناول المتعاونين معك.

Note: Jira synced databases will inherit Notion permissions. Members can access synced databases on any pages they have permission to view.

If a member adds a private Jira project to a Notion page, anyone with Notion page access will see it.

خاصية الأشخاص في قاعدة بياناتك المتزامنة

ستتضمن قواعد البيانات المتزامنة خصائص الأشخاص! الآن، يمكنك استخدام تعيين الهوية لربط هويات الجهات الخارجية JIRA بملفات تعريف فريقك على Notion. للقيام بذلك:

  1. تأكد من أنك قمت بتنفيذ Jira Cloud.

  2. تأكد من أن اسمك وعنوان بريدك الإلكتروني متطابقان في Notion وJira.

  3. اتبع التعليمات هنا لضبط مستوى الرؤية على أي شخص.

تعديل أو حذف قاعدة البيانات المتزامنة الخاصة بك

لتعديل مشاريع Jira وخصائص المهام التي تمت مزامنتها مع قاعدة بيانات Notion الخاصة بك، حدد ••• في أعلى قاعدة البيانات المتزامنة → المصدر.

لحذف قاعدة بيانات متزامنة مع Jira، حدد ••• في أعلى قاعدة البيانات المتزامنة → حذف الجدول.

بعد الاستيراد الأولي، يتم تحديث مشاريعك المتزامنة مع Jira بطريقتين:

  • خطافات الويب (Webhooks): يتم إرسال التحديثات التي تتم في Jira إلى Notion في الوقت الفعلي من خلال خطافات الويب.

    • تظهر هذه التغييرات عادةً في غضون دقائق، ولكن قد تحدث تأخيرات عرضية أو تفوت بعض التحديثات بسبب مشكلات في الشبكة أو النظام.

    • يتم إعداد خطاف الويب تلقائيًا عند إنشاء المزامنة لأول مرة.

  • إعادة المزامنة: إذا فُوت تحديث عبر خطاف الويب، فستقوم آلية إعادة المزامنة لدينا بمزامنة مجموعتك مع Jira مرة أخرى لضمان تحديثها:

    • لا يتم تشغيل إعادة المزامنة إلا عندما تكون المجموعة قيد العرض النشط وقد تستغرق وقتاً، خاصة بالنسبة للمجموعات الكبيرة.

    • سيتم تشغيلها مرة واحدة يومياً على الأكثر ويشار إليها بتسمية "المزامنة قيد التقدم".

      • خلال هذه العملية، لا يمكن للمستخدمين تعديل تكوين المزامنة (على سبيل المثال، إضافة/إزالة المشاريع أو الخصائص).

Note: If a Jira property is a custom "text" field, it will be parsed as a text string and appear distorted—even if the input in Jira is a date, number, etc.

As an example, the field type in Jira must be set as a date field for the data to translate correctly in Notion and display as a date.

الأذونات والمصادقة

تحترم المزامنة ثنائية الاتجاه أذونات كل من Notion وJira للوصول والتحرير الآمن.

  • فقط المستخدمون الذين لديهم حق الوصول للتحرير إلى قاعدة بيانات Jira المتزامنة يمكنهم تمكين واستخدام المزامنة ثنائية الاتجاه.

  • يجب على كل مستخدم مصادقة حساب Jira الفردي الخاص به لتمكين التحرير من Notion. إذا قمت مسبقاً بتوصيل Jira للعرض فقط، فستحتاج إلى إعادة المصادقة لتمكين التحرير.

  • لا يمكن لأي ضيف أو أي شخص يصل إلى قاعدة بيانات Jira المتزامنة عبر رابط عام استخدام المزامنة ثنائية الاتجاه.

قاعدة بيانات المشاريع

ستتم مزامنة مشاريع Jira الخاصة بك في قاعدة بيانات مشاريع Notion. سيتم تعيين مشاريعك بذكاء إلى عناصر عمل Jira المقابلة لها في قاعدة بيانات عناصر عمل ذات صلة ومتزامنة في Notion. ستأتي قاعدة البيانات هذه مع طرق عرض افتراضية لقاعدة البيانات معبأة مسبقاً لمساعدتك على البدء بسرعة أكبر:

  • نشط (عرض الجدول): يعرض هذا العرض المشاريع التي قمت بمزامنتها والتي تكون حالتها قيد التقدم. بعبارة أخرى، لا يعرض هذا العرض المشاريع التي تم الانتهاء منها بالفعل. توجد أيضاً عوامل تصفية مسبقة الضبط للمالك والتاريخ لتسهيل البحث.

  • عرض الخط الزمني: يعرض هذا العرض اسم المشروع، والحالة، والمالك، ومعدل الإنجاز. توجد أيضاً عوامل تصفية مسبقة الضبط للحالة، والمالك، والتاريخ لتسهيل البحث.

  • عرض اللوحة: يعرض هذا العرض مشاريعك مجمعة حسب الحالة (التخطيط، قيد التقدم). يمكنك تخصيص الحالات التي تظهر في العرض من قائمة •••. يتم فرز المشاريع حسب الأولوية التنازلية.

  • الكل (عرض الجدول): يعرض هذا العرض جميع مشاريعك المتزامنة. توجد عوامل تصفية مسبقة الضبط للحالة، والمالك، والتاريخ لتسهيل البحث.

قاعدة بيانات عناصر العمل (المشكلات)

ستتم مزامنة عناصر عمل Jira الخاصة بك (ملحمة، خطأ، مهمة، مهمة فرعية، قصة) في قاعدة بيانات عناصر عمل Notion، وهي تعادل قاعدة بيانات المهام في Notion. كما هو الحال مع قاعدة بيانات المشاريع المتزامنة، سيتم إنشاء طرق عرض افتراضية لقاعدة البيانات من أجلك لمساعدتك على البدء بسرعة أكبر:

  • حسب المشروع (عرض الجدول): يعرض هذا العرض جميع المهام، مجمعة حسب المشروع. توجد عوامل تصفية مسبقة الضبط للحالة، والشخص المسؤول، والتاريخ، والمشروع لتسهيل البحث.

  • حسب الملحمة (عرض الجدول): يعرض هذا العرض قصص ومهام وأخطاء Jira الخاصة بك مجمعة حسب الملحمة.

  • عرض اللوحة: يتم تجميع هذا العرض حسب الحالة وفرزه حسب الأولوية التنازلية. الخصائص مسبقة الضبط التي سيتم عرضها هي الشخص المسؤول، والمشروع، والأولوية، والمهام الفرعية،

  • كل المهام (عرض الجدول): يعرض هذا العرض جميع مهامك المتزامنة. الخصائص مسبقة الضبط التي سيتم عرضها هي اسم المهمة، والحالة، والشخص المسؤول، والتاريخ، والأولوية، والعلامات، والمشروع

  • خاصتي (عرض الجدول): تمت تصفية هذا العرض ليظهر فقط المهام المسندة إليك. توجد عوامل تصفية مسبقة الضبط للحالة، والتاريخ، والمشروع.

يدعم Jira Sync معظم خصائص Jira، ولكن ليس كلها. إليك قائمة بخصائص Jira غير المدعومة:

تتبع الوقت

الدقة

مستوى الأمان

Σ التقدم

التقدم

تقييد بـ

StatusCategory

الترتيب

Note: While Notion doesn't support certain Jira custom properties, it does support all Jira primitive custom properties, such as string, number, select, person, and date.

Experiencing an issue with Jira Sync? See how you can troubleshoot common errors here →

  • في الوقت الحالي، يعمل Jira Sync مع Jira Cloud فقط. ولا يتم دعم Jira Data Center وJira Server.

  • يجب ألا تستغرق المزامنة الأولية سوى بضع دقائق لتكتمل، ولكن اعتماداً على حجم مشاريع Jira وعناصر العمل الخاصة بك، قد يستغرق هذا ما يصل إلى بضع ساعات.

  • قد لا تتم مزامنة بعض حقول أو خصائص المشكلات، مثل النص المنسق في الخصائص والاختيارات المتعددة المتداخلة.

  • بينما يمكنك تعديل الحالة، والشخص المسؤول، والأولوية، والمرفقات، والتعليقات، لا يمكن تعديل بعض حقول أو خصائص المشكلات. وتشمل هذه الوصف، والعنوان، والتاريخ، والحقول المخصصة، وغيرها من حقول الاختيار أو الاختيار المتعدد (باستثناء الأولوية والحالة).

  • سيتم إضافة التعليقات التي يتم إجراؤها في Notion إلى Jira، ولكن لن تتمكن من تعديلها أو حذفها بعد ذلك.

  • يجب أن يكون الحد الأقصى لحجم المرفقات 1MB. يمكن أن تحتوي كل مشكلة في Jira على ما يصل إلى خمسة مرفقات. إذا حاولت تحميل مرفق يتجاوز حد الحجم، فسيفشل التحميل.

    • لا يمكنك سحب وإفلات المرفقات في مشكلة. استخدم أيقونة الإرفاق لإضافة مرفق.

  • ستظهر فقط قيم الأولوية المستخدمة بالفعل في عناصر عمل Jira التي تمت مزامنتها في Notion — الخيارات الموجودة في Jira ولكن لم يتم استخدامها بعد لن تكون متاحة للاختيار. لجعلها قابلة للاختيار، قم بتعيين تلك القيم لمشكلة واحدة على الأقل في Jira تمت مزامنتها بالفعل مع Notion.

  • للحصول على الأداء الأمثل، لن يتم استيراد خصائص Jira التي تحتوي على أكثر من 1,000 قيمة.

  • بمجرد إعداد المزامنة الأولية، يجب أن تنعكس تحديثات الخصائص في Notion في الوقت الفعلي. إذا قمت بإنشاء خصائص جديدة، فقد يستغرق الأمر ما يصل إلى 12 ساعة حتى تتم مزامنة تلك التغييرات.

  • لا يمكنك مزامنة Jira مع Notion يدويًا — تحدث المزامنة استجابةً للتحديثات التي يتم إجراؤها في Jira.

  • ستتمكن من معرفة متى تمت آخر مزامنة لـ Notion مع Jira من خلال تمرير مؤشر الماوس فوق الشارة الزرقاء في الجزء العلوي من قاعدة بيانات. إذا رأيت بدلاً من ذلك صفراءفشلت المزامنة أو توقفت المزامنة، فقد تضطر إلى اتباع الخطوات أدناه لإعادة ربط Jira.

  • قد تستغرق خاصية المراقب ما يصل إلى 12 ساعة للمزامنة بشكل صحيح.

  • المزامنة ثنائية الاتجاه غير متاحة على الهاتف المحمول (ولكن المزامنة أحادية الاتجاه متاحة).

Note: If you delete a property in Jira, the associated database item in your synced database will be deleted too.

إذا فشل تسجيل خطاف الويب (webhook) الخاص بك، أو فشلت مزامنة مشروعك، فسترى فشلت المزامنة في الجزء العلوي من قاعدة البيانات. لحل هذه المشكلة، حاول إجراء المزامنة مرة أخرى باستخدام مجموعة مختلفة من المشاريع. يمكنك أيضًا التأكد من أن مشاريعك لا تواجه أي مشكلات في Jira.

إذا لم يعد رمز Jira الخاص بك صالحًا أو قام شخص ما بإلغاء ربط Jira بـ Notion، فسترى توقفت المزامنة في الجزء العلوي من قاعدة البيانات. لحل هذه المشكلة، حدد إعادة المصادقة بجوار توقفت المزامنة. يجب أن تكون مالك مساحة عمل لإكمال هذه العملية.

بمجرد إعادة ربط مثيل Jira الخاص بك بـ Notion، لن يتم إنشاء قواعد بيانات المشاريع وعناصر العمل الخاصة بك من جديد؛ بدلاً من ذلك، ستستمر في استخدام قواعد بيانات المشاريع وعناصر العمل التي كانت لديك من قبل.

إذا كنت ترغب في إلغاء ربط Jira بـ Notion تمامًا:

  1. انتقل إلى الإعدادات في الشريط الجانبي → استيراد.

  2. حدد ••• بجوار Jira → إزالة.


تقديم تعليق

هل كان هذا المورد مفيداً؟


Powered by Fruition