من يملك هذا الحقل؟
عنوان العميل عُدِّل في المتجر وفي النظام. أيّهما يفوز؟
الجواب اللازم
مالك واحد لكل حقل يكتبه، والآخر يقرأ فقط. السماح للطرفين بالكتابة يُنتج تعارضًا لا حل نظيفًا له مهما كان الكود جيدًا.
التكاملات
التكامل ليس ربط نظامين.
التكامل ليس ربط نظامين.
بل الاتفاق على من يملك الحقيقة.
أغلب مشاريع التكامل لا تفشل تقنيًا. تفشل لأن أحدًا لم يحسم سؤالًا واحدًا قبل البدء: إذا اختلف الرقم بين النظامين، أيّهما الصحيح؟ من يجيب عن هذا السؤال لكل حقل يكون قد أنهى نصف المشروع قبل كتابة سطر.
- مالك واحد لكل حقل
- سجل لكل عملية تبادل
- سلوك واضح عند الفشل
تكاملات شائعة — واتجاه التدفق في كل واحدأمثلة
| الطرف الآخر | الاتجاه |
|---|---|
| مالي | |
| متطلبات الفوترة الإلكترونية | يرسل |
| كشوف الحسابات البنكية | يستقبل |
| بوابات الدفع الإلكتروني | تبادل |
| تشغيلي | |
| المتجر الإلكتروني | تبادل |
| أجهزة الحضور والانصراف | يستقبل |
| أنظمة متخصصة قائمة لديكم | تبادل |
| إشعارات | |
| الرسائل النصية والبريد | يرسل |
| لكل صف: من يملك الحقل؟ وماذا يحدث إن لم يستجب الطرف الآخر؟ — سؤالان قبل البرمجة. | |
المتطلبات النظامية للفوترة الإلكترونية وغيرها تُحدَّد من جهاتها المختصة وقد تتغيّر،
وتفصيلها في صفحة الفوترة الإلكترونية.
وما نلتزم به هنا هو بناء التكامل على المتطلب المعتمد وتحديثه عند تغيّره.
قبل البرمجة
ست أسئلة… يُهمَل خمسة منها عادةً
كل واحد منها يُجاب في ورقة لا في كود. والمشاريع التي تتخطاها تكتشفها لاحقًا في صورة أرقام لا تتطابق.
ماذا لو لم يستجب الطرف الآخر؟
النظام الخارجي متوقف والعملية في انتظاره.
الجواب اللازم
قاعدة مكتوبة: إعادة محاولة كم مرة وعلى أي فترات، ثم تعليق مع تنبيه لمن. الصمت أسوأ الخيارات لأنه يبدو نجاحًا.
كم فارق الوقت المقبول؟
هل يجب أن يظهر الطلب فورًا أم يكفي خلال ساعة؟
الجواب اللازم
رقم لكل نوع بيانات. التكامل اللحظي أغلى وأكثر عرضة للفشل، وكثير من الحالات يكفيها التبادل الدوري — والفرق في الكلفة كبير.
هل تُسجَّل العملية مرتين؟
انقطع الاتصال بعد الإرسال وقبل التأكيد، فأُعيد الإرسال.
الجواب اللازم
معرّف فريد لكل عملية يمنع تسجيلها مرتين مهما تكرر الإرسال. غيابه سبب شائع لفواتير وسندات مكررة يصعب تتبعها لاحقًا.
ماذا لو تغيّر الطرف الآخر؟
النظام الخارجي أصدر تحديثًا غيّر شكل البيانات.
الجواب اللازم
من يتابع تحديثات الطرف الآخر ومن يُبلَّغ. التكامل ليس مشروعًا ينتهي بالتسليم بل التزامًا مستمرًا ما دام الطرفان يتطوران.
من يعرف أنه توقف؟
تكامل تعطّل منذ ستة أيام ولم يلاحظ أحد.
الجواب اللازم
مراقبة وتنبيه على التوقف لا انتظار بلاغ. التكاملات تتعطّل بصمت غالبًا، ويظهر الأثر متأخرًا في صورة بيانات ناقصة لا في رسالة خطأ.
كيف نبني التكامل
خمس مراحل — والأولى ورقية بالكامل
اختر مرحلة لترى ماذا يحدث فيها، وما المخرجات، وما الذي يُقاس عليها.
المراحل
التوصيف
التكامل يُكتب قبل أن يُبرمج
- تحديد مصدر الحقيقةلكل حقل طرف واحد يملكه ويكتبه، والآخر يقرأ — لا طرفان يكتبان
- اتجاه التدفقما الذي يُرسل وما الذي يُستقبل وما الذي يُتبادَل في الاتجاهين
- التوقيت المقبوللحظي أم كل ساعة أم يوميًا — ولكل خيار كلفته وتعقيده
- سلوك الفشلماذا يحدث إن لم يستجب الطرف الآخر: إعادة محاولة، تعليق، أم تنبيه فوري
المخرجات في هذه المرحلة
- وثيقة التكامل
- خريطة الحقول
- قواعد الفشل
يُقاس بـ: الحقول بلا مالك محدد
البناء
الجسر يُبنى بمنطق واضح لا بأنبوب
- مطابقة الحقولربط كل حقل بمقابله مع قواعد التحويل عند اختلاف الصيغ
- التحقق قبل الإرسالرفض السجل الناقص عند المصدر لا اكتشافه عند الوجهة
- معالجة التكرارضمان ألا تُسجَّل العملية الواحدة مرتين إن أُعيد الإرسال
- سجل لكل عملية تبادلما أُرسل ومتى ونتيجته — قابلًا للاستعلام لا للتخمين
المخرجات في هذه المرحلة
- خريطة التحويل
- قواعد التحقق
- سجل التبادل
يُقاس بـ: السجلات المرفوضة · حالات التكرار
الاختبار
بما في ذلك الحالات التي لا تعجبنا
- حالات صحيحةالتحقق من المسار الطبيعي أولًا وبأحجام واقعية
- حالات فاشلة عمدًاقطع الاتصال، إرسال بيانات ناقصة، تجاوز الحدود — ورصد السلوك
- اختبار الحملالتأكد أن التكامل يحتمل ذروة الشهر لا يوم التجربة الهادئ
- مطابقة الطرفينمقارنة عدد وقيمة السجلات في الطرفين بعد كل جولة اختبار
المخرجات في هذه المرحلة
- تقرير الاختبار
- محضر المطابقة
يُقاس بـ: فروقات المطابقة · سلوك حالات الفشل
التشغيل
البدء محدودًا ثم التوسع
- تشغيل تدريجيالبدء بنوع مستند واحد أو فرع واحد قبل التعميم
- تشغيل موازٍإبقاء الطريقة القديمة فترة قصيرة للمقارنة والتأكد
- مطابقة يوميةتقرير يومي بالفروق بين الطرفين في الأسابيع الأولى
- التعميم بعد الثباتالتوسع بعد استقرار المطابقة لا بعد نجاح أول يوم
المخرجات في هذه المرحلة
- خطة التشغيل
- تقرير المطابقة اليومي
يُقاس بـ: أيام بلا فروق قبل التعميم
المراقبة والصيانة
التكامل يتعطّل بصمت
- مراقبة مستمرةمتابعة نجاح التبادل وزمنه وحجم الطلبات المعلّقة
- تنبيه على التوقفإشعار فوري عند فشل متكرر أو تجاوز فارق الوقت المتفق عليه
- متابعة تغيّر الطرف الآخرالأنظمة الخارجية تُحدَّث، وما يعمل اليوم قد يتوقف بعد إصدارها القادم
- مراجعة الجدوىإلغاء أي تكامل لم يعد له مبرر بدل صيانته إلى الأبد
المخرجات في هذه المرحلة
- لوحة حالة التكاملات
- سجل الأعطال
- تقرير المراجعة
يُقاس بـ: زمن اكتشاف التوقف · التكاملات الملغاة
أنماط التكامل
أربعة أنماط… وليس الأحدث دائمًا هو الأنسب
الاختيار بينها ليس تقنيًا بل عمليًا: ما الذي يحتمله الطرف الآخر، وكم فارق الوقت المقبول لديكم.
| النمط | كيف يعمل | مناسب لـ | حدوده |
|---|---|---|---|
| واجهة API لحظية | تبادل مباشر لحظة وقوع العملية | ما يجب أن يظهر فورًا: طلب، دفعة، رصيد | يتطلب توفر الطرفين معًا دائمًا |
| تبادل ملفات مجدول | ملف بيانات يُرسل ويُستقبل على فترات | الأنظمة القديمة والكميات الكبيرة | فارق زمني بحسب الجدولة |
| قاعدة أو طبقة وسيطة | مكان مشترك يكتب فيه طرف ويقرأ منه آخر | تعدد الأطراف أو اختلاف الأوقات | مكوّن إضافي يُصان ويُراقَب |
| استيراد يدوي منظّم | رفع ملف بصيغة محددة مع تحقق قبل الاعتماد | تبادل نادر أو طرف لا يدعم غيره | يحتاج شخصًا — لكنه الأبسط والأوضح |
النمط الرابع غير محبّب في العروض لأنه «يدوي»، ونذكره عمدًا: تبادل يقع مرتين شهريًا
لا يستحق بناء تكامل يُصان طوال العام. استيراد منظّم بتحقق واضح أرخص وأوضح وأسهل تتبعًا —
وترقيته لاحقًا إلى تكامل آلي متاح متى صار متكررًا.
بصراحة
أربعة تكاملات لا ننصح بها
لكل واحد منها بديل أبسط، والإصرار عليه يشتري تعقيدًا دائمًا مقابل فائدة عابرة.
| التكامل | لماذا لا ننصح به | البديل |
|---|---|---|
| كتابة الطرفين على الحقل نفسه | تعارض لا حل نظيفًا له، وأي قاعدة أفضلية تُنتج فقدان تعديلات صامتًا | مالك واحد يكتب والآخر يقرأ |
| ربط مباشر بقاعدة بيانات الطرف الآخر | يتجاوز قواعد النظام وتحققه، ويتعطّل مع أول تحديث بنيوي عندهم | واجهة API أو ملفات متفق عليها |
| تكامل لنقل يقع مرتين شهريًا | كلفة بناء وصيانة دائمة مقابل توفير دقائق معدودة | استيراد منظّم بتحقق |
| مزامنة كل شيء «احتياطًا» | نقل بيانات لا يستخدمها أحد يزيد الحمل وسطح الخطأ ونطاق التسريب | نقل ما يُستخدم فعلًا فقط |
والقاعدة التي نبدأ بها كل نقاش تكامل: ما الذي سيتغير في عمل الناس إن نجح هذا التكامل؟ إن كان الجواب «سيتوقف موظف عن إعادة إدخال بيانات يوميًا» فهو تكامل يستحق. وإن كان «ستصبح البيانات متزامنة» بلا أثر على أحد، فهو تعقيد بلا مستفيد.
أسئلة التكاملات
ما يسأله مدير تقنية المعلومات
نعم، وتُسلَّم موثّقة مع بيئة اختبار مستقلة حتى يجرّب فريقكم أو مزوّدكم الآخر قبل الربط بالتشغيل. ونرى أن المزوّد الذي لا يوثّق واجهاته يجعل كل تكامل مستقبلي يمر به إجباريًا — وهذا قيد لا خاصية.
نعم عبر تبادل ملفات مجدول بصيغة متفق عليها، وهو نمط ناضج ويعمل جيدًا مع الأنظمة القديمة والكميات الكبيرة. الحد الوحيد هو الفارق الزمني بحسب الجدولة، ويُحدَّد معكم مقدمًا.
تُطبَّق قاعدة الفشل المتفق عليها: إعادة محاولة بعدد وفترات محددة، ثم تعليق العملية مع تنبيه للجهة المسؤولة. ولا تُفقد العمليات المعلّقة بل تبقى في طابور قابل للاستعلام وإعادة المعالجة بعد زوال السبب.
بلوحة حالة تعرض آخر تبادل ناجح لكل تكامل وحجم المعلّق، وتنبيه آلي عند التوقف أو تجاوز فارق الوقت. هذا مهم تحديدًا لأن التكاملات تتعطّل بصمت، ويظهر أثرها متأخرًا في صورة بيانات ناقصة لا رسالة خطأ.
يُحدَّد في العقد صراحةً. التكامل التزام مستمر لا مشروع ينتهي بالتسليم، لأن الطرف الآخر يُحدَّث وقد يتغيّر شكل بياناته. وما يبقى بلا مسؤول محدد يُكتشف تعطّله بعد أسابيع.
يعتمد على المنصة المعنية وما تتيحه من قنوات ربط ومتطلبات وصلاحيات، وهي أمور تحددها الجهة صاحبة المنصة وقد تتغيّر. نبني التكامل على المتطلب المعتمد وقتها ونحدّثه عند تغيّره، ونوضح لكم مقدمًا ما هو ممكن وما يحتاج موافقة من الجهة نفسها.
الخطوة التالية
ابدأ بحقل واحد… لا بقائمة أنظمة
أرسل لنا قائمة أنظمتكم القائمة، ونحدد معكم أيّها يستحق التكامل وأيّها يكفيه استيراد منظّم. ونبدأ بالإجابة عن السؤال الذي يحسم نصف المشروع: من يملك كل حقل.
- خريطة حقول بمالك واحد لكل حقل
- قاعدة مكتوبة لسلوك الفشل والتنبيه
- توصية صريحة بما لا يستحق تكاملًا
صفحات ذات صلة انتقل إليها