مقدمة واجهة برمجة التطبيقات لتكامل نظام تعقب مقدم الطلب

  • مقالة

ينطبق على تطبيقات Dynamics 365 هذه:
Human Resources

توضح هذه المقالة واجهة برمجة التطبيقات لتكامل نظام تعقب مقدم الطلب (ATS) في Dynamics 365 Human Resources . وهدف واجهة API هو تمكين عمليات التكامل الانسيابية بين أنظمة ATS في Dynamics 365 Human Resources وأنظمة الشركاء.

سير عمل تكامل نظام ATS.

تبدأ التجربة المتكاملة في الموارد البشرية عندما يقوم مدير التوظيف بإنشاء طلب توظيف. عند تنشيط الطلب، يقوم نظام ATS بسحب تفاصيل الطلب لإنشاء مشروع تعيين. وبعد ذلك يتبع مسار التوظيف لتحديد مرشح للمنصب (المناصب) وتوظيفه. وأخيرا، يكمل نظام ATS رحلة التكامل الكاملة عن طريق إرسال سجل المرشح المحدد إلى الموارد البشرية. يمكن أن يمر سجل الترشيح بعد ذلك بمزيد من عمليات التحقق من الصحة ومهام سير العمل لإنشاء سجل الموظف.

لتمكين التكامل، أضافت الموارد البشرية المكونات التالية:

  1. وظيفة لإنشاء طلب التوظيف.
  2. ملف تعريف مرشح والسير العمل المرتبط.
  3. تفتح واجهة API للتكامل الوظائف الجديدة لتكامل الطلبات.

لمزيد من المعلومات حول إعداد طلب التعيين ووظيفة المرشح واستخدامها، راجع توظيف المرشحين لوظيفة.

Microsoft Dataverse

تأتي واجهة API مدمجة في Microsoft Dataverse (المعروف سابقًا بـ Common Data Service). وتجري كافة أشكال تفاعل RESTful مع واجهة API هذه عن طريق واجهة ويب Microsoft Dataverse، التي تستخدم OData. تعد واجهة API هذه مجموعة فرعية من واجهة ويب Dataverse. تحدد واجهة ويب Dataverse خصائص مثل المصادقة واتفاقيات SLA و, الدفعة والتحكم في التزامن ومعالجة الأخطاء.

لمزيد من المعلومات عن واجهة ويب Microsoft Dataverse، راجع:

تتضمن الوثائق الواردة أعلاه تفاصيل وإرشادات للمطور حول استخدام واجهة API الويب Dataverse، مثل إدارة المصادقة وتنفيذ العمليات واستخدام تعقب التغييرات أو رموز دلتا مع واجهة API.

مجموعات الخيار

يتضمن نموذج البيانات لواجهة API لتكامل نظام ATS الموضح في هذا المستند مجموعات الخيارات التي توفر قيمًا عددية مقترنة بخصائص الوحدة. للحصول على تفاصيل حول العمل مع مجموعات الخيارات في واجهة ويب Dataverse، راجع إنشاء وتحديث مجموعات الخيارات باستخدام واجهة الويب. يتم تحديد مجموعات الخيارات لكل بيئة من بيئات Dataverse.

الجداول الظاهرية للموارد البشرية في Dataverse

تستخدم نقاط النهاية لواجهات API لتكامل نظام ATS قدرات النظام الأساسي في الجدول الظاهري لـ Microsoft Dataverse. بشكل افتراضي، لا يتم نشر الجداول الظاهرية ونقاط نهاية واجهات API المقترنة بها لبيئات الموارد البشرية، مما يتيح للمؤسسات تحديد نقاط نهاية OData التي سيتم عرضها للبيئة. لاستخدام واجهة API، يجب إنشاء الجداول الظاهرية لكيانات الموارد البشرية للبيئة.

للحصول على معلومات حول إنشاء الجداول الظاهرية لواجهة API، راجع تكوين الجداول الظاهرية في Dataverse.

نموذج البيانات

يتم توسيط نموذج البيانات حول وحدتين رئيسيتين:

  • يمثل RecruitingRequest طلبًا إلى ATS لتوظيف شخص لأحد المناصب المفتوحة أو أكثر. لمطالعة مثال استعلام، راجع مثال استعلام طلب توظيف.
  • يمثل CandidateToHire تفاصيل المرشح الذي قبل العرض الخاص بالمنصب. يمثل الشخص الفرد الذي سيكو المرشح. يمكن أن يكون لأحد الأشخاص أدوار متعددة في الشركة، مثل المرشح أو العامل أو الموظف أو المقاول. للاطلاع على مثال للاستعلام ، راجع مثال الاستعلام عن المرشح المراد توظيفه.

يوضح المخطط التالي العلاقات داخل API. تحتوي العديد من الأنواع على مفاتيح خارجية لكيانات أخرى موجودة مسبقا في الموارد البشرية لم يتم توضيحها هنا. يوفر هذا المستند معلومات حول الكيانات الخاصة بسيناريوهات تكامل التعيين. ومع ذلك، هناك العديد من الكيانات الأخرى في واجهة ويب Dataverse لـ Dynamics 365 Human Resources يمكن أن تكون مرتبطة أيضًا بالتكامل الخاص بك. على سبيل المثال، قد تحتاج أيضا إلى تفصيل العاملين أو الوظائف أو المناصب أو الكيانات الأخرى غير المحددة. تجري الاشارة إلى العديد من هذه الكيانات في علاقات المفاتيح الخارجية أو خصائص التنقل.

نموذج بيانات واجهة API لتكامل ATS.

مثال الاستعلام:

الكيانات:

مجموعات الخيارات:

مثال الاستعلام:

الكيانات:

مجموعات الخيارات:

راجع أيضًا

تعيين المرشحين للوظائف
ما هو Microsoft Dataverse؟
استخدام واجهة ويب Microsoft Dataverse
إنشاء مجموعات الخيارات وتحديثها باستخدام واجهة الويب