פרטי תבנית לייבוא נתונים אל Apple School Manager
כדי להוסיף נתונים ל-Apple School Manager, ניתן להשתמש בקבצים בתבנית .csv בפורמט של Apple או של OneRoster.
שמות תבניות .csv של Apple: סטודנטים, צוות, קורסים, כיתות, גיליונות נוכחות, מיקומים
שמות תבניות .csv של OneRoster: משתמשים, קורסים, כיתות, הרשמות, ארגונים
שם קובץ של Apple | שם קובץ של OneRoster | תוכן | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Apple: כולל את פרטי חשבונות הסטודנטים. OneRoster: כולל את פרטי חשבונות הסטודנטים, המורים והצוות. | |||||||||||
לא זמין | כולל את פרטי חשבונות הצוותים, כגון מורים. | ||||||||||
כולל את פרטי הקורסים. | |||||||||||
כולל מידע על כיתות ומורים (צוות). | |||||||||||
כולל מידע על הכיתה, הסטודנטים והמיקום (גיליון נוכחות). | |||||||||||
כולל פרטי מיקום (בית ספר או חוג). | |||||||||||
תבניות וחשבונות 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 יום, אלא אם:
למשתמש יש תפקיד שרכש יישומים או ספרים בכמות גדולה.
המשתמש נמחק באופן ידני לפני המגבלה של 120 יום.
השמות של קובצי ה‑.csv חייבים להיות זהים לשמות הקבצים המקוריים.
את כל הקבצים יש לדחוס לקובץ ארכיון מכווץ אחד (.zip) על מנת שניתן יהיה להעלות אותם.
אין למקם אף קובץ בתיקיה בתוך קובץ הארכיון המכווץ.
כל ההפניות למפתח זר בקובצי .csv אחרים חייבות להיות מוגדרות בקובץ שאליו ההפניה.
הגבלות תווים בתבניות .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: grades | Apple: סטודנטים OneRoster: משתמשים | 64 |
Apple: email_address OneRoster: email | Apple: סטודנטים OneRoster: משתמשים | 256 |
Apple: person_number OneRoster: identifier | Apple: סטודנטים, צוות OneRoster: משתמשים | 64 |
Apple: person_id OneRoster: sourcedId | Apple: סטודנטים, צוות, כיתות, גיליונות נוכחות OneRoster: משתמשים, כיתות, הרשמות | 256 |
Apple: sis_username OneRoster: username | 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: title | Apple: קורסים OneRoster: קורסים | 128 |
Apple: course_number OneRoster: courseCode | Apple: קורסים OneRoster: קורסים | 64 |
Apple: location_name OneRoster: name | Apple: מיקומים OneRoster: ארגונים | 256 |
Apple: location_id OneRoster: sourcedID | Apple: סטודנטים, צוות, קורסים, כיתות, מיקומים OneRoster: משתמשים, קורסים, כיתות, ארגונים | 256 |