Informacje o szablonach na potrzeby importowania rekordów do usługi Apple School Manager
Firma Apple udostępnia sześć szablonów używanych do dodawania danych do Twojej lokalizacji:
Uczestnicy: Zawiera informacje o kontach uczestników.
Personel: Zawiera informacje o kontach pracowników, na przykład prowadzących.
Kursy: Zawiera definicje kursów.
Klasy: Zawiera informacje o kursie i prowadzących (personelu).
Listy uczestników zajęć: Zawiera informacje o klasach, uczestnikach i lokalizacjach.
Lokalizacje: Zawiera informacje o lokalizacjach.
Szablony i zarządzane Apple ID
Jeśli pole opcjonalne — takie jak person_number lub sis_username — jest częścią formatu zarządzanego Apple ID, 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:
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.
Jeśli edytujesz szablony, zastąp przykładowe dane własnymi. Nie zmieniaj zawartości wiersza nagłówka w żadnym pliku. Nie powielaj kolumn w żadnym pliku. Możesz dodawać kolumny do określonych szablonów.
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. Niektóre wartości w wierszu uczestnika mogą być puste. 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).
Jeśli brakuje wpisu z wcześniejszego przesłania, konto zostanie dezaktywowane i automatycznie usunięte po 120 dniach, chyba że konto ma zakupioną zawartość masową.
Nazwy plików .csv muszą być identyczne z oryginalnymi.
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.
Wszystkie odwołania kluczy obcych do innych plików .csv należy określić w pliku referencyjnym.
Limity znaków w szablonach .csv
Niektóre pola w szablonach .csv mają ograniczenia dotyczące dozwolonej liczby znaków.
Pole | Szablony | Limit znaków |
---|---|---|
first_name | Uczestnicy, personel | 32 |
middle_name | Uczestnicy, personel | 32 |
last_name | Uczestnicy, personel | 64 |
grade_level | Uczestnicy | 64 |
email_address | Uczestnicy | 256 |
person_number | Uczestnicy, personel | 64 |
person_id | Uczestnicy, personel, klasy, klasy, plany zajęć | 256 |
sis_username | Uczestnicy, personel | 256 |
class_id | Klasy, plany zajęć | 256 |
class_number | Klasy | 64 |
course_id | Kursy, klasy | 256 |
course_name | Kursy | 128 |
course_number | Kursy | 64 |
location_name | Lokalizacje | 256 |
location_id | Uczestnicy, personel, kursy, klasy, lokalizacje | 256 |