PUBLICX NOTAT / XML skemaer AF / Maibritt Kerner Introduktion Kommunikation mellem Eksamensdatabasen og eksterne systemer foregår primært via XML dokumenter. Formatet af disse XML dokumenter er defineret i en række XML skemaer. Dette dokument præsenterer de anvendte XML skemaer i en grafisk fremstilling. 1. Fødesystem: XML skemaer til ExDbRequestWS De nye generelle XML skemaer er konstrueret, så de understøtter indberetning af data og statusforespørgsel på tidligere versioner af indberetninger. Indberetningsdata Skemaerne for eksamens-/prøvebeviser (Certificate) og dets indlejrede skemaer samt skemaet for enkeltkarakterer (SingleGrade) er beskrevet i følgende afsnit. Details Nedenstående figur viser PersonDetails, Institution og StatutoryOrderReference i udfoldet tilstand. Disse skemaer hentes/refereres hos OIO, og er her blot vist for fuldstændighedens skyld. Element Type Længde Valide værdier PersonGivenName xs:string 50 Fornavn PersonSurnameName xs:string 40 Efternavn CivilRegistrationNumber xs:string 10 CPR nummer [Document Date] 09.11.2011 A264.331.6 Side 1 af 25
Element Type Længde Valide værdier Title xs:string 200 Det forventes, at det indberettende system finder indholdet til dette felt fra regelgrundlagstabellen i UMF Date xs:date Det forventes, at det indberettende system finder indholdet til dette felt fra regelgrundlagstabellen i UMF Element Type Længde Valide værdier LegalUnitName xs:string 50 Institutionsnavn InstitutionIdentifier xs:positiveinteger 6 Danmarks Statistiks institutionsnummer Certificate Generelt skema for eksamensbevis/prøvebevis, som bruges til indberetning fra Fødesystemet. 09.11.2011 A264.331.9 Side 2 af 25
09.11.2011 A264.331.9 Side 3 af 25
Element Type Længde Valide værdier new:certtype xs:string 3 UPP, COM, CSS, USS Bevistype (Internt felt, skal ikke udfyldes af det indberettende system) FeedSystemID xs:string 100 Fødesystemets Identifikation af det pågældende bevis new:examqualifier xs:string 3 STX, HF, HHX, HTX, GSK, GIF Eksamenstype (STX, HF, HHX, HTX, GSK, GIF) new:examqualifiertext xs:string 60 Studentereksamensbevis Spr. stud. eksamensbevis Mat. stud. eksamensbevis HF eksamensbevis (2004 bek.) HF eksamensbevis (1995 bek.) HF eksamensbevis Enkeltf. spr. stud. eks.bevis Enkeltf. mat. stud. eks.bevis HF Prøvebevis STX Prøvebevis Højere Handelseksamen GS, hhx- pakke Højere teknisk eksamen HHX Prøvebevis HTX Prøvebevis GIF eksamensbevis Tekstuel beskrivelse af eksamenstype new:examinationperiod xs:string 50 Format: V YY/YY+1 (eks. V 08/09), hvis terminen ligger mellem 1/10 31/3 eller S YYYY (eks. S 2009), hvis terminen ligger mellem 1/4 30/9. new:examinationperiodqualifier xs:string 50 Det forventes, at det indberettende system finder indholdet til dette felt fra prøveterminer (betegnelse) i UMF Tekstuel beskrivelse af den pågældende termin new:coesa xs:string 5 Det forventes, at det indberettende system finder indholdet til dette felt fra CØSA- Formålstabellen i UMF Cøsa formal New:CoesaVersion xs:positiveinteger 4 Det forventes, at det indberettende system finder indholdet til dette felt fra Uddannelsestabellen i UMF Version DateCreated xs:date Oprettelsesedato i det indberettende system new:examyear xs:gyear Eksamensår new:issued xs:string 50 Udstedelsesdato new:issuingauthority xs:string Rektor ExamResult xs:decimal 3, 1 Opnået eksamensresultat JustificationFactor xs:decimal 3,2 Bonus A factor 09.11.2011 A264.331.9 Side 4 af 25
JustifiedExamResult xs:decimal 3, 1 Justeret eksamensresultat ExaminationMarkYearAverage xs:decimal 3, 1 Gennemsnit for afsluttende standpunktskarakter (årskarakter) ExaminationMarkAverage xs:decimal 3, 1 Gennemsnit for prøvekarakterer AverageCalcScale xs:string 15 Værdier der er valide i UMF Karakterskala for gennemsnit New:SubjectCode xs:string 5 Det forventes, at det indberettende system finder indholdet til dette felt fra fagtabellen (fagnummer) i UMF Fagnummer new:subjectname xs:string 50 Det forventes, at det indberettende system finder indholdet til dette felt fra fagtabellen (betegnelse) i UMF Fagnavn new:level xs:string 1 Det forventes, at det indberettende system finder indholdet til dette felt fra fagtabellen i UMF Niveau new:subjectstudiedlevel xs:string 5 Fagniveau for afgivet karakter 09.11.2011 A264.331.9 Side 5 af 25
TestGrade Generelt skema for de basale dele af en karakter. Indgår i: et eksamensbevis eller et prøvebevis (én eller flere gange), en beregnet karakter (én eller flere gange) 09.11.2011 A264.331.9 Side 6 af 25
09.11.2011 A264.331.9 Side 7 af 25
Element Type Længde Valide værdier new:examinationperiod xs:string 50 Format: V YY/YY+1 (eks. V 08/09), hvis terminen ligger mellem 1/10 31/3 eller S YYYY (eks. S 2009), hvis terminen ligger mellem 1/4 30/9. New:SubjectCode xs:string 5 Det forventes, at det indberettende system finder indholdet til dette felt fra fagtabellen (fagnummer) i UMF Fagnummer MarkText xs:string 50 Beskrivende tekst til karakter MeritText xs:string 100 Beskrivende tekst til merit SchoolPeriod xs:string 4 Skoleperiode MeritInstitution xs:string 50 Merit institution new:subjectstudiedlevel xs:string 5 Fagniveau for afgivet karakter new:examinationyearperiod xs:integer 4 Året for den anførte termin StatutoryOrderShortName xs:string 3 HF, GYM Bekendtgørelse (HF, GYM) new:examyear xs:gyear Eksamensår new:subjectname xs:string 50 Det forventes, at det indberettende system finder indholdet til dette felt fra fagtabellen (betegnelse) i UMF Fagnavn new:level xs:string 1 Det forventes, at det indberettende system finder indholdet til dette felt fra fagtabellen i UMF Niveau new:markvalue xs:string 2 Værdier, der er valide i forhold til MarkingScale i UMF Afgivet karakter new:markqualifier xs:string 50 Mundtlig eksamen, Skriftlig eksamen, Mundtlig standpunktskarakter, Skriftlig standpunktskarakter, Større skriftlig opgave, Studieretningsprojekt, Eksamensprojekt, Almen studieforb. Det forventes, at det indberettende system validerer for korrekt resultatform for prøvekarakterer i UMF Resultatform new:markingscale xs:string 15 Værdier der er valide i UMF Karakterskala Merit xs:boolean True, false Merit: J/N MarkWeight xs:decimal 3, 2 Karakterens vægt i gennemsnittet DerivedMarkingScale1 xs:string 15 Værdier der er valide i UMF Karakterskala første afledt karakter DerivedMarkValue1 xs:string 2 Værdier, der er valide i forhold til MarkingScale i UMF Første afledt karakter 09.11.2011 A264.331.9 Side 8 af 25
DerivedMarkingScale2 xs:string 15 Værdier der er valide i UMF Karakterskala anden afledt karakter DerivedMarkValue2 xs:string 2 Værdier, der er valide i forhold til MarkingScale i UMF Anden afledt karakter new:projecttype xs:string 50 Det forventes, at det indberettende system finder indholdet til dette felt fra fagtabellen (betegnelse) i UMF. Skal svare til SubjectName Studieprojektet: f.eks: Eksamensprojekt, Almen studieforberedelse, Studieretningsprojekt, Større skriftlig opgave ProjectSubjectName xs:string 50 Det forventes, at det indberettende system finder indholdet til dette felt fra fagtabellen (betegnelse) i UMF Fagnavn f. projekt-underfag ProjectSubjectLevel xs:string 1 Det forventes, at det indberettende system finder indholdet til dette felt fra fagtabellen i UMF Niveau f. projekt-underfag ProjectSubjectCode xs:string 5 Det forventes, at det indberettende system finder indholdet til dette felt fra fagtabellen (fagnummer) i UMF Fagkode f. projekt-underfag 09.11.2011 A264.331.9 Side 9 af 25
CalculatedGrade Generelt skema for indberetning af beregnede karakterer. Anvendes kun som indlejret på Certificate, når der er tale om karakterer på et prøvebevis. 09.11.2011 A264.331.9 Side 10 af 25
09.11.2011 A264.331.9 Side 11 af 25
Element Type Længde Valide værdier new:subjectname xs:string 50 Det forventes, at det indberettende system finder indholdet til dette felt fra fagtabellen (betegnelse) i UMF Fagnavn new:level xs:string 1 Det forventes, at det indberettende system finder indholdet til dette felt fra fagtabellen i UMF Niveau new:subjectstudiedlevel xs:string 5 Fagniveau for afgivet karakter new:markingscale xs:string 15 Værdier der er valide i UMF Karakterskala new:markqualifier xs:string 50 Mundtlig eksamen, Skriftlig eksamen, Mundtlig standpunktskarakter, Skriftlig standpunktskarakter, Større skriftlig opgave, Studieretningsprojekt, Eksamensprojekt, Almen studieforb. Det forventes, at det indberettende system validerer for korrekt resultatform for prøvekarakterer i UMF Resultatform new:markvalue xs:string 2 Værdier, der er valide i forhold til MarkingScale i UMF Afgivet karakter new:examinationyearperiod xs:integer 4 Året for den anførte termin new:examinationperiod xs:string 50 Format: V YY/YY+1 (eks. V 08/09), hvis terminen ligger mellem 1/10 31/3 eller S YYYY (eks. S 2009), hvis terminen ligger mellem 1/4 30/9 09.11.2011 A264.331.9 Side 12 af 25
SingleGrade Generelt skema for indberetning af enkeltkarakterer. 09.11.2011 A264.331.9 Side 13 af 25
09.11.2011 A264.331.9 Side 14 af 25
Element Type Længde Valide værdier new:sgtype xs:string 3 USG, CSG Enkeltkaraktertype (intern) FeedSystemID xs:string 100 Fødesystemets Identifikation af det pågældende bevis new:examyear xs:gyear Eksamensår new:subjectname xs:string 50 Det forventes, at det indberettende system finder indholdet til dette felt fra fagtabellen (betegnelse) i UMF Fagnavn new:level xs:string 1 Det forventes, at det indberettende system finder indholdet til dette felt fra fagtabellen i UMF Niveau new:examqualifier xs:string 3 STX, HF HHX, HTX,GSK,GIF Eksamenstype (STX, HF, HHX, HTX, GSK, GIF) new:examqualifiertext xs:string 60 Studentereksamensbevis Spr. stud. eksamensbevis Mat. stud. eksamensbevis HF eksamensbevis (2004 bek.) HF eksamensbevis (1995 bek.) HF eksamensbevis Enkeltf. spr. stud. eks.bevis Enkeltf. mat. stud. eks.bevis HF Prøvebevis STX Prøvebevis Højere Handelseksamen GS, hhx- pakke Højere teknisk eksamen HHX Prøvebevis HTX Prøvebevis Tekstuel beskrivelse af eksamenstype new:coesa xs:string 5 Det forventes at det indberettende system finder indholdet til dette felt fra CØSA- Formåls-tabellen i UMF Cøsa formal new:coesaversion xs:positiveinteger 4 Det forventes at det indberettende system finder indholdet til dette felt fra Uddannelses-tabellen i UMF Version new:publicationdate xs:datetime YYYY-MM-DDThh:mm:ss Feltet angiver det tidspunkt, hvor en enkeltkarakter bliver offentliggjort, og dermed må vises i Eksamensdatabasen. Feltet er ikke tvunget. Offentliggørelsesdato DateCreated xs:date Oprettelsesedato i det indberettende system new:examinationperiod xs:string 50 09.11.2011 A264.331.9 Side 15 af 25
Format: V YY/YY+1 (eks. V 08/09), hvis terminen ligger mellem 1/10 31/3 eller S YYYY (eks. S 2009), hvis terminen ligger mellem 1/4 30/9. new:subjectcode xs:string 5 Det forventes, at det indberettende system finder indholdet til dette felt fra fagtabellen (fagnummer) i UMF Fagnummer MarkText xs:string 50 Beskrivende tekst til karakter MeritText xs:string 100 Beskrivende tekst til merit SchoolPeriod xs:string 4 Skoleperiode new:subjectstudiedlevel xs:string 5 Fagniveau for afgivet karakter new:examinationyearperiod xs:integer 4 Året for den anførte termin StatutoryOrderShortName xs:string 3 HF, GYM Bekendtgørelse (HF, GYM) MeritInstitution xs:string 50 Merit institution new:examyear xs:gyear Eksamensår new:subjectname xs:string 50 Det forventes, at det indberettende system finder indholdet til dette felt fra fagtabellen (betegnelse) i UMF Fagnavn new:level xs:string 1 Det forventes, at det indberettende system finder indholdet til dette felt fra fagtabellen i UMF Niveau new:markvalue xs:string 2 Værdier, der er valide i forhold til MarkingScale i UMF Afgivet karakter new:markqualifier xs:string 50 Mundtlig eksamen, Skriftlig eksamen, Mundtlig standpunktskarakter, Skriftlig standpunktskarakter, Større skriftlig opgave, Studieretningsprojekt, Eksamensprojekt, Almen studieforb. Det forventes, at det indberettende system validerer for korrekt resultatform for prøvekarakterer i UMF Resultatform new:markingscale xs:string 15 Værdier der er valide i UMF Karakterskala Merit xs:boolean True, false Merit: J/N DerivedMarkingScale1 xs:string 15 Værdier der er valide i UMF Karakterskala første afledt karakter DerivedMarkValue1 xs:string 2 Værdier, der er valide i forhold til MarkingScale i UMF Første afledt karakter 09.11.2011 A264.331.9 Side 16 af 25
DerivedMarkingScale2 xs:string 15 Værdier der er valide i UMF Karakterskala anden afledt karakter DerivedMarkValue2 xs:string 2 Værdier, der er valide i forhold til MarkingScale i UMF Anden afledt karakter new:projecttype xs:string 50 Det forventes, at det indberettende system finder indholdet til dette felt fra fagtabellen (betegnelse) i UMF. Skal svare til SubjectName Studieprojektet: Eksamensprojekt, Almen studieforberedelse, Studieretningsprojekt, Større skriftlig opgave ProjectSubjectName xs:string 50 Det forventes, at det indberettende system finder indholdet til dette felt fra fagtabellen (betegnelse) i UMF Fagnavn f. projekt-underfag ProjectSubjectLevel xs:string 1 Det forventes, at det indberettende system finder indholdet til dette felt fra fagtabellen i UMF Niveau f. projekt-underfag ProjectSubjectCode xs:string 5 Det forventes, at det indberettende system finder indholdet til dette felt fra fagtabellen (fagnummer) i UMF Fagkode f. projekt-underfag 09.11.2011 A264.331.9 Side 17 af 25
2. Modtagesystem: XML skemaer til ExDbRequestWS Beviser, prøvebeviser og enkeltkarakterer modtages i dette overordnede skema. 09.11.2011 A264.331.9 Side 18 af 25
Beviser og prøvebeviser Dette skema repræsenterer beviser og prøvebeviser fra gymnasiale uddannelser. 09.11.2011 A264.331.9 Side 19 af 25
09.11.2011 A264.331.9 Side 20 af 25
09.11.2011 A264.331.9 Side 21 af 25
09.11.2011 A264.331.9 Side 22 af 25
Enkeltkarakterer Dette skema repræsenterer karakterer fra gymnasiale uddannelser 09.11.2011 A264.331.9 Side 23 af 25
09.11.2011 A264.331.9 Side 24 af 25
3. Historik Korrekturmarkeringer angiver ændringer mellem den forrige og den aktuelle version af dokumentet. Dokumentid Dato Udarb. af Ændringer A264.727.8 25.10.2011 Kernerm Opdateret til version 2.4. A264.727.9 09.11.2011 Kernerm Opdateret med korrekte schemaer og CoesaVersion opdateret til positiveinteger. 09.11.2011 A264.331.9 Side 25 af 25