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