Sjablooninformatie voor het importeren van gegevens naar Apple¬School¬Manager
Om gegevens toe te voegen aan Apple School Manager, kun je csv-sjabloonbestanden met Apple bestandsindeling of met OneRoster-bestandsindeling gebruiken.
csv-sjabloonnamen van Apple: leerlingen, medewerkers, lessen, klassen, roosters, locaties
csv-sjabloonnamen van OneRoster: gebruikers, lessen, klassen, aanmeldingen, organisaties
Apple bestandsnaam | OneRoster bestandsnaam | Inhoud | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Apple: Bevat informatie over leerlingenaccounts. OneRoster: Bevat informatie over leerlingen-, docenten- en medewerkersaccounts. | |||||||||||
n.v.t. | Bevat info over medewerkeraccounts, zoals docenten. | ||||||||||
Bevat informatie over de les. | |||||||||||
Bevat informatie over klassen en docenten (medewerkers). | |||||||||||
Bevat informatie over de klas, leerling en locatie (rooster). | |||||||||||
Bevat informatie over de locatie (school of afdeling). | |||||||||||
Sjablonen en beheerde Apple Accounts
Als een optioneel veld, zoals person_number of sis_username, onderdeel is van de indeling van je beheerde Apple Account, 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 die gebruiker alleen 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 vermelding van een eerdere upload ontbreekt, wordt de gebruikersaccount gedeactiveerd en na 120 dagen automatisch verwijderd, tenzij:
De gebruiker heeft een rol die apps of boeken in bulk heeft aangeschaft
De gebruiker handmatig wordt verwijderd voordat de limiet van 120 dagen is verstreken
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.
Kenmerknaam | Sjablonen | Tekenlimiet |
|---|---|---|
Apple: first_name OneRoster: givenName | Apple: leerlingen, medewerkers OneRoster: gebruikers | 32 |
Apple: middle_name OneRoster: middleName | Apple: leerlingen, medewerkers OneRoster: gebruikers | 32 |
Apple: last_name OneRoster: familyName | Apple: leerlingen, medewerkers OneRoster: gebruikers | 64 |
Apple: grade_level OneRoster: grades | Apple: leerlingen OneRoster: gebruikers | 64 |
Apple: email_address OneRoster: email | Apple: leerlingen OneRoster: gebruikers | 256 |
Apple: person_number OneRoster: identifier | Apple: leerlingen, medewerkers OneRoster: gebruikers | 64 |
Apple: person_id OneRoster: sourcedId | Apple: leerlingen, medewerkers, klassen, roosters OneRoster: gebruikers, klassen, aanmeldingen | 256 |
Apple: sis_username OneRoster: username | Apple: leerlingen, medewerkers OneRoster: gebruikers | 256 |
Apple: class_id OneRoster: sourcedID | Apple: klassen, roosters OneRoster: klassen, aanmeldingen | 256 |
Apple: class_number OneRoster: classCode | Apple: leerlingen, klassen OneRoster: klassen | 64 |
Apple: course_id OneRoster: sourcedID | Apple: lessen, klassen OneRoster: lessen, klassen | 256 |
Apple: course_name OneRoster: title | Apple: lessen OneRoster: lessen | 128 |
Apple: course_number OneRoster: courseCode | Apple: lessen OneRoster: lessen | 64 |
Apple: location_name OneRoster: name | Apple: locaties OneRoster: organisaties | 256 |
Apple: location_id OneRoster: sourcedID | Apple: leerlingen, medewerkers, lessen, klassen, locaties OneRoster: gebruikers, lessen, klassen, organisaties | 256 |