Informacje o szablonach na potrzeby importowania danych do usługi Apple School Manager
Aby dodać dane do usługi Apple School Manager, możesz użyć plików szablonu .csv sformatowanych przez Apple lub przez OneRoster.
Nazwy szablonów .csv Apple: Uczestnicy, Personel, Kursy, Klasy, Plany zajęć, Lokalizacje
Nazwy szablonów .csv OneRoster: Użytkownicy, Kursy, Klasy, Rejestracje, Organizacje
Nazwa pliku Apple | Nazwa pliku OneRoster | Zawartość | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Apple: Zawiera informacje o kontach uczestników. OneRoster: Zawiera informacje o kontach uczestników, prowadzących i personelu. | |||||||||||
Niedostępne | Zawiera informacje o kontach pracowników, na przykład prowadzących. | ||||||||||
Zawiera informacje o kursach. | |||||||||||
Zawiera informacje o klasach i prowadzących (pracownikach). | |||||||||||
Zawiera informacje o klasach, uczestnikach i lokalizacjach (planach zajęć). | |||||||||||
Zawiera informacje o lokalizacjach (szkołach lub wydziałach). | |||||||||||
Szablony i zarządzane konta Apple
Jeśli pole opcjonalne — takie jak person_number lub sis_username — jest częścią formatu zarządzanego konta Apple, staje się ono polem wymaganym. Jeśli pozostawisz je pustą, przesyłanie SFTP nie powiedzie się, zwracając błąd MANAGED_ID_GENERATION_FAILED.
Przygotowywanie szablonów
Podczas przygotowywania szablonu należy spełnić następujące kryteria:
Struktura
Nazwy plików .csv muszą być identyczne z oryginalnymi.
Nie zmieniaj nazwy wiersza nagłówka w żadnym pliku.
Nie usuwaj kolumny, nawet jeśli jest pusta.
Możesz dodawać kolumny do szablonów students, staff i classes.
W każdym szablonie każdy wiersz musi zawierać unikatową wartość. Na przykład w pliku students.csv każdy wiersz musi odpowiadać unikatowemu uczestnikowi.
W szablonach students.csv i staff.csv pole person_id musi być unikatowe dla wszystkich lokalizacji.
Ważne: Jeśli użyjesz SFTP do przesłania nowego użytkownika, a przypisany identyfikator person_id jest już przypisany do innego użytkownika, nowy użytkownik zastępuje istniejącego użytkownika w usłudze Apple School Manager. Po ukończeniu zastępowania można uaktualniać tego użytkownika tylko poprzez SFTP.
Niektóre wartości mogą być puste. Na przykład w pliku students.csv drugie imię może pozostać puste.
Zastąp przykładowe dane własnymi.
Formatowanie
Wartości literałów, na przykład znak podziału wiersza lub cudzysłowu w nazwie, musi być poprzedzony ukośnikiem odwrotnym (\), na przykład \". Wszelkie identyfikatory muszą składać się ze znaków alfanumerycznych i mogą zawierać myślnik (-).
Jeśli wartość zawiera spację ( ) lub przecinek (,), należy umieścić ją w prostym cudzysłowie ("). Jeśli wartość nie zawiera żadnego z takich znaków specjalnych, nie używaj cudzysłowu. Jeśli nie użyjesz cudzysłowu, gdy będzie wymagany, lub użyjesz cudzysłowu drukarskiego, będzie to skutkowało błędami podczas przesyłania plików.
Wartości w plikach muszą być oddzielone przecinkami (,) lub średnikami (;), niezależnie od sposobu utworzenia pliku. Nie wstawiaj spacji ani tabulatorów między przecinkiem lub średnikiem i następną wartością. Każdy plik musi mieć kodowanie UTF-8. Aby oznaczyć koniec wiersza, użyj symbolu nowego wiersza w formacie UNIX (\n).
Wszystkie odwołania kluczy obcych do innych plików .csv należy określić w pliku referencyjnym.
Przesyłanie
Jeśli brakuje wpisu z wcześniejszego przesłania, konto użytkownika zostanie dezaktywowane i automatycznie usunięte po 120 dniach, chyba że:
Użytkownik pełni rolę, w ramach której dokonywał grupowych zakupów aplikacji lub książek
Użytkownik zostanie ręcznie usunięty przed upływem 120-dniowego limitu.
Wszystkie pliki do wczytania muszą być skompresowane w jedno archiwum w formacie .zip.
Nie wolno umieszczać żadnego pliku w osobnym folderze w skompresowanym archiwum w formacie .zip.
Limity znaków w szablonach .csv
Niektóre pola w szablonach .csv mają ograniczenia dotyczące dozwolonej liczby znaków.
Nazwa atrybutu | Szablony | Limit znaków |
|---|---|---|
Apple: first_name OneRoster: givenName | Apple: Uczestnicy, Personel OneRoster: Użytkownicy | 32 |
Apple: middle_name OneRoster: middleName | Apple: Uczestnicy, Personel OneRoster: Użytkownicy | 32 |
Apple: last_name OneRoster: familyName | Apple: Uczestnicy, Personel OneRoster: Użytkownicy | 64 |
Apple: grade_level OneRoster: grades | Apple: Uczestnicy OneRoster: Użytkownicy | 64 |
Apple: email_address OneRoster: email | Apple: Uczestnicy OneRoster: Użytkownicy | 256 |
Apple: person_number OneRoster: identifier | Apple: Uczestnicy, Personel OneRoster: Użytkownicy | 64 |
Apple: person_id OneRoster: sourcedId | Apple: Uczestnicy, Personel, Klasy, Plany zajęć OneRoster: Użytkownicy, Klasy, Rejestracje | 256 |
Apple: sis_username OneRoster: username | Apple: Uczestnicy, Personel OneRoster: Użytkownicy | 256 |
Apple: class_id OneRoster: sourcedID | Apple: Klasy, Plany zajęć OneRoster: Klasy, Rejestracje | 256 |
Apple: class_number OneRoster: classCode | Apple: Uczestnicy, Klasy OneRoster: Klasy | 64 |
Apple: course_id OneRoster: sourcedID | Apple: Kursy, Klasy OneRoster: Kursy, Klasy | 256 |
Apple: course_name OneRoster: title | Apple: Kursy OneRoster: Kursy | 128 |
Apple: course_number OneRoster: courseCode | Apple: Kursy OneRoster: Kursy | 64 |
Apple: location_name OneRoster: name | Apple: Lokalizacje OneRoster: Organizacje | 256 |
Apple: location_id OneRoster: sourcedID | Apple: Uczestnicy, Personel, Kursy, Klasy, Lokalizacje OneRoster: Użytkownicy, Kursy, Klasy, Organizacje | 256 |