Sjablooninformatie voor het importeren van gegevens naar Apple School Manager
Om gegevens toe te voegen aan Apple School Manager, kun je csv -bestanden gebruiken met Apple indeling of met OneRoster-indeling.
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 elke sjabloon moet elke rij een unieke waarde vertegenwoordigen. In het bestand students.csv moet bijvoorbeeld 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 worden gemaskeerd 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 (") eromheen. Als je waarde geen van deze bijzondere tekens bevat, gebruik dan geen aanhalingstekens. Als je geen aanhalingstekens gebruikt waar deze nodig zijn, of je gebruikt gekrulde aanhalingstekens, dan krijg je fouten in het uploadproces.
De waarden in je csv -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 worden gedefinieerd 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 csv -bestanden moeten in één zip-bestand (.zip) worden gecomprimeerd om te worden geüpload.
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 |