اكتب كل تكامل كبطاقة مستقلة من عشرة حقول: الغرض، والاتجاه، والمحفّز، والبيانات بمصدر كل حقل، والتوقيت، وما يحدث عند الفشل، والمطابقة، والأمان، والمسؤوليات على كل طرف بما فيها مورّد النظام الآخر، ثم حالات القبول وما هو خارج النطاق.
بند مثل «ربط مع نظام الصيانة» يقبله الجميع ولا يلزم أحدًا بشيء. البطاقة تجعل البند قابلًا للاختبار قبل الدفع.
مشكلة بند السطر الواحد
في العروض يُكتب التكامل غالبًا بسطر: «ربط مع نظام الصيانة»، أو «تكامل مع نظام المستودعات لقراءة أوامر التوريد». يوافق الطرفان على السطر لأن كلًا منهما يتخيله بطريقته. ثم يبدأ التنفيذ فتظهر الأسئلة: هل يُنشئ نظام الصيانة الزيارة أم يتحقق نظام الزوار من الأمر فقط؟ ماذا لو أُلغي أمر العمل بعد اعتماد الزيارة؟ من يطلب من مورّد نظام الصيانة فتح الواجهة؟
صفحة التكامل تشرح فئات التكامل ومنهجية تقييم التوافق قبل أي وعد: حصر الموجود، وفحص الواجهة، وشروط البيئة، ونتيجة مكتوبة. هذا المقال يأخذ الخطوة التالية: كيف تتحول النتيجة «ممكن» أو «ممكن بشروط» إلى بند يعرف كل طرف ما عليه فيه.
بطاقة التكامل: عشرة حقول
بطاقة تكامل واحدة لكل ربط
المثال في العمود الأخير لتكامل افتراضي مع نظام صيانة؛ استبدله بما يخصك. بطاقة لكل تكامل، حتى لو كان النظام الآخر واحدًا والتبادل في اتجاهين.
| الحقل | السؤال الذي يجيب عنه | مثال |
|---|---|---|
| ١. الغرض التشغيلي | ما المشكلة التي يحلها الربط لو نجح؟ | ألا يُعاد إدخال زيارات المقاولين يدويًا من أوامر العمل |
| ٢. الاتجاه | من يرسل ومن يستقبل؟ | نظام الصيانة ← نظام الزوار (إنشاء طلب)، ونظام الزوار ← نظام الصيانة (حالة الدخول والخروج) |
| ٣. المحفّز | ما الحدث الذي يطلق التبادل؟ | اعتماد أمر عمل يحتاج مقاولًا خارجيًا في منطقة محددة |
| ٤. البيانات | أي حقول، وما مصدر كل حقل؟ | رقم الأمر، الشركة، المنطقة، التاريخ المتوقع — من نظام الصيانة؛ الأفراد ووثائقهم — من نظام الزوار |
| ٥. التوقيت | فوري، أم دوري، أم عند الطلب؟ وما التأخير المقبول؟ | عند اعتماد الأمر، ويُقبل تأخير دقائق |
| ٦. السلوك عند الفشل | ماذا يحدث إن لم يصل التبادل أو وصل ناقصًا؟ | يبقى أمر العمل دون طلب زيارة، ويُنبّه مسؤول النظام، ويمكن إنشاء الطلب يدويًا بالمرجع |
| ٧. المطابقة | كيف نكتشف ما فات؟ | تقرير يومي بأوامر العمل المعتمدة التي لا تقابلها زيارة |
| ٨. الأمان | كيف يتعرف كل طرف على الآخر، وما الصلاحية، وأين السجل؟ | مفتاح مخصص للتكامل بصلاحية إنشاء الطلبات فقط، وسجل استخدام |
| ٩. المسؤوليات | ما على مورّد نظام الزوار، وما على تقنية المعلومات، وما على مورّد النظام الآخر؟ | الواجهة من الطرفين، فتح المسار الشبكي، توثيق واجهة نظام الصيانة وإتاحتها |
| ١٠. القبول وخارج النطاق | ما الحالات التي تثبت النجاح، وما الذي لا يشمله البند؟ | ست حالات قبول؛ لا يشمل إصدار تصاريح العمل ولا تقييم محتواها |
أضف أسفل البطاقة سطر الافتراضات المعلنة: ما يعتمد على طرف ثالث — توثيق واجهة، أو ترخيص، أو ترقية إصدار — وما يحدث للبند إن لم يتحقق الافتراض.
مصدر الحقيقة لكل حقل
أكثر مشكلات التكامل لا تظهر في يوم التشغيل، بل بعد أشهر: اسم شركة مقاولة مكتوب بطريقتين في نظامين، أو فرد أُوقف في أحدهما وبقي معتمدًا في الآخر. السبب أن أحدًا لم يقرر أي نظام يملك الحقل.
- لكل حقل مالك واحد. يُعدَّل هناك فقط، ويُقرأ في الطرف الآخر.
- ملف الشركة المقاولة وأفرادها ووثائقهم — غالبًا في نظام الزوار، لأنه يدير صلاحيتها ودورة حياة الوثائق.
- أمر العمل ونطاقه وتصريح العمل — في نظام الصيانة أو التصاريح، ونظام الزوار يحمل المرجع فقط.
- الموظفون والأقسام — في الدليل المؤسسي، ونظام الزوار يقرأ المضيفين والأدوار منه عند الربط.
- المعرّف المشترك — اتفق على الحقل الذي يربط السجلين: رقم الأمر، أو رقم سجل الشركة لديكم، لا الاسم.
حين يفشل التبادل
التكامل الذي يُختبر على الحالة السعيدة فقط سينجح في الاختبار ويتعثر في الشهر الأول. اكتب السلوك المتوقع في كل حالة من هذه قبل التنفيذ:
| الحالة | السلوك الذي يُتفق عليه |
|---|---|
| النظام الآخر متوقف | هل يُعاد المحاولة؟ لكم مرة؟ ومن يُنبَّه؟ وهل يستمر العمل اليدوي بالمرجع؟ |
| بيانات ناقصة أو غير صالحة | يُرفض التبادل بسبب مسجّل، أم يُنشأ طلب ناقص يُستكمل يدويًا؟ |
| تكرار الإرسال | كيف يُمنع إنشاء طلبين لأمر عمل واحد؟ |
| إلغاء أو تعديل في المصدر | أمر عمل أُلغي بعد اعتماد الزيارة: تُلغى الزيارة آليًا، أم يُنبَّه صاحب القرار فقط؟ |
| تعارض بين النظامين | أي النظامين يغلب في كل حقل — بحسب مصدر الحقيقة أعلاه |
| انقطاع طويل | كيف تُطابق الفجوة بعد العودة، ومن يراجع النتيجة؟ |
أقصى ما يفعله التكامل أن يُشترط وجود مرجع أمر عمل أو تصريح عمل ساري قبل إصدار تصريح الدخول، أو أن يُقرأ سريانه. إصدار تصريح العمل وتقييم محتواه الفني يبقى بالكامل في إجراء التصاريح لديكم.
اختبارات قبول التكامل
كل تكامل له قبول مستقل عن قبول النظام نفسه، يُنفَّذ بعد أن يعمل الإجراء يدويًا. ست حالات تكفي لأغلب البطاقات:
- الحالة السعيدةالمحفّز يُطلق التبادل، والبيانات تصل كاملة، وتظهر في الطرف الآخر خلال التأخير المقبول.
- بيانات ناقصةيحدث السلوك المتفق عليه تمامًا، ويُسجَّل السبب.
- التكرارإرسال الحدث مرتين لا ينتج سجلين.
- الإلغاء في المصدريحدث في الطرف الآخر ما نصت عليه البطاقة.
- توقف الطرف الآخر ثم عودتهيعمل البديل اليدوي، وتظهر الفجوة في تقرير المطابقة، وتُعالج.
- الصلاحيةمفتاح التكامل لا يستطيع ما يتجاوز نطاقه، وكل استدعاء في السجل.
أضف هذه الحالات إلى حالات اختبار القبول كقسم مستقل لكل تكامل، ولا تربط قبول الإجراء الأساسي بها.
مثال: أمر عمل ينشئ زيارة
من سطر في العرض إلى بطاقة قابلة للاختبار
مثال توضيحيمنشأة تريد «ربط نظام الزوار بنظام الصيانة». نظام الصيانة يوفر واجهة موثقة بحسب نتيجة تقييم التوافق.
- السطر الأصلي«تكامل مع نظام الصيانة». وافق عليه المورّد ومالك نظام الصيانة، وكل منهما يتخيل شيئًا آخر.
- جلسة البطاقةيتضح أن الحاجة الفعلية هي زيارات المقاولين المرتبطة بأوامر عمل خارجية فقط، لا كل أوامر العمل. فيُكتب المحفّز: أمر عمل معتمد بنوع «مقاول خارجي».
- السؤال الذي لم يُطرحماذا لو أُلغي الأمر بعد اعتماد الزيارة؟ يقرر الأمن ألا تُلغى الزيارة آليًا، بل يُنبَّه صاحب الاعتماد ليقرر — لأن بعض الفرق تدخل لأكثر من أمر.
- المسؤولياتتُكتب مسؤولية مورّد نظام الصيانة عن إتاحة الواجهة وتوثيقها كافتراض معلن، مع ما يحدث إن تأخرت: يعمل الإجراء يدويًا بالمرجع، ويُؤجَّل التكامل.
- القبولست حالات تُنفَّذ بعد شهر من تشغيل الإجراء يدويًا. تفشل حالة التكرار في المرة الأولى، وتُعالج قبل التوقيع.
أسئلة قبل الموافقة على البند
- هل يستند البند إلى نتيجة تقييم توافق مكتوبة، أم إلى «سندرسه لاحقًا»؟
- هل لكل تكامل بطاقة مستقلة بالحقول العشرة؟
- ما الافتراضات التي تعتمد على مورّد النظام الآخر، وما البديل إن لم تتحقق؟
- هل يُسعَّر التكامل مستقلًا عن التهيئة، بحيث يمكن تأجيله دون إعادة التسعير كله؟
- هل يعمل الإجراء كاملًا دون التكامل، فلا يتوقف التشغيل على نجاحه؟
- من يصون التكامل عند تحديث أحد النظامين، وعلى حساب من؟
السؤال الخامس هو الأهم. بنود العقد تحمي التشغيل، لكن التصميم الذي يجعل الإجراء مستقلًا عن التكامل يحميه أكثر.
أسئلة متكررة
غالبًا نعم. التشغيل أولًا يكشف أي تكامل يستحق فعلًا، ويجعل البطاقة مبنية على حركة حقيقية. الاستثناء: الدليل المؤسسي للدخول الموحد إن كانت سياسة تقنية المعلومات تشترطه من اليوم الأول.
تقنية المعلومات ومالك النظام الآخر مع مورّد نظام الزوار في جلسة واحدة. المورّد وحده يعرف نظامه لا نظامكم، وأنتم وحدكم لا تعرفون ما يتيحه نظامه.
يحدث، وخصوصًا مع أنظمة قديمة. لذلك يُكتب كافتراض معلن لا كوعد. البدائل: ربط جزئي، أو وسيط إن سمحت البيئة، أو التشغيل بالمرجع اليدوي — وهي خيارات تشرحها صفحة التكامل.
نعم، ولو مختصرة: القناة الرسمية باسم المنشأة، ومن يتعاقد مع مشغّل الرسائل، والنصوص المعتمدة، وما يحدث إن تعذّر الإرسال. الإشعار الذي لا يصل دون أن يعلم أحد أسوأ من غياب الإشعار.