ข้อมูลเทมเพลตสำหรับการนำเข้าบันทึกข้อมูลไปยัง 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 สำหรับการขึ้นบรรทัดใหม่ นั่นคือ \n
การอ้างอิงคีย์นอกทั้งหมดไปยังไฟล์ .csv อื่นๆ จะต้องกำหนดไว้ในไฟล์อ้างอิง
กำลังอัปโหลด
หากขาดรายการจากการอัปโหลดก่อนหน้านี้ จะมีการปิดใช้งานบัญชีผู้ใช้และลบออกโดยอัตโนมัติหลังจากผ่านไป 120 หากไม่เป็นไปตามเงื่อนไขต่อไปนี้
ผู้ใช้มีบทบาทที่ได้ซื้อแอปหรือหนังสือเป็นจำนวนมาก
ผู้ใช้ถูกลบโดยการดำเนินการด้วยตนเองก่อนครบตามขีดจำกัดที่ 120 วัน
ไฟล์ทั้งหมดจะต้องบีบอัดลงในไฟล์เก็บถาวรรูปแบบ zip (.zip) เพื่ออัปโหลด
ไม่สามารถวางไฟล์ภายในโฟลเดอร์ในไฟล์เก็บถาวรรูปแบบ zip ได้
การจำกัดจำนวนอักขระในเทมเพลต .csv
บางช่องในเทมเพลต .csv มีการจำกัดจำนวนอักขระที่อนุญาต
ชื่อคุณลักษณะ | เทมเพลต | จำนวนอักขระที่จำกัด |
|---|---|---|
Apple: first_name OneRoster: givenName | Apple: นักเรียน เจ้าหน้าที่ OneRoster: ผู้ใช้ | 32 |
Apple: middle_name OneRoster: middleName | Apple: นักเรียน เจ้าหน้าที่ OneRoster: ผู้ใช้ | 32 |
Apple: last_name OneRoster: familyName | Apple: นักเรียน เจ้าหน้าที่ OneRoster: ผู้ใช้ | 64 |
Apple: grade_level OneRoster: ระดับชั้น | Apple: นักเรียน OneRoster: ผู้ใช้ | 64 |
Apple: email_address OneRoster: อีเมล | Apple: นักเรียน OneRoster: ผู้ใช้ | 256 |
Apple: person_number OneRoster: ตัวระบุ | Apple: นักเรียน เจ้าหน้าที่ OneRoster: ผู้ใช้ | 64 |
Apple: person_id OneRoster: sourcedId | Apple: นักเรียน เจ้าหน้าที่ ห้องเรียน บัญชีรายชื่อ OneRoster: ผู้ใช้ ห้องเรียน การลงทะเบียน | 256 |
Apple: sis_username OneRoster: ชื่อผู้ใช้ | Apple: นักเรียน เจ้าหน้าที่ OneRoster: ผู้ใช้ | 256 |
Apple: class_id OneRoster: sourcedID | Apple: ห้องเรียน บัญชีรายชื่อ OneRoster: ห้องเรียน การลงทะเบียน | 256 |
Apple: class_number OneRoster: classCode | Apple: นักเรียน ห้องเรียน OneRoster: ห้องเรียน | 64 |
Apple: course_id OneRoster: sourcedID | Apple: หลักสูตร ห้องเรียน OneRoster: หลักสูตร ห้องเรียน | 256 |
Apple: course_name OneRoster: ชื่อหลักสูตร | Apple: หลักสูตร OneRoster: หลักสูตร | 128 |
Apple: course_number OneRoster: courseCode | Apple: หลักสูตร OneRoster: หลักสูตร | 64 |
Apple: location_name OneRoster: ชื่อ | Apple: ตำแหน่งที่ตั้ง OneRoster: องค์กร | 256 |
Apple: location_id OneRoster: sourcedID | Apple: นักเรียน เจ้าหน้าที่ หลักสูตร ห้องเรียน ตำแหน่งที่ตั้ง OneRoster: ผู้ใช้ หลักสูตร ห้องเรียน องค์กร | 256 |