مزامنة الأشخاص من BambooHR
اربط BambooHR بمفتاح API ويُبقي Polzy أعضاءك محدَّثين وفق جدول زمني — وخلال لحظات من أي تغيير إذا أضفت ويب هوك من BambooHR.
في هذه الصفحة
اربط BambooHR وسيقرأ Polzy دليل موظفيك وفق جدول زمني. ينضم الموظفون الجدد كأعضاء في مساحة العمل، وتنتقل التغييرات في المسمى الوظيفي أو القسم أو المدير مع المزامنة التالية، ويتوقف من يغادر عن تلقي الاستبيانات. وإذا أضفت أيضًا ويب هوك من BambooHR، يصل التغيير إلى Polzy خلال لحظات بدلًا من انتظار المزامنة التالية.
مزامنة الأشخاص متاحة في خطة Team وما فوقها، ولا يستطيع ربط مصدر إلا مسؤولو مساحة العمل. يقرأ Polzy من BambooHR فقط: لا يكتب فيه أبدًا ولا يغيّر أي سجل موظف.
قبل أن تبدأ
تحتاج إلى:
- أن تكون مسؤولًا في مساحة عمل Polzy، على خطة Team أو أعلى، مع تفعيل مزامنة الأشخاص من الإعدادات ← عام ← ما تقوم به مساحة العمل هذه.
- مستخدم في BambooHR يُسمح له بإنشاء مفاتيح API ويرى كل موظف وكل حقل يجب أن يقرأه Polzy — بمن فيهم الموظفون السابقون وتواريخ انتهاء الخدمة والمشرفون. فمفتاح API يرى بالضبط ما يراه مستخدمه.
- النطاق الفرعي لـ BambooHR: الجزء من عنوان BambooHR الذي يسبق
.bamboohr.com. فيhttps://acme.bamboohr.comيكونacme. - للويب هوك: مسؤول في BambooHR، وصفحة التكاملات في Polzy، وهي متاحة في خطة Business.
تتزامن مساحة العمل من مصدر واحد في كل مرة. إذا كان هناك مصدر آخر مربوط، فافصله أولًا. وإذا كانت مؤسستك تزوّد الأشخاص عبر SCIM، فلا يمكن ربط أي مصدر إطلاقًا — راجع SCIM.
إنشاء مفتاح API في BambooHR
- سجّل الدخول إلى BambooHR بالمستخدم الذي يجب أن يحمل المفتاح صلاحياته. من الأفضل تخصيص مستخدم للتكاملات: فإن عُطِّل هذا المستخدم، يتوقف المفتاح عن العمل.
- انقر على اسمك في الزاوية السفلية اليسرى واختر API Keys.
- أضف مفتاحًا جديدًا، وسمّه Polzy، وأنشئه.
- انسخ المفتاح فورًا. يعرضه BambooHR مرة واحدة فقط.
راجع BambooHR: Getting started with the API.
ربط BambooHR في Polzy
- افتح جهات الاتصال ← المزامنة والحقول.
- ضمن المصادر المتاحة، ابحث عن BambooHR واختر ربط. تُفتح لوحة من ثلاث خطوات: الاتصال وإعدادات المزامنة وربط الحقول.
- أدخل النطاق الفرعي لـ BambooHR والصق API Key. اترك سرّ الويب هوك فارغًا الآن؛ فهو للويب هوك الموضّح أدناه.
- اختر اختبار الاتصال. تعني رسالة Successfully connected to BambooHR. Found N employees. أن المفتاح يعمل.
- اختر التالي، وراجع إعدادات المزامنة (انظر أدناه)، ثم اختر التالي مرة أخرى.
- في ربط الحقول، أبقِ الربط الافتراضي أو فعّل تخطيط الحقول المخصص (انظر أدناه)، ثم اختر ربط.
يُخزَّن المفتاح مشفّرًا ولا يُستخدم إلا للقراءة من BambooHR. يتحقق Polzy منه مجددًا حين تختار ربط: فإن رفضه BambooHR، لا يُحفظ شيء.
إعدادات المزامنة
| الإعداد | ماذا يفعل | الافتراضي |
|---|---|---|
| تكرار المزامنة | عدد مرات قراءة Polzy لـ BambooHR: كل 30 دقيقة، أو كل ساعة، أو كل 4 ساعات، أو يوميًا. | كل ساعة |
| تعطيل الموظفين الذين انتهت خدمتهم | من جلبه Polzy من BambooHR ولم يعد يظهر فيه يُعطَّل في المزامنة التالية. | مفعّل |
| إرسال رسائل دعوة عبر البريد الإلكتروني | يتلقى الأعضاء الجدد الذين لديهم بريد إلكتروني دعوة لتسجيل الدخول إلى Polzy. | مفعّل |
| الدور الافتراضي | الدور الذي يحصل عليه الأعضاء الجدد: مُشاهد أو محرّر أو مسؤول. ينطبق فقط على من تنشئهم المزامنة. | مُشاهد |
| حفظ البيانات الخام | يحتفظ بنسخة من كل سجل كما أرسله BambooHR بجانب الشخص في Polzy. أبقه معطّلًا ما لم تكن تتحقق من مشكلة في الربط: فهو يخزّن بيانات شخصية أكثر مما تحتاج. | معطّل |
ربط الحقول
يقرأ Polzy من BambooHR عبر تقرير يضم الحقول التي يحتاجها، بما فيها الموظفون السابقون. يملأ الربط الافتراضي:
| حقل Polzy | من BambooHR |
|---|---|
| البريد الإلكتروني | workEmail |
| الاسم الأول، اسم العائلة | firstName، lastName |
| المسمى الوظيفي | jobTitle |
| القسم، المكتب | department، location |
| رقم الهاتف | mobilePhone |
| الرقم الوظيفي، تاريخ البدء | id، hireDate |
| حالة النشاط | تُستنتج من terminationDate وstatus |
| المدير | supervisorId |
لتغييره، فعّل تخطيط الحقول المخصص. يصبح لكل صف مصدر تختاره — ومن الحقول الأخرى المتاحة workPhone وemployeeNumber وdivision — وقيمة في إذا كان فارغًا، استخدم، تُكتب حين لا يكون لدى BambooHR شيء لذلك الشخص. أما القيمة التي يرسلها BambooHR فلا تُستبدل أبدًا.
أمور تجدر معرفتها:
- لا تُملأ إلا حقول مساحة عملك. لا يُحفظ القسم أو المكتب إلا إذا كان في مساحة عملك حقل بهذا الاسم. أضف حقلًا عبر إضافة حقل في المزامنة والحقول، ثم اربطه.
- المجموعات. لمقارنة النتائج حسب حقل، اجعله حقلًا من نوع قائمة وفعّل المجموعات بجانبه في جدول ربط الحقول. تُطابَق القيم القادمة من BambooHR مع خيارات الحقل.
- أمثلة حقيقية. بعد الربط، اختر الإعدادات في المزامنة والحقول وافتح ربط الحقول من جديد: تأتي القائمة حينها من خمسة سجلات حقيقية، لكل منها مثال.
- المديرون. يصبح المشرف مدير الشخص إذا كان موجودًا في Polzy أيضًا. وإن لم يكن موجودًا بعد، يُنشأ الربط في مزامنة لاحقة. يحتاج المديرون إلى تفعيل التسلسل الإداري في مساحة العمل.
المعاينة وتشغيل المزامنة الأولى
- في المزامنة والحقول، اختر معاينة مزامنة ضمن سجل المزامنة. يحسب Polzy ما ستضيفه المزامنة وتحدّثه وتعطّله دون أن يغيّر شيئًا، ويفتح السجل حيث تظهر النتيجة بوصف معاينة.
- راجع المعاينة. إن بدت الأسماء أو عناوين البريد أو الأقسام خاطئة، فصحّح الربط من الإعدادات وعاين مرة أخرى.
- اختر مزامنة الآن. تظهر النتيجة في سجل المزامنة.
يُطابَق الأشخاص بمعرّفهم في BambooHR، ثم بالبريد الإلكتروني، فمن دعوته يدويًا من قبل يُحدَّث بدلًا من أن يُضاف مرتين.
استلام التغييرات خلال لحظات عبر ويب هوك
دون ويب هوك، تصل التغييرات مع المزامنة المجدولة التالية. ومعه، يُعلم BambooHR نظام Polzy بالموظفين الذين تغيّروا، فيقرأ Polzy كلًّا منهم فورًا.
- افتح في Polzy التكاملات، ثم BambooHR، وانسخ العنوان الظاهر تحت الاستقبال. هذا العنوان مخصص لاتصالك وينتهي بـ
/bamboohr. - افتح في BambooHR Account Settings واختر Webhooks. إن لم تجده، يستطيع دعم BambooHR تفعيل الويب هوك لحسابك.
- أضف ويب هوك باسم Polzy، والصق العنوان بوصفه URL، واختر JSON صيغةً.
- اختر الحقول المراد مراقبتها — الحقول التي تربطها في Polzy، مثل الاسم وبريد العمل والمسمى الوظيفي والقسم والموقع والحالة والمشرف.
- أنشئ المفتاح الخاص (private key) وانسخه قبل الحفظ. يعرضه BambooHR مرة واحدة فقط.
- افتح في Polzy جهات الاتصال ← المزامنة والحقول، واختر الإعدادات، والصق المفتاح الخاص في سرّ الويب هوك، ثم اختر حفظ في الخطوة الأخيرة.
يوقّع BambooHR كل استدعاء بالمفتاح الخاص (X-BambooHR-Signature وX-BambooHR-Timestamp). يرفض Polzy أي استدعاء غير موقّع، أو موقّع بمفتاح آخر، أو مضى عليه أكثر من خمس دقائق، ولا ينفّذ شيئًا مرتين إذا وصل الاستدعاء نفسه مجددًا. يظهر كل تغيير في السجل الكامل كتشغيل مستقل موسوم بـ ويب هوك. راجع BambooHR: Webhooks.
الجدول وسجل المزامنة
بعد المزامنة الأولى يعمل Polzy تلقائيًا بالتكرار الذي اخترته، بفارق دقائق قليلة. يعرض السطر تحت اسم BambooHR موعد آخر مزامنة، وعدد مرات تشغيلها، وعدد الأشخاص والمجموعات التي جلبتها. يعرض سجل المزامنة آخر خمسة تشغيلات — نجحت أو جزئية (تُخطّي بعض الأشخاص أو فشلوا) أو فشلت أو معاينة — ويفتح السجل الكامل كل تشغيل مع كل تغيير أجراه.
إذا فشلت مزامنة، يعيد Polzy المحاولة لاحقًا وينتظر أطول في كل مرة. بعد ثلاث حالات فشل متتالية، أو فورًا إذا رفض BambooHR المفتاح، يظهر على المصدر يحتاج إلى انتباه ويُبلَّغ المسؤولون. يعود مزامنة الآن إلى العمل حين يصبح المصدر متصلًا: صحّح المفتاح من الإعدادات واحفظ.
عندما يغادر أحدهم
- انتهت خدمته في BambooHR. من لديه تاريخ انتهاء خدمة أو الحالة Terminated يُعطَّل في المزامنة التالية، أو فورًا مع الويب هوك. لا يتلقى الأشخاص المعطَّلون استبيانات ولا يشغلون مقعدًا، وتبقى إجاباتهم السابقة محفوظة.
- اختفى من BambooHR. مع تفعيل تعطيل الموظفين الذين انتهت خدمتهم، يُعطَّل أيضًا من لم يعد يظهر في BambooHR إطلاقًا.
- محظور في Polzy. من حظره مسؤول في Polzy يبقى محظورًا، مهما قال BambooHR.
لا تحذف المزامنة أحدًا أبدًا.
استكشاف الأخطاء وإصلاحها
| ما تراه | السبب | ما تفعله |
|---|---|---|
| BambooHR refused this API key: … The key needs report access. | أُبطل المفتاح، أو عُطِّل مستخدمه، أو لا يُسمح لذلك المستخدم بتشغيل التقارير. | أنشئ مفتاحًا بمستخدم لديه صلاحية التقارير والصقه في الإعدادات. |
| Failed to fetch from BambooHR | تعذّر الوصول إلى BambooHR، أو النطاق الفرعي غير صحيح. | تحقّق من النطاق الفرعي، ثم اختر مزامنة الآن. |
| يظهر الجميع نشطين، حتى من غادر | مستخدم المفتاح لا يرى تواريخ انتهاء الخدمة أو الحالة. | امنح ذلك المستخدم في BambooHR صلاحية الوصول إلى تلك الحقول. |
| لا تصل تغييرات الويب هوك أبدًا | لم يُحفظ سرّ الويب هوك، أو لا يطابق المفتاح الخاص، أو العنوان خاطئ. | أنشئ مفتاحًا خاصًا جديدًا، والصقه في سرّ الويب هوك، وتحقّق من URL في BambooHR. |
| لم يتم استيراد N شخص: لا توجد مقاعد متبقية في الخطة. | يشغل كل عضو مقعدًا، والخطة ممتلئة. | حرّر مقاعد أو غيّر الخطة، ثم اختر مزامنة الآن. |
| يستورد … الأشخاص بالفعل. افصله قبل توصيل مصدر آخر. | تتزامن مساحة العمل من مصدر واحد في كل مرة، وهناك مصدر آخر مربوط. | افتح الإعدادات لذلك المصدر واختر قطع الاتصال أولًا. |
معلومات مفيدة
- أعضاء لا جهات اتصال. كل من يأتي من BambooHR عضو: يستطيع تسجيل الدخول ويشغل مقعدًا. المزامنة التي تتجاوز مقاعدك تستورد من يتسع لهم، وتتوقف عندهم، وتُبلغ المسؤولين — راجع الاستخدام والحدود.
- الويب هوك اختياري. تستمر المزامنات المجدولة معه أو بدونه، وتلتقط ما فات الويب هوك.
- قطع الاتصال أو الإزالة. من الإعدادات، يوقف قطع الاتصال المزامنة ويحتفظ بالإعدادات والسجل لتعيد الربط لاحقًا، بينما تحذف إزالة الاتصال. في الحالتين يبقى الأشخاص الذين تمت مزامنتهم في Polzy ولا يعودون يُحدَّثون.
- تحتاج إلى مساعدة؟ يشرح رابط اسأل Polzy في لوحة الربط أين تجد كل قيمة في BambooHR.
روابط مفيدة
- BambooHR: Getting started with the API — إنشاء مفتاح API ومعرفة النطاق الفرعي.
- BambooHR: Webhooks — كيف يرسل BambooHR التغييرات ويوقّعها.
- الأشخاص وجهات الاتصال — الحقول والمجموعات والأعضاء.
مقالات ذات صلة
يمكن للأعضاء المسجّلين سؤال Polzy أو مراسلة الفريق من صفحة الدعم. تعتمد سرعة ردّنا على خطتك.