1. Generelt. GSI, import av datafil (spec 1.0) 1.1. Ingen individbasert innsamling Historikk Import Importmulighet i GSI

Transkript

1 1. Generelt 1.1. Ingen individbasert innsamling Det har noen år vært gjennomført testing av en individbasert innsamling til GSI (Grunnskolens Informasjonssystem). Det foreligger ikke nødvendige godkjenninger til at Utdanningsdirektoratet kan sette denne løsningen i drift. Det kan imidlertid bli aktuelt på et senere tidspunkt Historikk Det ble i 2008 gjort en større omlegging av GSI, og skjemaene ble ferdig så sent det året at det ikke ble laget mulighet for import av data fra skoleadministrative systemer. I 2009 var importmuligheten på plass, og det var da tre systemer som laget eksport til GSI. Skjemaene for 2010 ser ut til å bli klare først rundt , og det har derfor ikke vært sendt ut informasjon om importmuligheter til skoleadministrative systemer før nå Import Det er ingen endringer i selve formatet som brukes ved import i forhold til det som ble benyttet i Det betyr at det i prinsippet skal være mulig for skolene å kjøre eksport som kan brukes i Skoleåret er nytt Den eneste endringen som trengs i filen er at skoleåret settes til Kanskje har de skoleadministrative systemene sørget for at denne følger valgt skoleår i systemet. To felt har byttet navn Institusjonstypen som tidligere het "dinstitutiontype" er flyttet fra innsamlingsdata til enhetsdata og heter nå "uinstitutiontype" Driftsansvaret som tidligere het "dresponsibility" er flyttet fra innsamlingsdata til enhetsdata og heter nå "uresponsibility" Men importen vil takle både gamle og nye feltnavn på disse feltene. Bruker samme spec (1.0) som i fjor I XML-filen skal en angi hvilken spesifikasjon det importeres til. For at det skal bli minst mulig endringer for SAS, har vi altså valgt å beholde versjon 1.0 av spesifikasjonen Importmulighet i GSI Data som kan importeres, blir altså ikke på individnivå, men på samme nivå som de ligger i GSI (f.eks. antall gutter i 3. årstrinn, antall jenter med skyss hele skoleåret osv.). Beskrivelse av systemet: Det benyttes ordinært XML-format på datafilen. Feltreferansene som benyttes, er uavhengig av årlige omlegginger i skjemaene. Det betyr at leverandørene slipper å skrive om eksporten for nye år (kun evt. nye felt). En kan selv bestemme hvilke felt som skal ligge i datafilen, slik at det skoleadministrative systemet bare leverer de data som er tilgjengelig. En kan selv bestemme rekkefølgen på feltene i datafilen. Importen støtter mange skoler i samme fil. Dette er gunstig dersom kommunen kjører samme skoleadministrative løsning på flere skoler. Siden en ikke benytter individdata lenger, vil datafilen kunne leveres direkte i GSI uten noen form for kryptering av filen. Opplastingen vil skje over https pga at enkelte data kan oppfattes som sensitive ved små enheter Prinsipp Skolene kan redigere sine data i GSI, både før og etter at en har kjørt evt. import. GSI Importspesifikasjon Side 1 av 7

2 Ved import vil alle felt som ligger i filen, erstatte det som ligger i GSI. Blanke verdier blir ikke importert. Så dersom et felt er levert uten innhold, og det samme feltet har data i GSI, vil tallet som ligger i GSI bli liggende. Det vil bare bli kjørt import av de enheter som innlogget bruker har tilgang til å redigere på. Dersom filen inneholder flere skoler, må altså kommunen kjøre import for at alle skolene skal komme inn. Dersom en skole kjører en slik kommunefil, vil bare data fra den aktuelle skolen komme inn. Ved repeterende data (f.eks. antall elever pr. språk i ramme E) vil hele listen i GSI bli erstattet av det som kommer på filen. Adressedata for de fleste grunnskolene hentes hver dag fra NSR (Nasjonalt skoleregister). For disse enhetene vil adressedata på filen bli ignorert. Regelen er her som før: Det som kan registreres i GSI, kan importeres. Kalkulerte felt i GSI beregnes i importen av GSI-filen. Dersom det ligger data på kalkulerte felt i filen, vil disse bli ignorert. Som identifikator for hvilken enhet som rapporterer, benyttes GSI-Id (fem siffer der de to første er fylkesnummer). GSI-Id finnes i rammen Generelt i GSI Informasjon Det er opprettet et område på nettsidene til GSI der vi legger ut informasjon om import til GSI. Nettadressen er Testing av datafil Det finnes en valideringsfunksjon der leverandørene kan laste opp testfiler for å sjekke om de har korrekt format. Adressen er: Velg "Testing av fil". 2. Informasjon om filen Innhold Det er mulig å levere data til alle datafelt i GSI. Vi legger ved GSI-skjema med feltnavn og veiledning. Dere kan selv velge om dere vil ta med kalkulerte datafelt (f.eks. antall elever i 3. årstrinn som er sum av gutter og jenter). GSI vil ved import uansett kalkulere disse på nytt. Filen skal bare inneholde de datafelter som ligger inne i det skoleadministrative systemet. Det har ingenting å si om noen felter er blanke på grunn av at skolen ikke har lagt inn data. Skolen vil i GSI kunne skrive over og supplere det som er kommet inn gjennom importen. Format Formatet er XML. Spesifikasjon i punkt 4. Filnavn GSI har i utgangspunktet ingen krav til filnavn. For at det skal bli lettere for skolen å finne filen etter at den er laget og lettere å drive support, anbefaler vi følgende format på filnavnet: "GSI ÅÅÅÅ-MM-DD fritekst.xml". Eksempel: "GSI Borgen skole.xml" GSI Importspesifikasjon Side 2 av 7

3 3. Skjema og veiledning Det er vedlagt pdf-dokument med skjema og veiledning. På skjemaet står det navn på alle feltene. Det er disse navnene som benyttes i filen. Feltnavn Det finnes flere typer feltnavn i GSI: Type Eksempel Forklaring Enhetsfelt uname, u14.. Felt som er uavhengig av innsamling (f.ks. enhetens navn og telefonnummer) Datafelt d23, d289.. Ordinære felt som lagres for hver innsamling (f.eks. gutter i 3. årstrinn som får spesialundervisning) Repeterende r1, r2.. Felt nummereres fra 1 og oppover innenfor hver repeterende seksjon. Hver repeterende seksjon har et eget nummer (id) Repeterende I grunnskoleskjemaet i GSI er det nå 5 repeterende seksjoner. Disse har hver sin Id som benyttes i filen. 1: Kommuner i ramme A 2: Kommuner i ramme D (kun for private skoler) 3: Språk i ramme E 4: Kommuner i ramme E (kun for private skoler) 6: Kommuner i ramme K GSI Importspesifikasjon Side 3 av 7

4 4. Format på GSI-fil 4.1. XML-format Beskrivelse av elementer Element Attributtliste Beskrivelse Innhold gsi fileinfo collection system unit [0..*] - Toppelement, må alltid være med version date (dato) set (heltall) period name version id Hvilken versjon importspec'en har. Dato for eksport fra skolens system. Format dd.mm.yyyy Identifiserer hvilket innsamlingssett man importerer til. Vil være "1" for grunnskole. Unik innsamlingsidentifikator. For vil den være " ". Navnet på systemet som eksporterte filen. Versjon av systemet som eksporterte filen. Valgt enhets identifikator. I dag er denne GSI identifikatoren. [fileinfo], [unit] [collection], [system] [data], [repeating] data [0..*] id Verdiens feltnavn i GSIskjemaet. Feks "d231" eller "u4". Verdien som skal overføres til GSI for dette feltet. repeating [0..*] id (heltall) Angir en repeterende rad. Verdien i rid angir repeterende seksjon [data] Gyldige verdier uname: Tekst (maks 300 tegn) ucustomid: Tekst (5 tegn) u1-u30: Tekst (maks 300 tegn) d1-d949: Heltall d950-d999: Tekst (fri lengde) uinstitutiontype, uresponsibility: Heltall GSI Importspesifikasjon Side 4 av 7

5 Eksempel Format med eksempel. Feltnavn er markert med blått, eksempeldata med rødt. <?xml version="1.0" encoding="utf-8"?> <gsi xmlns:xsi=" xmlns=" xsi:schemalocation=" sas.xsd"> <fileinfo version="1.0" date=" "> <collection set="1" period=" "></collection> <system name="abc Systemer" version="2.1.4"></system> </fileinfo> <unit id="04002"> <data id="uname">hauge skole</data> <data id="u10">haugebakken 23</data> <data <data id="u14"> </data> <data id="d1">12</data> <data id="d2">17</data> <data id="d4">690</data> <repeating id="1"> <data id="r1">0402</data> <data id="r2">2</data> <repeating id="1"> <data id="r1">0406</data> <data id="r2">6</data> <data id="d199">85</data> <repeating id="3"> <data id="r1">125</data> <data id="r2">0</data> <data id="r3">2</data> <data id="r4">1</data> </unit> <unit id="14004"> <data id="uname">svingen skole</data> <data id="u10">svingen 14</data> <data id="d343">3</data> <data id="d344">1</data> <repeating id="1"> <data id="r1">0415</data> <data id="r2">2</data> </unit> </gsi> GSI Importspesifikasjon Side 5 av 7

6 4.2. Valgfelt Noen av feltene i GSI har forhåndsdefinerte verdialternativer. Disse feltene (samt gyldige verdier) er listet opp i den følgende tabellen. Feltnavn Innhold Verdier uinstitutiontype Institusjonstype 0: Ikke satt 1: Ordinær grunnskole (G) 2: Kommunen sentralt (K) 3: Spesialskole (S) 4: Frittstående SFO (F) uresponsibility Driftsansvar 0: Ikke satt 1: Fylkeskommunal 2: Interkommunal 3: Kommunal 4: Nedlagt 5: Privat 6: Statlig 7: Privat uten tilskudd d899 Målform 0: Ikke satt 1: Bokmål 2: Nynorsk 3: Samisk 4: Annet d900 Laveste årstrinn 0: Ikke satt 1: 1. årstrinn 2: 2. årstrinn.. 10: 10. årstrinn d901 Høyeste årstrinn Som laveste årstrinn (d900) d901 Adressedata er kontrollert 1:Ja, 0:Nei, -1:Ikke satt d903 SFO 1:Ja, 0:Nei, -1:Ikke satt d1(r1) Kommune Bruker standard kommunenummer (fire siffer) d276 Flere årstrinn i samme gruppe? 1:Ja, 0:Nei, -1:Ikke satt d1(r2) Kommune Bruker standard kommunenummer (fire siffer) d1(r3) Morsmål Språkliste, se lite på nettsiden d1(r4) Kommune Bruker standard kommunenummer (fire siffer) d731 Inntektsgraderte satser? 1:Ja, 0:Nei, -1:Ikke satt d732 Friplasser 1:Ja, 0:Nei, -1:Ikke satt d733 Søskenmoderasjon 1:Ja, 0:Nei, -1:Ikke satt d748 Benyttes skoleadm. system? 1:Ja, 0:Nei, -1:Ikke satt d749 Benyttes læringsplattform? 1:Ja, 0:Nei, -1:Ikke satt d750 Benyttes avtaler på IKTutstyr? 1:Ja, 0:Nei, -1:Ikke satt d250 Egen kommunal PP-tjeneste? 1:Ja, 0:Nei, -1:Ikke satt d805 Interkommunal PP-tjeneste 1:Ja, 0:Nei, -1:Ikke satt d806 Samordnet med PPT i VG 1:Ja, 0:Nei, -1:Ikke satt GSI Importspesifikasjon Side 6 av 7

7 4.3. Felt som importeres Det kan variere hvilke felt man vil akseptere import til. Dette gjelder enhetsfelt (som starter med "u"). Alle ordinære datafelt (som starter med "d" etterfulgt av et tall) vil være åpne for import. Det spiller likevel ingen rolle om felt man ikke har tilgang til å importere, er med i XMLfilen. Importen vil selv sørge for at kun de verdier man har tilgang til å importere, blir tatt med. 5. Systemer / leverandører Se punktet "Leverandører" på nettsiden GSI Importspesifikasjon Side 7 av 7