معلومات القالب الخاصة باستيراد السجلات إلى Apple School Manager
توفر Apple ستة قوالب لاستخدامها عند إضافة البيانات إلى موقعك:
الطلاب: يحتوي على معلومات حساب الطالب.
الموظفين: يحتوي على معلومات حساب الموظفين، مثل المشرفين.
الدورات: يحدد الدورات.
الفصول: يحتوي على معلومات حول الدورة والمشرف (الموظفين).
القوائم: تحتوي على معلومات حول الفصل والطلاب والموقع.
المواقع: تحتوي على معلومات الموقع.
قوالب وحسابات Apple ID المُدارة
في حالة وجود حقل اختياري - مثل person_number أو sis_username - كجزء من تنسيق حساب Apple ID المُدار، سيُصبح حقلاً مطلوبًا حينئذٍ. وإذا تركته فارغًا، فسيتعذر التحميل باستخدام SFTP وسيظهر الخطأ MANAGED_ID_GENERATION_FAILED.
إعداد القوالب
عند تجهيز قالب، يجب استيفاء المعايير التالية:
بالنسبة إلى قوالب students.csv وstaff.csv، يجب أن يكون person_id فريدًا لجميع المواقع.
هام: إذا استخدمت SFTP لتحميل بيانات مستخدم جديد، وكان person_id الذي تقوم بتعيينه مُعينًا بالفعل لمستخدم آخر، فسيتم استبدال المستخدم الموجود في Apple School Manager بالمستخدم الجديد. بعد اكتمال عملية الاستبدال، لا يمكنك تحديث هذا المستخدم إلا من خلال SFTP.
إذا قمت بتحرير القوالب، استبدل بيانات المثال ببياناتك. لا تغير محتويات صف الرأس في كل ملف. لا تنشئ أعمدة مكررة في أي ملف. يمكنك إضافة أعمدة إلى قوالب محددة.
يجب أن يمثل كل صف قيمة فريدة، في كل قالب. على سبيل المثال، يجب أن يكون كل صف ضمن ملف students.csv طالبًا فريدًا. يمكن أن تكون بعض القيم الخاصة بهذا الطالب فارغة. يجب تخطي القيم الحرفية—على سبيل المثال، فاصل أسطر أو علامة اقتباس ضمن اسم—بشرطة عكسية (\). وإليك مثال: \". يجب أن تكون أي معرفات يتم إدخالها أبجدية رقمية ويمكن أن تتضمن واصلة (-).
إذا كانت القيمة الخاصة بك تحتوي على مسافة ( ) أو فاصلة (,)، استخدم علامات الاقتباس المستقيمة (") حولها. إذا لم تحتوي القيمة الخاصة بك على أي من هذه الأحرف الخاصة، فلا تستخدم علامات الاقتباس. إذا لم تستخدم علامات الاقتباس عند الحاجة، أو إذا قمت باستخدام علامات الاقتباس المتعرجة، فستحصل على أخطاء في عملية التحميل.
يجب فصل القيم الموجودة في ملفاتك بفواصل (,) أو فواصل منقوطة (;)، بغض النظر عن الكيفية التي أنشأت بها الملف. لا تستخدم مسافات أو علامات تبويب بين فاصلة أو فاصلة منقوطة والقيمة التالية. يجب ترميز كل ملف بنظام UTF-8. لتمثيل نهاية السطر، استخدم ترميز UNIX newline \n.
إذا كان أحد الإدخالات من عملية تحميل سابقة مفقودًا، فسيتم تعطيل الحساب وحذفه تلقائيًا بعد 120 يومًا، ما لم يكن الحساب قد اشترى محتوى بالجملة.
يجب أن تتطابق أسماء ملفات .csv مع اسم الملف الأصلي تمامًا.
يجب ضغط جميع الملفات في ملف أرشيف مضغوط واحد (.zip) حتى يتم تحميله.
لا يمكن وضع أي ملف ضمن مجلد في ملف الأرشيف المضغوط.
يجب تعريف جميع مراجع المفتاح الخارجي لملفات .csv الأخرى في الملف المشار إليه.
الحد الأقصى لعدد الأحرف في قوالب .csv
تحتوي بعض الحقول في قوالب .csv على حدود بالنسبة لعدد الأحرف المسموح بها.
الحقل | القوالب | الحد الأقصى لعدد الأحرف |
|---|---|---|
first_name | الطلاب، الموظفون | ٣٢ |
middle_name | الطلاب، الموظفون | ٣٢ |
last_name | الطلاب، الموظفون | ٦٤ |
grade_level | الطلاب | ٦٤ |
email_address | الطلاب | ٢٥٦ |
person_number | الطلاب، الموظفون | ٦٤ |
person_id | الطلاب والموظفون والفصول والقوائم | ٢٥٦ |
sis_username | الطلاب، الموظفون | ٢٥٦ |
class_id | الفصول، القوائم | ٢٥٦ |
class_number | الفصول | ٦٤ |
course_id | الدورات، الفصول | ٢٥٦ |
course_name | الدورات | ١٢٨ |
course_number | الدورات | ٦٤ |
location_name | المواقع | ٢٥٦ |
location_id | الطلاب، الموظفون، الدورات، الفصول، المواقع | ٢٥٦ |