مزامنة الأشخاص من Workday
اطلب من مسؤول Workday نشر تقرير مخصص كخدمة ويب، واربطه بمستخدم نظام تكامل (ISU)، ويُبقي Polzy أعضاءك محدَّثين منه.
في هذه الصفحة
يقرأ Polzy من Workday عبر تقرير مخصص واحد يبنيه مسؤول Workday لديك وينشره كخدمة ويب — ويُسمّى غالبًا Report as a Service أو RaaS. كل صف في التقرير يمثّل شخصًا واحدًا. تنضم الصفوف الجديدة كأعضاء في مساحة العمل، وتنتقل التغييرات مع المزامنة التالية، ويتوقف من يصفه التقرير بأنه غير نشط عن تلقي الاستبيانات. أنت تختار أعمدة التقرير، فتحدّد بالضبط ما يستطيع Polzy قراءته.
مزامنة الأشخاص متاحة في خطة Team وما فوقها، ولا يستطيع ربط مصدر إلا مسؤولو مساحة العمل. يقرأ Polzy التقرير فقط: لا يكتب في Workday أبدًا.
قبل أن تبدأ
تحتاج إلى:
- أن تكون مسؤولًا في مساحة عمل Polzy، على خطة Team أو أعلى، مع تفعيل مزامنة الأشخاص من الإعدادات ← عام ← ما تقوم به مساحة العمل هذه.
- مسؤول في Workday يستطيع إنشاء integration system user ومجموعة أمان وتقرير مخصص. توثيق Workday لهذه المهام موجود في Workday Community، ويتطلب تسجيل الدخول إلى Workday.
- أن تكون الحقول التي تريد تجميع النتائج حسبها، مثل القسم أو الموقع، مضافة في Polzy.
تتزامن مساحة العمل من مصدر واحد في كل مرة. إذا كان هناك مصدر آخر مربوط، فافصله أولًا. وإذا كانت مؤسستك تزوّد الأشخاص عبر SCIM، فلا يمكن ربط أي مصدر إطلاقًا — راجع SCIM.
بناء التقرير في Workday
يتولى مسؤول Workday هذا الجزء.
- أنشئ integration system user لـ Polzy (عبر المهمة Create Integration System User)، بكلمة مرور قوية لا تنتهي صلاحيتها دون تنبيه.
- أضفه إلى integration system security group يمكنها رؤية الموظفين والحقول التي يعرضها التقرير.
- أنشئ تقريرًا مخصصًا للموظفين (workers) من النوع Advanced، وحدّد Enable As Web Service.
- أضف عمودًا لكل حقل، بالأسماء التي يتوقعها Polzy:
EmailوFirst_NameوLast_NameوEmployee_IDوActiveوManager_EmailوDepartmentوBusiness_TitleوLocation. تعمل الأسماء الأخرى أيضًا، لكنك تربطها حينها في Polzy. - ضمّن الموظفين الذين غادروا مؤخرًا، مع ضبط
Activeعلى 0 لهم، ليعرف Polzy أنهم غادروا. - شارك التقرير مع الـ integration system user.
- من إجراءات التقرير، اختر Web Service → View URLs وانسخ عنوان JSON. يبدو مثل
https://wd2-impl-services1.workday.com/ccx/service/customreport2/acme/ISU_Polzy/Polzy_Workers.
اختبر أولًا في tenant التنفيذ (implementation): فكل تقرير في Workday خاص بالـ tenant الذي أُنشئ فيه، ويجب بناؤه من جديد في بيئة الإنتاج.
ربط Workday في Polzy
- افتح جهات الاتصال ← المزامنة والحقول.
- ضمن المصادر المتاحة، ابحث عن Workday واختر ربط. تُفتح لوحة من ثلاث خطوات: الاتصال وإعدادات المزامنة وربط الحقول.
- الصق عنوان التقرير في عنوان URL لخدمة الويب الخاصة بالتقرير، وأدخل اسم الـ integration system user وكلمة مروره في اسم مستخدم API وكلمة مرور API.
- اختر اختبار الاتصال. يقرأ Polzy التقرير: تعني رسالة Connected. The report returned data. أن كل شيء يعمل، وتعني Connected, but the report returned no rows. أن المستخدم لا يرى أي موظف.
- اختر التالي، وراجع إعدادات المزامنة (انظر أدناه)، ثم اختر التالي مرة أخرى.
- في ربط الحقول، أبقِ الربط الافتراضي أو فعّل تخطيط الحقول المخصص (انظر أدناه)، ثم اختر ربط.
يطلب Polzy التقرير بصيغة JSON، لذا يعمل العنوان مع ?format=json في آخره أو بدونها. تُخزَّن كلمة المرور مشفّرة ولا تُستخدم إلا لقراءة التقرير.
إعدادات المزامنة
| الإعداد | ماذا يفعل | الافتراضي |
|---|---|---|
| تكرار المزامنة | عدد مرات قراءة Polzy للتقرير: كل ساعة، أو كل 4 ساعات، أو مرتين يوميًا، أو يوميًا. يحدّ Workday من عدد مرات استدعاء خدمات الويب لديه، لذا فإن كل 4 ساعات أو يوميًا هو الأفضل. | كل 4 ساعات |
| تعطيل الموظفين الذين انتهت خدمتهم | مخصص للأشخاص الذين يختفون من التقرير. لا أثر له حاليًا مع Workday: راجع عندما يغادر أحدهم. | مفعّل |
| إرسال رسائل دعوة عبر البريد الإلكتروني | يتلقى الأعضاء الجدد الذين لديهم بريد إلكتروني دعوة لتسجيل الدخول إلى Polzy. | مفعّل |
| الدور الافتراضي | الدور الذي يحصل عليه الأعضاء الجدد: مُشاهد أو محرّر أو مسؤول. ينطبق فقط على من تنشئهم المزامنة. | مُشاهد |
| جلب معلومات الاتصال وجلب بيانات المؤسسة وجلب بيانات التوظيف | لا أثر لها: كل ما يقرأه Polzy يأتي من أعمدة التقرير. | مفعّل |
| حفظ البيانات الخام | يحتفظ بنسخة من كل صف كما أرسله Workday بجانب الشخص في Polzy. أبقه معطّلًا ما لم تكن تتحقق من مشكلة في الربط: فهو يخزّن بيانات شخصية أكثر مما تحتاج. | معطّل |
ربط الحقول
يقرأ الربط الافتراضي أسماء الأعمدة الواردة في الخطوة 4 أعلاه:
| حقل Polzy | عمود التقرير |
|---|---|
| البريد الإلكتروني | Email |
| الاسم الأول، اسم العائلة | First_Name، Last_Name |
| الرقم الوظيفي | Employee_ID |
| حالة النشاط | Active |
| المدير | Manager_Email |
| القسم، المسمى الوظيفي، المكتب | Department، Business_Title، Location |
إذا كانت أعمدة تقريرك بأسماء أخرى، ففعّل تخطيط الحقول المخصص واختر العمود الصحيح لكل حقل. لكل صف أيضًا قيمة في إذا كان فارغًا، استخدم، تُكتب حين لا يكون في التقرير شيء لذلك الشخص — أما القيمة التي يرسلها التقرير فلا تُستبدل أبدًا.
أمور تجدر معرفتها:
- أمثلة حقيقية. عند الربط لأول مرة، تعرض القائمة أسماء الأعمدة الافتراضية. بعد الربط، اختر الإعدادات في المزامنة والحقول وافتح ربط الحقول من جديد: تأتي القائمة حينها من الصفوف الأولى في تقريرك، لكل منها مثال، فترى أسماء الأعمدة الحقيقية.
- لا تُملأ إلا حقول مساحة عملك. لا يُحفظ القسم أو المكتب إلا إذا كان في مساحة عملك حقل بهذا الاسم. أضف حقلًا عبر إضافة حقل في المزامنة والحقول، ثم اربطه.
- المجموعات. لمقارنة النتائج حسب حقل، اجعله حقلًا من نوع قائمة وفعّل المجموعات بجانبه في جدول ربط الحقول.
- المديرون. يُربط المدير إذا كان لدى أحد الأشخاص في Polzy ذلك البريد الإلكتروني. وإن لم يكن موجودًا بعد، يُنشأ الربط في مزامنة لاحقة. يحتاج المديرون إلى تفعيل التسلسل الإداري في مساحة العمل.
المعاينة وتشغيل المزامنة الأولى
- في المزامنة والحقول، اختر معاينة مزامنة ضمن سجل المزامنة. يحسب Polzy ما ستضيفه المزامنة وتحدّثه وتعطّله دون أن يغيّر شيئًا، ويفتح السجل حيث تظهر النتيجة بوصف معاينة.
- راجع المعاينة. إن بدت الأسماء أو عناوين البريد أو الأقسام خاطئة، فصحّح التقرير أو الربط وعاين مرة أخرى.
- اختر مزامنة الآن. تظهر النتيجة في سجل المزامنة.
يُطابَق الأشخاص القادمون من Workday مع الموجودين في Polzy بالبريد الإلكتروني، فمن دعوته يدويًا من قبل يُحدَّث بدلًا من أن يُضاف مرتين.
الجدول وسجل المزامنة
بعد المزامنة الأولى يعمل Polzy تلقائيًا بالتكرار الذي اخترته، بفارق دقائق قليلة. لا يوفّر Workday ويب هوك هنا، لذا تصل التغييرات مع المزامنة التالية، أو حين تختار مزامنة الآن. يعرض سجل المزامنة آخر خمسة تشغيلات — نجحت أو جزئية (تُخطّي بعض الأشخاص أو فشلوا) أو فشلت أو معاينة — ويفتح السجل الكامل كل تشغيل مع كل تغيير أجراه.
إذا فشلت مزامنة، يعيد Polzy المحاولة لاحقًا وينتظر أطول في كل مرة. بعد ثلاث حالات فشل متتالية، يظهر على المصدر يحتاج إلى انتباه ويُبلَّغ المسؤولون. يعود مزامنة الآن إلى العمل حين يصبح المصدر متصلًا: صحّح البيانات من الإعدادات واحفظ.
عندما يغادر أحدهم
- موسوم بعدم النشاط في التقرير. من يحمل عمود
Activeلديه القيمة 0 أو false أو inactive أو terminated يُعطَّل في المزامنة التالية، أما القيمة الفارغة فتُعدّ نشطة. لا يتلقى الأشخاص المعطَّلون استبيانات ولا يشغلون مقعدًا، وتبقى إجاباتهم السابقة محفوظة. - اختفى من التقرير. من يتوقف ببساطة عن الظهور في التقرير لا يُعطَّل حاليًا. أبقِ المغادرين في التقرير مع ضبط
Activeعلى 0 ما دام يمكن أن يكونوا نشطين في Polzy. - محظور في Polzy. من حظره مسؤول في Polzy يبقى محظورًا، مهما قال التقرير.
لا تحذف المزامنة أحدًا أبدًا.
استكشاف الأخطاء وإصلاحها
| ما تراه | السبب | ما تفعله |
|---|---|---|
| Tenant Name is required; Environment is required عند اختيار ربط | ما زال موصّل Workday في Polzy يتحقق من حقلين لم يعد النموذج يعرضهما. هذا خطأ من جهتنا، لا في قيمك. | تواصل مع دعم Polzy؛ لا يمكن حفظ الاتصال قبل إصلاح ذلك. |
| Failed to read the Workday report: Workday API error: … | العنوان غير صحيح، أو تغيّرت كلمة مرور المستخدم أو انتهت صلاحيتها، أو لا يُسمح للمستخدم بتشغيل التقرير. | افتح العنوان في المتصفح بحساب الـ integration system user، وعالج ما يُبلغ عنه Workday. |
| Connected, but the report returned no rows. | مجموعة أمان المستخدم لا ترى أي موظف، أو عامل تصفية التقرير لا يُبقي أحدًا. | وسّع مجموعة الأمان أو عامل تصفية التقرير. |
| يُتخطّى بعض الأشخاص | صفّ لا يحتوي بريدًا إلكترونيًا ولا رقم هاتف. | أضف عمود Email، أو اربط العمود الذي يحتويه. |
| لم يتم استيراد N شخص: لا توجد مقاعد متبقية في الخطة. | يشغل كل عضو مقعدًا، والخطة ممتلئة. | حرّر مقاعد أو غيّر الخطة، ثم اختر مزامنة الآن. |
| يستورد … الأشخاص بالفعل. افصله قبل توصيل مصدر آخر. | تتزامن مساحة العمل من مصدر واحد في كل مرة، وهناك مصدر آخر مربوط. | افتح الإعدادات لذلك المصدر واختر قطع الاتصال أولًا. |
معلومات مفيدة
- أعضاء لا جهات اتصال. كل من يأتي من Workday عضو: يستطيع تسجيل الدخول ويشغل مقعدًا. المزامنة التي تتجاوز مقاعدك تستورد من يتسع لهم، وتتوقف عندهم، وتُبلغ المسؤولين — راجع الاستخدام والحدود.
- أنت تتحكم في البيانات. لا يستطيع Polzy قراءة إلا ما يعرضه التقرير. استبعد أي عمود لا تريده في Polzy.
- قطع الاتصال أو الإزالة. من الإعدادات، يوقف قطع الاتصال المزامنة ويحتفظ بالإعدادات والسجل لتعيد الربط لاحقًا، بينما تحذف إزالة الاتصال. في الحالتين يبقى الأشخاص الذين تمت مزامنتهم في Polzy ولا يعودون يُحدَّثون.
- تحتاج إلى مساعدة؟ يشرح رابط اسأل Polzy في لوحة الربط مصدر كل قيمة.
روابط مفيدة
- أدلة Workday حول integration system users وreports as a service موجودة في Workday Community، وتتطلب تسجيل الدخول إلى Workday؛ ولا توجد صفحة عامة تغطيها.
- الأشخاص وجهات الاتصال — الحقول والمجموعات والأعضاء.
مقالات ذات صلة
يمكن للأعضاء المسجّلين سؤال Polzy أو مراسلة الفريق من صفحة الدعم. تعتمد سرعة ردّنا على خطتك.