البحث المنسّق (FMS) في SAP Business One: صياغة $[$38.1.0] و7 أمثلة عملية والتحديث التلقائي

ما هو البحث المنسّق

البحث المنسّق، ويُسمّى عادةً FMS، هو استعلام محفوظ مرتبط بحقل واحد في نموذج واحد. عند تشغيله، إما أن يكتب SAP Business One النتيجة في الحقل، أو يعرض قائمة يختار منها المستخدم.

يحبه المستخدمون لأنه يوفّر عليهم الكتابة. ويحبه المطورون لأنه لا يحتاج إلى أي إضافة. يمكنك ملء حقل UDF في السطر بالاسم الأجنبي للصنف، أو عرض المخزون في مستودع السطر، أو تقديم قائمة منسدلة من جدول معرّف من قِبل المستخدم.

إذا أردت تجاوز عناء الصياغة، فإن منشئ البحث المنسّق يكتب الاستعلام عنك.

الصياغة

هناك طريقتان لقراءة القيم من النموذج المفتوح.

في الصيغة الأولى:

• Item هو رقم عنصر النموذج. في مستندات المبيعات والمشتريات، 38 هو مصفوفة الأسطر و 4 هو رمز العميل أو المورّد.
• Column هو عمود المصفوفة. استخدم 0 لحقول الرأس.
• Type يحدد طريقة إرجاع القيمة:
  • 0 يعيد القيمة كما هي. استخدمه للرموز والنصوص وأرقام المستندات.
  • NUMBER يعيد رقمًا دون العملة أو الوحدة. استخدمه للحسابات.
  • CURRENCY يعيد رمز العملة أو وحدة القياس فقط.
  • DATE يعيد تاريخًا يمكنك إضافة أيام إليه.

يوصي دليل SAP نفسه بصيغة الأرقام، لأن $[$4.0.0] تعمل في أي مستند تسويقي، بينما $[OINV.CardCode] تعمل فقط في فواتير المبيعات.

تستخدم الحقول المعرّفة من قِبل المستخدم اسمها مكان العمود: $[$38.U_Discount.NUMBER].

لا تريد البحث عن معرّفات العناصر والأعمدة يدويًا؟ منشئ البحث المنسّق يكتب المتغير للحقل الذي تختاره.

مرجع سريع

قد تختلف أرقام العناصر والأعمدة بين الإصدارات والنماذج. تحقق منها عبر عرض ← معلومات النظام (View → System Information) قبل الاعتماد على أي رقم.

كيف تجد معرّفات العناصر والأعمدة

1. في SAP Business One، افتح عرض > معلومات النظام (View > System Information).
2. افتح النموذج ومرّر المؤشر فوق الحقل.
3. اقرأ شريط الحالة في الأسفل. يعرض العنصر والعمود، وللحقول المرتبطة بقاعدة البيانات اسم الجدول والحقل.

تحقق من كل معرّف على إصدارك ونموذجك. قد تختلف أرقام الأعمدة بين أنواع المستندات وحزم التوطين. ويساعدك مرجع جداول SAP B1 في أسماء الجداول والحقول.

كيف تربط بحثًا منسّقًا بحقل

1. احفظ استعلامك في مدير الاستعلامات، ويُفضّل في فئة باسم “FMS”.
2. افتح النموذج المستهدف وانقر داخل الحقل.
3. اضغط Alt+Shift+F2. تفتح نافذة البحث المنسّق.
4. اختر البحث في القيم المعرّفة من قِبل المستخدم الموجودة وفقًا لاستعلام محفوظ (Search in Existing User-Defined Values according to Saved Query) واختر استعلامك.
5. حدد متى يعمل:
   • دون تحديث تلقائي: يضغط المستخدم Shift+F2 أو ينقر على أيقونة العدسة.
   • التحديث التلقائي عند تغيّر الحقل (Auto Refresh When Field Changes): اختر الحقل المُشغِّل، مثل رمز الصنف. يعمل الاستعلام عندما يغادر المستخدم ذلك الحقل.
   • عرض القيم المحفوظة (Display Saved Values): يحتفظ بالقيمة المخزنة في المستند بدل إعادة تشغيل الاستعلام في كل مرة يُفتح فيها المستند.
6. انقر تحديث (Update) واختبر على مستند جديد.

يذكر دليل SAP أيضًا خيار «التحديث المنتظم» (Refresh Regularly)، ويحذّر من استخدامه إلا بحذر لأنه قد يبطئ النماذج ويغيّر المستندات المحفوظة عند تصفحها.

7 أمثلة عملية

كل الأمثلة بصياغة SQL Server. وتأتي ملاحظات HANA بعدها.

1. حقل صنف في السطر. الاسم الأجنبي لصنف السطر في حقل UDF على السطر (الجدول OITM).

SELECT T0.FrgnName
FROM OITM T0
WHERE T0.ItemCode = $[$38.1.0]

2. حقل شريك أعمال في الرأس. الائتمان المتاح للعميل المختار (الجدول OCRD).

SELECT T0.CreditLine - T0.Balance
FROM OCRD T0
WHERE T0.CardCode = $[$4.0.0]

3. المخزون في مستودع السطر. العمود 24 هو المستودع في كثير من نماذج المستندات. تأكد منه عبر معلومات النظام. والمخزون حسب المستودع موجود في OITW.

SELECT T0.OnHand
FROM OITW T0
WHERE T0.ItemCode = $[$38.1.0]
  AND T0.WhsCode = $[$38.24.0]

4. آخر سعر بيع لهذا العميل. مفيد للمراجعة بجانب عمود السعر (فواتير المبيعات في OINV).

SELECT TOP 1 T1.Price
FROM OINV T0
INNER JOIN INV1 T1 ON T0.DocEntry = T1.DocEntry
WHERE T0.CardCode = $[$4.0.0]
  AND T1.ItemCode = $[$38.1.0]
  AND T0.CANCELED = 'N'
ORDER BY T0.DocDate DESC, T0.DocEntry DESC

5. وزن السطر. وزن البيع للوحدة مضروبًا في كمية السطر (العمود 11).

SELECT T0.SWeight1 * $[$38.11.NUMBER]
FROM OITM T0
WHERE T0.ItemCode = $[$38.1.0]

6. قائمة منسدلة من جدول معرّف من قِبل المستخدم. إرجاع عمودين يعطي المستخدم قائمة يختار منها.

SELECT T0.Code, T0.Name
FROM [@REGIONS] T0
ORDER BY T0.Name

7. تاريخ اليوم. يملأ حقل UDF من نوع تاريخ عند إنشاء المستند.

SELECT GETDATE()

الفروق في HANA

على SAP Business One لـ HANA يبقى المنطق نفسه لكن SQL يتغير:

• ضع أسماء الجداول والأعمدة بين علامتي اقتباس مزدوجتين: T0."ItemCode" و "@REGIONS".
• أسماء حقول UDF داخل المتغير تحتاج أيضًا إلى اقتباس: $[$38."U_Discount".NUMBER].
• عبارة SELECT دون جدول تحتاج إلى FROM DUMMY.
• استبدل دوال SQL Server: تصبح GETDATE() هي CURRENT_DATE، وتصبح ISNULL هي IFNULL.

المثال 7 على HANA:

SELECT CURRENT_DATE FROM DUMMY

المثال 1 على HANA:

SELECT T0."FrgnName"
FROM OITM T0
WHERE T0."ItemCode" = $[$38.1.0]

إذا كنت تنقل استعلامات كثيرة، فالصقها في محوّل SQL إلى HANA ثم اختبر كل واحد منها.

أخطاء البحث المنسّق الشائعة وطريقة حلها

ولا يعمل التحديث التلقائي أيضًا على الحقول التي لم يعد ممكنًا تغييرها، مثل رقم الصنف في مذكرة تسليم قائمة.

نصائح للأداء

• عمليات البحث على مستوى الأسطر تتضاعف. البحث الذي يتحدّث تلقائيًا عند تغيّر رمز الصنف يعمل مرة لكل سطر. في أمر من 200 سطر، هذا يعني 200 استعلام. أضف ثلاث عمليات بحث كهذه وسيشعر المستخدمون بالبطء.
• صفِّ على المفاتيح. استعلم حسب ItemCode و CardCode و DocEntry. وتجنّب LIKE '%x%' والدوال على الأعمدة داخل جملة WHERE.
• تجنّب عمليات الربط الثقيلة على جداول المستندات. المثال 4 يمسح سجل الفواتير. هذا مقبول لبضع مئات الآلاف من الأسطر، وبطيء للملايين. فكّر في فهرس أو جدول ملخّص.
• فضّل التشغيل عند الطلب للاحتياجات النادرة. إذا كان المستخدمون يحتاجون القيمة من حين لآخر فقط، فاترك التحديث التلقائي مطفأً ودعهم يضغطون Shift+F2.
• استخدم عرض القيم المحفوظة لأي قيمة يجب ألا تتغير بعد حفظ المستند.

متى تستخدم شيئًا آخر

البحث المنسّق يملأ الحقول، لكنه لا يفرض القواعد. يستطيع المستخدم الكتابة فوق القيمة، وعمليات الاستيراد عبر DI API أو Service Layer لا تشغّله.

• استخدم الإجراء المخزن لإشعار المعاملات (SBO_SP_TransactionNotification) عندما يجب أن تنطبق قاعدة دائمًا، مثل «لا فاتورة دون مركز تكلفة» أو «لا يجوز أن يقل السعر عن التكلفة». فهو يمنع الحفظ أيًّا كان المصدر.
• استخدم إضافة عندما تحتاج إلى شاشات جديدة، أو أزرار، أو استدعاءات لواجهات برمجية خارجية، أو منطق يعتمد على حقول كثيرة في وقت واحد.
• احتفظ بالبحث المنسّق للقيم الافتراضية وعمليات البحث وقوائم الاختيار التي تساعد المستخدم على الكتابة أقل.

يملأ البحث المنسّق الحقول أثناء كتابة المستخدمين؛ أما لإعداد التقارير على البيانات نفسها، فتعرّف على طريقة بناء لوحة معلومات SAP Business One بدون Power BI.

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

المصادر

• SAP: كيفية تعريف البحث المنسّق واستخدامه (دليل SAP Business One، PDF)
• SAP: كيفية تعريف عمليات البحث المنسّق واستخدامها (مستضاف لدى Vision33)
• SAP Community: بحث منسّق لحساب الخصم على SAP B1 HANA
• أرشيف SAP Community: مراجع الحقول في البحث المنسّق ومعلومات النظام
• SAP Community: ظهور Internal error (-1003) occurred [Message 131-183] عند تنفيذ بحث منسّق
• Packt: العمل مع القيم المعرّفة من قِبل المستخدم في SAP Business One

خدمات ذات صلة

• تطوير SAP Business One