Indberetningsstruktur for Elevplanindberetning Dato 20-01-2016 Version Status 0.9 Foreløbig udgave Ansvarlig Egon Thor Hansen
Side 2 af 15 Ændringshistorik Version Kapitel/afsnit Beskrivelse 0.9 Dokumentet. Første udgave. Mangler endelig XML samt finpudsning af data- og indholdsbeskrivelser.
Side 3 af 15 Indhold 1 Indledning... 4 2 Hvordan?... 4 3 Hvilke personer skal indberetningen omfatte?... 4 4 Validering mod cpr-register inkl. navne- og adressebeskyttelse... 4 5 Hvilke oplysninger skal indberettes?... 5 5.1 Elever... 5 5.2 Skolemedarbejdere (lærere)... 5 5.3 Sletninger... 5 6 Hvad skal data indeholde?... 6 6.1 Elever... 6 6.2 Skolemedarbejdere... 9 7 Krydsvalideringsregler... 10 8 Midlertidige undtagelser... 10 9 XML Schema... 10 9.1 Elever... 10 9.2 Skolemedarbejdere... 14
Side 4 af 15 1 Indledning Dette dokument beskriver strukturen for de oplysninger, der skal indberettes til Elevplan fra studieadministrative systemer, som afløser EASY-A på erhvervsskolernes EUD-uddannelser, herunder EUX. Der skal ske en system til system -udveksling. Det betyder i praksis, at institutionens studieadministrative system har funktioner til at eksportere data og varetage selve dataudvekslingen ved hjælp af kald af et antal webservices i Elevplan. Indberetningerne skal ske dagligt. Overførselstidspunkterne for de enkelte institutioner aftales og skemalægges efter aftale mellem institutionen og STIL (Elevplan). Institutionens studieadministrative system skal have funktioner til at forsøge gentagelse af overførslen et nærmere defineret antal gange efter et nærmere defineret tidsrum, såfremt overførslen fejler. Disse parametre defineres endeligt efter en periode med pilotdrift. Den enkelte institution eller det enkelte studieadministrative system skal dagligt overvåge eventuelle fejlmeldinger fra dataoverførslen og enten selv afhjælpe eventuelle problemer eller indberette disse til STIL s support. 2 Hvordan? Hver indberetning skal ske som et udtræk af en aktuel status for de berørte personer. Desuden skal entiteter, som er slettet siden sidste udtræk, indberettes som slettet. 3 Hvilke personer skal indberetningen omfatte? Indberetningen skal omfatte følgende: Alle elever, som følger en EUD-uddannelse, herunder EUX, på institutionen, og som enten ikke er afgangsmeldt eller er afgangsmeldt inden for de seneste 30 dage. Alle skolemedarbejdere på institutionen, som via UNI-Login skal have adgang til Elevplan for at følge elevernes praktikuddannelse i Elevplan. 4 Validering mod cpr-register inkl. navne- og adressebeskyttelse Cpr-numre, som ikke er fiktive, forventes valideret mod cpr-registeret. Hvis personen ikke har navne- og adressebeskyttelse, forventes det, at navne- og adresseoplysningerne er i overensstemmelse med cpr-registeret. Hvis personen har navne- og adressebeskyttelse, forventes det, at fornavn og efternavn er det fiktive navn, eleven har valgt at anvende, og at adresseoplysningerne er
Side 5 af 15 blanke. Hvis skolen ikke kender elevens valgte kaldenavn, skal fornavn og efternavn anonymiseres automatisk. Cpr-numre, som er fiktive, forventes ikke valideret mod cpr-registeret. OBS: Bemærk, at det er gængs opfattelse, at man kan have adressebeskyttelse uden nødvendigvis at have navnebeskyttelse. Dette er ikke korrekt. Der er kun én slags beskyttelse: navne- og adressebeskyttelse, og hvis eleven har dette, skal både navn og adresse anonymiseres. 5 Hvilke oplysninger skal indberettes? 5.1 Elever Oplysninger om elever vedrører elevens Stamdata Uddannelse(r) Elevtype(r) Skoleforløb 5.2 Skolemedarbejdere (lærere) Oplysninger om skolemedarbejdere vedrører den enkelte lærers stamdata og status. Der skal kun sendes oplysninger om lærere, som skal anvende Elevplan, specielt lærere, som har behov for at anvende Elevplans praktikfaciliteter. 5.3 Sletninger Forekomster skal som udgangspunkt kun slettes, hvis der har været tale om en fejloprettelse. Ellers benyttes inaktivering og datostyring. Ved sletning af uddannelse/elevtype/skoleforløb for en elev angives UPD som operation på eleven og DEL som operation på den uddannelse hhv. elevtype hhv. skoleforløb, som skal slettes. Se desuden XML-beskrivelsen i afsnit 9 XML Schema.
Side 6 af 15 6 Hvad skal data indeholde? 6.1 Elever Institution: N institution string(6) 6-cifter institutionsnummer. Nøgle i institutionsregisteret. Betegnes også DS-nummer. Elev: operation string(3) DEL: Sletning af elev. UPD: Anvendes, uanset om der er tale om oprettelse, ændring eller status. N cpr string(10) Cpr-nummer uden -. Kan også være et fiktivt cprnummer. fiktivtcpr bool true: cpr-nummer er fiktivt. false: cpr-nummer er ikke fiktivt. fornavn string Personens fornavne. Hvis personen har navne- og adressebeskyttelse, skal kaldenavn angives i stedet. efternavn string Personens efternavn. Hvis personen har navne- og adressebeskyttelse, skal kaldenavn angives. co string Eventuel co-adresse. Blank, hvis personen har navne- og adressebeskyttelse. første 100 tegn.
Side 7 af 15 gade string Blank, hvis personen har navne- og adressebeskyttelse. sted string Blank, hvis personen har navne- og adressebeskyttelse. postnr string Blank, hvis personen har navne- og adressebeskyttelse. første 15 tegn. postdistrikt string Blank, hvis personen har navne- og adressebeskyttelse. land string Blank, hvis personen har navne- og adressebeskyttelse. email string Personens e-mail-adresse. mobilnummer string Personens mobilnummer dod bool true: Personen er død. false: Personen er ikke død. Uddannelse: N cosaformal string Max længde 4. Uddannelsens CØSA-formål i henhold til CØSA s definition.
Side 8 af 15 version string Max længde 4 Uddannelsens version i henhold til CØSA s definition. Bemærk: der må max være 1 version pr. CØSA-formål pr. elev pr. skole startdato dato Dato for elevens start eller indmeldelse på uddannelsen på skolen. afgangsdato dato eller tom Tom: eleven er aktiv. Ikke tom: Eleven er afgangsmeldt pr. denne dato. afgangskode string Max længde 4. Udfyldes, hvis afgangsdato er udfyldt. Værdi ifølge kodetabel udmeldt af UVM. afgangstekst string Max længde 100. Udfyldes med teksten, som svarer til afgangsårsagen. Elevtype: N elevtype string ifølge kodetabel udmeldt af CØSA. N startdato dato Den dato, elevtypen skal gælde fra. slutdato dato eller tom tom: Ingen slutdato. Dato: den sidste dato, elevtypen er gældende. Skoleforløb: N betegnelse string Betegnelse for skoleforløbet. N startdato dato Startdato for skoleforløbet. slutdato dato Må ikke være tom. Slutdato for skoleforløbet.
Side 9 af 15 skolehjem bool true: Eleven bor på skolehjem under skoleforløbet. false: Eleven bor ikke på skolehjem under skoleforløbet. skolepraktik bool true: Skoleforløbet vedrører elevens ophold i skolens praktikcenter. false: Forløbet er et forløb med skoleundervisning. 6.2 Skolemedarbejdere Nøgle Felt Type Bemærkning N institution string(6) 6-cifret institutionsnummer. Nøgle i institutionsregisteret. Betegnes også DS-nummer. operation string(3) DEL: Sletning af elev. UPD: Anvendes, uanset om der er tale om oprettelse, ændring eller status. N cpr string(10) Cpr-nummer uden -. Kan også være et fiktivt cprnummer. fiktivtcpr bool true: Cpr-nummer er fiktivt. false: Cpr-nummer er ikke fiktivt. fornavn string Personens fornavne Hvis personen har navne- og adressebeskyttelse skal kaldenavn angives i stedet efternavn string Personens efternavn. Hvis personen har navne- og adressebeskyttelse, skal kaldenavn angives.
Side 10 af 15 e-mail string Personens e-mail-adresse. arbejdsmobilnummer string Personens arbejdsmobilnummer. aktiv bool true: Personen er aktiv. false: Personen er ikke aktiv, dvs. kan ikke logge ind. dod bool true: Personen er død. false: personen er ikke død. 7 Krydsvalideringsregler (Beskrives senere). 8 Midlertidige undtagelser Der accepteres (midlertidigt) følgende undtagelser for manglende data: (beskrives senere). 9 XML Schema Nedenstående er foreløbige versioner. Valideringer er foreløbigt kun indsat som kommentarer. 9.1 Elever <?xml version="1.0"?> <xs:schema xmlns:xs="http://www.w3.org/2001/xmlschema"> <xs:simpletype name="institution"> <xs:restriction base="xs:string"> <xs:pattern value="\d{6}"/> </xs:restriction> </xs:simpletype> <xs:element name="elev" type="elev"/> <xs:complextype name="elev"> <xs:sequence> <xs:element name="operation" type="xs:string"/> <!-- værdisæt: UPD / DEL, ikke tom--> <xs:element name="cpr" type="xs:string"/> <!-- positiveinteger min 0100000000 max 9999999999, ikke tom--> <xs:element name="fiktivtcpr" type="xs:boolean"/> <!-- ikke tom-->
<xs:element name="fornavn" type="xs:string"/> <!-- maxlength 100, ikke tom--> <xs:element name="efternavn" type="xs:string"/> <!-- maxlength 100, ikke tom--> <xs:element name="co" type="xs:string"/> <xs:element name="gade" type="xs:string"/> <xs:element name="sted" type="xs:string"/> <xs:element name="postnr" type="xs:string"/> <!-- maxlength 15, eller tom--> <xs:element name="postdistrikt" type="xs:string"/> <xs:element name="land" type="xs:string"/> <xs:element name="email" type="xs:string"/> <xs:element name="mobilnummer" type="xs:string"/> <!-- maxlength 50, eller tom--> <xs:element name="dod" type="xs:boolean"/> <!-- ikke tom--> <xs:element name="uddannelse" type="uddannelse" minoccurs="0" maxoccurs="unbounded"/> </xs:sequence> </xs:complextype> <xs:complextype name="uddannelse"> <xs:sequence> <xs:element name="operation" type="xs:string" minoccurs="1" <!-- værdisæt: UPD / DEL, ikke tom--> <xs:element name="cosaformal" type="xs:string" minoccurs="1" <!-- string minlength 1 maxlength 4, ikke tom--> <xs:element name="version" type="xs:string" minoccurs="1" max- Occurs="1"/> <!-- string minlength 1 maxlength 4, ikke tom--> <xs:element name="startdato" type="xs:date" minoccurs="1" max- Occurs="1"/> <!-- dato 01-01-2000-31-12-2050, ikke tom--> <xs:element name="afgangsdato" type="xs:string" minoccurs="1" <!-- dato 01-01-2000-31-12-2050, eller tom--> <xs:element name="afgangskode" type="xs:string" minoccurs="1" <!-- maxlength 4, eller tom--> <xs:element name="afgangstekst" type="xs:string" minoccurs="1" <xs:element name="elevtype" type="elevtype" minoccurs="0" max- Occurs="unbounded"/> <xs:element name="skoleforlob" type="skoleforlob" minoccurs="0" maxoccurs="unbounded"/> </xs:sequence> </xs:complextype> <xs:complextype name="elevtype"> <xs:sequence> <xs:element name="operation" type="xs:string" minoccurs="1" Side 11 af 15
<!-- værdisæt: UPD / DEL, ikke tom--> <xs:element name="elevtype" type="xs:string" minoccurs="1" <!-- string minlength 1 maxlength 50, ikke tom--> <xs:element name="startdato" type="xs:date" minoccurs="1" max- Occurs="1"/> <!-- dato 01-01-2000-31-12-2050, ikke tom--> <xs:element name="slutdato" type="xs:string" minoccurs="1" max- Occurs="1"/> <!-- dato 01-01-2000-31-12-2050, eller tom--> </xs:sequence> </xs:complextype> <xs:complextype name="skoleforlob"> <xs:sequence> <xs:element name="operation" type="xs:string" minoccurs="1" <!-- værdisæt: UPD / DEL, ikke tom--> <xs:element name="betegnelse" type="xs:string" minoccurs="1" <!-- string minlength 1 maxlength 50, ikke tom--> <xs:element name="startdato" type="xs:date" minoccurs="1" max- Occurs="1"/> <!-- dato 01-01-2000-31-12-2050, ikke tom--> <xs:element name="slutdato" type="xs:string" minoccurs="1" max- Occurs="1"/> <!-- dato 01-01-2000-31-12-2050, eller tom--> <xs:element name="skolehjem" type="xs:boolean"/> <!-- ikke tom--> <xs:element name="skolepraktik" type="xs:boolean"/> <!-- ikke tom--> </xs:sequence> </xs:complextype> </xs:schema> Side 12 af 15
Side 13 af 15
Side 14 af 15 9.2 Skolemedarbejdere <?xml version="1.0"?> <xs:schema xmlns:xs="http://www.w3.org/2001/xmlschema"> <xs:simpletype name="institution"> <xs:restriction base="xs:string"> <xs:pattern value="\d{6}"/> </xs:restriction> </xs:simpletype> <xs:element name="medarbejder" type="medarbejder"/> <xs:complextype name="medarbejder"> <xs:sequence> <xs:element name="operation" type="xs:string"/> <!-- værdisæt: UPD / DEL, ikke tom--> <xs:element name="cpr" type="xs:string"/> <!-- positiveinteger min 0100000000 max 9999999999, ikke tom--> <xs:element name="fiktivtcpr" type="xs:boolean"/> <!-- ikke tom--> <xs:element name="fornavn" type="xs:string"/> <!-- maxlength 100, ikke tom--> <xs:element name="efternavn" type="xs:string"/> <!-- maxlength 100, ikke tom--> <xs:element name="email" type="xs:string"/> <xs:element name="arbejdsmobilnummer" type="xs:string"/> <!-- maxlength 50, eller tom--> <xs:element name="aktiv" type="xs:boolean"/> <!-- ikke tom--> <xs:element name="dod" type="xs:boolean"/> <!-- ikke tom--> </xs:sequence> </xs:complextype> </xs:schema>
Side 15 af 15