قواعد لجميع ملفات CSV
- إن القيم الموجودة في الملف حساسة لحالة الأحرف.
- يتم تمثيل القيمة الفارغة بفاصلتين من دون مسافات بينهما. على سبيل المثال، باستثناء الأقواس، تشير [,,] إلى قيمة فارغة، في حين تشير [, ,] إلى حرف مسافة، يتم تحليله كقيمة غير صالحة.
- يجب أن تحتوي ملفات CSV على رأس (السطر الأول) مطابق تمامًا، بما في ذلك حالة الأحرف، للتنسيق المدرج في الأمثلة الواردة في المقاطع أدناه.
- تحتوي الأسطر اللاحقة في الملف على البيانات المطلوب معالجتها (إدراجها أو تحديثها أو حذفها).
- أسماء الملفات قياسية (المستخدمون والمؤسسات، وما إلى ذلك).
البيان
يجب عليك تضمين ملف بيان مع كل حزمة. يحتوي البيان على الإصدار وقائمة الملفات التي ترسلها إلى Brightspace، كما يوضح ما إذا كانت بيانات لائحة الأسماء تشير إلى قيمة كل حزمة.
- يجب أن يكون اسم الملف manifest.csv.
- يمكن أن تكون القيمة أحد الخيارات الآتية:
- مجمَّع - لاستيراد اللقطات المجمّعة. يجب ترك حقلي الحالة وdatelastmodified فارغين في حال استخدام الوضع المجمَّع. يقوم الوضع المجمّع بحذف ضمني للتسجيلات فقط.
- دلتا - لاستيراد الدلتا. يجب تعبئة حقلي الحالة وdatelastmodified. هذا هو الوضع الوحيد الذي يسمح بحذف صريح.
- غائب - إذا لم يتم إرسال ملف، فيجب وضع علامة غائب عليه.
يسرد ما يأتي نموذج محتوى للبيان (مع سطر الرأس المطلوب):
propertyName,value
manifest.version,1.0
oneroster.version,1.1
file.academicSessions,delta
file.categories,absent
file.classes,delta
file.classResources,absent
file.courses,delta
file.courseResources,absent
file.demographics,absent
file.enrollments,delta
file.lineItems,absent
file.orgs,delta
file.users,delta
file.resources,absent
file.results,absent
|
ملاحظة: يتيح استخدام OneRoster CSV في وضع مجمَّع لنظام معلومات الطالب إلغاء تسجيل المستخدمين تلقائيًا من المقررات التعليمية والمقاطع إذا لم يعودوا مُدرجين في الملف المجمّع. تضمن هذه الميزة بقاء Brightspace متزامنة مع نظام معلومات الطالب من دون الحاجة إلى بيانات حالة إلغاء التسجيل الصريحة في ملفات OneRoster. |
الجلسات الأكاديمية
يسرد المثال الآتي صفين من محتوى الجلسة الأكاديمية (مع سطر الرأس المطلوب). يتكون الملف من تسعة أعمدة إلزامية، ويجب أن يحتوي كل عمود على قيمة صالحة أو يمكن تركه فارغًا وفقًا لتنسيق الملف.
sourcedId,status,dateLastModified,title,type,startDate,endDate,parentSourcedId,schoolYear
TERM_LW11,active,2016-04-30T00:00:00Z,Spring TERM_LW11,term,2017-04-30,2017-06-30,,2017
GRADINGPERIOD_LW11,active,2016-04-30T00:00:00Z,Full Spring GRADINGPERIOD_LW11,gradingPeriod,2017-04-30,2017-06-30,TERM_LW11,2017
| العمود |
الحقل |
مطلوب |
القيم المدعومة |
ملاحظات |
| 1 |
SourceId |
نعم |
|
يتم التخزين مع حزمة التكامل لأنظمة معلومات الطالب للتعيين إلى وحدة تنظيمية في Brightspace |
| 2 |
الحالة |
نعم |
نشط، tobedeleted |
يُستخدم لإنشاء/تحديث الجلسة الأكاديمية أو حذفها. مطلوب عند وجود dateLastModified وعند إرسال دلتا. |
| 3 |
DateLastModified |
شمال |
YYYY-MM-DDTHH:mm:SS:ssZ |
*تعقب داخلي* |
| 4 |
العنوان |
نعم |
|
اسم الوحدة التنظيمية وكود الوحدة التنظيمية |
| 5 |
النوع |
نعم |
gradingPeriod، فصل دراسي، schoolyear، فصل |
نوع الوحدة التنظيمية |
| 6 |
StartDate |
نعم |
YYYY-MM-DD |
يمكن نسخ تاريخ بدء الجلسة الأكاديمية إلى تواريخ بدء مضامين المقررات التعليمية المقترنة. |
| 7 |
EndDate |
نعم |
YYYY-MM-DD |
يمكن نسخ تاريخ نهاية الجلسة الأكاديمية إلى تواريخ نهاية مضامين المقررات التعليمية المقترنة. |
| 8 |
ParentSourceId |
شمال |
|
تم تجاهله |
| 9 |
السنة الدراسية |
نعم |
YYYY |
غير معيّن |
الوحدات التنظيمية
يسرد المثال الآتي أربعة صفوف من محتوى المؤسسات (مع سطر الرأس المطلوب). يتكون الملف من سبعة أعمدة إلزامية، ويجب أن يحتوي كل عمود على قيمة صالحة أو يُترك فارغًا وفقًا لتنسيق الملف.
sourcedId,status,dateLastModified,name,type,identifier,parentSourcedId
DISTRICT_LW11,active,2016-04-30T00:00:00Z,DISTRICT_LW11,district,,
SCHOOL_LW111,active,2016-04-30T00:00:00Z,SCHOOL_LW111,school,,DISTRICT_LW11
DISTRICT_LW12,active,2016-04-30T00:00:00Z,DISTRICT_LW12,district,,
SCHOOL_LW121,active,2016-04-30T00:00:00Z,SCHOOL_LW121,school,,DISTRICT_LW12
| العمود |
الحقل |
مطلوب |
القيم المدعومة |
ملاحظات |
| 1 |
SourceId |
نعم |
|
يتم التخزين مع حزمة التكامل لأنظمة معلومات الطالب للتعيين إلى وحدة تنظيمية في Brightspace |
| 2 |
الحالة |
شمال |
نشط أو tobedeleted |
إنشاء/تحديث الوحدة التنظيمية أو حذفها. مطلوب عند وجود dateLastModified وعند إرسال دلتا |
| 3 |
DateLastModified |
شمال |
YYYY-MM-DDTHH:mm:SS:ssZ |
*تعقب داخلي* |
| 4 |
الاسم |
نعم |
|
اسم الوحدة التنظيمية وكود الوحدة التنظيمية (إذا لم تتم تعبئة المعرِّف) |
| 5 |
النوع |
نعم |
قسم، مدرسة، منطقة، محلي، حكومي، وطني |
نوع الوحدة التنظيمية |
| 6 |
المعرِّف |
شمال |
|
كود الوحدة التنظيمية (إن وُجد) |
| 7 |
ParentSourcedId |
شمال |
|
SourceId للوحدة التنظيمية الأصل غير مطلوب على وجه التحديد، ولكن من دونه لن تكون الوحدات التنظيمية جزءًا من تسلسل هرمي |
المقررات التعليمية
يسرد ما يأتي صفين من نموذج محتوى للمقررات التعليمية (مع سطر الرأس المطلوب). يتكون الملف من 10 أعمدة إلزامية، ويجب أن يحتوي كل عمود على قيمة صالحة أو يُترك فارغًا وفقًا لتنسيق الملف.
sourcedId,status,dateLastModified,schoolYearSourcedId,title,courseCode,grades,orgSourcedId,subjects,subjectCodes
COURSE_LW11,active,2017-04-30T00:00:00Z,,The ways of the Force,COURSE_LW11,,SCHOOL_LW111,,
COURSE_LW12,active,2017-04-30T00:00:00Z,,French As A Second Language,COURSE_LW12,,SCHOOL_LW111,,
| العمود |
الحقل |
مطلوب |
القيم المدعومة |
ملاحظات |
| 1 |
SourceId |
نعم |
|
يتم التخزين مع حزمة التكامل لأنظمة معلومات الطالب للتعيين إلى وحدة تنظيمية في Brightspace (قالب المقرر التعليمي) |
| 2 |
الحالة |
شمال |
نشط أو tobedeleted |
إنشاء/تحديث قالب المقرر التعليمي أو حذفه. مطلوب عند وجود dateLastModified وعند إرسال دلتا |
| 3 |
DateLastModified |
شمال |
YYYY-MM-DDTHH:mm:SS:ssZ |
*تعقب داخلي* |
| 4 |
SchoolYearSourceId |
شمال |
|
تم تجاهله |
| 5 |
العنوان |
نعم |
|
اسم الوحدة التنظيمية وكود الوحدة التنظيمية (إذا لم تتم تعبئة المعرِّف) |
| 6 |
CourseCode |
شمال |
|
كود الوحدة التنظيمية (إن وجد) |
| 7 |
العلامات |
شمال |
|
تم تجاهله
|
| 8 |
OrgSourceId |
نعم |
|
SourceId للوحدة التنظيمية الأصل (مثل المدرسة) |
| 9 |
الموضوعات |
شمال |
|
تم تجاهله |
| 10 |
SubjectCodes |
شمال |
|
تم تجاهله |
الصفوف
يسرد ما يأتي ثلاثة صفوف من نموذج محتوى للصفوف (مع سطر الرأس المطلوب). يتكون الملف من 14 عمودًا إلزاميًا، ويجب أن يحتوي كل عمود على قيمة صالحة أو يُترك فارغًا وفقًا لتنسيق الملف. يتم إنشاء كل سجل كمضمون مقرر تعليمي مع مقطع واحد تحته.
sourcedId,status,dateLastModified,title,grades,courseSourcedId,classCode,classType,location,schoolSourcedId,termSourcedIds,subjects,subjectCodes,periods
CLASS_LW111,active,2017-04-30T00:00:00Z,The Force 101,,COURSE_LW11,CLASS_LW111,scheduled,,SCHOOL_LW111,TERM_LW11,,,
CLASS_LW112,active,2017-04-30T00:00:00Z,The Force Advanced,,COURSE_LW11,CLASS_LW112,scheduled,,SCHOOL_LW111,TERM_LW11,,,
CLASS_LW121,active,2017-04-30T00:00:00Z,French - Reading LW1,,COURSE_LW12,CLASS_LW121 fr-reading,scheduled,,SCHOOL_LW111,TERM_LW11,,,
| العمود |
الحقل |
مطلوب |
القيم المدعومة |
ملاحظات |
| 1 |
SourceId |
نعم |
|
يتم التخزين مع حزمة التكامل لأنظمة معلومات الطالب للتعيين إلى وحدة تنظيمية في Brightspace (مضمون المقرر التعليمي) |
| 2 |
الحالة |
شمال |
نشط أو tobedeleted |
إنشاء/تحديث مضمون المقرر التعليمي والمقطع أو حذفهما (التعيين إلى غير نشط أو الحذف استنادًا إلى تكوين إدارة حزمة التكامل لأنظمة معلومات الطالب). مطلوب عند وجود dateLastModified |
| 3 |
DateLastModified |
شمال |
YYYY-MM-DDTHH:mm:SS:ssZ |
*تعقب داخلي* |
| 4 |
العنوان |
نعم |
|
اسم الوحدة التنظيمية وكود الوحدة التنظيمية (إذا لم يتم توفير classCode) |
| 5 |
العلامات |
شمال |
|
تم تجاهله |
| 6 |
CourseSourceId |
نعم |
|
SourceId للوحدة التنظيمية الأصل (قالب المقرر التعليمي) |
| 7 |
ClassCode |
شمال |
|
كود الوحدة التنظيمية (إن وُجد) |
| 8 |
ClassType |
نعم |
غرفة الصف، مجدولة |
تم تجاهله |
| 9 |
الموقع |
شمال |
|
تم تجاهله
|
| 10 |
SchoolSourceId |
نعم |
|
SourceId للوحدة التنظيمية الأصل (مثل المدرسة) |
| 12 |
TermsSourceId |
نعم |
|
SourceId للوحدة التنظيمية الأصل (مثل الفصل) |
| 12 |
الموضوعات |
شمال |
|
تم تجاهله |
| 13 |
SubjectCodes |
شمال |
|
تم تجاهله |
| 14 |
الفترات |
شمال |
|
تم تجاهله |
ابدأ من هنا
المستخدمون
يسرد ما يأتي خمسة صفوف من نموذج محتوى للمستخدمين (مع سطر الرأس المطلوب). يتكون الملف من 18 عمودًا إلزاميًا، ويجب تعبئة كل عمود بقيمة صالحة أو تركه فارغًا وفقًا لتنسيق الملف.
|
sourcedId,status,dateLastModified,enabledUser,orgSourcedIds,role,username,userIds,givenName,familyName,middleName,identifier,email,sms,phone,agentSourcedIds,grades,password
STUDENT_LW11,active,2017-04-30T00:00:00Z,TRUE,SCHOOL_LW111,student,STUDENT_LW11,,Luke,Walker,,,email@email.com,,,"PARENT_LW11,TEACHER_LW11,GUARDIAN_LW11",,
STUDENT_LW12,active,2017-04-30T00:00:00Z,TRUE,SCHOOL_LW111,student,STUDENT_LW12,,Prince,Lee,,,email@email.com,,,"PARENT_LW11,GUARDIAN_LW11",,
PARENT_LW11,active,2017-04-30T00:00:00Z,TRUE,SCHOOL_LW111,parent,PARENT_LW11,,Bartholomew,Vadery,,,email@email.com,,,"STUDENT_LW11,STUDENT_LW12",,
GUARDIAN_LW11,active,2017-04-30T00:00:00Z,TRUE,SCHOOL_LW111,guardian,GUARDIAN_LW11,,Obi,Kennedy,,,email@email.com,,,"STUDENT_LW11,STUDENT_LW12",,
TEACHER_LW11,active,2017-04-30T00:00:00Z,TRUE,SCHOOL_LW111,teacher,TEACHER_LW11,,Mac,Yodad,,,email@email.com,,,"STUDENT_LW12,STUDENT_LW11",,
|
| العمود |
الحقل |
مطلوب |
القيم المحتملة |
ملاحظات |
| 1 |
SourcedId |
نعم |
|
OrgDefinedId إذا لم يكن المعرِّف متوفرًا |
| 2 |
الحالة |
شمال |
نشط أو tobedeleted |
نشط بشكل افتراضي (يعتمد على إعداد واجهة المستخدم)
مطلوب إذا كان DateLastModified موجودًا
غير نشط أو tobedeleted يلغي تنشيط المستخدم |
| 3 |
DateLastModified |
شمال |
YYYY-MM-DDTHH:mm:SS*,s*ssZ |
*تعقب داخلي* |
| 4 |
EnabledUser |
نعم |
صواب أم خطأ |
نشط في LMS في حال الصواب |
| 5 |
OrgSourceIds |
نعم |
|
تسجيل الوحدة التنظيمية المدرسية |
| 6 |
دور |
نعم |
|
الدور في المؤسسة |
| 7 |
اسم المستخدم |
نعم |
|
اسم المستخدم
|
| 8 |
UserIds |
شمال |
|
تم تجاهله |
| 9 |
GivenName |
نعم |
|
FirstName |
| 10 |
FamilyName |
نعم |
|
LastName |
| 11 |
MiddleName |
شمال |
|
MiddleName |
| 12 |
المعرِّف |
شمال |
|
OrgDefinedId (إن وُجد) |
| 13 |
البريد الإلكتروني |
شمال |
|
ExternalEmail |
| 14 |
Sms |
شمال |
|
تم تجاهله |
| 15 |
الهاتف |
شمال |
|
تم تجاهله |
| 16 |
AgentSourcedIds |
شمال |
|
يُستخدم هذا للإشارة إلى علاقة الأهل/ولي الأمر |
| 17 |
العلامات |
شمال |
|
غير معيّن |
| 18 |
كلمة المرور |
شمال |
|
|
التسجيلات
يسرد ما يأتي صفًا واحدًا من نموذج محتوى للتسجيلات (مع سطر الرأس المطلوب). يتكون الملف من 10 أعمدة إلزامية، ويجب تعبئة كل عمود بقيمة صالحة أو تركه فارغًا وفقًا لتنسيق الملف. سيتم تسجيل مستخدم محدد في مضمون المقرر التعليمي والمقطع
|
sourcedId,status,dateLastModified,classSourcedId,schoolSourcedId,userSourcedId,role,primary,beginDate,endDate
STUDENT_CLASS_LW1111,active,2017-04-30T00:00:00Z,CLASS_LW111,SCHOOL_LW111,STUDENT_LW11,student,,,
|
| العمود |
الحقل |
مطلوب |
القيم المحتملة |
ملاحظات |
| 1 |
SourceId |
نعم |
|
*تعقب داخلي* |
| 2 |
الحالة |
شمال |
نشط أو tobedeleted |
نشط بشكل افتراضي
مطلوب إذا كان DateLastModified موجودًا |
| 3 |
DateLastModified |
شمال |
YYYY-MM-DDTHH:mm:SS:ssZ |
*تعقب داخلي* |
| 4 |
UserSourcedId |
نعم |
|
المستخدم المراد تسجيله |
| 5 |
ClassSourcedId |
نعم |
|
الصف المطلوب التسجيل فيه |
| 6 |
SchoolSourcedId |
نعم |
صواب أم خطأ |
غير معيّن |
| 7 |
دور |
نعم |
القيم الوحيدة المسموح بها هي المسؤول والمراقب والطالب والمعلّم. |
الدور في الوحدة التنظيمية لمضمون المقرر التعليمي
|
| 8 |
أساسي |
شمال |
|
غير معيّن |
| 9 |
BeginDate |
شمال |
|
غير معيّن |
| 10 |
EndDate |
شمال |
|
غير معيّن |