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

البحث العالمي

تقدم ميزة البحث العالمي واجهة بحث موحدة للعثور بسرعة على العملاء، جهات الاتصال، الخدمات، المخزون، والمواقع عبر قاعدة بيانات OmniCRM بالكامل.

انظر أيضًا: العملاء، المخزون، إدارة الخدمات.

الوصول إلى البحث العالمي​

من أي مكان في نظام إدارة علاقات العملاء:

انقر على أيقونة البحث في شريط التنقل العلوي أو انتقل إلى:

تظهر صفحة البحث العالمي مع مربع بحث كبير وخيارات تصفية.

كيفية العمل​

يؤدي البحث العالمي بحثًا عبر الكيانات عبر خمسة أنواع من البيانات:

ما الذي يتم البحث عنه:

  1. العملاء - اسم العميل
  2. جهات الاتصال - الاسم الأول، الاسم الأخير، عنوان البريد الإلكتروني، رقم الهاتف
  3. المواقع - اسم الموقع
  4. المخزون - أرقام السلاسل، ICCIDs، المعرفات (itemtext1، itemtext2)
  5. الخدمات - اسم الخدمة، UUID الخدمة

سلوك البحث:

  • مطابقة جزئية - يبحث عن المصطلحات التي تحتوي على استعلامك (مثل، "Smith" تطابق "John Smith" و "Smithson")
  • غير حساسة لحالة الأحرف - "john" تطابق "John"، "JOHN"، و "john"
  • كيانات متعددة - بحث واحد يعيد النتائج من جميع أنواع الكيانات
  • نتائج مقسمة - تظهر 10 نتائج لكل صفحة بشكل افتراضي

إجراء بحث​

البحث الأساسي​

  1. أدخل مصطلح البحث الخاص بك في مربع البحث
  2. انقر على "بحث" أو اضغط على Enter

نتائج البحث العالمي{.align-center width="800px"}

مصطلحات البحث المثال:

  • اسم العميل: "Acme Corp"
  • رقم الهاتف: "+1234567890" أو "1234567890"
  • البريد الإلكتروني: "john@example.com" أو "john"
  • رقم السلسلة: "ICCID8944" أو فقط "8944"
  • UUID الخدمة: "123e4567-e89b"

تضمين الحسابات المغلقة​

بشكل افتراضي، يعيد البحث النتائج من حسابات العملاء المفتوحة فقط.

للبحث عبر جميع الحسابات بما في ذلك المغلقة:

  1. تحقق من مربع "تضمين الحسابات المغلقة"
  2. انقر على "بحث" مرة أخرى

سيبحث هذا في:

  • العملاء الذين لديهم customer_status = "مغلق"
  • جهات الاتصال، الخدمات، المواقع، والمخزون المرتبط بالعملاء المغلقين

حالات الاستخدام للبحث في الحسابات المغلقة:

  • العثور على سجلات العملاء التاريخية
  • تحديد المعدات من الخدمات الملغاة
  • البحث عن أرقام الهواتف القديمة أو الخدمات
  • استعادة بيانات العملاء لإعادة التفعيل

فهم نتائج البحث​

تنسيق عرض النتائج​

تُعرض النتائج في قائمة قابلة للتمرير تظهر:

John Smith معرف العميل: 123 النوع: عميل

John Smith (جهة اتصال) معرف العميل: 123 النوع: جهة اتصال

الهاتف المحمول - +44 7700 900123 معرف العميل: 123 النوع: خدمة

كل نتيجة تظهر:

  • الاسم/العنوان - المعرف الرئيسي (رابط قابل للنقر)
  • معرف العميل - العميل الرئيسي الذي ينتمي إليه
  • النوع - نوع الكيان (عميل، جهة اتصال، موقع، مخزون، خدمة)

أنواع النتائج موضحة​

نتائج العملاء:

يؤدي النقر إلى فتح صفحة نظرة عامة على العميل تعرض جميع التفاصيل، الخدمات، جهات الاتصال، إلخ.

نتائج جهات الاتصال:

يؤدي النقر إلى فتح صفحة العميل مع علامة التبويب جهات الاتصال نشطة، مع التمرير إلى جهة الاتصال المحددة.

نتائج المواقع:

يؤدي النقر إلى فتح صفحة العميل مع علامة التبويب المواقع نشطة.

نتائج المخزون:

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

نتائج الخدمات:

يؤدي النقر إلى فتح صفحة العميل مع علامة التبويب الخدمات نشطة، مع تسليط الضوء على الخدمة المحددة.

التنقل من النتائج​

جميع نتائج البحث هي روابط قابلة للنقر تنقل مباشرة إلى الصفحة ذات الصلة:

نمط الرابط:

  • /customers/{customer_id} - سجلات العملاء
  • /customers/{customer_id}#4 - جهات الاتصال (علامة التبويب 4)
  • /customers/{customer_id}#2 - المواقع (علامة التبويب 2)
  • /customers/{customer_id}#8 - المخزون (علامة التبويب 8)
  • /customers/{customer_id}#3 - الخدمات (علامة التبويب 3)
  • /inventory-items-list - مخزون غير مخصص

تقوم علامة التجزئة (#) تلقائيًا بتحديد علامة التبويب الصحيحة عند تحميل صفحة العميل.

تقسيم الصفحات​

تُقسم النتائج إلى صفحات تحتوي على 10 عناصر لكل صفحة:

عرض النتائج 11-20 من 47

انتقل عبر الصفحات باستخدام:

  • أزرار ال��ابق/التالي
  • أرقام الصفحات - انقر على الصفحة المحددة
  • لوحة المفاتيح - الأسهم اليسرى/اليمنى (إذا تم تنفيذها)

سيناريوهات البحث الشائعة​

السيناريو 1: العثور على عميل بواسطة الهاتف

يتصل المستخدم، ويقدم رقم الهاتف.

النتائج: • John Smith (جهة اتصال) - معرف العميل: 123 • الهاتف المحمول - 555-0123 (خدمة) - معرف العميل: 123

انقر على أي من النتائج للوصول إلى حساب العميل.

السيناريو 2: تحديد بطاقة SIM

يحتاج الفني إلى معرفة أي عميل لديه بطاقة SIM معينة.

النتائج: • 8944538000000001234 (مخزون) - معرف العميل: 456

انقر على النتيجة لرؤية تخصيص SIM، تفاصيل العميل.

السيناريو 3: العثور على عميل غير نشط

تحتاج إلى تحديد موقع عميل أغلق حسابه منذ 6 أشهر.

☑ تضمين الحسابات المغلقة

النتائج: • Acme Corporation (عميل) - معرف العميل: 789

السيناريو 4: البحث بواسطة البريد الإلكتروني

يرسل العميل بريدًا إلكترونيًا إلى الدعم، يحتاج الموظف إلى العثور على حسابه.

النتائج: • John Smith (جهة اتصال) - معرف العميل: 123

السيناريو 5: العثور على خدمة بواسطة UUID

تظهر سجلات التزويد UUID الخدمة، تحتاج إلى معرفة أي عميل.

النتائج: • الهاتف المحمول - +44 7700 900123 (خدمة) - معرف العميل: 456

نصائح البحث​

للحصول على أفضل النتائج:

  • استخدم مصطلحات جزئية - "Smith" أفضل من "John Smith" للحصول على نتائج أوسع
  • جرب التباينات - إذا لم تنجح "John"، جرب الهاتف أو البريد الإلكتروني
  • تضمين الحسابات المغلقة - عند البحث في البيانات التاريخية
  • كن محددًا للمعدات - استخدم أرقام السلاسل الكاملة للمخزون
  • ابحث عن UUID الخدمة - عندما لا تكون المعرفات الأخرى معروفة

ما الذي يتم البحث عنه (حسب الكيان):

العملاء:

  • اسم العميل فقط (ليس العنوان، الملاحظات، أ�� الحقول الأخرى)

جهات الاتصال:

  • الاسم الأول
  • الاسم الأخير
  • عنوان البريد الإلكتروني
  • رقم الهاتف

المواقع:

  • اسم الموقع فقط

المخزون:

  • itemtext1 (عادةً ICCID، رقم السلسلة، عنوان MAC)
  • itemtext2 (عادةً IMSI، معرف ثانوي)
  • ملاحظة: لا يتم البحث في itemtext3-20 أو ملاحظات المخزون

الخدمات:

  • اسم الخدمة
  • UUID الخدمة

ما الذي لا يتم البحث عنه:

  • عناوين العملاء
  • ملاحظات العملاء
  • أوصاف المعاملات
  • تفاصيل الفواتير
  • سجلات التزويد
  • إدخالات سجل النشاط
  • ملاحظات المخزون (بخلاف itemtext1/2)

مرجع API​

نقطة نهاية البحث العالمي​

GET /utilities/search_everything?search=Smith&page=1&per_page=10&search_closed_records=false
Authorization: Bearer <token>

معلمات الاستعلام:

  • search (مطلوب) - مصطلح البحث
  • page (اختياري) - رقم الصفحة (افتراضي: 1)
  • per_page (اختياري) - النتائج لكل صفحة (افتراضي: 10)
  • search_closed_records (اختياري) - تضمين الحسابات المغلقة (افتراضي: false)

الاستجابة:

{
  "data": [
    {
      "id": 123,
      "name": "John Smith",
      "customer_id": 123,
      "type": "customer"
    },
    {
      "id": 456,
      "name": "John Smith",
      "customer_id": 123,
      "type": "contact"
    },
    {
      "id": 789,
      "name": "Mobile - +44 7700 900123",
      "customer_id": 123,
      "type": "service"
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 10,
    "total_pages": 5,
    "total_items": 47
  }
}

منطق البحث (الجهة الخلفية):

تقوم الجهة الخلفية بتنفيذ اتحاد SQL عبر جميع جداول الكيانات:

-- العملاء
SELECT customer_id AS id,
       customer_name AS name,
       customer_id,
       'customer' AS type
FROM customer
WHERE customer_name LIKE '%Smith%'
  AND customer_status = 'Open'

UNION ALL

-- جهات الاتصال
SELECT contact_id AS id,
       CONCAT(contact_firstname, ' ', contact_lastname) AS name,
       customer_id,
       'contact' AS type
FROM customer_contact
WHERE (contact_firstname LIKE '%Smith%' OR
       contact_lastname LIKE '%Smith%' OR
       contact_email LIKE '%Smith%' OR
       contact_phone LIKE '%Smith%')

UNION ALL

-- المواقع
SELECT site_id AS id,
       site_name AS name,
       customer_id,
       'site' AS type
FROM customer_site
WHERE site_name LIKE '%Smith%'

UNION ALL

-- المخزون
SELECT inventory_id AS id,
       itemtext1 AS name,
       customer_id,
       'inventory' AS type
FROM inventory
WHERE itemtext1 LIKE '%Smith%' OR
      itemtext2 LIKE '%Smith%'

UNION ALL

-- الخدمات
SELECT service_id AS id,
       service_name AS name,
       customer_id,
       'service' AS type
FROM customer_service
WHERE service_name LIKE '%Smith%' OR
      service_uuid LIKE '%Smith%'

ثم يتم تقسيم النتائج وإرجاعها.

اعتبارات الأداء​

أداء البحث:

  • تستخدم عمليات البحث استعلامات LIKE مع الرموز النجمية (%term%)
  • لا يوجد فهرس نص كامل تم تنفيذه حاليًا
  • قد تواجه قواعد البيانات الكبيرة (>100k عميل) عمليات بحث أبطأ
  • يتم تحديد النتائج بـ 10 لكل صفحة لأغراض الأداء

نصائح التحسين:

  • كن محددًا مع مصطلحات البحث لتقليل مجموعة النتائج
  • ا��تخدم فلتر الحسابات المغلقة لتقليل نطاق البحث
  • فكر في إضافة فهارس قاعدة البيانات على الحقول التي يتم البحث فيها بشكل متكرر

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

لم يتم العثور على نتائج (لكن السجل موجود)

  • السبب: لا يتطابق مصطلح البحث مع تنسيق البيانات المخزنة
  • أمثلة:
    • الهاتف مخزن كـ "+44 7700 900123"، البحث عن "07700900123" لن يتطابق
    • البريد الإلكتروني مخزن كـ "<john.smith@example.com>"، البحث عن "john" لن يتطابق
  • الإصلاح: جرب التباينات، استخدم المطابقات الجزئية التي توجد بالتأكيد

البحث بطيء جدًا

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

النتائج ترتبط بعمي�� خاطئ

  • السبب: وجود عملاء/جهات اتصال متعددة بنفس الاسم
  • الإصلاح: استخدم معرف العميل للتفريق، أو ابحث بواسطة معرف فريد (البريد الإلكتروني، الهاتف)

الحسابات المغلقة لا تظهر

  • السبب: لم يتم تحديد مربع "تضمين الحسابات المغلقة"
  • الإصلاح: تحقق من المربع وابحث مرة أخرى

الوثائق ذات الصلة​

  • basics_customers - إدارة العملاء
  • basics_navigation - التنقل العام
  • administration_inventory - عمليات البحث في المخزون