كيفية تصدير واستيراد سير العمل في ActivePieces: دليل شامل لأتمتة البرامج مفتوحة المصدر

بعد قضاء ساعات في بناء نظام أتمتة، فإن آخر ما ترغب فيه هو إعادة إنشائه يدويًا عند تغيير الخوادم، أو إعداد بيئة اختبار، أو اتخاذ قرار بمغادرة Activepieces Cloud. لتجنب ذلك، تتيح المنصة تصدير تعريف التدفق واستخدامه لاحقاً في حالة أخرى.

يُعد هذا الإجراء مفيدًا لمشاركة عمليات التشغيل الآلي، أو الاحتفاظ بنسخة من هيكلها، أو انقل سير العمل من Activepieces Cloud إلى خادمك الخاصومع ذلك، فإن الملف المصدر لا يحتوي على كل ما هو ضروري لبدء التشغيل الآلي على الفور: يجب التحقق من الاتصالات والمتغيرات وخطافات الويب والموارد الخارجية في الوجهة.

ماذا يحتوي تدفق Activepieces المُصدّر؟

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

عادةً، يحتفظ التعريف المُصدَّر بما يلي:

• اسم وبنية التدفق.
• المحفز تُستخدم لبدء التشغيل الآلي.
• الإجراءات والشروط والفروع والحلقات المُهيأة.
• الحقول التي تم إدخالها في كل خطوة وتعيينات البيانات الخاصة بها.
• المراجع المستخدمة لاسترجاع النتائج من الخطوات السابقة.
• La نسخة محددة من كل قطعة يستخدمها التدفق.

هذا لا يعني أن الملف نسخة كاملة من Activepieces. ولأسباب أمنية، لا تتوقع أن يتضمن الملف... كلمات المرور، أو رموز OAuth، أو مفاتيح API يتم تخزينها في الاتصالات. كما أنها لا تنقل مستخدمي النظام الأساسي، أو سجل التنفيذ، أو السجلات، أو الملفات المحفوظة، أو قاعدة بيانات المثيل بأكملها.

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

كيفية تصدير تدفق Activepieces

قبل تنزيل الملف، افتح برنامج التشغيل الآلي وتأكد من أنك تعمل بالإصدار الذي ترغب في الاحتفاظ به. يحتفظ Activepieces بـ المسودات والنسخ المنشورةلذلك، يُنصح بحفظ التغييرات واختبارها قبل التصدير.

قد تختلف أسماء ومواقع الأزرار قليلاً بين الإصدارات، ولكن الإجراء العام هو كما يلي:

1. انتقل إلى Activepieces وافتح القسم التدفقات.
2. حدد موقع نظام التشغيل الآلي الذي تريد نقله.
3. افتح قائمة الخيارات الخاصة به، والتي عادة ما يتم تمثيلها بثلاث نقاط.
4. يختار تدفق التصدير أو الخيار المعادل.
5. احفظ الملف الذي تم تنزيله في مجلد يسهل التعرف عليه.
6. لا تقم بتعديل محتواه يدويًا إلا إذا كنت تعرف المخطط المستخدم بواسطة الإصدار المثبت.

استخدم اسمًا يُحدد كلاً من التدفق وتاريخه، على سبيل المثال:

facturas-correo-2026-09.json

ومن الجدير بالذكر أيضاً نسخة من Activepieces من النسخة الأصليةقد تكون هذه المعلومات مفيدة للغاية إذا واجه الملف مشاكل عند استيراده بعد أشهر على خادم مختلف.

كيفية استيراد الملف إلى مثيل آخر

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

تتكون العملية العامة من:

1. افتح القسم التدفقات من مثيل الوجهة.
2. اضغط على الزر لإنشاء أو استيراد عملية أتمتة.
3. يختار تدفق الاستيراد.
4. حدد الملف الذي تم تصديره مسبقًا.
5. انتظر حتى يقوم Activepieces بإعادة بناء الخطوات.
6. افتح كل قسم وتأكد من عدم ظهور أي تحذيرات فيه.
7. قم بضبط أي اتصالات ومتغيرات مفقودة.
8. اختبر الخطوات بشكل فردي قبل نشر سير العمل.

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

كيفية نقل سير عمل Activepieces Cloud إلى خادمك الخاص

إذا كنت تنتقل من السحابة إلى نسخة مُستضافة ذاتيًا، فقم أولاً بتثبيت وتحديث النظام الأساسي المستهدف. يمكنك الرجوع إلى الإجراء المحدد لـ قم بتثبيت Activepieces باستخدام Docker دون الخلط بين النوايا الواردة في هذا الدليل.

بعد ذلك، قم بتصدير مسارات العمل واحدة تلو الأخرى واستوردها إلى الخادم الجديد. لكل عملية أتمتة، يجب عليك مراجعة ما يلي:

• الروابط: أعد تفويض حسابات OAuth وأعد إدخال المفاتيح المطلوبة.
• متغيرات المشروع: أنشئ نفس الأسماء وقم بتعيين القيم المقابلة للبيئة الجديدة.
• العناوين الداخلية: استبدل أسماء النطاقات أو عناوين IP الخاصة أو المنافذ أو أسماء الحاويات التي تغيرت.
• روابط الويب: انسخ عناوين URL الجديدة وقم بتحديثها في التطبيقات التي كانت ترسل الأحداث.
• الجداول: يقوم بنقل البيانات الداخلية التي تحتاجها عملية التشغيل الآلي بشكل منفصل.
• غرف خاصة: قم بتثبيتها على الخادم الوجهة قبل محاولة تشغيل العملية.

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

كيفية إعادة تهيئة الاتصالات والمتغيرات

عندما يواجه ActivePieces خطوة تعتمد على اتصال مفقود، فقد يعرضه على أنه غير موجود أو يطلب منك تحديد اتصال متاح. هذا مقصود: نقل بيانات الاعتماد تلقائيًا سيحول الملف المُصدَّر إلى مخاطر أمنية.

افتح كل خطوة تستخدم Gmail أو Slack أو جداول بيانات Google أو قاعدة بيانات أو أي تكامل آخر. ثم أنشئ اتصالاً جديداً أو حدد اتصالاً موجوداً بالفعل في المشروع المستهدف.

يحدث شيء مشابه مع المتغيرات. يسمح لك Activepieces بإدراج مراجع مثل:

{{variables['URL_API']}}

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

لا تستخدم المتغيرات العادية لاستبدال الاتصالات المكونة من جزء واحد. يجب تخزين بيانات الاعتماد الخاصة بخدمات Gmail أو Slack أو Stripe أو الخدمات المماثلة باستخدام نظام توصيل القطع النشطة.

كيفية التحقق من أن التدفق المستورد يعمل

قبل النشر، قم بإجراء عملية تحقق شاملة:

1. افتح المشغل واسترجع بيانات الاختبار.
2. قم بتنفيذ كل إجراء على حدة.
3. تحقق من عمليات الربط التي تعتمد على الخطوات السابقة.
4. راجع الروابط والمتغيرات المستخدمة.
5. تأكد من أن النطاقات والمسارات تنتمي إلى البيئة الجديدة.
6. تحقق من التواريخ والمناطق الزمنية والجداول الزمنية.
7. انشر التدفق فقط عندما تنجح جميع الخطوات.
8. قم بتشغيل البرنامج بالكامل وتحقق من سجله.

تُثبّت Activepieces كل خطوة على نسخة محددة من عملكيمنع هذا التحديث من تغيير سلوك التدفق بصمت، ولكنه قد يسبب مشاكل إذا كانت النسخة المستقبلة قديمة جدًا أو لا يتوفر بها هذا الإصدار.

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

الأخطاء الشائعة عند تصدير أو استيراد التدفقات

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

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

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