تربط صفحة الإعدادات ← التكاملات جاديرون بالأنظمة الأخرى. كل من يفتح الصفحة يرى بطاقة Google Meet الشخصية. ويرى مدير مساحة العمل أيضًا قسم الواجهات البرمجية وخطافات الويب، ومنه تُربط بمساحة العمل أنظمة تخطيط الموارد أو الموارد البشرية أو أدوات المراقبة الأمنية.
أين تجدونها
الإعدادات ← التكاملات (/{slug}/app/settings/integrations).
- تظهر بطاقة Google Meet للأدوار التي تملك صلاحية إدارة التكاملات (ضمن الإعدادات والتكاملات).
- يظهر قسم الواجهات البرمجية وخطافات الويب لدور مدير مساحة العمل المقفل وحده، وهو يسجّل الدخول دائمًا بالتحقق بخطوتين. ولا تراه الأدوار الأخرى، حتى التي تملك صلاحية إدارة التكاملات.
Google Meet
اربطوا حساب Google الخاص بكم ليُنشأ رابط Google Meet تلقائيًا عند تأكيد المقابلة. تعرض البطاقة حساب Google المرتبط، ويزيله زر فصل. والربط شخصي: يربط كل من يجري المقابلات حسابه.
الواجهات البرمجية وخطافات الويب
التكامل نظام خارجي واحد، مثل «Oracle HCM - الإنتاج». لكل تكامل:
- صلاحيات خاصة به؛
- مفتاح API واحد أو أكثر، يستدعي بها النظام واجهة جاديرون البرمجية؛
- نقاط استقبال لخطافات الويب، يرسل إليها جاديرون حدثًا عند تغيّر البيانات.
ويُسجَّل كل ما يفعله التكامل في سجل التدقيق باسم تكامل · الاسم.
تأتي مساحات العمل المجهّزة ببيانات نموذجية مع تكامل ERP (demo) لتتعرف على الشاشة: مفتاح (قيمته غير قابلة للاستخدام)، ونقطة استقبال موقوفة مؤقتًا مع عدد من التسليمات الناجحة والجاري إعادتها والفاشلة، ومهمة إدراج مجمّع مكتملة فيها صفان فاشلان، وخمسة موظفين مربوطين بمعرّفات erp-demo.
تعرض القائمة حالة كل تكامل (نشط أو موقوف)، وعدد صلاحياته ومفاتيحه النشطة ونقاط الاستقبال، ووقت آخر استخدام لأحد مفاتيحه. ويطلب زر تكامل جديد اسمًا ووصفًا اختياريًا. افتحوا التكامل لإدارته من أربعة تبويبات.
الوصول
- التفاصيل: تغيير اسم التكامل أو وصفه.
- الصلاحيات: المصفوفة نفسها المستخدمة في الأدوار والصلاحيات: العرض والتنفيذ لكل وحدة، إضافة إلى الصلاحيات المسمّاة. يقرأ التكامل ويكتب بهذه الصلاحيات تمامًا، وبالقواعد نفسها التي تنطبق على من يستخدم المنصة. ونطاق بياناته دائمًا كامل مساحة العمل. فمثلًا، دون صلاحية عرض بيانات التواصل للمرشحين تظهر له عناوين البريد وأرقام الجوال مخفية، ودون صلاحية تعيين المرشحين لا يستطيع التعيين. وتتيح له صلاحية العرض في سجل التدقيق قراءة سجل التدقيق والاشتراك في حدثه على خطافات الويب. وإزالة صلاحية تُسقط أيضًا رسائل خطافات الويب التي ما زالت تنتظر الإرسال إلى نقاطه (تظهر فشلت مع
scope changed)، لأنها أُعدّت بالصلاحيات القديمة. أعيدوا القراءة معupdatedSinceلتعويضها. - قائمة عناوين IP المسموحة: عنوان IP أو نطاق CIDR في كل سطر (مثل
203.0.113.10أو10.20.0.0/16). إذا كانت القائمة غير فارغة، تُرفض الطلبات القادمة من أي عنوان آخر. اتركوها فارغة للسماح بأي عنوان. ويُشار تحت الحقل إلى أي عنوان غير صالح أو نطاق/0، ولا يُحفظ شيء. - الحالة: يرفض إيقاف التكامل طلبات كل مفاتيحه ويؤجل رسائل خطافات الويب حتى تستأنفوه، دون حذف شيء.
- حذف التكامل: بعد التأكيد يُحذف التكامل مع مفاتيحه ونقاط الاستقبال وسجل التسليم والمهام المجمّعة، ويتوقف النظام المرتبط عن العمل فورًا.
مفاتيح API
يطلب زر مفتاح جديد اسمًا (مثل «خادم المزامنة») وتاريخ انتهاء اختياريًا. ويتوقف المفتاح عن العمل في نهاية ذلك اليوم.
تعرض القائمة اسم كل مفتاح وبادئته (مثل jdr_live_t7Q…)، ووقت إنشائه وآخر استخدام له، وتاريخ انتهائه، وحالته: نشط أو منتهٍ أو ملغى. ويطلب إلغاء المفتاح تأكيدًا، وبعده يُرفض كل طلب يحمل ذلك المفتاح. ولا يمكن التراجع عن الإلغاء.
تدوير المفتاح: أصدروا مفتاحًا جديدًا، وانقلوا نظامكم إليه، ثم ألغوا القديم. ويمكن أن يملك التكامل عدة مفاتيح نشطة في الوقت نفسه، فلا يتوقف العمل.
خطافات الويب
يطلب زر إضافة نقطة استقبال:
- رابط نقطة الاستقبال: عنوان
httpsعام في نظامكم يستقبل طلباتPOSTبصيغة JSON. وتُرفض العناوين الخاصة والداخلية والمحلية. - الأحداث:
- كل أحداث الموارد يشمل كل أحداث الموارد، ومنها ما يُضاف لاحقًا، ولا يشمل سجل التدقيق.
- أحداث محددة يتيح اختيار الأحداث مجمّعة حسب المورد (الوحدات التنظيمية، والوظائف، والموظفين، والمرشحين، والطلبات، وغيرها). وإذا كان التكامل لا يستطيع قراءة مورد ما، تظهر مجموعته باهتة مع ملاحظة: لن تُرسل أحداثه، فامنحوا التكامل صلاحية العرض في ذلك المورد أولًا.
- سجل التدقيق (
audit.recorded) مدرج على حدة وغير مختار افتراضيًا. يرسل كل قيد في سجل التدقيق حدثًا مستقلًا، لأنظمة المراقبة الأمنية (SIEM). ولا يمكن اختياره إلا إذا ملك التكامل صلاحية العرض في سجل التدقيق.
وعند إضافة النقطة يظهر سر التوقيع لتنسخوه إلى نظامكم.
تعرض بطاقة كل نقطة استقبال رابطها وحالتها (نشطة أو موقوفة أو معطّلة) وأحداثها، مع هذه الإجراءات:
- إرسال حدث تجريبي: يرسل حدث
pingفورًا ويخبركم إن قبله نظامكم. ويتطلب أن تكون النقطة والتكامل نشطين. - تعديل: تغيير الرابط أو الأحداث.
- إيقاف / استئناف: أثناء الإيقاف لا تُرسل الأحداث الجديدة ولا تُحفظ لوقت لاحق، أما الرسائل التي تنتظر التسليم أصلًا فتُعلَّق وتُعاد محاولتها حين تعود النقطة نشطة.
- حذف: يطلب تأكيدًا، ثم يحذف النقطة وسجل تسليمها.
- السر وسجل التسليم: يفتح سر التوقيع وسجل التسليم (أدناه).
سر التوقيع: تحمل كل رسالة ترويسة Jadiroon-Signature موقّعة بهذا السر (HMAC-SHA256)، وينبغي أن يتحقق نظامكم منها قبل قبول الرسالة. يُظهر زر إظهار السر مع زر نسخ. وينشئ تدوير السر سرًا جديدًا بعد التأكيد. ويبقى السر القديم صالحًا 24 ساعة، وتحمل الرسائل خلالها التوقيعين معًا، فلديكم يوم كامل لتحديث نظامكم. وتعرض البطاقة وقت انتهاء هذه المدة. ولا يمكن التدوير مجددًا قبل انتهائها (فالتدوير الثاني يُسقط السر الأول قبل أن ينتقل إليه نظامكم).
الفشل والتعطيل التلقائي: الرسالة التي لا يقبلها نظامكم باستجابة 2xx تُعاد محاولتها على فترات متزايدة حتى 3 أيام. وما دام التسليم يفشل، تعرض البطاقة ملاحظة «يفشل التسليم منذ». وبعد 3 أيام من الفشل المتواصل تُعطَّل النقطة ويُبلَّغ مديرو مساحة العمل. أصلحوا نظام الاستقبال، ثم استخدموا إعادة التفعيل.
وإذا كانت النقطة مشتركة في سجل التدقيق لكن التكامل فقد صلاحية العرض في سجل التدقيق، تنبّه البطاقة إلى ذلك: لا يُرسل شيء من سجل التدقيق. أعيدوا الصلاحية من تبويب الوصول، أو عدّلوا النقطة لإزالة الحدث.
سجل التسليم: الرسائل الأحدث أولًا، 50 في كل مرة، مع التصفية حسب الحالة:
- نجحت: قبلها نظامكم.
- بانتظار المحاولة: تنتظر محاولتها التالية (إعادة المحاولة بعد فشل).
- فشلت: حدث تجريبي لم يُقبل، أو رسالة كانت تنتظر التسليم وأُسقطت لأن صلاحيات التكامل أو أحداث النقطة ضاقت (تظهر الاستجابة
scope changed). - توقفت المحاولات: لم تبقَ محاولات.
ويعرض كل صف نوع الحدث ومعرّفه، وعدد المحاولات، وآخر رمز استجابة من نظامكم، والمدة، والمحاولة التالية. افتحوا الصف لتروا أول 500 حرف من استجابة نظامكم. ويرسل إعادة الإرسال الحدث مجددًا فورًا في صف جديد، بصلاحيات التكامل الحالية؛ ويتطلب أن تكون النقطة والتكامل نشطين، ويُرفض إن لم تعد النقطة مشتركة في هذا الحدث أو لم يعد التكامل يملك صلاحية رؤيته. ويُحتفظ بالرسائل 30 يومًا.
المهام المجمّعة
قائمة للاطلاع فقط بمهام الإدراج المجمّع التي أرسلها هذا التكامل: المورد، والحالة (في الانتظار أو قيد التنفيذ أو اكتملت أو فشلت)، والتقدّم، وعدد الصفوف الناجحة والفاشلة، وبادئة المفتاح المستخدم، ووقت الإرسال والانتهاء. ويفتح زر النتائج نتيجة كل صف. تظهر الصفوف الفاشلة أولًا مع رمز الخطأ ورسالته. ورقم الصف 0 هو أول صف في الطلب. وتُحفظ نتائج الصفوف 7 أيام.
التدقيق
يُسجَّل كل تغيير في هذه الصفحة في سجل التدقيق: إنشاء التكامل وتعديله وإيقافه وحذفه، وتغيير الصلاحيات (مع ما أضيف وما أزيل)، وإصدار المفاتيح وإلغاؤها، وتغيير نقاط الاستقبال، وتدوير الأسرار وإظهارها، والأحداث التجريبية وإعادة الإرسال. أما المفاتيح والأسرار نفسها فلا تُكتب في السجل أبدًا.