Sjablooninformatie voor het importeren van records naar Apple School Manager
Apple biedt zes sjablonen die je kunt gebruiken om gegevens toe te voegen aan je locatie:
Leerlingen: Bevat informatie over leerlingenaccounts.
Medewerkers: Bevat info over medewerkeraccounts, zoals docenten.
Lessen: Definieert lessen.
Klassen: Bevat info over les, docent (medewerker)
Deelnemerslijsten: Bevat informatie over klas, leerling en locatie.
Locaties: Bevat informatie over locaties.
Sjablonen en beheerde Apple ID's
Als een optioneel veld, zoals person_number of sis_username, onderdeel is van de indeling van je Beheerde Apple ID, wordt het een vereist veld. Als je dit leeg laat, mislukt de SFTP-upload met de fout MANAGED_ID_GENERATION_FAILED.
Sjablonen voorbereiden
Bij de voorbereiding van een sjabloon moet er aan de volgende criteria worden voldaan:
Voor de sjablonen students.csv en staff.csv, moet person_id uniek zijn voor alle locaties.
Belangrijk: Als je SFTP gebruikt om een nieuwe gebruiker te uploaden en de person_id die je toewijst al is toegewezen aan een andere gebruiker, overschrijft de nieuwe gebruiker de bestaande gebruiker in Apple School Manager. Nadat het overschrijven is voltooid, kun je alleen die gebruiker bijwerken via SFTP.
Bij het bewerken van sjablonen vervang je de voorbeeldgegevens door die van jezelf. Verander de inhoud van de koprij van de bestanden niet. Maak geen dubbele kolommen in de bestanden. Je kunt kolommen toevoegen aan specifieke sjablonen.
In elk sjabloon moet elke rij een unieke waarde vertegenwoordigen. In het bestand students.csv bijvoorbeeld, moet elke rij een unieke leerling weergeven. Bepaalde waarden kunnen leeg zijn voor die leerling. Vaste waarden, bijvoorbeeld een regeleinde of aanhalingsteken binnen een naam, moeten gemaskeerd worden met een backslash (\). Bijvoorbeeld: \". Ingevoerde identificatie moet alfanumeriek zijn en mag een koppelteken (-) bevatten.
Als je waarde een spatie ( ) of een komma (,) bevat, gebruik dan rechte aanhalingstekens (") er omheen. Als je waarde geen van deze bijzondere tekens bevat, gebruik dan geen aanhalingstekens. Als je geen aanhalingstekens gebruikt waar deze nodig zijn, of je gebruikte kromme aanhalingstekens, dan krijg je fouten in het uploadproces.
De waarden in je bestand moeten worden gescheiden door komma's (,) of puntkomma's (;), ongeacht hoe je het bestand hebt aangemaakt. Er mogen geen spaties of tabs tussen een komma of puntkomma en de volgende waarde staan. Elk bestand moet als UTF-8 gecodeerd zijn. Gebruik de UNIX newline-codering om het einde van de regel weer te geven \n.
Als een invoer uit een eerdere upload ontbreekt, wordt het account gedeactiveerd en automatisch verwijderd na 120 dagen, tenzij het account volumecontent heeft aangeschaft.
De namen van de csv-bestanden moeten exact hetzelfde zijn als de oorspronkelijke bestandsnaam.
Alle bestanden moeten in één zip-bestand worden gecomprimeerd om geüpload te worden.
Er mogen geen bestanden in een map binnen het zip-archief worden gezet.
Alle externe-sleutelverwijzingen naar andere csv-bestanden moeten gedefinieerd worden in het bestand waarnaar wordt verwezen.
Tekenlimieten in .csv-sjablonen
Bepaalde velden in de .csv-sjablonen hebben een maximaal toegestaan aantal tekens.
Veld | Sjablonen | Tekenlimiet |
---|---|---|
first_name | Leerlingen, medewerkers | 32 |
middle_name | Leerlingen, medewerkers | 32 |
last_name | Leerlingen, medewerkers | 64 |
grade_level | Leerlingen | 64 |
email_address | Leerlingen | 256 |
person_number | Leerlingen, medewerkers | 64 |
person_id | Leerlingen, medewerkers, klassen, deelnemerslijsten | 256 |
sis_username | Leerlingen, medewerkers | 256 |
class_id | Klassen, deelnemerslijsten | 256 |
class_number | Klassen | 64 |
course_id | Lessen, klassen | 256 |
course_name | Lessen | 128 |
course_number | Lessen | 64 |
location_name | Locaties | 256 |
location_id | Leerlingen, docenten, lessen, klassen, locaties | 256 |