تحديث تكامل iSAMS الخاص بك إلى OAuth 2.0 (للعملاء الحاليين)

الجمهور المستهدف: تنطبق هذه المقالة على عملاء SchoolsBuddy الحاليين الذين يستخدمون تكامل iSAMS .

تقوم iSAMS بترقية جميع واجهات برمجة تطبيقات Batch إلى OAuth 2.0 - وهو معيار صناعي حديث يوفر أمانًا معززًا للبيانات، وموثوقية اتصال محسنة، وتحكمًا أفضل في الوصول إلى بيانات مدرستك.

لضمان استمرار مزامنة بياناتك دون انقطاع خلال فترات انقطاع خدمة iSAMS القادمة، يرجى إكمال الخطوات أدناه قبل 14 أكتوبر 2026.

الجزء الأول: إنشاء سر عميل OAuth 2.0 الخاص بك في iSAMS

1. قم بتسجيل الدخول إلى iSAMS كمسؤول وافتح لوحة التحكم .
2. حدد مدير خدمات واجهة برمجة التطبيقات (API).
3. حدد إدارة مفاتيح واجهة برمجة التطبيقات للدفعات.
4. حدد موقع مفتاح Batch API الخاص بك لـ SchoolsBuddy ، وانقر فوق رمز المفتاح الذهبي على الجانب الأيمن.
   
5. في النافذة المنبثقة التي تسألك عما إذا كنت تريد إنشاء سر جديد لمفتاح API هذا، انقر فوق نعم .
6. سيظهر معرّف العميل وسر العميل.
   ⚠️ هام: لا تغلق هذه النافذة أو علامة تبويب المتصفح حتى تُكمل الجزء الثاني!

الجزء الثاني: أضف بيانات اعتمادك إلى SchoolsBuddy

قم بتسجيل الدخول إلى SchoolsBuddy بصفتك مشرفًا رئيسيًا.

1. انتقل إلى الإعدادات
2. البدء > تكامل البيانات
3. تأكد من أن مفتاح التبديل الخاص بـ "تمكين الاستيراد" مضبوط على وضع التشغيل (أخضر).

4. تأكد من صحة عنوان URL الخاص باستضافة نظام iSAMS الخاص بمدرستك.

5. انتقل إلى قسم مفاتيح API (يجب أن تكون جميع كيانات البيانات النشطة مفعلة بالفعل).

6. تحقق من معرف العميل الخاص بك (يجب أن يكون هذا الحقل مملوءًا مسبقًا).

7. ألصق سر العميل الذي أنشأته في الجزء 1 (الخطوة 6) في الحقل المقابل.
   

8. فلاتر استيراد البيانات الخاصة بالوالدين: تم ضبط هذه الفلاتر وفقًا لتفضيلات مدرستكم أثناء عملية التسجيل الأولية. اتركوا هذه الإعدادات كما هي ما لم تتغير متطلبات الاستيراد الخاصة بمدرستكم.

9. فلاتر استيراد بيانات الموظفين: تمت إضافة نطاق البريد الإلكتروني الخاص بمدرستكم هنا مسبقًا. لا تُجرِ أي تغييرات على هذا القسم إلا عند تحديث نطاق بيانات الموظفين.
10. معالجة نهاية العام: لا تحتاج إلى إجراء أي تغييرات هنا الآن. عندما يحين موعد ترحيل بياناتك الأكاديمية السنوية، يُرجى الرجوع إلى [دليل معالجة نهاية العام iSAMS ] .
11. انتقل إلى أسفل الصفحة وانقر على "حفظ التغييرات".

تم تحديث تكامل iSAMS الخاص بك وهو الآن جاهز لعملية الترقية القادمة إلى OAuth 2.0!

🚀 ميزة جديدة: تشغيل استيراد iSAMS يدويًا

يمكنك الآن تشغيل استيراد البيانات يدويًا عند الطلب من iSAMS مباشرةً من داخل SchoolsBuddy ! إذا أجريت تغييرات عاجلة في iSAMS وتحتاج إلى تطبيقها في SchoolsBuddy فورًا:

1. انتقل إلى الإعدادات > بدء الاستخدام > تكامل البيانات .

2. انقر على زر "تشغيل الاستيراد" الموجود أسفل الصفحة.

⏱️ ملاحظات هامة حول الاستيراد اليدوي:

• الحد الأقصى للتكرار: لا يمكن تشغيل زر " تشغيل الاستيراد" إلا مرة واحدة كل 5 دقائق .

• وقت المعالجة: اعتمادًا على حجم مدرستك ومجموعة البيانات الخاصة بها، قد تستغرق عملية الاستيراد من 10 إلى 20 دقيقة لإكمالها.

• تأخير تحديث بيانات iSAMS : لكي تظهر التحديثات في SchoolsBuddy ، يجب أولاً أن تنتقل التغييرات إلى بيانات iSAMS API. تحديث البيانات مباشرةً في iSAMS لا يعني تحديثها فورًا في بيانات SchoolsBuddy . يُرجى الانتظار حتى يُحدّث iSAMS بياناته قبل بدء عملية الاستيراد.

• نصيحة احترافية: يمكنك تقليل وتيرة تحديث خلاصات iSAMS عن طريق تقليل مدة صلاحية ذاكرة التخزين المؤقت لمفتاح API. (الافتراضي: 24 ساعة).