استيراد من Confluence

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

• مستورد ملفات Zip: يمكن استخدامه لاستيراد جزء فقط من مساحة العمل الخاصة بك. يمكنه فقط استيراد مساحات العمل الأصغر التي يصل حجمها إلى 5 جيجابايت (أو 15 جيجابايت عند الطلب).

• مستورد واجهة برمجة التطبيقات (API): يمكنه فقط استيراد مساحة العمل بأكملها. يمكنه استيراد مساحات عمل يصل حجمها إلى 30 جيجابايت. يحتفظ بالتعليقات وتعيين المستخدم.

عمليات الاستيراد متعددة المساحات: يمكن استيراد ما يصل إلى 10 مساحات Confluence في وقت واحد مباشرة من خلال واجهة المستخدم. تُنشئ كل مساحة Confluence محددة صفحة سجِل خاصة بها وتُستورد كصفحة خاصة منفصلة ذات مستوى أعلى (في مساحات عمل Notion مختلفة حسب الحاجة). هذه الميزة متاحة فقط لخطط الأعمال و الخطة المؤسسية.

• موقع Confluence → مؤسسة Notion

• مساحة Confluence → مساحة عمل Notion

• صفحة Confluence → صفحة Notion

• وحدات الماكرو → محتوى مسطح أو أقرب نوع كتلة في Notion (على سبيل المثال، Confluence Expand → قائمة قابلة للطي/طي Notion)

• استيراد ما يصل إلى ~50 ألف صفحة أو 30 جيجابايت في الحجم. قد تفشل عمليات الاستيراد الأكبر.

  • نصيحة: بالنسبة للمساحات الكبيرة، قم بتقسيم الصادرات حسب المساحة الفرعية أو الأقسام واستخدم مستورد ZIP. إذا كان حجم مساحة العمل أكبر من 100 جيجابايت، فاتصل بمدير حسابك.

• بمجرد بدء الاستيراد، يمكنك إغلاق متصفحك بأمان — سنرسل إليك بريداً إلكترونياً عند اكتماله.

• راجع تقدم عملية الاستيراد الخاصة بك في الإعدادات → استيراد. يمكنك هناك رؤية حالة استيرادك وعمليات الاستيراد المكتملة.

تصدير مساحة Confluence الخاصة بك إلى HTML

1. من مساحة عمل Confluence الخاصة بك، انتقل إلى إعدادات المساحة في الشريط الجانبي العلوي الأيمن.

2. حدد أدوات المحتوى في شريط الأدوات العلوي، ثم تصدير. إذا لم ترَ أياً من هذين الخيارين، فقد تحتاج إلى طلب إذن التصدير من مسؤول مساحة العمل.

3. حدد HTML من قائمة التنسيقات.

4. حدد تصدير مخصص وقم بإلغاء تحديد مربع تضمين التعليقات.

5. حدد الصفحات التي تريد تصديرها. لاحظ أن الصفحات التي تحتوي على مرفقات كبيرة يمكن أن تزيد بشكل كبير من حجم التصدير وتعقيده.

6. اسمح لعملية التصدير بإنهاء المعالجة. قد يستغرق هذا بعض الوقت لمساحات العمل الكبيرة.

7. بمجرد اكتمال العملية، انقر فوق تنزيل لحفظ التصدير على جهاز الكمبيوتر الخاص بك. سيكون اسم الملف مشابهاً لـ Confluence-space-export-XXXXXX.html.zip.

الاستيراد إلى Notion

1. انتقل إلى مساحة عمل Notion التي تود استيراد محتوى Confluence إليها.

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

3. انتقل إلى ملف .zip الذي تم تصديره من Confluence وحدده للتحميل. لا تحتاج إلى فك ضغط الملف - قم بتحميل الأرشيف بالكامل.

4. سترى رسالة "جاري التحميل..." بينما يقوم المتصفح بتحميل ملفك، ثم رسالة حالة مع تقدم عملية الاستيراد.

5. عند اكتمال الاستيراد، سيتم نقلك إلى المحتوى الذي تم استيراده حديثاً.

ربط Confluence وNotion

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

2. اختر الاستيراد عبر API.

3. حدد نوع مثيل Confluence الخاص بك: سحابي (cloud) أو خادم (server). لمعرفة نوع المثيل الخاص بك، افتح Confluence، وانقر على مساعدة → ? بجوار ملفك الشخصي → حول Confluence. يدعم Notion المثيلات السحابية والخوادم فقط.

المصادقة باستخدام Confluence Cloud

1. أدخل بريدك الإلكتروني وموقع Confluence الخاص بك.

2. أنشئ رمز API من حساب Atlassian الخاص بك وأدخله في الحقل. اقرأ المزيد حول إنشاء الرموز في Confluence.

3. انقر على مصادقة.

المصادقة باستخدام Confluence Server

1. ابحث عن وحدد إصدار Confluence الخاص بك.

2. أدخل بريدك الإلكتروني وموقع Confluence الخاص بك.

3. إذا كنت تستخدم Confluence 7.9 أو إصداراً أحدث، فأنشئ رمز وصول شخصي والصقه. إذا كنت تستخدم إصداراً أقدم، فأدخل اسم المستخدم وكلمة المرور الخاصين بـ Confluence.

4. انقر على مصادقة.

الاستيراد

1. انقر على Confluence من قائمة الاستيراد.

2. راقب تقدم عملية الاستيراد — قد تستغرق هذه الخطوة عدة ساعات للمساحات الكبيرة.

   • بمجرد رؤية جاري استيراد الصفحات…، يمكنك إغلاق نافذة المتصفح بأمان. سنرسل إليك بريداً إلكترونياً بمجرد اكتمال الاستيراد.

3. كرر هذا القسم إذا كنت ترغب في استيراد أكثر من مساحة عمل واحدة من Confluence.

• يستورد Notion كل شيء إلى جذر/أصل واحد في القسم الخاص، أو إلى مساحة فريق مختارة للشخص الذي يقوم بالاستيراد.

• من المتوقع أن يقوم المستخدمون بتنظيف وإعداد بنية مساحة العمل قبل دعوة الآخرين.

• يجب إعادة تطبيق الأذونات في Notion - خطط لإجراء مراجعة بعد الاستيراد لتعيين مجموعات وقيود Confluence إلى مجموعات Notion ومساحات الفريق وأذونات مستوى الصفحة.

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

• غالباً ما تتدهور تنسيقات الجداول ووحدات الماكرو/الإضافات (على سبيل المثال، ui-steps، و إبراز/تنبيه ، وتسميات الصور التوضيحية).

• معظم وحدات الماكرو غير مدعومة. يحاول Notion تعيين البيانات إلى أقرب كتلة في Notion.

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

• بالنسبة للمساحات المتعددة، قم بتشغيل عمليات الاستيراد بالتسلسل (مساحة واحدة في كل مرة) ما لم تستخدم استيراد مساحات متعددة (لخطط الأعمال/الخطة المؤسسية فقط).

• قد تحدث إخفاقات في الاستيراد مع بيانات Confluence المعقدة (على سبيل المثال، الخلايا المدمجة، والجداول داخل الجداول).

• يدعم Notion فقط رموز واجهة برمجة التطبيقات (API tokens) ذات النطاق الخاص بالمستخدم (وليس الرموز ذات النطاق العام). استخدم خيار رمز واجهة برمجة التطبيقات الشخصي عند المصادقة.

• المرفقات والوسائط التي لا تتم الإشارة إليها في الصفحات لن يتم استيرادها.

• أحياناً لا يتم الحفاظ على التسلسل الهرمي بالكامل - تحقق من ذلك عبر استيراد تجريبي.

• يتم استيراد كتل LaTeX الرياضية بشكل غير صحيح

  • لماذا يحدث هذا: يختلف تنسيق ماكرو الكتلة الخاص بإضافة LaTeX في Confluence عن الرياضيات المضمنة. يدعم Notion وحدات ماكرو LaTeX المضمنة ولكن ليس متغير ماكرو الكتلة.

  • للإصلاح: قم بتحويل وحدات ماكرو كتلة LaTeX إلى وحدات ماكرو مضمنة في Confluence قبل إعادة الاستيراد، أو ضع LaTeX في كتلة تعليمات برمجية وقم بتحويلها إلى كتلة رياضيات يدويًا بعد الاستيراد.

• تعذر استيراد محتوى Gliffy

  • لماذا يحدث هذا: لا يدعم Notion صور Gliffy عبر مستورد الملفات.

  • للإصلاح: قم بتعديل HTML لاستبدال كتلة Gliffy بكتلة صورة تشير إلى الملف الصحيح قبل الاستيراد.

• فشل الاستيراد

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

  • للإصلاح: استورد مساحة واحدة في كل مرة، وقسّم المساحات الكبيرة إلى أقسام، وأعد تصدير ملف ZIP سليم، أو استخدم مستورد API مع عمليات تشغيل محددة النطاق.

• الاستيراد يفتقد إلى صور أو مرفقات

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

  • للإصلاح: تأكد من تحديد خيار "تضمين المرفقات" عند التصدير، وحافظ على المسارات النسبية سليمة داخل ملف ZIP، أو أعد تحميل الأصول الرئيسية بعد الاستيراد.

• معاينات روابط Jira معطلة بعد الاستيراد

  • لماذا يحدث هذا: تعمل معاينات روابط Jira فقط إذا كان المستخدم مصادقاً عليه قبل بدء عملية الترحيل.

  • للإصلاح: قم بالمصادقة مع Jira قبل تشغيل عملية الترحيل.

• تسلسل الملفات الهرمي لا يتم الحفاظ عليه كما هو متوقع

  • لماذا يحدث هذا: حالات استثنائية في هيكل التصدير أو التداخل العميق.

  • للإصلاح: اختبر باستخدام مجموعة فرعية تمثيلية أولاً؛ وأعد التنظيم في Notion بعد الاستيراد.

• فقدان وحدات ماكرو Confluence و/أو التنسيق الخاص:

  • لماذا يحدث هذا: وحدات ماكرو غير مدعومة أو محتوى خاص بالتطبيقات.

  • للإصلاح: قم بالتعيين إلى كتل Notion الأصلية: توسيع (Expand) ← قائمة قابلة للطي/طي (Toggle)، عناصر الإجراء (Action items) ← قائمة مهام (To-do). بسّط الجداول المعقدة أو صدّرها إلى ملف CSV واستوردها إلى قاعدة بيانات Notion.

• أذونات Confluence لا يتم تكرارها في Notion:

  • لماذا يحدث هذا: هذا أمر متوقع عند استخدام عمليات الاستيراد الذاتية.

  • للإصلاح: خطط ونفذ تعيين الأذونات بعد وصول المحتوى إلى Notion، باستخدام مجموعات Notion، ومساحات العمل (teamspaces)، وأذونات مستوى الصفحة.