تعريف الخدمات

الاستخدام

تُستخدم الشاشة لتعريف وتفصيل الخدمات الإلكترونية المحددة التي ترغب المنشأة في تفعيلها عبر المنصات الخارجية (مثل خدمة إصدار أو تجديد الإقامة)، حيث يتم هنا تعريف الخدمات التابعة للمنصات التي سبق إنشاؤها في شاشة “تعريف المنصة”، تهدف هذه الشاشة إلى بناء القواعد الفنية لكل خدمة على حدة، من خلال ربط مسار البرمجة(API) وتحديد الحقول المطلوب سحب بياناتها آلياً من النظام وتوجيهها إلى الخدمة المحددة داخل المنصة المعنية، مما يضمن تنفيذ المعاملات بسرعة ودقة دون الحاجة لإعادة إدخال البيانات يدوياً، وهي الخدمات التي ستظهر لاحقاً في شاشة “خدمات المنصة” ليتمكن المستخدم من طلبها وتنفيذها للموظفين.

طريقة استخدام الشاشة

تستخدم الشاشة بعد النقر على زر إضافة سجل جديد على النحو التالي:

أولاً: البيانات الرئيسية

• المنصة: يُستخدم لاختيار المنصة التي تتبع لها الخدمة والتي تم تعريفها مسبقًا في شاشة “تعريف المنصة”، مثل منصة مقيم.
• الرقم: يظهر رقم تسلسلي آليًا، قابل للتعديل، مع مراعاة عدم تكراره لنفس المنصة.
• اسم الخدمة / الاسم الأجنبي: يُستخدم هذان الحقلان لتدوين اسم الخدمة المراد تفعيلها (مثل: إصدار إقامة) باللغة الافتراضية للنظام (إجباري) وباللغة الأجنبية (اختياري).
• رمز الخدمة: يُستخدم لإدخال الرمز البرمجي الخاص بالخدمة كما هو معرف لدى المنصة الخارجية (مثل الرمز Iqama_Issue”” المخصص لخدمة إصدار الإقامة)، يجب كتابة هذا الرمز بدقة تامة كما هو محدد في وثائق المنصة، وذلك لضمان نجاح الاتصال بالخدمة المطلوبة وتوجيه الطلب إلى الإجراء الصحيح.
• واجهة برمجة التطبيقات (API): يُستخدم لإدخال “المسار التقني” الخاص بالخدمة المحددة (Endpoint Path)، وهو العنوان الفرعي الذي يوجه النظام للوصول إلى الوظيفة المطلوبة داخل المنصة الخارجية (مثل المسار المخصص لخدمة تجديد الإقامة)، يضمن هذا الرابط تكامل البيانات وتنفيذ الخدمة بشكل آلي وسريع من خلال قناة اتصال برمجية مباشرة بين النظامين.
• الترتيب: يُستخدم لتحديد التسلسل الرقمي لظهور هذه الخدمة ضمن قائمة الخدمات الأخرى في شاشة “خدمات المنصة”، مما يسهل على المستخدم الوصول إلى الخدمات الأكثر استخداماً بشكل أسرع وأكثر تنظيماً.

ثانياً: البيانات التفصيلية

يُستخدم هذا التبويب لربط حقول النظام بالحقول المقابلة لها في المنصة الخارجية، لضمان سحب بيانات الموظفين تلقائياً وإرسالها إلى مكانها الصحيح، ويتم التعامل مع حقوله كالتالي:

• #: يظهر الحقل رقمًا تسلسليًا آليًا غير قابل للتعديل.
• اسم المتغير: يُستخدم لاختيار مسمى الحقل المعتمد داخل النظام (مثل: رقم الحدود، الاسم الأول، مدينة الإصدار، الخ)، وهي الحقول التي تُمثل مصدر البيانات الفعلي من بيانات الموظفين والتي سيتم إرسال قيمها إلى المنصة الخارجية ضمن طلبات التكامل.
• القيمة في المنصة: يُستخدم لإدخال المسمى البرمجي للمتغير كما هو مُعرَّف في وثائق التكامل الخاصة بالمنصة الخارجية (مثل Border No أو FirstName)، ويُعد هذا المسمى هو المفتاح الذي يوجّه النظام لإرسال البيانات إلى الحقل الصحيح داخل المنصة، بما يضمن نجاح عملية الربط وتنفيذ الخدمة دون أخطاء.
• حفظ: بعد الانتهاء من إدخال البيانات يتم حفظ البيانات بالنقر على زر حفظ.