פרטי תבנית לייבוא רשומות אל Apple School Manager
Apple מספקת שש תבניות לשימוש לצורך הוספת נתונים למיקום שלך:
סטודנטים: תבנית זו מכילה את פרטי חשבונות הסטודנטים.
צוות: תבנית זו מכילה את פרטי חשבונות הצוותים, כגון מורים.
קורסים: תבנית זו מגדירה קורסים.
כיתות: תבנית זו מכילה פרטים על קורסים, כגון שם הקורס והמדריך (הצוות).
גיליונות נוכחות: תבנית זו מכילה פרטים על הכיתה, הסטודנטים והמיקום.
מיקומים: תבנית זו מכילה פרטי מיקום.
תבניות וחשבונות Apple ID מנוהלים
אם שדה אופציונלי – כמו as 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, כל שורה חייבת לכלול סטודנט/ית ספציפי/ת. חלק מהערכים עבור כל סטודנט/ית יכולים להיות ריקים. ערכים ליטרליים, למשל מעבר שורה או תו מרכאות בתוך שם, יש "להבריח" (escaped) באמצעות קו נטוי הפוך (\). לדוגמה: \". מזהים שמוזנים חייבים להיות אלפאנומריים ויכולים לכלול מקף (-).
אם הערך מכיל רווח ( ) או פסיק (,), יש להשתמש במרכאות ישרות (") מימינו ומשמאלו. אם הערך אינו מכיל אף אחד מהתווים המיוחדים הללו, יש להשתמש במרכאות. אם לא נעשה שימוש במרכאות היכן שהן נחוצות, או שנעשה שימוש במרכאות מסולסלות, תהליך ההעלאה יחזיר שגיאות.
בין הערכים בקבצים יש להפריד באמצעות תווי פסיק (,) או נקודה-פסיק (;), ללא קשר לאופן יצירת הקבצים. אין להשתמש ברווחים או בטאבים בין הפסיק או הנקודה-פסיק לבין הערך הבא. יש לקדד כל קובץ בפורמט UTF-8. כדי לייצג סוף שורה, יש להשתמש בקידוד שורה חדשה של UNIX – \n.
אם חסר ערך מהעלאה קודמת, החשבון יושבת ויימחק באופן אוטומטי לאחר 120 יום, אלא אם התבצעה מהחשבון קניית פריטי תוכן בכמויות גדולות.
השמות של קובצי ה‑.csv חייבים להיות זהים לשמות הקבצים המקוריים.
את כל הקבצים יש לדחוס לקובץ ארכיון מכווץ אחד (.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 |