انتقل إلى المحتوى الرئيسي

مقدمة

تتيح لك وحدة "Integrations" ربط واجهات برمجة التطبيقات (API) والخدمات عبر الإنترنت باستخدام البرمجة المرئية. تسحب كتل العقد إلى الواجهة وتصل بينها، فتبني منطق تطبيقاتك بصريًا. هذا يجعل التطوير في متناول من ليسوا مبرمجين محترفين أيضًا، ويسرّع كثيرًا ربط الأنظمة المختلفة ببعضها:

العناصر الأساسية لواجهة وحدة Integrations​

1. اللوحة اليسرى للعقد​

تضم اللوحة اليسرى جميع العقد المتاحة، وهي العناصر التي تبني منها تدفقات البيانات.

لاستخدام عقدة، اسحبها إلى منطقة العمل. لكل عقدة وظيفتها وإعداداتها الخاصة.

أمثلة على العقد:

  • Inject: ترسل البيانات إلى التدفق يدويًا.
  • Debug: تعرض البيانات والرسائل في قائمة التصحيح.
  • Function: تتيح كتابة كود مخصص بلغة JavaScript.
  • Template: تُستخدم لإنشاء قوالب نصية أو قوالب HTML.

2. علامات التبويب​

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

  • إنشاء علامات تبويب جديدة: انقر على الزر + لإضافة علامة تبويب. كل علامة تبويب جديدة هي تدفق بيانات مستقل، ما يساعدك على تنظيم المشروع.
  • إعادة تسمية علامات التبويب: انقر نقرًا مزدوجًا على اسم علامة التبويب واكتب الاسم الجديد. يفيد ذلك خاصةً عندما تكثر علامات التبويب وتريد أن تعرف بوضوح محتوى كل منها.
  • حذف علامات التبويب: انقر بزر الماوس الأيمن على علامة التبويب واختر Delete من القائمة السياقية. احرص على ألا تفقد بيانات مهمة.
  • تعطيل علامات التبويب: يعطّل الخيار Disable في القائمة السياقية نفسها تدفق علامة التبويب دون حذفها. في علامة التبويب المعطّلة يصبح اسم هذا الخيار Enable، وهو يعيد تفعيل التدفق. تُحفظ هذه الحالة في مخطط JSON في الحقل disabled الخاص بعلامة التبويب.

مثال: إذا كنت تعمل على تكامل للمدفوعات، يمكنك إنشاء علامة تبويب منفصلة لكل خدمة.

3. منطقة العمل​

منطقة العمل هي الجزء الأوسط من الواجهة، وفيها تبني تدفقات البيانات وتعدّلها.

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

نصيحة: كبّر منطقة العمل أو صغّرها بالماوس أو بلوحة اللمس لرؤية جميع تفاصيل التدفق.

4. نموذج تحرير العقدة​

عند النقر نقرًا مزدوجًا على عقدة في منطقة العمل، يُفتح نموذج تحرير العقدة، وهو النافذة التي تضبط فيها سلوك العقدة.

  • حقول الإعدادات: لكل عقدة معاملاتها الخاصة القابلة للتعديل. في عقدة Function مثلًا يمكنك كتابة الكود وتعديله.
  • حفظ التغييرات: بعد تعديل العقدة، انقر على Submit لحفظ التغييرات.

مثال: في عقدة Function يمكنك كتابة كود JavaScript يحوّل البيانات. وفي عقدة Template يمكنك إنشاء قالب يُدرج البيانات ديناميكيًا.

5. لوحة التصحيح​

تقع لوحة التصحيح على اليمين، وتعرض البيانات الناتجة والرسائل الصادرة عن عقدة Debug. تحتوي اللوحة على علامتي تبويب: Debug لرسائل التدفق، وConfiguration.

  • عرض الرسائل: عند تشغيل تدفق البيانات، ترسل عقدة Debug الرسائل إلى علامة التبويب Debug. يساعدك ذلك على متابعة ما يجري في التدفق والتحقق من صحة البيانات.
  • تصفية الرسائل: تحدد القائمة الموجودة فوق الرسائل مصدر الرسائل المعروضة: all nodes لعرض رسائل جميع العقد، وcurrent workflow لعرض رسائل عقد علامة التبويب الحالية فقط. يفيد ذلك عندما تكثر البيانات الناتجة من عقد Debug مختلفة.
  • مسح نافذة Debug: انقر على أيقونة علامة × بجوار عامل التصفية لحذف الرسائل القديمة والتركيز على البيانات الجديدة.

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

6. أزرار التحكم​

زر Open full screen​

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

زر Publish​

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

زر Import​

Input Schema ونقل المخطط بين العقد​

تعرض كل عقدة في نموذج التحرير كتلة Input Schema، وهي مخطط البيانات الواردة من العقدة السابقة في التدفق. يعرض المخطط الحقول المتاحة على شكل أزواج "مفتاح: نوع"، مع مراعاة تداخل الكائنات.

إذا كان للحقل وصف في وصف الـ API، فإنه يظهر بجوار المفتاح. ويستخدم محرر الكود هذه الأوصاف نفسها في الإكمال التلقائي والتلميحات عند كتابة قوالب Mustache.

العقد التي تنقل المخطط إلى العقدة التالية​

لا تستطيع جميع العقد نقل المخطط. العقد التي تنقله هي:

  • Function: يُنشأ المخطط من الحقل Output Example (JSON). ويُستخدم هذا الحقل أيضًا بيانات اختبار عند استدعاء التدفق دون تشغيل كود Function فعليًا.
  • Admin API: يُؤخذ المخطط من وصف الطريقة في وصف الـ API. عند النقر على Execute، يُحدَّث المخطط بالاستجابة الفعلية من الـ API. وتحتفظ الحقول المطابقة لوصف الـ API بأوصافها النصية.
  • Http Request: لا يوجد مخطط في البداية. يظهر المخطط بعد النقر على Execute ويُؤخذ من الاستجابة الفعلية.

زر Execute​

يتوفر زر Execute في نموذج تحرير العقدتين Admin API وHttp Request. يشغّل هذا الزر سلسلة العقد كاملة من بداية التدفق حتى العقدة الحالية.

ملاحظات:

  • ينفّذ الخادم التدفق وفق حالته عند آخر Publish، لذا تأكد من نشر التدفق قبل الاختبار.
  • إذا كانت في المسار عقدة function لا تمرّر البيانات إلى ما بعدها، لكن حقل Output Example (JSON) فيها معبأ، تُستخدم قيمته بيانات اختبار.
  • عند نجاح الاستجابة، تُمرَّر النتيجة إلى العقدة التالية بوصفها مخططًا.
  • عند حدوث خطأ، لا يُمرَّر أي مخطط إلى العقدة التالية.

الاستدعاء التلقائي لعقد القراءة فقط​

تُستدعى جميع عقد admin-api التي تنفّذ طلبات قراءة فقط (GET) تلقائيًا عند فتح صفحة Integrations وعند تحديث التدفق بالزر Publish. وبذلك يبقى مخطط البيانات محدّثًا دائمًا دون تشغيل يدوي.

آخر تحديث في