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