تكامل ساب بزنس ون (SAP Business One) عبر API.

Service Layer أم DI API: أيّهما يناسبك؟

Service Layer هو واجهة REST (OData) من SAP لنظام SAP Business One. إنه HTTP عادي، فيمكن لأي نظام قادر على استدعاء واجهة ويب أن يستخدمه، ويعمل على خادم SAP، فلا حاجة لتثبيت أي شيء على الجهاز الذي يستدعيه. وهو خيارنا الأول للتكاملات الجديدة.

أما DI API فهو مكتبة COM يجب تثبيتها مع عميل SAP Business One على جهاز Windows، وتُستخدم من شيفرة .NET. نختارها حيث لا يغطي Service Layer كائنًا أو وظيفة، أو حيث تستخدمها إضافة قائمة أصلًا. كلاهما يكتب المستندات مع التحقق الخاص بـ SAP، وكلاهما يعمل على SQL Server و SAP HANA.

دليل SAP B1 Service Layer (تسجيل الدخول، $filter، الترقيم) ←

كيف تمنعون تكرار المستندات في ساب بزنس ون (SAP Business One)؟

يحمل كل مستند يأتي من نظام آخر المعرّف الفريد لذلك النظام، مثل رقم الطلب، محفوظًا في حقل معرّف من قِبل المستخدم (UDF) على مستند SAP. وقبل أن يُنشئ التكامل أي شيء، يتحقق مما إذا كان مستند بهذا المعرّف موجودًا بالفعل، فلا تُنشئ رسالةٌ وصلت مرتين، أو مهمةٌ أُعيد تشغيلها بعد فشل، فاتورةً أو أمرًا ثانيًا أبدًا.

ماذا يحدث عندما يفشل استدعاء؟

تذهب الرسالة إلى قائمة انتظار الأخطاء مع السبب، وتُعاد محاولتها بطريقة مضبوطة. المشكلات المؤقتة، مثل توقف النظام الآخر أو انتهاء جلسة Service Layer، تُعاد محاولتها؛ أما أخطاء الأعمال، مثل صنف غير موجود أو فترة مُقفلة، فتنتظر في القائمة حتى يصحّح شخص البيانات. ويُسجَّل كل استدعاء، فترى ما أُرسل، وبماذا أجابت SAP، ولماذا فشل شيء ما.

رموز أخطاء DI API و Service Layer ←

كيف يقرأ التكامل البيانات من SAP Business One؟

عبر Service Layer، باستخدام طلبات الكيانات مع $select و $filter للقراءات البسيطة، واستعلامات SQL محفوظة تُستدعى عبر خدمة SQLQueries للعروض التي تربط عدة جداول. يمكن أن تستخدم القراءات استعلامات SQL Server أو SAP HANA. أما الكتابة فلا تتم أبدًا مباشرة في جداول SAP باستخدام SQL، لأن ذلك يتجاوز التحقق الخاص بـ SAP وقد يُفسد البيانات.

أخطاء Service Layer SQLQueries وحلولها ←

كيف تعمل عمليات تسجيل الدخول والجلسات في Service Layer؟

يسجّل التكامل الدخول بإرسال قاعدة بيانات الشركة واسم المستخدم وكلمة المرور إلى نقطة Login في Service Layer. يعيد SAP Business One ملف تعريف الارتباط B1SESSION (إضافة إلى ملف ROUTEID لموازنة الأحمال)، ويُرسل مع كل استدعاء لاحق. تنتهي مهلة الجلسة بعد فترة دون استدعاءات (30 دقيقة افتراضيًا، وتظهر في استجابة Login باسم SessionTimeout)، لذلك يعيد التكامل استخدام جلسته ويسجّل الدخول مجددًا عند انتهائها. وتُعامَل الجلسة المنتهية كخطأ مؤقت تُعاد محاولته بعد تسجيل الدخول الجديد، لا كمستند فاشل أبدًا.

استعلامات OData والترقيم والطلبات المجمّعة

تستخدم القراءات خيارات OData مثل $select و $filter و $orderby، فلا ينتقل عبر الشبكة إلا الحقول والسجلات المطلوبة. يقسّم Service Layer النتائج إلى صفحات (20 سجلًا لكل صفحة افتراضيًا) ويعيد رابطًا إلى الصفحة التالية؛ فيتبعه التكامل، أو يطلب صفحات أكبر باستخدام الترويسة Prefer: odata.maxpagesize.

يمكن إرسال عدة استدعاءات معًا كطلب $batch واحد. والاستدعاءات المجمّعة في مجموعة تغييرات (change set) تُنفَّذ كمعاملة واحدة، فإما أن تُرحَّل جميعها أو لا يُرحَّل أيٌّ منها. وتظهر الحقول المعرّفة من قِبل المستخدم على كل كيان بأسمائها التي تبدأ بـ U_، وتتوفر الكائنات المعرّفة من قِبل المستخدم (UDO) المسجّلة ككيانات مستقلة.

منشئ طلبات Service Layer (مجاني) ←

من يملك شيفرة التكامل؟

أنت. يملك العميل الشيفرة المصدرية وقاعدة البيانات والتوثيق بعد كل مرحلة مدفوعة. يمكنك استضافة التكامل وصيانته بنفسك، أو تسليمه لمطور آخر، أو أن تطلب منا الاستمرار في دعمه.

ما الدعم الذي تحصل عليه بعد التشغيل الفعلي؟

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

أدلة ذات صلة: دليل SAP B1 Service Layer (تسجيل الدخول، $filter، الترقيم) · أخطاء Service Layer SQLQueries وحلولها · رموز أخطاء DI API (-5002، -1029، -2035) · أمثلة SBO_SP_TransactionNotification (SQL Server و HANA)

أدوات مجانية: منشئ طلبات Service Layer · جدول OCRD (شركاء الأعمال) · جدول ORDR (أوامر البيع) · جدول ODLN (التسليمات) · جدول ORCT (الدفعات الواردة) · جدول OVPM (الدفعات الصادرة)