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

مقدمة

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

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

قبل أن نبدأ في إنشاء تدفقاتك الأولى والتكاملات، دعنا نفهم الواجهة. سيسهل فهم كيفية تنظيم العناصر الأساسية العمل ويساعدك على التكيف بشكل أسرع.

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.
  • مسح نافذة التصحيح: اضغط على أيقونة الصليب بجوار الفلتر لمسح الرسائل القديمة والتركيز على البيانات الجديدة.

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

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

زر "فتح في وضع ملء الشاشة"​

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

زر "نشر"​

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

زر "استيراد"​

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

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

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

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

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

لا تستطيع جميع العقد نقل المخطط. قائمة العقد التي تفعل ذلك:

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

زر Execute​

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

الميزات:

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

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

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