Koulun tietojen synkronoinnin CSV-tiedostot

Voit käyttää CSV-tiedostoja (pilkulla erotetut arvot) School Data Syncin (SDS) kanssa, kun haluat synkronoida opiskelijatietojärjestelmäsi (SIS) Office 365:n kanssa. Jos käytät tätä menetelmää, tarvitset kuusi erilaista CSV-tiedostoa synkronointiprofiilin määrittämiseen SDS:ssä. Tässä aiheessa käsitellään tarvittavia CSV-tiedostoja ja niiden muotoilua.

School Data Syncin pakolliset CSV-tiedostot

Kun järjestelmänvalvoja määrittää SDS:ää CSV-tiedostojen avulla, hänen täytyy koota kuusi erillistä CSV-tiedostoa, jotka sisältävät kaikki alla luetellut pakolliset määritteet. Voit sisällyttää kuuteen CSV-tiedostoon myös mitä tahansa vapaaehtoisia määritteitä. Saat tarkat ohjeet synkronointiprofiilin määrittämiseen SDS:ssä CSV-tiedostojen avulla ohjeartikkelista School Data Syncin käyttöönotto CSV-tiedostojen avulla. Jos haluat hankkia CSV-esimerkkitiedostot, jotka sisältävät oikeiden määritearvojen mukaiset ja oikein muotoillut esimerkkitiedot, tutustu SDS GitHub -säilöön.

CSV-tiedostojen pakolliset määritteet vaihtelevat niiden synkronointiasetusten perusteella, jotka valitaan SDS-synkronointiprofiilin ohjatun määrityksen yhteydessä. Jos Office 365 -vuokraajasi on Yhdistyneessä kuningaskunnassa, kuudella CSV-tiedostolla ja niiden pakollisilla määritteillä on lisäksi joitain muitakin lisävaatimuksia. Saat lisätietoja näistä vaatimuksista tämän asiakirjan Yhdistyneen kuningaskunnan CSV-tiedostojen kohdasta. Voit myös tutustua Yhdistyneen kuningaskunnan esimerkkitiedostoihin SDS GitHub -säilössä.

Huomautus: Varmista, että CSV-tiedostot eivät sisällä virheellisiä merkkejä. Lisäksi CSV-tiedostoissa saa olla enintään 500 000 tietoriviä. Jos rivejä on enemmän kuin 500 000, ylimääräiset rivit on jaettava kuuden CSV-tiedoston joukoksi. Lisäksi sinun on luotava lisäsynkronointiprofiili tiedostojen latausta ja synkronointia varten.

Kuusi vaadittua CSV-tiedosto ovat seuraavat:

Huomautus: CSV-tiedostojen nimien on oltava täysin samat kuin yllä mainitut, ja kaikkien tiedostojen on oltava samassa kansiossa tai hakemistossa paikallisessa tietokoneessa. Kyseisessä hakemistossa ei saa olla muita tiedostoja. Lisäksi jokainen alla mainittu CSV-tiedoston määritteen nimi määritetään kyseisen CSV-tiedoston otsikoksi.

Kaikkien CSV-tiedostojen on oltava samassa hakemistossa

School.csv

School.csv-tiedoston täytyy sisältää seuraavat pakolliset määritteet. Nämä ovat pakolliset vähimmäisvaatimukset, jotka vaaditaan, jotta voit luoda oppilaitoksen ja synkronoida sen SDS:ssä. Jos et sisällytä näitä määritteitä, tiedoston lataaminen järjestelmään saattaa epäonnistua tai oppilaitoksen luominen tai synkronointi ei ehkä onnistu oikein. Tämä aiheuttaa virheen synkronointiprofiilin virheraporttiin.

  • SIS ID    – tämä on oppilaitoksen opiskelijatietojärjestelmätunnus (SIS-tunnus).

  • Name    – tämä on oppilaitoksen nimi.

School.csv-tiedoston valinnaiset määritteet

School.csv-tiedosto voi sisältää seuraavat vapaaehtoiset määritteet. Kun määrität synkronointiprofiilia, voit lisätä minkä tahansa alla luetellun valinnaisen määritteen, mutta jokaisen valitun määritteen tulee olla mukana myös vastaavassa CSV-tiedostossa sarakeotsikkona. Näiden määritteiden nimien täytyy olla täysin identtisiä kuin alla (kirjain kirjaimelta). Vaikka SDS ei vaadikaan näitä kenttiä, mitkä tahansa SDS:n synkronoituja tietoja käyttävät sovellukset saattavat käyttää näitä määritteitä. Muista sisällyttää mukaan kaikki tarvittavat määritteet mahdollisimman monipuolisen käytön takaamiseksi. Voit kysyä sovelluskehittäjiltä ja -julkaisijoilta lisätietoja siitä, miten näitä määritteitä käytetään eri sovelluksissa. Voit muokata ja lisätä synkronointiprofiilin vapaaehtoisia määritteitä SDS:ssä milloin tahansa tarpeiden mukaan.

  • School Number

  • School NCES_ID

  • State ID

  • Grade Low

  • Grade High

  • Principal SIS ID

  • Principal Name

  • Principal Secondary Email

  • Address

  • City

  • State

  • Country

  • Zip

  • Phone

  • Zone

Alla oleva näyttökuva on ohjatusta SDS-synkronointiprofiilin määrityksestä: siinä harmaana näytetyt määritteet ovat pakollisia ja muut näytetyt määritteet vapaaehtoisia.

Section.csv

Section.csv-tiedoston täytyy sisältää seuraavat pakolliset määritteet. Nämä ovat pakolliset vähimmäisvaatimukset, jotka vaaditaan, jotta voit luoda osan ja synkronoida sen SDS:ssä. Jos et sisällytä näitä määritteitä, tiedoston lataaminen järjestelmään saattaa epäonnistua tai osan luominen tai synkronointi ei ehkä onnistu oikein. Tämä aiheuttaa virheen synkronointiprofiilin virheraporttiin.

  • SIS ID    – tämä on osan SIS-tunnus.

  • School SIS ID    – tämä on oppilaitoksen opiskelijatietojärjestelmätunnus (SIS-tunnus).

  • Section name    – tämä on osan nimi.

Section.csv-tiedoston valinnaiset määritteet

Section.csv-tiedosto voi sisältää seuraavat vapaaehtoiset määritteet. Kun määrität synkronointiprofiilia, voit lisätä minkä tahansa alla luetellun valinnaisen määritteen, mutta jokaisen valitun määritteen tulee olla mukana myös vastaavassa CSV-tiedostossa sarakeotsikkona. Näiden määritteiden nimien täytyy olla täysin identtisiä kuin alla (kirjain kirjaimelta). Vaikka SDS ei vaadikaan näitä kenttiä, mitkä tahansa SDS:n synkronoituja tietoja käyttävät sovellukset saattavat käyttää näitä määritteitä. Muista sisällyttää mukaan kaikki tarvittavat määritteet mahdollisimman monipuolisen käytön takaamiseksi. Voit kysyä sovelluskehittäjiltä ja -julkaisijoilta lisätietoja siitä, miten näitä määritteitä käytetään eri sovelluksissa. Voit muokata ja lisätä synkronointiprofiilin vapaaehtoisia määritteitä SDS:ssä milloin tahansa tarpeiden mukaan.

  • Section Number

  • Term SIS ID

  • Term Name

  • Term StartDate

  • Term EndDate

  • Course SIS ID

  • Course Name

  • Course Number

  • Course Description

  • Course Subject

  • Periods

  • Status

Alla oleva näyttökuva on ohjatusta SDS-synkronointiprofiilin määrityksestä: siinä harmaana näytetyt määritteet ovat pakollisia ja muut näytetyt määritteet vapaaehtoisia.

Student.csv

Students.csv-tiedoston täytyy sisältää seuraavat pakolliset määritteet. Nämä ovat pakolliset vähimmäisvaatimukset, jotka vaaditaan, jotta voit luoda oppilaan ja synkronoida sen SDS:ssä. Jos et sisällytä näitä määritteitä, tiedoston lataaminen järjestelmään saattaa epäonnistua tai oppilaan luominen tai synkronointi ei ehkä onnistu oikein. Tämä aiheuttaa virheen synkronointiprofiilin virheraporttiin.

  • SIS ID    – tämä on opiskelijan opiskelijatietojärjestelmätunnus (SIS-tunnus).

  • School SIS ID    – tämä on oppilaitokselle annettu SIS-järjestelmän tunnus.

  • Username – tämä on opiskelijan käyttäjänimi. 

Jos valitsit SDS-synkronointiprofiilin ohjatussa määrityksessä uusien käyttäjien luomisen ja synkronoinnin asetuksen, myös kolme alla lueteltua määritettä ovat pakollisia. Jos valitsit nykyisten käyttäjien synkronoinnin asetuksen, nämä kolme määritettä eivät ole pakollisia. Tässä tapauksessa SDS ei myöskään voi korvata näitä määritteitä Azuressa, joten ne ovat jo mukana käyttäjäobjektissa.

Student.csv-tiedoston valinnaiset määritteet

Student.csv-tiedosto voi sisältää seuraavat vapaaehtoiset määritteet. Kun määrität synkronointiprofiilia, voit lisätä minkä tahansa alla luetellun valinnaisen määritteen, mutta jokaisen valitun määritteen tulee olla mukana myös vastaavassa CSV-tiedostossa sarakeotsikkona. Näiden määritteiden nimien täytyy olla täysin identtisiä kuin alla (kirjain kirjaimelta). Vaikka SDS ei vaadikaan näitä kenttiä, mitkä tahansa SDS:n synkronoituja tietoja käyttävät sovellukset saattavat käyttää näitä määritteitä. Muista sisällyttää mukaan kaikki tarvittavat määritteet mahdollisimman monipuolisen käytön takaamiseksi. Voit kysyä sovelluskehittäjiltä ja -julkaisijoilta lisätietoja siitä, miten näitä määritteitä käytetään eri sovelluksissa. Voit muokata ja lisätä synkronointiprofiilin vapaaehtoisia määritteitä SDS:ssä milloin tahansa tarpeiden mukaan.

  • State ID

  • Secondary Email

  • Student Number

  • Grade

  • Status

  • Mailing Address

  • Mailing City

  • Mailing State

  • Mailing Zip

  • Mailing Latitude

  • Mailing Longitude

  • Mailing Country

  • Residence Address

  • Residence City

  • Residence State

  • Residence Zip

  • Residence Latitude

  • Residence Longitude

  • Residence Country

  • Gender

  • Birthdate

  • ELL Status

  • FederalRace

  • Graduation Year

Alla oleva näyttökuva on ohjatusta SDS-synkronointiprofiilin määrityksestä: siinä harmaana näytetyt määritteet ovat pakollisia ja muut näytetyt määritteet vapaaehtoisia.

Teacher.csv

Teacher.csv-tiedoston täytyy sisältää seuraavat pakolliset määritteet. Nämä ovat pakolliset vähimmäisvaatimukset, jotka vaaditaan, jotta voit luoda opettajan ja synkronoida sen SDS:ssä. Jos et sisällytä näitä määritteitä, tiedoston lataaminen järjestelmään saattaa epäonnistua tai opettajan luominen tai synkronointi ei ehkä onnistu oikein. Tämä aiheuttaa virheen synkronointiprofiilin virheraporttiin.

  • SIS ID    – tämä on opettajan opiskelijatietojärjestelmätunnus (SIS-tunnus).

  • School SIS ID    – tämä on oppilaitokselle annettu SIS-järjestelmän tunnus.

  • Username – tämä on opettajan käyttäjänimi.

Jos valitsit SDS-synkronointiprofiilin ohjatussa määrityksessä uusien käyttäjien luomisen ja synkronoinnin asetuksen, myös kolme alla lueteltua määritettä ovat pakollisia. Jos valitsit nykyisten käyttäjien synkronoinnin asetuksen, nämä kolme määritettä eivät ole pakollisia. Tässä tapauksessa SDS ei myöskään voi korvata näitä määritteitä Azuressa, joten ne ovat jo mukana käyttäjäobjektissa.

Teacher.csv-tiedoston valinnaiset määritteet

Teacher.csv-tiedosto voi sisältää seuraavat vapaaehtoiset määritteet. Kun määrität synkronointiprofiilia, voit lisätä minkä tahansa alla luetellun valinnaisen määritteen, mutta jokaisen valitun määritteen tulee olla mukana myös vastaavassa CSV-tiedostossa sarakeotsikkona. Näiden määritteiden nimien täytyy olla täysin identtisiä kuin alla (kirjain kirjaimelta). Vaikka SDS ei vaadikaan näitä kenttiä, mitkä tahansa SDS:n synkronoituja tietoja käyttävät sovellukset saattavat käyttää näitä määritteitä. Muista sisällyttää mukaan kaikki tarvittavat määritteet mahdollisimman monipuolisen käytön takaamiseksi. Voit kysyä sovelluskehittäjiltä ja -julkaisijoilta lisätietoja siitä, miten näitä määritteitä käytetään eri sovelluksissa. Voit muokata ja lisätä synkronointiprofiilin vapaaehtoisia määritteitä SDS:ssä milloin tahansa tarpeiden mukaan.

  • State ID

  • Teacher Number

  • Status

  • Secondary Email

  • Title

  • Qualification

Alla oleva näyttökuva on ohjatusta SDS-synkronointiprofiilin määrityksestä: siinä harmaana näytetyt määritteet ovat pakollisia ja muut sinisenä näytetyt määritteet vapaaehtoisia.

StudentEnrollment.csv

StudentEnrollment.csv-tiedoston täytyy sisältää seuraavat pakolliset määritteet. Nämä ovat pakolliset vähimmäisvaatimukset, jotka vaaditaan, jotta voit luoda lisätä opiskelijan osaan SDS:ssä. Jos et sisällytä näitä määritteitä, tiedoston lataaminen järjestelmään saattaa epäonnistua tai oppilasrekisteröitymismääritysten luominen tai synkronointi ei ehkä onnistu oikein. Tämä aiheuttaa virheen synkronointiprofiilin virheraporttiin.

  • Section SIS ID    – tämä on osan opiskelijatietojärjestelmätunnus (SIS-tunnus).

  • SIS ID    – tämä on opiskelijan opiskelijatietojärjestelmätunnus (SIS-tunnus).

TeacherRoster.csv

TeacherRoster.csv-tiedoston täytyy sisältää seuraavat pakolliset määritteet. Nämä ovat pakolliset vähimmäisvaatimukset, jotka vaaditaan, jotta voit luoda lisätä opettajan osaan SDS:ssä. Jos et sisällytä näitä määritteitä, tiedoston lataaminen järjestelmään saattaa epäonnistua tai opettajaluettelonyhdistämisen luominen tai synkronointi ei ehkä onnistu oikein. Tämä aiheuttaa virheen synkronointiprofiilin virheraporttiin.

  • Osan SIS-tunnus   – osan opiskelijatietojärjestelmätunnus (SIS-tunnus).

  • SIS-tunnus   – opettajan opiskelijatietojärjestelmätunnus (SIS-tunnus).

Yhdistyneen kuningaskunnan CSV-tiedostot

Jos olet ottamassa School Data Synciä käyttöön CSV-tiedostojen avulla Office 365 -vuokraajalle Yhdistyneessä kuningaskunnassa, yllä luetelluissa pakollisissa määritteissä ja niiden CSV-tiedostoissa on joitain eroja. Alla on yhteenveto Yhdistyneen kuningaskunnan CSV-tiedostojen kaikista pakollisista määritteistä. Kaikki yllä luetellut vapaaehtoiset määritteet ovat samoja myös Yhdistyneessä kuningaskunnassa.

School.csv

  • DfE number – tämä on oppilaitoksen DfE-numero.

  • Name  – tämä on oppilaitoksen nimi.

Section.csv

  • ID – tämä on osan tunnus.

  • School DfE number – tämä on oppilaitoksen DfE-numero.

  • Section Name – tämä on osan nimi.

Student.csv

  • ID – tämä on opiskelijan tunnus.

  • School ​​​​​​​DfE number – tämä on oppilaitoksen DfE-numero.

  • Username – tämä on opiskelijan käyttäjänimi.

Teacher.csv

  • ID – tämä on opettajan tunnus.

  • School ​​​​​​​DfE number – tämä on oppilaitoksen DfE-numero.

  • Username – tämä on opettajan käyttäjänimi.

StudentEnrollment.csv

  • Section ID – tämä on osan tunnus.

  • ID – tämä on opettajan SIS-tunnus.

TeacherRoster.csv

  • Section ID – tämä on osan tunnus.

  • ID – tämä on opettajan tunnus.

Aiheeseen liittyvät artikkelitpacteralocked100mathced

School Data Syncin ja Classroomin yleiskuvaus

School Data Syncin käyttöönotto CSV-tiedostojen avulla

Kehitä taitojasi
Tutustu koulutusmateriaaliin
Saat uudet ominaisuudet ensimmäisten joukossa
Liity Office Insider -käyttäjiin

Oliko näistä tiedoista hyötyä?

Kiitos palautteesta!

Kiitos palautteestasi! Näyttää siltä, että Office-tukiedustajamme avusta voi olla sinulle hyötyä.

×