SFTP gebruiken om gegevens van leerlingen, medewerkers en klassen naar Apple School Manager te uploaden
Als je studenteninformatiesysteem (SIS) momenteel niet wordt ondersteund door Apple School Manager of als je geen studenteninformatiesysteem hebt, kun je gegevens van leerlingen, medewerkers en klassen naar Apple School Manager uploaden via SFTP.
Je eerste SFTP-upload configureren
Wanneer je SFTP configureert in de SIS/SFTP-assistent, ontvang je van Apple School Manager CSV-sjabloonbestanden en de toegangsgegevens voor een afgeschermde SFTP-server. Je kunt gegevens exporteren vanuit een ondersteund SIS of de bestanden aanmaken in een spreadsheetapp zoals Numbers. Voordat je exporteert vanuit je SIS, moet je contact opnemen met je SIS om te controleren of de structuur correct is voor Apple School Manager.
Voor een SFTP-upload is een programma van een andere fabrikant vereist in macOS. Als je geen SFTP-client hebt geïnstalleerd, kun je er een vinden in de Mac App Store.
Gebruik de knoppen hieronder om hulp te krijgen bij het instellen van de SFTP-bestanden. Als je SFTP nog niet eerder hebt gebruikt om gegevens te uploaden naar Apple School Manager, begin je met het gedeelte 'Je eerste SFTP-upload configureren'.
Je eerste SFTP-upload configureren
Log in bij Apple School Manager als beheerder, systeembeheerder of personenmanager.
Klik op je naam onderaan de navigatiekolom, klik op 'Voorkeuren', klik op 'Accounts', klik op 'Directory-synchronisatie' en selecteer 'Schakel in' in het gedeelte 'SIS/SFTP'. Voordat je SFTP kunt configureren, moet je eerst een domein verifiëren.
Klik op 'Leerlingen, docenten en klassen vinden'.
Klik op 'SFTP instellen'.
Apple School Manager genereert een URL, gebruikersnaam en wachtwoord om te gebruiken wanneer je bestanden uploadt. Gebruik deze informatie om je SFTP-client te configureren.
Klik op 'Download sjablonen'.
Lees de instructies voor het gebruik van sjablonen in het gedeelte 'Gegevensbestanden invullen'.
Wanneer je gegevensbestanden zijn ingevuld, maak je een ziparchief van alle zes bestanden. In de Finder kun je de bestanden selecteren en vervolgens in het Archief-menu 'Comprimeer 6 onderdelen' kiezen. Het maakt niet uit welke naam je het ziparchief geeft.
Upload het zipbestand naar Apple School Manager. Gebruik een SFTP-client om verbinding te maken met de URL die in de SIS/SFTP-assistent wordt weergegeven. Als je wordt gevraagd om inloggegevens, gebruik je de gebruikersnaam en het wachtwoord die je hebt gekregen toen je op 'SFTP instellen' klikte. Kopieer het zipbestand naar de map 'Dropbox'.
Klik op 'Ga door' in de SIS/SFTP-assistent. Als je upload fouten bevat, kun je een logbestand doornemen waarin de bestanden en regels met fouten zijn geïdentificeerd. Corrigeer eventuele fouten in de gegevensbestanden en herhaal vervolgens stap 8 en 9. Je hoeft het vorige bestand niet van de SFTP-server te verwijderen.
Wanneer de SFTP-import is voltooid, klik je op 'Bekijk SFTP-data'. Als je fouten vindt, klik je op 'Annuleer'. Corrigeer eventuele fouten in de gegevensbestanden en herhaal vervolgens het uploadproces. Als de gegevens juist en volledig zijn, klik je op 'Ga door'.
Onder 'Maak accounts en klassen aan' kies je een structuur voor beheerde Apple ID's voor leerlingen, docenten en medewerkers. Klik op 'Bekijk accounts en klassen'. Wanneer de ID's de juiste structuur hebben, klik je op 'Maak accounts en klassen aan'. In de indeling van beheerde Apple ID's kunnen uitsluitend geverifieerde domeinen
Nadat de accounts zijn aangemaakt, verdeel je de inloggegevens onder gebruikers en wijs je rollen toe aan medewerkers.
Je gegevensbestanden invullen
De sjabloondownload bevat zes kommagescheiden bestanden (CSV) voor klassen, lessen, locaties, roosters, leerlingen en personeel. Als de sjablonen niet beschikbaar zijn in Apple School Manager, of als je je kopie van de originele sjablonen bent kwijtgeraakt, kun je deze opnieuw downloaden.
Je kunt je SIS gebruiken om gegevens te exporteren in de structuur die wordt beschreven in de sjablonen en dit artikel, of je kunt de sjablonen wijzigen in een spreadsheetprogramma zoals Numbers.
Gebruik de tabellen in dit artikel om ervoor te zorgen dat je de juiste informatie invoert en bewaar elk bestand vervolgens zonder de naam ervan te wijzigen.
Je waarden opmaken
Als je de sjablonen wijzigt, vervang je de voorbeeldgegevens door je eigen gegevens. Wijzig de inhoud van de koptekstcellen van het bestand niet. Voeg geen kolommen toe in bestanden, behalve als dat hieronder wordt aangegeven.
In elke sjabloon moet elke rij een unieke waarde weergeven. Voorbeeld: in students.csv moet elke rij een unieke leerling zijn. Bepaalde waarden voor die leerling kunnen leeg zijn. Letterwaarden zoals een regeleinde of aanhalingsteken binnen een naam moeten worden voorafgegaan door een backslash (\), zoals (\'). Eventuele ID's moeten alfanumeriek zijn en mogen een '-' bevatten.
Als je waarde een spatie ( ) of komma (,) bevat, gebruik je daar rechte aanhalingstekens (") omheen. Als je waarde geen van deze speciale tekens bevat, gebruik je geen aanhalingstekens. Als je geen aanhalingstekens gebruikt als dat wel nodig is, of als je gekrulde aanhalingstekens gebruikt, krijg je fouten in het uploadproces.
De waarden in je bestanden moeten worden gescheiden door komma's (,) of puntkomma's (;), ongeacht hoe je het bestand hebt aangemaakt. Gebruik geen spaties of tabs tussen een komma of puntkomma en de volgende waarde. Elk bestand moet worden gecodeerd als UTF-8 en Unix nieuwe-regels (\n) gebruiken.
Als een doorgaans optioneel veld zoals 'person_number' of 'sis_username' onderdeel is van je structuur voor beheerde Apple ID's, wordt het een verplicht veld. Als je het veld leeg laat, mislukt het uploaden met de fout 'MANAGED_ID_GENERATION_FAILED'.
Locatiebestand
location_id | Een unieke ID die bestaat uit cijfers en/of letters zonder spaties. | Nodig |
location_name | De naam van de locatie. | Nodig |
Je moet minimaal één locatie opgeven in het locatiebestand. Je kunt SFTP niet gebruiken om leerling- of personeelsaccounts aan te maken in de hoofdlocatie.
Leerlingenbestand
Als je SFTP gebruikt om een nieuwe persoon te uploaden en de person_id die je toewijst al bestaat in Apple School Manager, overschrijft je nieuwe persoon de bestaande gebruiker in Apple School Manager. Wanneer de overschrijving is voltooid, kun je die gebruiker alleen bijwerken via SFTP.
person_id | De unieke ID voor een specifieke leerling. Deze person_id moet overeenkomen met de unieke ID in je SIS, indien beschikbaar. Deze person_id is de unieke ID voor de leerling in Apple School Manager. Gebruik deze waarde om te verwijzen naar de leerling in het roosterbestand en naar docenten in het klassenbestand. | Nodig |
person_number | Nog een waarde waarmee een leerling op je school kan worden geïdentificeerd. Dit kan een identificatienummer van een leerling zijn. | Optioneel |
first_name | De voornaam van de leerling. | Nodig |
middle_name | De tweede naam van de leerling. | Optioneel |
last_name | De achternaam van de leerling. | Nodig |
grade_level | Het onderwijsniveau van de leerling. | Optioneel |
email_address* | Een e-mailadres voor de leerling. | Optioneel |
sis_username | De gebruikersnaam voor de leerling in je SIS. | Optioneel |
password_policy | Gebruik het veld 'password_policy' om een wachtwoordbeleid op te geven voor elke leerling. Het veld 'password_policy' moet het getal 4, 6 of 8 bevatten, maar je kunt het veld ook leeg laten. Als je het getal '8' selecteert, wordt dit het standaardwachtwoordbeleid (acht of meer alfanumerieke tekens). Deze waarde overschrijft het wachtwoordbeleid van de locatie en elk ander wachtwoordbeleid dat eerder is ingesteld voor die leerling. Als je 'password_policy' leeg laat, wordt het standaardwachtwoordbeleid voor de locatie gebruikt voor een nieuwe leerling en worden er geen wijzigingen aangebracht aan bestaande leerlingen. | Optioneel |
location_id | De location_id voor de leerling. Deze moet overeenkomen met een location_id in het locatiebestand. Als deze vermelding niet overeenkomt met een vermelding in het locatiebestand, ondervind je problemen tijdens het uploadproces. | Nodig |
* Als gebundelde authenticatie Als het e-mailadres zich in een gebundeld domein bevindt, wordt de gebruikersaccount een federatieve account.
Meerdere locaties toewijzen
Je kunt aan een leerling meerdere locaties toewijzen door meerdere locatiekolommen toe te voegen in het leerlingenbestand. Je kunt maximaal 998 extra locatiekolommen toevoegen met de naam 'location_id_2', 'location_id_3' enzovoort, tot en met 'location_id_999'. Voor elke leerling kun je in deze kolommen optioneel een andere location_id invoeren. Deze moet overeenkomen met een location_id in het locatiebestand. Als deze vermelding niet overeenkomt met een vermelding in het locatiebestand, ondervind je problemen tijdens het uploadproces.
Medewerkersbestand
Als je SFTP gebruikt om een nieuwe persoon te uploaden, en de person_id die je toewijst al bestaat in Apple School Manager, overschrijft de nieuwe persoon de bestaande gebruiker in Apple School Manager. Wanneer de overschrijving is voltooid, kun je die gebruiker alleen bijwerken via SFTP. Alle medewerkers ontvangen het standaardwachtwoordbeleid (acht of meer alfanumerieke tekens).
person_id | De unieke ID voor een specifieke medewerker. Deze person_id moet overeenkomen met de unieke ID in je SIS, indien beschikbaar. Deze person_id is de unieke ID van de medewerker in Apple School Manager. Gebruik deze waarde om te verwijzen naar docenten in het klassenbestand. | Nodig |
person_number | Nog een waarde waarmee een medewerker op je school kan worden geïdentificeerd. Dit kan een badgenummer van een medewerker zijn. | Optioneel |
first_name | De voornaam van de medewerker. | Nodig |
middle_name | De tweede naam van de medewerker. | Optioneel |
last_name | De achternaam van de medewerker. | Nodig |
email_address* | Een e-mailadres voor deze medewerker. | Optioneel |
sis_username | De gebruikersnaam voor de medewerker in je SIS. | Optioneel |
location_id | De location_id voor de medewerker. Deze moet overeenkomen met een location_id in het locatiebestand. Als deze vermelding niet overeenkomt met een vermelding in het locatiebestand, ondervind je problemen tijdens het uploadproces. | Nodig |
* Als gebundelde authenticatie Als het e-mailadres zich in een gebundeld domein bevindt, wordt de gebruikersaccount een federatieve account.
Meerdere locaties toewijzen
Je kunt aan een medewerker meerdere locaties toewijzen door meerdere locatiekolommen toe te voegen in het medewerkersbestand. Je kunt maximaal 998 extra locatiekolommen toevoegen met de naam 'location_id_2', 'location_id_3' enzovoort, tot en met 'location_id_999'. Voor elke medewerker kun je in deze kolommen optioneel een andere location_id invoeren. Deze moet overeenkomen met een location_id in het locatiebestand. Als deze vermelding niet overeenkomt met een vermelding in het locatiebestand, ondervind je problemen tijdens het uploadproces.
Lesbestand
course_id | Een unieke ID voor de les. Deze moet overeenkomen met de bijbehorende course_id die is gebruikt in het klassenbestand. | Nodig |
course_number | Een nummer voor de les. Dit nummer kan het lesnummer in je SIS of je lesprogrammagids zijn. | Optioneel |
course_name | De naam van je les. | Optioneel |
location_id | De location_id voor de les. Deze moet overeenkomen met een location_id in het locatiebestand. Als deze vermelding niet overeenkomt met een vermelding in het locatiebestand, ondervind je problemen tijdens het uploadproces. | Nodig |
Klassenbestand
class_id | Een unieke ID voor de klas. | Nodig |
class_number | Een getal of code waarmee deze klas in je organisatie wordt geïdentificeerd. In tegenstelling tot class_id wordt class_number niet gebruikt om naar deze klas te verwijzen in CSV-roosters. | Optioneel |
course_id | De course_id van de les waar deze klas bij hoort. Deze moet overeenkomen met een course_id in het klassenbestand. | Nodig |
instructor_id | De person_id voor de docent. Deze moet overeenkomen met de person_id die is gebruikt in het medewerkersbestand. | Optioneel |
instructor_id_2 | De person_id voor de docent. Deze moet overeenkomen met de person_id die is gebruikt in het medewerkersbestand. | Optioneel |
instructor_id_3 | De person_id voor de docent. Deze moet overeenkomen met de person_id die is gebruikt in het medewerkersbestand. | Optioneel |
location_id | De location_id voor de klas. Deze moet overeenkomen met de location_id in het locatiebestand. Als deze vermelding niet overeenkomt met een vermelding in het locatiebestand, ondervind je problemen tijdens het uploadproces. | Nodig |
Meerdere docenten toewijzen
Je kunt aan een klas meer dan drie docenten toewijzen door meerdere docentenkolommen toe te voegen in het klassenbestand. Je kunt maximaal 12 extra docentenkolommen toevoegen, met de naam 'instructor_id_4', 'instructor_id_5' enzovoort, tot en met 'instructor_id_15'. Voor elke klas kun je optioneel een andere person_id voor de docent invoeren. Deze moet overeenkomen met de person_id die is gebruikt in het medewerkersbestand.
Roosterbestand
roster_id | Een unieke ID voor het rooster in je SIS of andere lesdatabase (indien beschikbaar). | Nodig |
class_id | Een unieke alfanumerieke ID voor de klas. Deze moet overeenkomen met een class_id in het klassenbestand. | Nodig |
student_id | Een person_id voor één leerling. | Nodig |
Het roosterbestand wordt gebruikt om leerlingen toe te wijzen aan hun klassen. Elke regel in het bestand moet een unieke roster_id hebben en slechts één class_id en één person_id bevatten.
Je bestanden bijwerken
Wanneer je leerlingen, medewerkers en klassen wilt toevoegen of bewerken, bewerk je je gegevensbestanden en upload je de nieuwe kopieën. Wanneer je bestanden uploadt, moet je alle zes bestanden uploaden en moet elk bestand de volledige lijst van elke categorie bevatten, en niet alleen de onderdelen die je wilt toevoegen. Als je de SFTP-accountgegevens wilt controleren, kies je 'Instellingen' > 'Gegevensbron'.
Als je in Apple School Manager de SFTP-verbinding verbreekt, worden je accounts en klassen gewijzigd in 'Handmatig'. Je kunt dit oplossen door de SFTP-verbinding te herstellen en een nieuwe upload uit te voeren.
Na de eerste upload worden nieuwe accounts en klassen automatisch aangemaakt wanneer je uploadt. Als er fouten zijn, ontvang je een mail vanuit Apple School Manager.
Als een vermelding van een eerdere upload ontbreekt
Als een vermelding van een eerdere upload ontbreekt, wordt de account gedeactiveerd en automatisch verwijderd na 120 dagen, tenzij er nog volume-aankopen gekoppeld zijn aan de account.
Als een les of klas wordt verwijderd
Als een les of klas wordt verwijderd uit de upload, worden de leerlingen uit de klas verwijderd en wordt de bron gewijzigd in 'Handmatig'. Als een les in gebruik was in Schoolwerk, wordt het rooster verwijderd en moet er een nieuwe les worden aangemaakt om nieuwe inschrijvingen mogelijk te maken. Als een klas in gebruik was in Schoolwerk, worden de voortgangsgegevens automatisch verwijderd en zijn deze niet meer beschikbaar voor de docent of de leerlingen.
Lessen en klassen met een handmatige bron worden nog wel gesynchroniseerd met je MDM-oplossing, maar ze worden mogelijk niet meer weergegeven in de Klaslokaal-app. Handmatige klassen kunnen worden verwijderd in Apple School Manager als ze niet meer gesynchroniseerd hoeven te worden.
Informatie over producten die niet door Apple zijn gemaakt of externe websites die niet door Apple worden beheerd of getest, wordt verstrekt zonder aanbeveling of goedkeuring. Apple aanvaardt geen aansprakelijkheid wat betreft de keuze, de prestaties of het gebruik van websites of producten van derden. Apple doet geen enkele toezegging met betrekking tot de juistheid of de betrouwbaarheid van websites van derden. Neem contact op met de leverancier voor meer informatie.