Använda SFTP för att överföra data om elever, personal och klasser till Apple School Manager
Om ditt elevinformationsystem (SIS) inte stöds av Apple School Manager, eller om du inte har ett elevinformationsystem, kan du överföra data om elever, personal och klasser till Apple School Manager med SFTP.
Ställ in din första SFTP-överföring
När du ställer in SFTP i SIS-/SFTP-assistenten får du tillgång till CSV-mallfilerna och information om hur du kommer åt en privat SFTP-server i Apple School Manager. Du kan exportera data från ett SIS-system som stöds eller skapa filerna i ett kalkylprogram som Numbers. Kontakta ditt SIS-system innan du exporterar från systemet för att se till att formatet passar Apple School Manager.
SFTP-överföring kräver ett tredjepartsprogram i macOS. Om du inte har installerat en SFTP-klient kan du hitta en i Mac App Store.
Använd knapparna nedan för att få hjälp med att installera dina SFTP-filer. Om du inte har använt SFTP för att överföra data till Apple School Manager går du till avsnittet Ställa in den första SFTP-överföringen.
Ställa in den första SFTP-överföringen
Logga in på Apple School Manager som Administratör, Platsansvarig eller Personansvarig.
Klicka på ditt namn längst ned i sidofältet, klicka på Inställningar, klicka på Konton, klicka på Katalogsynkronisering och välj sedan Aktivera i avsnittet SIS/SFTP. Du måste verifiera en domän
Klicka på Sök efter studenter, lärare och klasser.
/locale/sv-se/2022-asm-sftp-upload-data-setup-assistant-step-3.png)
Klicka på Ställ in SFTP.
/locale/sv-se/2022-asm-sftp-upload-data-find-students-staff-classes-step-4.png)
Apple School Manager genererar en URL, ett användarnamn och ett lösenord att använda när filer överförs. Använd den här informationen för att konfigurera SFTP-klienten.
/locale/sv-se/2022-asm-sftp-upload-data-sftp-info-step-5.png)
Klicka på Hämta mallar.
Läs instruktionerna för att använda mallar i avsnittet Fylla i datafiler.
När dina datafiler är ifyllda skapar du ett ZIP-arkiv med alla sex filerna. I Finder kan du välja filerna och sedan gå till menyn Arkiv och välja Komprimera 6 objekt. Det spelar ingen roll vad du döper ZIP-arkivet till.
Överför ZIP-filen till Apple School Manager. Använd en SFTP-klient till att ansluta till URL:en som visas i SIS-/SFTP-assistenten. När du uppmanas ange inloggningsinformation anger du användarnamnet och lösenordet som du fick när du klickade på Ställ in SFTP. Kopiera ZIP-filen till Dropbox-katalogen.
Klicka på Fortsätt i SIS-/SFTP-assistenten. Om det uppstår fel vid överföringen kan du gå igenom en logg som identifierar vilka filer och rader som innehåller felaktigheter. Rätta eventuella fel i datafilerna och upprepa sedan steg 8 och 9. Du behöver inte ta bort den tidigare filen från SFTP-servern.
När SFTP-importen är klar klickar du på Granska SFTP-data. Om du hittar några fel klickar du på Avbryt. Rätta eventuella fel i datafilerna och upprepa sedan överföringsprocessen. Klicka på Fortsätt när data är korrekta och slutförda.
/locale/sv-se/2022-asm-sftp-upload-data-review-sftp-data-step-11.png)
Välj ett hanterat Apple-ID-format för elever, lärare och personal under Skapa konton och klasser. Klicka på Förhandsgranska konton och klasser. När dessa ID:n är i rätt format klickar du på Skapa konton och klasser. Endast verifierade domäner
/locale/sv-se/2022-asm-sftp-upload-data-preview-accounts-step-12.png)
När kontona skapats distribuerar du inloggningsinformationen till användarna och tilldelar personalen roller.
/locale/sv-se/2022-asm-sftp-upload-data-done-step-13.png)
Fylla i datafiler
De hämtade mallarna omfattar sex CSV-filer för klasser, kurser, platser, register, elever och personal. Om mallarna inte är tillgängliga i Apple School Manager eller om du har tappat bort en kopia av de ursprungliga mallarna, kan du hämta dem igen.
Du kan använda ditt SIS-system för att exportera data i det format som beskrivs i mallarna och denna artikel, eller så kan du redigera mallarna i ett kalkylbladsprogram som Numbers.
Använd tabellerna i den här artikeln för att se till att du anger rätt information, och spara sedan varje fil utan att ändra dess namn.
Formatera dina värden
När du redigerar mallarna kan du ersätta exempeldata med egna data. Ändra inte innehållet i rubrikcellen för varje fil. Lägg inte till kolumner i någon fil förutom enligt beskrivningen nedan.
Alla rader i en mall måste ha unika värden. Exempel: Varje rad i mallen students.csv måste innehålla en unik elev. Vissa värden för den eleven kan vara tomma. Värden som radbrytningar och citattecken i namn måste föregås av ett omvänt snedstreck (\), till exempel (\”). Alla identifierare som anges måste vara alfanumeriska och de kan innehålla ett ”-”.
Om ditt värde innehåller blanksteg ( ) eller kommatecken (,), omger du det med raka citattecken ("). Om ditt värde inte innehåller något av dessa specialtecken använder du inte citattecken. Om du inte använder citattecken där de är nödvändiga, eller om du inte använder raka citattecken, uppstår problem vid överföringsprocessen.
Värdena i dina filer måste separeras med kommatecken (,) eller semikolon (;), oavsett hur du skapade filen. Använd inte blanksteg eller tabb mellan ett kommatecken eller semikolon och efterföljande värde. Filerna måste vara i UTF-8-format och använda Unix-kommando för ny rad (\n).
Om ett annars valfritt fält, såsom person_number eller sis_username, är en del av ditt hanterade Apple-ID-format blir det ett obligatoriskt fält. Om du lämnar det tomt misslyckas överföringen med felet MANAGED_ID_GENERATION_FAILED.
Platsfil
location_id | En unik identifierare som består av siffror och/eller bokstäver utan mellanslag. | Obligatorisk |
location_name | Namn på platsen. | Obligatorisk |
Du måste definiera minst en plats i platsfilen. Du kan inte använda SFTP för att skapa elev- eller personalkonto på den huvudsakliga ”översta” platsen.
Elevfil
Om du använder SFTP för att överföra en ny person och det person_id du tilldelar personen redan finns i Apple School Manager, skrivs den befintliga användaren över av den nya personen i Apple School Manager. När överskrivningen är slutförd kan du endast uppdatera den användaren via SFTP.
person_id | Den unika identifieraren för en viss elev. Detta person_id bör matcha den unika identifieraren i SIS-systemet, om sådant finns. Detta person_id är den unika identifieraren för eleven i Apple School Manager. Använd det när du hänvisar till eleven i registerfilen och till lärare i klassfilen. | Obligatorisk |
person_number | Annat värde som kan identifiera en elev på din skola. Det kan vara ett elev-ID. | Valfritt |
first_name | Elevens förnamn. | Obligatorisk |
middle_name | Elevens mellannamn. | Valfritt |
last_name | Elevens efternamn. | Obligatorisk |
grade_level | Elevens betyg. | Valfritt |
email_address* | Elevens e-postadress. | Valfritt |
sis_username | Elevens användarnamn i SIS-systemet. | Valfritt |
password_policy | Använd fältet password_policy för att ange riktlinjer för lösenord för varje enskild elev. Fältet password_policy måste innehålla siffran 4, siffran 6, siffran 8 eller vara tomt. Om du väljer 8 blir det standardriktlinjer för lösenord (8 eller fler alfanumeriska tecken). Det här värdet åsidosätter platsens riktlinjer för lösenord och andra riktlinjer för lösenord som du har angett för eleven. Om du lämnar fältet password_policy tomt används en standardiserad riktlinje för lösenord för platsen för nya elever och inga ändringar görs för befintliga elever. | Valfritt |
location_id | Elevens location_id. Det måste stämma överens med ett location_id i platsfilen. Om den här posten inte matchar en post i platsfilen får du problem med överföringsprocessen. | Obligatorisk |
*Om federerad autentisering Om e-postadressen är i en federerad domän blir användarkontot federerat.
Tilldela flera platser
Du kan tilldela en elev mer än en plats genom att lägga till fler platskolumner i elevfilen. Du kan lägga till upp till 998 fler platskolumner med namnen location_id_2, location_id_3 upp till location_id_999. För varje elev är det valfritt att ange ett annat location_id för var och en av dessa kolumner. Det måste stämma överens med ett location_id i platsfilen. Om den här posten inte matchar en post i platsfilen får du problem med överföringsprocessen.
Personalfil
Om du använder SFTP för att överföra en ny person och det person_id du tilldelar personen redan finns i Apple School Manager, skrivs den befintliga användaren över av den nya personen i Apple School Manager. När överskrivningen är slutförd kan du endast uppdatera den användaren via SFTP. Alla i personalen följer standardpolicyn för lösenord (minst 8 alfanumeriska tecken).
person_id | Den unika identifieraren för en viss medarbetare i personalen. Detta person_id bör matcha den unika identifieraren i SIS-systemet, om sådant finns. Ett person_id är unikt för varje medarbetare i Apple School Manager. Använd det här värdet för att hänvisa till lärare i Klassfilen. | Obligatorisk |
person_number | Annat värde som kan identifiera en medarbetare på din skola. Det kan vara ett nummer på en ID-bricka. | Valfritt |
first_name | Medarbetarens förnamn. | Obligatorisk |
middle_name | Medarbetarens mellannamn. | Valfritt |
last_name | Medarbetarens efternamn. | Obligatorisk |
email_address* | En e-postadress till medarbetaren. | Valfritt |
sis_username | Medarbetarens användarnamn i ditt SIS-system. | Valfritt |
location_id | Medarbetarens location_id. Det bör stämma överens med ett location_id i platsfilen. Om den här posten inte matchar en post i platsfilen får du problem med överföringsprocessen. | Obligatorisk |
*Om federerad autentisering Om e-postadressen är i en federerad domän blir användarkontot federerat.
Tilldela flera platser
Du kan tilldela en medarbetare mer än en plats genom att lägga till fler platskolumner i Personalfilen. Du kan lägga till upp till 998 fler platskolumner med namnen location_id_2, location_id_3 upp till location_id_999. För varje medarbetare är det valfritt att ange ett annat location_id för var och en av dessa kolumner. Det måste stämma överens med ett location_id i platsfilen. Om den här posten inte matchar en post i platsfilen får du problem med överföringsprocessen.
Kursfil
course_id | En unik identifierare för kursen. Detta måste matcha motsvarande course_id som används i klassfilen. | Obligatorisk |
course_number | Ett nummer för kursen. Det här numret kan vara kursnumret i SIS eller i din kursplan. | Valfritt |
course_name | Kursens namn. | Valfritt |
location_id | Kursens location_id. Det bör stämma överens med ett location_id i platsfilen. Om den här posten inte matchar en post i platsfilen får du problem med överföringsprocessen. | Obligatorisk |
Klassfil
class_id | En unik identifierare för klassen. | Obligatorisk |
class_number | Ett nummer eller en kod som identifierar den här klassen i din organisation. Till skillnad mot class_id används inte class_number för att referera till denna klass i CSV-registret. | Valfritt |
course_id | Course_id på kursen som denna klass tillhör. Det måste matcha ett course_id i kursfilen. | Obligatorisk |
instructor_id | Lärarens person_id. Det här måste stämma överens med det person_id som används i personalfilen. | Valfritt |
instructor_id_2 | Lärarens person_id. Det här måste stämma överens med det person_id som används i personalfilen. | Valfritt |
instructor_id_3 | Lärarens person_id. Det här måste stämma överens med det person_id som används i personalfilen. | Valfritt |
location_id | Klassens location_id. Bör motsvara location_id i platsfilen. Om den här posten inte matchar en post i platsfilen får du problem med överföringsprocessen. | Obligatorisk |
Tilldela flera instruktörer
Du kan tilldela fler än tre instruktörer en klass genom att lägga till fler instruktörskolumner i Klassfilen. Du kan lägga till upp till 12 fler instruktörskolumner med namnen instructor_id_4, instructor_id_5 upp till instructor_id_15. För varje klass är det valfritt att ange ett annat person_id på instruktören. Det här måste stämma överens med det person_id som används i personalfilen.
Registerfil
roster_id | En unik identifierare för registret i SIS eller annan kursdatabas (om tillgänglig). | Obligatorisk |
class_id | En unik alfanumerisk identifierare för klassen. Det måste matcha ett class_id i klassfilen. | Obligatorisk |
student_id | Ett person_id på en elev. | Obligatorisk |
Registerfilen används för att lägga till elever i deras klasser. Varje rad i filen måste ha ett unikt roster_id och endast innehålla ett class_id samt ett person_id.
Uppdatera dina filer
När du vill lägga till eller ändra elever, personal och klasser ändrar du datafilerna och överför de nya versionerna. Samtliga sex filer måste överföras vid varje överföring, och varje fil måste innehålla den fullständiga listan för varje kategori, inte bara objekten som du vill lägga till. Du kan kontrollera uppgifterna om ett SFTP-konto genom att välja Inställningar > Datakälla.
Om du kopplar från SFTP-anslutningen i Apple School Manager ändras dina konton och klasser till manuella. Du löser detta genom att återskapa din SFTP-anslutning och göra en ny överföring.
Efter den första överföringen skapas nya konton och klasser automatiskt när du överför. Om det finns några fel skickar Apple School Manager ett e-postmeddelande till dig.
Om en post från en tidigare överföring saknas
Om en post från en tidigare överföring saknas inaktiveras och raderas kontot automatiskt
Om en kurs eller klass är borttagen
Om en kurs eller en klass tas bort från överföringen tas eleven bort från klassen och källan ändras till Manuell. Om kurserna användes i Skolarbete tas registret bort och en ny kurs måste skapas för omregistrering. Om klasserna användes i Skolarbete raderas data om framsteg automatiskt och är inte längre tillgängliga för läraren eller eleven.
Kurser och klasser med en manuell källa fortsätter att synkroniseras med din MDM-lösning, men kanske inte längre visas i appen Klassrum. Manuella klasser kan raderas i Apple School Manager om du vill ta bort dem från synkronisering.
Information om produkter som inte tillverkas av Apple eller som finns på oberoende webbplatser som inte står under Apples kontroll eller testats av Apple anges endast i informationssyfte och är inte att betrakta som rekommendationer av eller stöd för produkterna. Apple tar inget ansvar för valet eller nyttjandet av webbplatser eller produkter från tredje part och inte heller för produkternas prestanda. Apple garanterar inte att informationen på webbplatser från tredje part är korrekt eller tillförlitlig. Kontakta leverantören för mer information.
