متقدم

Relova — موصل الآلة عن بعد

قم بتوصيل قاعدة بيانات خارجية أو جدول بيانات أو واجهة برمجة تطبيقات واستخدم صفوفها كآلات مباشرة وقطع غيار وموردين داخل iTenance — دون استيراد البيانات أو نسخها.

يربط Relova نظام iTenance بنظام تديره بالفعل — نظام تخطيط موارد المؤسسات (ERP)، أو مؤرخ SCADA، أو سجل أصول قديم، أو جدول بيانات مشترك — ويقدم صفوفًا مختارة منه كسجلات iTenance عادية. لا يتم نسخ البيانات أبدًا إلى المستأجر الخاص بك: تقرأ كل شاشة من المصدر، لذا فإن ما تراه يكون دائمًا حديثًا. اتصالات Relova للقراءة فقط حسب التصميم؛ لا يمكن لـ Relova أبدًا الكتابة مرة أخرى إلى النظام الذي تتصل به.

Relova أم الاستيراد الشامل؟

كلاهما يجلب البيانات الخارجية. اختر حسب ما إذا كان المصدر يتغير باستمرار.

استخدم الاستيراد الشامل عندما…

  • لديك ملف لمرة واحدة (قائمة موردين، سجل أصول افتتاحي).
  • تريد أن تصبح السجلات بيانات iTenance قابلة للتحرير بالكامل.
  • لن يتغير المصدر، أو أنك سعيد بإعادة الاستيراد عند حدوث ذلك.

استخدم Relova عندما…

  • المصدر هو نظام مباشر يتم تحديثه تلقائيًا (ERP، مؤرخ، MES).
  • تريد أن تنعكس قراءات الآلة أو حالاتها دون إعادة تحميل.
  • تريد أن تؤدي حالة بعيدة (درجة حرارة، ساعات تشغيل، علامة خطأ) إلى رفع أمر عمل تلقائيًا.

قبل أن تبدأ

  • يجب أن تكون وحدة Relova Remote Machines نشطة في خطتك. الإعدادات ← الوحدات، أو اسأل مالك حسابك.
  • تحتاج إلى إذن إدارة الإعدادات — Relova موجودة ضمن الإعدادات.
  • جهز تفاصيل اتصال المصدر: المضيف والمنفذ واسم قاعدة البيانات واسم مستخدم وكلمة مرور للقراءة فقط. أنشئ حسابًا مخصصًا للقراءة فقط على المصدر إذا أمكنك ذلك.
  • إذا كان المصدر يقبل الاتصالات فقط من داخل شبكته الخاصة، فاحصل على وصول SSH إلى مضيف يمكنه الوصول إليه (يمكن لـ Relova إنشاء نفق من خلاله).

الخطوة 1 — افتح Relova

انتقل إلى الإعدادات ← Relova. تعرض علامة التبويب نظرة عامة أربعة عدادات — الاتصالات، الأخطاء، تعيينات الوحدات، المراجع الافتراضية — وقائمة باتصالاتك. شريط علامات التبويب أسفل العنوان (نظرة عامة · الاتصالات · التعيينات · المشغلات) ينقلك بين الشاشات.

في إعداد جديد تمامًا، يكون كل عداد صفرًا وتظهر القائمة "لم يتم تكوين أي اتصالات بعد." مع زر إنشاء اتصالك الأول — هذه هي الخطوة 2.

الخطوة 2 — إضافة اتصال

افتح علامة التبويب الاتصالات وانقر على اتصال جديد (أعلى اليمين، زر "+"). املأ النموذج:

  • اسم الاتصال — تسمية ستتعرف عليها، على سبيل المثال "نظام تخطيط موارد المؤسسات للإنتاج".
  • مشغل قاعدة البيانات — MySQL / MariaDB، PostgreSQL، SQL Server، Oracle، SAP HANA، أو ملف CSV / Excel، أو واجهة برمجة تطبيقات REST. يتغير باقي النموذج ليطابق ذلك.
  • المضيف، المنفذ، قاعدة البيانات، المخطط — عنوان الشبكة للمصدر. يتم ملء المنفذ مسبقًا من المشغل.
  • اسم المستخدم / كلمة المرور — بيانات الاعتماد للقراءة فقط. يتم تشفيرها قبل تخزينها ولا تظهر مرة أخرى أبدًا؛ اترك كلمة المرور فارغة عند التحرير للاحتفاظ بالكلمة الحالية.
  • ذاكرة التخزين المؤقت للمخطط — المدة (بالثواني) التي يمكن لـ Relova إعادة استخدام قائمة الجداول والأعمدة قبل إعادة قراءتها. 300 (5 دقائق) هو افتراضي جيد؛ 0 يعطل التخزين المؤقت.
  • وضع الاستعلام — افتراضي يقرأ من المصدر في كل عرض (الأحدث). لقطة تحتفظ بنسخة مؤقتة قصيرة الأجل لقوائم أسرع. عند الطلب يقرأ فقط عندما يفتح شخص ما السجل.

نفق SSH (اختياري)

قم بتشغيل نفق SSH عندما يكون المصدر قابلاً للوصول فقط من داخل شبكة خاصة. أعطِ مضيف SSH ومنفذه ومستخدمه، والصق مفتاحًا خاصًا (موصى به) أو كلمة مرور. اترك مضيف SSH فارغًا لإنشاء نفق من خلال مضيف قاعدة البيانات نفسه.

مصادر CSV / Excel

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

انقر على اختبار الاتصال أولاً — يفتح Relova الاتصال، ويقوم بقراءة غير ضارة، ويبلغ عن النجاح أو الخطأ الدقيق. عندما ينجح، انقر على حفظ. يظهر الاتصال في القائمة مع نقطة حالة.

حالات الاتصال

  • متصل — آخر فحص نجح.
  • متدهور — قابل للوصول ولكنه بطيء أو يعيد تحذيرات.
  • خطأ — آخر فحص فشل. افتح الاتصال لمعرفة السبب؛ استخدم اختبار الاتصال بعد الإصلاح.
  • معطل - قمت بإيقاف تشغيله. تتوقف السجلات المترابطة عن الحل حتى تقوم بإعادة تمكينه.

يحتوي كل صف على اختبار وتعديل وتمكين / تعطيل وحذف. يؤدي حذف اتصال إلى إزالة تعييناته وكل مرجع افتراضي أنشأه.

الخطوة 3 - تصفح المصدر (اختياري ولكنه مفيد)

من صف الاتصال، اختر متصفح المخطط (أيقونة قاعدة البيانات). اختر الاتصال، ويسرد Relova جداوله على اليسار. انقر فوق جدول لمعرفة أعمدته - الاسم، النوع، قابل للإلغاء، المفتاح - وانقر فوق معاينة البيانات لرؤية الصفوف الأولى. استخدم هذا للعثور على أسماء الجداول والأعمدة الدقيقة التي ستحتاجها في الخطوة 4. تحديث يعيد قراءة المخطط ويمسح ذاكرة التخزين المؤقت.

الخطوة 4 - ربط جدول بوحدة

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

  • الاتصال وجدول المصدر - أي جدول بعيد يغذي هذا التعيين.
  • اسم التعيين - على سبيل المثال "أصول ERP".
  • الوحدة المستهدفة - الآلات / المعدات، قطع الغيار، المخزون، الموردون، المواقع. هذا يحدد ما ستصبح عليه الصفوف.
  • الموقع - تحديد نطاق التعيين لموقع واحد، أو تركه مفتوحًا. يتم حفظ أمر العمل الذي يتم إنشاؤه من هذا التعيين مقابل هذا الموقع.
  • عمود المفتاح البعيد - العمود الذي يحدد بشكل فريد كل صف بعيد (عادةً id). يستخدمه Relova للحفاظ على المراجع مستقرة بين عمليات المزامنة.

تعيينات الأعمدة

انقر فوق إضافة تعيين لكل حقل تريد ملؤه: اختر حقل محلي (على سبيل المثال machine_name) والعمود البعيد الذي يغذيه. الحقول المميزة بعلامة * مطلوبة - لن تقبل الوحدة سجلًا حتى يتم تعيينها. تخبرك اللوحة عندما يتم تغطية كل حقل مطلوب.

حقول العرض

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

القيم الافتراضية الثابتة والربط

استخدم القيم الافتراضية لملء عمود محلي مطلوب ليس له مصدر بعيد معقول - على سبيل المثال location_id ثابت، أو machine_id لربط كل صف من هذا التعيين بآلة iTenance واحدة. استخدم الربط لسحب عمود من جدول بعيد مرتبط دون عرض قاعدة بيانات.

سلوك المزامنة

افتراضي - دائمًا مباشر. تخزين اللقطة مؤقتًا - تخزين كل صف مؤقتًا لمدة TTL ذاكرة التخزين المؤقت التي تحددها (بالدقائق). عند الطلب - قراءة فقط عند الفتح. أضف عمود اكتشاف التغيير (على سبيل المثال updated_at) حتى يتمكن Relova من جلب الصفوف التي تغيرت فقط منذ آخر مزامنة بدلاً من الجدول بأكمله.

انقر فوق معاينة لرؤية الصفوف الأولية بجوار النتيجة المعينة، ثم حفظ. يقوم Relova بفهرسة الصفوف البعيدة وتبدأ في الظهور في الوحدة المستهدفة، كل منها معلم كسجل بعيد.

التعامل مع السجلات البعيدة

  • تبدو الآلة البعيدة مثل أي آلة أخرى في القوائم وفي صفحة العرض الخاصة بها، مع شارة صغيرة تشير إلى أنها بعيدة.
  • الحقول التي تأتي من المصدر (الاسم، الطراز، الرقم التسلسلي، القراءات) هي للقراءة فقط في iTenance. تحديث من المصدر على السجل يسحب أحدث القيم.
  • يتم تعيين العلاقات المحلية فقط - الموقع، الشركة المصنعة، الفئة، المباني - باستخدام تعديل العلاقات وتبقى في iTenance؛ لا تقوم المزامنة أبدًا بالكتابة فوقها.
  • يمكنك إنشاء أوامر عمل وإضافة مهام وتسجيل وقت التوقف ضد آلة بعيدة تمامًا كالمعتاد.

الخطوة 5 - إنشاء أوامر عمل تلقائيًا (المشغلات)

افتح علامة التبويب المشغلات وانقر فوق قاعدة جديدة. يراقب المشغل حقلًا واحدًا من صفوف تعيين متزامنة ويفتح أمر عمل لحظة استيفاء القيمة لشرطك.

  • مراقبة التعيين - أي صفوف تعيين يجب مراقبتها (هذا يحدد أيضًا المبنى الذي يتم حفظ أمر العمل ضده).
  • الاسم - الغرض من هذه القاعدة، على سبيل المثال "ارتفاع درجة حرارة المحمل".
  • عند الحقل - عمود من اللقطة المتزامنة (ابدأ الكتابة للحصول على اقتراحات من حقول عرض التعيين)، على سبيل المثال temperature.
  • المشغل - يرتفع فوق / ينخفض تحت / يساوي / أكبر من / يحتوي على نص / هو أحد / يتغير على الإطلاق، وهكذا.
  • القيمة - الرقم أو النص للمقارنة به. "هو أحد" يأخذ قائمة؛ "يتغير على الإطلاق" لا يحتاج إلى قيمة.
  • الأولوية - الأولوية التي يحصل عليها أمر العمل الذي تم إنشاؤه (منخفض / عادي / مرتفع / حرج).
  • فترة التهدئة - الدقائق التي تظل فيها القاعدة صامتة بعد إطلاقها، لذلك لا تنشئ قيمة تحوم حول العتبة مجموعة من التكرارات. 1440 = يوم واحد.
  • قوالب العنوان / الوصف - صياغة أمر العمل. أدخل القيم البعيدة باستخدام {column_name}، على سبيل المثال تنبيه المحمل: {temperature}°C على {machine_name}. اتركه فارغًا للحصول على افتراضي معقول.
حفظ. تظهر القاعدة في القائمة مع شرطها وأولويتها وفترة التهدئة؛ يسجل شريط النشاط الأخير أدناه كل مرة تطابقت فيها، أو تم تخطيها (فترة التهدئة) أو أنشأت أمر عمل. استخدم المفتاح في صف لإيقاف قاعدة مؤقتًا دون حذفها.
يتم حفظ أمر العمل ضد مباني التعيين. يتم ربطه بآلة iTenance فقط عندما تكون هذه الآلة مرتبطة حقًا بالصف البعيد - سجل ظل مادي، أو آلة قمت بتسميتها في القيم الافتراضية للتعيين. تُستخدم القيم البعيدة فقط للصياغة، ولا تُستخدم أبدًا لاختيار الآلة التي يهبط عليها أمر العمل.

الأمان والعزل

  • للقراءة فقط، دائمًا. يمنع Relova أي عبارة ليست للقراءة. لا يمكنه INSERT أو UPDATE أو DELETE أو تغيير مخطط المصدر.
  • يتم تشفير بيانات الاعتماد في حالة السكون باستخدام مفتاح منفصل عن بيانات التطبيق الأخرى، ولا يتم إرجاعها أبدًا إلى المتصفح.
  • الطلبات الصادرة محمية. ترفض Relova الاتصال بنطاقات العناوين الداخلية/الاسترجاعية ما لم يقم المشغل الخاص بك بإضافة مضيف إلى القائمة البيضاء صراحةً، مما يمنع توجيه نموذج اتصال نحو البنية التحتية الداخلية.
  • كل اتصال وتعيين ومرجع بعيد محدد النطاق لمستأجرك. لا يمكن لمستأجر واحد رؤية أو الاستعلام عن بيانات Relova الخاصة بمستأجر آخر.
  • تنطبق قيود الصفوف ومهلات الاستعلام على كل عملية قراءة تمريرية، لذلك لا يمكن لتعيين سيء سحب مجموعة نتائج غير محدودة.

استكشاف الأخطاء وإصلاحها

فشل اختبار الاتصال فورًا.

خطأ في المضيف/المنفذ، أو جدار حماية المصدر لا يسمح لخادم iTenance الخاص بك. تأكد من التفاصيل باستخدام عميل قاعدة بيانات من نفس الشبكة، ثم أضف نفق SSH إذا كان المصدر خاصًا.

اختبار الاتصال جيد ولكن القوائم فارغة.

لا يغطي التعيين أي حقول مطلوبة، أو اسم جدول المصدر خاطئ. أعد التحقق من الخطوة 4 مقابل متصفح المخطط، واستخدم معاينة.

“الحقول المطلوبة لم يتم تعيينها بعد”.

عمود محلي غير فارغ (NOT-NULL) بدون قيمة افتراضية لم يتم تعيينه. إما أن تعين عمودًا بعيدًا له أو تعطيه قيمة افتراضية.

القيم تبدو قديمة.

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

Relova على النطاق المركزي لا يعرض شيئًا.

تعمل Relova دائمًا من مساحة عمل المستأجر. افتحها من عنوان المستأجر العادي الخاص بك، وليس من نطاق تسجيل الدخول المركزي.

انظر أيضاً