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:
Structuur
De namen van de csv-bestanden moeten exact hetzelfde zijn als de oorspronkelijke bestandsnaam.
Verander van geen van de bestanden de naam van de koprij.
Verwijder geen kolommen, zelfs niet als de kolom leeg is.
Je kunt kolommen toevoegen aan de sjablonen voor leerlingen, medewerkers en klassen.
In elk sjabloon moet elke rij een unieke waarde vertegenwoordigen. In het bestand students.csv bijvoorbeeld, moet elke rij een unieke leerling weergeven.
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.
Bepaalde waarden kunnen leeg zijn. Zo kan in het bestand students.csv de tweede voornaam leeg zijn.
Vervang de voorbeeldgegevens door die van jezelf.
Opmaak
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.
Alle externe-sleutelverwijzingen naar andere csv-bestanden moeten gedefinieerd worden in het bestand waarnaar wordt verwezen.
Uploaden
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
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.
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 |