دليل Validatar

البحث الشامل (Global Search)

Global Search

دليل تثبيت وتهيئة Apache Solr لتفعيل ميزة البحث الشامل عن الاختبارات والمهام والكائنات الوصفية في Validatar.

لوحة المتابعة

نظرة عامة

يمكنك بسهولة إيجاد الاختبارات (tests) والمهام (jobs) والكائنات الوصفية (metadata objects) باستخدام شريط البحث الموجود في رأس القائمة. ولا يقتصر البحث على اسم الكائن فقط، بل يمكنك البحث حسب Data Source، أو نص SQL المستخدم في الاختبار، أو منشئ الاختبار، وغير ذلك.

المتطلبات المسبقة

هناك بعض الخطوات التي يجب إكمالها قبل إمكانية استخدام Global Search:

  1. 1تثبيت وتهيئة Apache Solr
  2. 2تهيئة إعدادات Global Search داخل Validatar
ظهور شريط البحث

لن يظهر شريط البحث في رأس Validatar إذا لم يتم تهيئة Global Search.

تثبيت Solr على Windows

1. تثبيت Java

إذا لم يكن مثبتًا بالفعل:

شكل 1: 1. تثبيت Java
  1. 1راجع متطلبات النظام لـ Apache Solr: https://solr.apache.org/guide/solr/latest/deployment-guide/system-requirements.html
  2. 2نزّل Java من Adoptium أو OpenJDK أو استخدم إصدار Oracle.
  3. 3ثبّت ملف MSI الذي تم تنزيله.
  4. 4أنشئ متغير بيئة نظام باسم JAVA_HOME يشير إلى مجلد Java الجذري من التثبيت أعلاه.

2. تثبيت Solr

ترخيص Solr

يُوزَّع Solr من قبل Apache تحت رخصة Apache License الإصدار 2.0، والتي يمكن الاطلاع عليها هنا: https://www.apache.org/licenses/LICENSE-2.0.

  1. 1نزّل Solr من هنا: https://solr.apache.org/downloads.html، واستخدم رابط أحدث ملف zip ثنائي (مثال: https://www.apache.org/dyn/closer.lua/solr/solr/9.8.1/solr-9.8.1.tgz?action=download).
  2. 2فك ضغط ملف Solr.
  3. 3افتح موجه أوامر (command line)، وانتقل إلى المجلد الذي فككت فيه ضغط Solr، وابدأ تشغيل Solr باستخدام الأمر التالي:
bin\solr.cmd start
شكل 2: 2. تثبيت Solr
  1. 1عند هذه النقطة، يجب أن تتمكن من فتح متصفح على ذلك الخادم والانتقال إلى http://localhost:8983 لفتح واجهة Solr.
ملاحظة إعادة تشغيل الخادم

يجب تشغيل هذا الأمر في كل مرة تُعاد فيها تشغيل الخادم، لذا يُفضّل إنشاء مهمة باستخدام Windows Task Scheduler بمُشغِّل (trigger) من نوع "At startup".

3. إضافة نواة Validatar إلى Solr

  1. 1النواة (core) في Solr هي المكان الذي تُخزَّن فيه البيانات التي تُفهرسها Validatar. إذا كنت تستخدم نسخة واحدة من Solr لعدة نسخ من Validatar (dev و prod)، فستحتاج إلى استخدام نواة مختلفة لكل نسخة.
  2. 2أنشئ مجلد "validatar" للنواة الجديدة داخل مجلد Solr الجذري. إذا استخدمت اسم مجلد مختلف، استبدل أي إشارة إلى "validatar" في هذه الخطوة والخطوات التالية.
شكل 3: 3. إضافة نواة Validatar إلى Solr
  1. 1نزّل الملف التالي: https://admin.cloud.validatar.com/assets/releases/2025-2/solr-root.zip
  2. 2انسخ مجلد "conf" من ملف الـ zip إلى مجلد "validatar".
  3. 3افتح متصفحًا على الخادم وانتقل إلى: http://localhost:8983/solr/#/~cores
  4. 4أدخل "validatar" في مربعي النص name و instanceDir، ثم انقر على زر "Add Core".

تهيئة Global Search في Validatar

  1. 1افتح متصفحًا وانتقل إلى Validatar.
  2. 2اذهب إلى Settings > Configuration > Global Search.
  3. 3أدخل http://localhost:8983/solr في خانة Solr Endpoint URL، و"validatar" في خانة Solr Core Name، واترك حقلي اسم المستخدم/كلمة المرور فارغين.
  4. 4انقر على زر Validate Settings للتحقق من صحة التهيئة. إذا كان كل شيء صحيحًا، ستظهر لك علامتا صح خضراوان.
  1. 1مرر لأعلى وحدّد مربع Enable Indexing، ثم انقر على زر Save في الأعلى.
  2. 2بعد بضع ثوانٍ، ستبدأ Validatar بفهرسة البيانات. يمكنك متابعة تقدم الفهرسة بالنقر على زر التحديث بجانب عنوان Indexing Statistics.
ملاحظة إحصاءات الفهرسة

تشمل الكائنات المفهرسة الكائنات المؤرشفة والمعطّلة في قاعدة بيانات Validatar.

شكل 4: تهيئة Global Search في Validatar
شكل 5: تهيئة Global Search في Validatar
السابقالقيم الافتراضيةالتالي إعدادات SMTP