تُقدّم هذه المقالة دليلاً شاملاً خطوة بخطوة لمساعدتك في استيراد بيانات iSAMS إلى SchoolsBuddy . استخدم الفهرس الموجود على الجانب الأيمن للتنقل بسرعة إلى القسم ذي الصلة باحتياجاتك.
1. نظرة عامة
يستورد SchoolsBuddy بياناتك الأساسية - بما في ذلك الطلاب وجهات الاتصال والموظفين - مباشرةً من iSAMS باستخدام مفاتيح واجهة برمجة التطبيقات Batch API . يقوم النظام بتحديث البيانات ليلاً ، مما يضمن بقاء معلوماتك دقيقة ومحدثة.
يرجى إعداد سبعة مفاتيح API منفصلة للدفعات (المفتاح الطبي اختياري) عبر لوحة تحكم إدارة iSAMS > قسم مفاتيح API.
إن إنشاء هذه المفاتيح بشكل منفصل يسمح SchoolsBuddy بسحب أنواع مختلفة من البيانات بشكل مستقل، مما يحسن من معالجة الأحمال ويضمن تشغيل استيراد البيانات بسلاسة وبالتسلسل الصحيح.
2. كيفية إنشاء مفتاح API للدفعات
لإعداد مفاتيح واجهة برمجة التطبيقات (API)، اتبع الخطوات التالية. قد تختلف هذه الخطوات قليلاً حسب ما إذا كنت تستخدم نسخة ISAMS مستضافة على السحابة أو نسخة مستضافة ذاتيًا.
- قم بتسجيل الدخول إلى ISAMS كمسؤول وانقر على لوحة التحكم .
-
حدد مدير خدمات واجهة برمجة التطبيقات
-
حدد إدارة مفاتيح واجهة برمجة التطبيقات المجمعة
- انقر فوق إنشاء مفتاح API للدفعة (أو طلب مفتاح API للدفعة إذا رأيت ذلك بدلاً من ذلك).
ستحتاج إلى طلب 6 أو 7 مفاتيح جديدة من ISAMS أولاً (اعتمادًا على ما إذا كنت ترغب في مشاركة المعلومات الطبية). - قم بتسمية المفتاح بوضوح بناءً على غرضه (على سبيل المثال، SchoolsBuddy – الطلاب؛ SchoolsBuddy – جهات الاتصال) حتى يسهل التعرف عليه لاحقًا.
-
قم بضبط الإعدادات الرئيسية التالية:
الحالة: نشط
الوضع: الإنتاج
-
مدة صلاحية ذاكرة التخزين المؤقت: من ساعتين إلى أربع ساعات (بدلاً من المدة الافتراضية البالغة 24 ساعة)
- حدد علامة تبويب طرق المعالجة الدفعية .
-
قم بضبط كل مفتاح من خلال التحقق من الإعدادات كما هو موضح في الجدول أدناه. هذا مثال على مفتاح جهات الاتصال.
يرجى الرجوع إلى الجدول أدناه للاطلاع على الإعدادات الصحيحة لكل نوع من أنواع مفاتيح واجهة برمجة تطبيقات الدفعات:
-
مفتاح API 1 المجموعات - مدير المدرسة - البيوت الأكاديمية
- مدير المدرسة - النماذج
- مدير مدرسة - سنوات
مفتاح API 2 طاقم عمل - مدير الموارد البشرية - الموظفون الحاليون
مفتاح API 3 طلاب - مدير شؤون الطلاب - الطلاب الحاليون
مفتاح API 4 جهات الاتصال - PupilManager - جهات الاتصال (المفلترة) .
- لا تحدد خياري "جهات الاتصال" أو "الحقول المخصصة" - انظر لقطة الشاشة
- يرجى الاطلاع على الملاحظة المهمة أدناه بشأن قاعدة استيراد جهات الاتصال SchoolsBuddy
مفتاح API 5 طبي - هذا المفتاح اختياري
- مدير شؤون الطلاب - الطلاب الحاليون - الصحة
- لا تقم بتحديد خيار الحقول المخصصة - انظر لقطة الشاشة
مفتاح API 6 المواضيع - TeacherManager - الأقسام، نماذج التدريس، قوائم المجموعات والمجموعات (لأمسيات أولياء الأمور / اجتماعات أولياء الأمور والمعلمين والتواصل)
مفتاح API 7 الخريجون (المغادرون) - مدير شؤون الطلاب - الخريجين
⚠️ هام:
اختر فقط الطرق المدرجة لكل مفتاح أدناه.
يرجى عدم تحديد أي إعدادات إضافية أو حقول مخصصة ، لأن ذلك قد يمنع SchoolsBuddy من معالجة البيانات بشكل صحيح.
-
- انتقل إلى علامة تبويب التكامل.
- أدخل اسم المكامل " Faria " واسم المنتج " SchoolsBuddy ".
- انقر على "حفظ وإغلاق" .
- ستظهر نافذة منبثقة تحتوي على بيانات اعتماد خادم المصادقة.
لا تغلق هذه النافذة بعد - ستحتاج إلى هذه المعلومات لإكمال عملية دمج SchoolsBuddy .
3. إعدادات SchoolsBuddy
بعد إنشاء مفاتيح API في iSAMS ، يرجى اتباع الخطوات الواردة في هذه المقالة: تكامل بيانات iSAMS : الجزء 2 لبدء التكامل مع SchoolsBuddy .
4. الأسئلة الشائعة
س: ماذا لو احتجنا إلى تحديث أي تفاصيل تخص الطلاب أو أولياء الأمور أو الموظفين؟
ج: يُرجى تحديث البيانات مباشرةً في iSAMS كالمعتاد. ستُستورد هذه التغييرات إلى SchoolsBuddy كل ليلة. مع ذلك، قد يستغرق تحديث بيانات iSAMS عبر واجهة برمجة التطبيقات (API) وقتًا أطول في بعض الأحيان، وقد تلاحظ ظهور سجلات الطلاب قبل تحديث عناوين بريدهم الإلكتروني بالكامل. نوصي بالانتظار لمدة تصل إلى 48 ساعة حتى تتم مزامنة جميع بيانات الطلاب الجدد بالكامل.
س: هل سيتم فصل الطلاب تلقائياً عند مغادرتهم؟
ج: نعم. سيتم حذف الطلاب المصنفين كمغادرين أو خريجين في iSAMS تلقائيًا.
س: هل سيتم حذف أسماء أولياء الأمور تلقائياً عند مغادرة الطالب؟
ج: سيتم تعطيل حسابات أولياء الأمور ما لم يكن للطالب أخ أو أخت يدرس حاليًا في المدرسة ولديه حساب نشط SchoolsBuddy .
س: هل سيتم فصل الموظفين تلقائياً عند مغادرتهم؟
ج: لا. سيحتفظ كل من الموظفين الداخليين والخارجيين بحساباتهم SchoolsBuddy حتى يتم حذفها يدويًا. يجب على مستخدم مدير المؤسسة الرئيسي حذف حساباته في SchoolsBuddy ، وذلك بسبب قيود واجهة برمجة تطبيقات iSAMS .
س: لماذا يتم تعديل مدة صلاحية ذاكرة التخزين المؤقت؟
ج: يقوم برنامج SchoolsBuddy بالاستعلام من iSAMS مرة واحدة كل 24 ساعة خلال الليل.
يضمن تقليل مدة صلاحية ذاكرة التخزين المؤقت إلى 2-4 ساعات ما يلي:
يمكن تحديث البيانات بشكل أسرع إذا لزم الأمر.
يمكنك تشغيل مزامنة البيانات يدويًا (على سبيل المثال، إذا تمت إضافة طالب جديد خلال اليوم).
لا يزال النظام يقلل من الحمل على قاعدة بيانات iSAMS الخاصة بك عن طريق تخزين النتائج مؤقتًا لبضع ساعات.
إذا تم ضبط ذاكرة التخزين المؤقت على الوضع الافتراضي 24 ساعة ، فلن تكون أي بيانات جديدة أو محدثة متاحة حتى المزامنة المجدولة لليوم التالي.
س: هل يمكن SchoolsBuddy استيراد بيانات الحضور "خارج المدرسة" من iSAMS كل يوم؟
ج: لا، ليس حاليًا. في المستقبل، قد تُضمّن iSAMS هذه البيانات في واجهة برمجة التطبيقات العامة الخاصة بها، مما يسمح SchoolsBuddy باستيرادها.
س: هل يمكن SchoolsBuddy استيراد المعلومات الطبية؟
ج: نعم. إذا زودتنا بمفتاح واجهة برمجة تطبيقات طريقة الدفعات الطبية، فيمكننا استيراد الحالات الطبية لطلابك.
س: هل سيتم استيراد فصول المعلمين مباشرة إلى SchoolsBuddy ؟
ج: نعم، ولكن سيتم استيراد الفصول الدراسية القائمة على المجموعات فقط لدعم اجتماعات أولياء الأمور والمعلمين والتواصل. أما الفصول الدراسية القائمة على النماذج فلا يتم استيرادها.
س: هل يمكن إضافة بيوت الإقامة الداخلية إلى SchoolsBuddy ؟
ج: يدعم نظام التكامل لدينا حاليًا المساكن الأكاديمية فقط. مع ذلك، أبدت بعض المدارس رغبتها في إضافة المساكن الداخلية إلى سجلات الطلاب. يُرجى زيارة بوابة منتجاتنا للتصويت على هذه الميزة.
س: هل يمكن مزامنة صور الطلاب مع SchoolsBuddy ؟
ج: لا يمكن حاليًا مزامنة صور الطلاب عبر واجهة برمجة تطبيقات iSAMS . مع ذلك، يُرجى التواصل مع فريق الدعم لدينا إذا كنتم مهتمين، فقد نتمكن من تقديم آلية عمل بديلة.
س: نستخدم حساب iSAMS واحد لعدة فروع جامعية عن طريق تعيين السنوات كما هو موضح أدناه. هل يمثل هذا مشكلة؟
الحرم الجامعي 1: السنوات من 1 إلى 10
الحرم الجامعي الثاني: السنوات من 20 إلى 30
ج: يقوم SchoolsBuddy بمزامنة اسم السنة الدراسية، لذا إذا كانت كل من السنة العاشرة والسنة العشرين تحملان نفس الاسم (مثلاً، "السنة الخامسة")، فسيتم استيرادهما كمجموعة سنة واحدة. نوصي بإضافة مُعرّف الحرم الجامعي إلى أسماء مجموعات السنوات لتمييزها في SchoolsBuddy ، على سبيل المثال، "السنة الخامسة - الحرم الجامعي 1" و"السنة الخامسة - الحرم الجامعي 2".