مسارات العمل
مسارات العمل خطوط أتمتة قابلة لإعادة الاستخدام تعالج حركة المرور الملتقطة أو تشغّل خطوات نشطة أو تحوّل البيانات دون الحاجة إلى كتابة برامج نصية مستقلة.
أنواع مسارات العمل
| النوع | ما يفعّله | الاستخدام الشائع |
|---|---|---|
| سلبي | حركة مرور ملتقطة جديدة | تمييز الأنماط المهمة ووسم الطلبات وإنشاء نتائج تلقائياً. |
| نشط | تشغيل يدوي | إرسال طلبات متابعة وربط الإجراءات وتنفيذ اختبارات متعددة الخطوات. |
| تحويل | مدخلات اختبار أو إجراءات تحويل أو المطابقة والاستبدال | تحويل النصوص أو البايتات، مثل تنسيق JavaScript أو توحيد JSON. |
تعمل مسارات العمل السلبية باستمرار في الخلفية. تعمل المسارات النشطة عند الطلب على مجموعة طلبات محددة.
لوحة مسار العمل
افتح مسارات العمل وحدد مسار عمل لفتح لوحته.
- تظهر العقد في اللوحة الوسطى. لكل عقدة منافذ إدخال وإخراج محددة النوع.
- صل منفذ إخراج بمنفذ إدخال بالنقر والسحب بينهما.
- انقر عقدة لفتح لوحة إعدادها على اليمين.
- يحتوي شريط الأدوات العلوي على عناصر التحكم في التشغيل والتمكين والتعطيل والاستيراد والتصدير.
أنواع العقد
| العقدة | الوصف |
|---|---|
| البداية / النهاية | عقد دخول وخروج مناسبة لنوع مسار العمل السلبي أو النشط أو التحويلي. |
| الشروط | إذا / وإلا، وإذا / وإلا باستخدام JS، ومطابقة HTTPQL، ومطابقة النطاق، واحتواء سلسلة، ومطابقة تعبير نمطي. |
| الترميز | ترميز وفك ترميز Base64 وURL والنظام السداسي عشري وHTML. |
| التنسيق والتجزئة | تصغير وتنسيق JSON وMD5 وSHA-1 وSHA-256. |
| عمليات النص | إزالة الفراغات الطرفية والضم والتقسيم والمطابقة والاستبدال وتحويل JQ واستخراج Grep. |
| JavaScript | منطق مخصص باستخدام SDK مسار العمل؛ يمكنه قراءة حركة المرور والعمل على الملفات وإنشاء نتائج. |
| التكامل | التسجيل وWebhook واستدعاء مسار عمل وإرسال طلب وقاعدة مطابقة واستبدال. |
استخدم لوحة العقد للمنافذ والإعدادات الفعلية. انقر اتصالاً للعمل على ذلك الرابط بدلاً من حذف عقدة لإعادة توصيل المخطط. احفظ باستخدام حفظ أو Ctrl+S، أو Command+S على macOS.
المشاركة والنطاق
تُشارك مسارات العمل بين المشاريع في مساحة العمل نفسها افتراضياً. فعّل خاص بالمشروع لإبقاء تعريف مع مشروعه. لا تعني التعريفات المشتركة مشاركة حركة مرور كل مشروع أو نتائجه أو ملاحظاته. صدّر واستورد JSON مسار العمل عند الانتقال إلى مساحة عمل أو تثبيت آخر.
الاختبار قبل الاستخدام الحي
تحتوي مسارات العمل السلبية والنشطة على قسم اختبار HTTP يضم عينات URL وطلب خام واستجابة خام. فعّل مسار العمل واملأ تلك الحقول وانقر اختبار مسار العمل. يحفظ الاختبار التعديلات قبل التنفيذ. تُحفظ قيم العينات لكل مسار عمل أثناء التنقل بعيداً والعودة.
يحتوي مسار عمل التحويل بدلاً من ذلك على مدخلات الاختبار ومخرجات. ابدأ بمدخل تمثيلي صغير، ثم اختبر أصلاً بحجم واقعي. وجود عينة اختبار لا يجعل تنفيذ كود JavaScript اعتباطي أو عقد إرسال الطلبات بلا مخاطر: يمكن لكود مسار العمل تنفيذ إجراءاته المعدة.
JavaScript والملفات
يدعم JavaScript في مسار العمل SDK في Ogma واستيرادات fs/path المتوافقة. استخدم sdk.fs.readFile وwriteFile وappendFile وexists وreadDir وmkdir وunlink لعمليات الملفات، وsdk.path للمسارات الملائمة للمنصة. هذه مساعدات Ogma وليست مكتبة Node.js القياسية بأكملها.
لتصدير أصل، اقرأ response.getBody().toText() واختر وجهة باستخدام sdk.path.join وأنشئ مجلدها الأب وتحقق من sdk.fs.exists إذا كنت لا تريد الكتابة فوق ملف موجود. راجع مسارات نظام الملفات قبل التنفيذ: تعمل مساعدات نظام الملفات لمسار العمل على مضيف Ogma، بخلاف sdk.fs الخاص بمجلد الإضافة المعزول. راجع SDK الإضافات لبيئة التشغيل المختلفة تلك.
استيراد مسار عمل
- انقر استيراد في شريط أدوات مسارات العمل.
- حدد ملف مسار عمل JSON.
- يُفتح مسار العمل في اللوحة. تحقق من إعداد العقد قبل تمكينه.
- احفظ مسار العمل.
يمكن مشاركة ملفات JSON المصدرة لمسارات العمل بين تثبيتات Ogma أو تخزينها في نظام التحكم بالإصدارات.
تشغيل مسار عمل على السجل الملتقط
يمكن إعادة تشغيل مسارات العمل النشطة على الطلبات الملتقطة سابقاً.
- افتح مسار العمل.
- انقر تشغيل على السجل.
- في نافذة فحص السجل، أدخل مرشح HTTPQL اختيارياً لتحديد الطلبات التي يعالجها مسار العمل.
- انقر تشغيل.
راجع عدد المطابقات وابدأ المهمة. يظهر التقدم والأخطاء في مهمة الفحص وفي سجل تشغيلها عند تمكين التسجيل. توفر مسارات العمل السلبية فحص السجل وإعادة التشغيل على طلب للمعالجة بأثر رجعي.
لبضعة أصول مهمة، حدد صفاً أو أكثر في سجل HTTP وانقر بزر الفأرة الأيمن واختر إرسال إلى مسار العمل وحدد مسار عمل نشطاً ومفعلاً. يغذي ذلك الإدخالات المحددة إليه دون تغيير تعريفه أو معالجة السجل كله.
ينشئ زر الذكاء الاصطناعي بجانب حقل مرشح فحص السجل تعبير HTTPQL من وصف بلغة طبيعية.
تشغيلات مسار العمل ونتائجه
فعّل تفعيل التسجيل في إعداد مسار العمل عندما تحتاج تفاصيل التنفيذ. ينطبق ذلك على المسارات السلبية والنشطة والتحويلية، بما فيها تحويلات المطابقة والاستبدال. عند التعطيل، تستمر المعالجة لكن لا تضيف سجلات تشغيل أو خطوات؛ أعد تمكينه وكرر اختباراً لتشخيص مشكلة.
- انقر تشغيلاً لرؤية مخرجات الخطوات لكل عقدة.
- تُميز العقد التي أنتجت أخطاء.
- تظهر النتائج المُنشأة أثناء التشغيل في واجهة النتائج.
- تظهر المتغيرات المستخرجة أثناء التشغيل في لوحة تفاصيل الخطوة.
يزيل مسح الكل سجل التشغيل المخزن لمسار العمل المحدد. نزّل السجلات قبل مسحها إذا احتجت إلى الاحتفاظ بأدلة تصحيح الأخطاء. يمكن أن يخزن التسجيل مخرجات كبيرة مثل متون برامج نصية كاملة، لذا أبقه معطلاً للتحويلات كثيفة الحجم ما لم تكن بحاجة إليه.
تمكين مسار عمل سلبي
- افتح مسار العمل.
- تحقق من اكتمال إعداد اللوحة، دون منافذ مطلوبة غير موصولة.
- بدّل تفعيل في شريط الأدوات.
تعالج مسارات العمل السلبية المفعلة حركة المرور الجديدة تلقائياً. عطّل مسار عمل لإيقافه مؤقتاً دون حذفه.