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

وصف مخطط JSON

في هذه الوثيقة، تم وصف هيكل مخطط JSON لوحدة التكاملات.

الهيكل العام​

يمثل مخطط JSON مصفوفة من الكائنات، حيث كل كائن هو إما عقدة (node) أو علامة تبويب (tab):

[
  {
    "label": "مرحبا بالعالم!",
    "id": "1f24387b252057fe",
    "type": "tab",
    "disabled": false
  },
  {
    "name": "تشغيل",
    "id": "b51ab819b83e1915",
    "type": "inject",
    "x": 46.96875,
    "y": 99.51171875,
    "z": "1f24387b252057fe",
    "wires": [
      [
        "bd07e1ff0aedba0b"
      ]
    ]
  },
  {
    "id": "2b524ca59e4ed633",
    "type": "debug",
    "name": "تصحيح",
    "x": 610.05078125,
    "y": 98.59765625,
    "z": "1f24387b252057fe",
    "wires": []
  },
  {
    "name": "وظيفة",
    "func": "msg.payload = 'العالم'\n\nreturn msg;",
    "id": "bd07e1ff0aedba0b",
    "type": "function",
    "x": 229.62890625,
    "y": 98.8515625,
    "z": "1f24387b252057fe",
    "wires": [
      [
        "2e1172b330c69aeb"
      ]
    ]
  },
  {
    "id": "2e1172b330c69aeb",
    "type": "template",
    "name": "قالب",
    "x": 418.66796875,
    "y": 98.19140625,
    "z": "1f24387b252057fe",
    "syntax": "mustache",
    "template": "مرحبا {{payload}} !",
    "output": "str",
    "wires": [
      [
        "2b524ca59e4ed633"
      ]
    ]
  }
]

المعلمات الأساسية للعقد​

تحتوي معظم العقد على المعلمات العامة التالية:

  • id (string) - معرف فريد للعقدة
  • type (string) - نوع العقدة (مثل "inject"، "function"، "template")
  • name (string) - الاسم المعروض للعقدة
  • x، y (number) - إحداثيات العقدة في مساحة العمل
  • z (string) - معرف علامة التبويب التي تنتمي إليها العقدة
  • wires (array) - مصفوفة من مصفوفات معرفات العقد التي تم توصيل المخرج بها

العقد النظامية​

عقدة "tab" (علامة تبويب)​

تمثل العقدة من نوع tab حاوية لمجموعة من العقد، يتم عرضها بصريًا كعلامة تبويب في الواجهة.

المعلمات:

  • label (string) - الاسم المعروض لعلامة التبويب
  • id (string) - معرف فريد لعلامة التبويب
  • type (string) - نوع العقدة (tab)
  • disabled (boolean) - هل تم تعطيل علامة التبويب

عقدة "debug" (تصحيح)​

تستخدم العقدة من نوع debug لعرض الرسائل في لوحة التصحيح.

المعلمات الأساسية:

  • id (string) - معرف فريد للعقدة
  • type (string) - نوع العقدة (debug)
  • name (string) - الاسم المعروض للعقدة
  • x، y (number) - إحداثيات العقدة في مساحة العمل
  • z (string) - معرف علامة التبويب التي تنتمي إليها العقدة
  • wires (array) - مصفوفة الاتصالات للمخرجات

الروابط بين العقد​

تحدد المعلمة wires الروابط بين العقد. كل عنصر في المصفوفة يتوافق مع مخرج العقدة ويحتوي على مصفوفة من معرفات العقد التي تم توصيل هذا المخرج بها.

مثال:

"wires": [
  [
    "bd07e1ff0aedba0b"
  ]
]

وصف معلمات العقد​

عقدة "inject" (حقن)​

تستخدم العقدة inject لإنشاء وإرسال الرسائل إلى التدفق يدويًا.

المعلمات الأساسية:

  • id (string) - معرف فريد للعقدة
  • type (string) - نوع العقدة (inject)
  • name (string) - الاسم المعروض للعقدة
  • x، y (number) - إحداثيات العقدة في مساحة العمل
  • z (string) - معرف علامة التبويب التي تنتمي إليها العقدة
  • wires (array) - مصفوفة الاتصالات للمخرجات

عقدة "function" (وظيفة)​

تسمح العقدة من نوع function بتنفيذ كود JavaScript عشوائي.

المعلمات الأساسية:

  • id (string) - معرف فريد للعقدة
  • type (string) - نوع العقدة (function)
  • name (string) - اسم العقدة
  • func (string) - الكود المنفذ
  • x، y (number) - إحداثيات العقدة في مساحة العمل
  • z (string) - معرف علامة التبويب التي تنتمي إليها العقدة
  • wires (array) - مصفوفة الاتصالات للمخرجات

عقدة "template" (قالب)​

تستخدم العقدة من نوع template لتحويل الرسائل باستخدام القوالب.

المعلمات الأساسية:

  • id (string) - معرف فريد للعقدة
  • type (string) - نوع العقدة (template)
  • name (string) - اسم العقدة
  • syntax (string) - صيغة القالب (mustache أو plain)
  • template (string) - قالب الرسالة
  • output (string) - نوع الإخراج (str — نص عادي، json أو yaml)
  • x، y (number) - إحداثيات العقدة في مساحة العمل
  • z (string) - معرف علامة التبويب التي تنتمي إليها العقدة
  • wires (array) - مصفوفة الاتصالات للمخرجات

عقدة "interval-node" (فاصل)​

تستخدم العقدة من نوع interval-node لتوليد الرسائل عبر فترات زمنية محددة.

المعلمات الأساسية:

  • id (string) - معرف فريد للعقدة
  • type (string) - نوع العقدة (interval-node)
  • name (string) - اسم العقدة
  • interval (number) - الفاصل الزمني بالدقائق بين الرسائل
  • x، y (number) - إحداثيات العقدة في مساحة العمل
  • z (string) - معرف علامة التبويب التي تنتمي إليها العقدة
  • wires (array) - مصفوفة الاتصالات للمخرجات

عقدة "switch" (مفتاح)​

تستخدم العقدة من نوع switch لتوجيه الرسائل عبر مسارات مختلفة بناءً على الشروط.

المعلمات الأساسية:

  • id (string) - معرف فريد للعقدة
  • type (string) - نوع العقدة (switch)
  • name (string) - اسم العقدة
  • property (string) - خاصية الرسالة للتحقق
  • rules (array) - مصفوفة من القواعد للتوجيه
  • outputs (number) - عدد منافذ المخرجات
  • checkall (string) - التحقق من جميع القواعد (true أو false)
  • repair (boolean) - إصلاح الرسائل غير الصالحة
  • x، y (number) - إحداثيات العقدة في مساحة العمل
  • z (string) - معرف علامة التبويب التي تنتمي إليها العقدة
  • wires (array) - مصفوفة الاتصالات للمخرجات

عقدة "split" (فاصل)​

تستخدم العقدة من نوع split لتقسيم الرسائل إلى عدة أجزاء.

المعلمات الأساسية:

  • id (string) - معرف فريد للعقدة
  • type (string) - نوع العقدة (split)
  • name (string) - اسم العقدة
  • property (string) - خاصية الرسالة للتقسيم
  • propertyType (string) - نوع الخاصية (msg، flow، global)
  • splt (string) - فاصل للسلاسل
  • spltType (string) - نوع الفاصل (str، bin)
  • arraySplt (number) - حجم الأجزاء للمصفوفات
  • arraySpltType (string) - نوع تقسيم المصفوفات (len، index)
  • stream (boolean) - وضع المعالجة المتدفقة
  • x، y (number) - إحداثيات العقدة في مساحة العمل
  • z (string) - معرف علامة التبويب التي تنتمي إليها العقدة
  • wires (array) - مصفوفة الاتصالات للمخرجات

عقدة "http in" (HTTP دخول)​

تستخدم العقدة من نوع http in لإنشاء نقاط نهاية HTTP واستقبال طلبات HTTP الواردة.

المعلمات الأساسية:

  • id (string) - معرف فريد للعقدة
  • type (string) - نوع العقدة (http in)
  • name (string) - اسم العقدة (اختياري)
  • url (string) - مسار URL لنقطة النهاية
  • method (string) - طريقة HTTP (get، post، put، delete، patch)
  • x، y (number) - إحداثيات العقدة في مساحة العمل
  • z (string) - معرف علامة التبويب التي تنتمي إليها العقدة
  • wires (array) - مصفوفة الاتصالات لمعالجة الطلبات

عقدة "http request" (طلب HTTP)​

تستخدم العقدة من نوع http request لتنفيذ طلبات HTTP الصادرة.

المعلمات الأساسية:

  • id (string) - معرف فريد للعقدة
  • type (string) - نوع العقدة (http request)
  • name (string) - اسم العقدة
  • url (string) - عنوان URL للطلب
  • method (string) - طريقة HTTP (GET، POST، PUT، DELETE، إلخ)
  • ret (string) - تنسيق الاستجابة (obj، txt، bin)
  • headers (array) - مصفوفة من رؤوس الطلب
  • paytoqs (string) - أين يتم وضع الحمولة (body، query)
  • useAuth (boolean) - استخدام المصادقة
  • authType (string) - نوع المصادقة (basic، bearer)
  • x، y (number) - إحداثيات العقدة في مساحة العمل
  • z (string) - معرف علامة التبويب التي تنتمي إليها العقدة
  • wires (array) - مصفوفة الاتصالات لمعالجة الاستجابة

عقدة "http response" (استجابة HTTP)​

تستخدم العقدة من نوع http response لإرسال استجابات HTTP إلى العميل.

المعلمات الأساسية:

  • id (string) - معرف فريد للعقدة
  • type (string) - نوع العقدة (http response)
  • name (string) - اسم العقدة
  • statusCode (number) - رمز حالة HTTP للاستجابة
  • x، y (number) - إحداثيات العقدة في مساحة العمل
  • z (string) - معرف علامة التبويب التي تنتمي إليها العقدة
  • wires (array) - مصفوفة الاتصالات (عادة فارغة)

عقدة "cms-events"​

تسمح هذه العقدة بتتبع الأحداث من وحدة الأحداث وإدخالها في التدفق.

المعلمات الأساسية:

  • id (string) - معرف فريد للعقدة
  • type (string) - نوع العقدة (cms-events)
  • name (string) - اسم العقدة
  • eventMarker (string) - معرف الحدث
  • property (string) - خاصية الرسالة للمعالجة
  • targetType (string) - نوع الهدف للمعالجة (msg، flow، global)
  • x، y (number) - إحداثيات العقدة في مساحة العمل
  • z (string) - معرف علامة التبويب التي تنتمي إليها العقدة
  • wires (array) - مصفوفة الاتصالات لمزيد من المعالجة

عقدة "admin-api" (API الإدارة)​

تسمح هذه العقدة بالتفاعل مع واجهات برمجة التطبيقات المختلفة.

المعلمات الأساسية:

  • id (string) - معرف فريد للعقدة
  • type (string) - نوع العقدة (admin-api)
  • name (string) - اسم العقدة
  • path (string) - مسار نقطة نهاية واجهة برمجة التطبيقات
  • method (string) - طريقة HTTP (post، get، put، delete)
  • operation (string) - معرف العملية
  • data (string) - بيانات الطلب بتنسيق JSON
  • wires (array) - مصفوفة الاتصالات لمعالجة الاستجابة

عقدة "telegram"​

تقوم العقدة من نوع telegram بإرسال الرسائل عبر واجهة برمجة تطبيقات Telegram Bot. تم وصف الحقول بالتفصيل في صفحة العقدة telegram.

المعلمات الأساسية:

  • id (string) - معرف فريد للعقدة
  • type (string) - نوع العقدة (telegram)
  • name (string) - اسم العقدة
  • botToken (string) - رمز البوت
  • chatId (string) - معرف الدردشة
  • text (string) - نص الرسالة
  • parseMode (string) - تنسيق النص (none، Markdown، MarkdownV2 أو HTML)
  • replyMarkup (array) - صفوف من الأزرار المضمنة، حيث يحتوي كل زر على text و callbackData
  • callbackQueryId (string) - معرف طلب الاسترجاع
  • showAlert (boolean) - عرض الإشعار في نافذة منبثقة
  • notificationText (string) - نص الإشعار (عند showAlert: true)
  • x، y (number) - إحداثيات العقدة في مساحة العمل
  • z (string) - معرف علامة التبويب التي تنتمي إليها العقدة
  • wires (array) - مصفوفة الاتصالات للمخرجات

عقدة "whatsapp"​

تقوم العقدة من نوع whatsapp بإرسال الرسائل عبر واجهة برمجة تطبيقات WhatsApp Business Cloud. تم وصف الحقول بالتفصيل في صفحة العقدة whatsapp.

المعلمات الأساسية:

  • id (string) - معرف فريد للعقدة
  • type (string) - نوع العقدة (whatsapp)
  • name (string) - اسم العقدة
  • phoneNumberId (string) - معرف رقم المرسل
  • accessToken (string) - رمز الوصول
  • apiVersion (string) - إصدار واجهة برمجة التطبيقات (افتراضيًا v20.0)
  • action (string) - نوع الرسالة (message أو template)
  • to (string) - رقم المستلم
  • text (string) - نص الرسالة (عند action: message)
  • templateName (string) - اسم القالب (عند action: template)
  • locale (string) - لغة القالب (عند action: template)
  • components (array) - معلمات القالب، حيث يحتوي كل منها على type (header أو body)، parameter_name و text
  • x، y (number) - إحداثيات العقدة في مساحة العمل
  • z (string) - معرف علامة التبويب التي تنتمي إليها العقدة
  • wires (array) - مصفوفة الاتصالات للمخرجات

عقدة "notification"​

تقوم العقدة من نوع notification بإرسال إشعار وفقًا لقالب الحدث من وحدة الأحداث. تم وصف الحقول بالتفصيل في صفحة العقدة notification.

المعلمات الأساسية:

  • id (string) - معرف فريد للعقدة
  • type (string) - نوع العقدة (notification)
  • name (string) - اسم العقدة
  • eventId (number | null) - معرف قالب الحدث
  • variables (object) - قيم متغيرات القالب حسب علاماتها
  • recipientsPath (string) - مسار مصفوفة المستلمين في الرسالة
  • x، y (number) - إحداثيات العقدة في مساحة العمل
  • z (string) - معرف علامة التبويب التي تنتمي إليها العقدة
  • wires (array) - مصفوفة الاتصالات للمخرجات