Udtræk karakterstatistik til Ressourceregnskab for AVU og FVU
Dette er den tekniske dokumentation af indberetningen til Ministeriet for Børn og Undervisnings ressourceregnskab for AVU og FVU. Formatet stammer fra ministeriets prøveadministrative system 'PAS', som dog ikke længere eksisterer. Nedenstående dokumentation er en redigeret udgave af dokumentationen til PAS.
Generelt
Alle elektroniske indberetninger er XML-formaterede ASCII-filer.
Filnavne skal være uden mellemrum og uden ÆØÅ. Filnavnene skal være en sammensætning af institutionsnummeret, indberetningsterminen og indberetningstypen.
Hvis "&"-tegnet skal anvendes i tekstfelter, skal tegnet escapes på sædvanlig HTML-manér; altså med de fem tegn: "&"
XML giver mulighed for på en standardiseret måde at udveksle struktureret information. XML-filerne er "flade ASCII-filer".
Der findes i rigt udbud af informationer om XML. Dette dokument er dog tænkt at indeholde tilstrækkelig information til at der kan dannes korrekte, XML-formaterede filer.
Meget kort sagt er strukturen i en XML-fil følgende:
Første linje i filen er obligatorisk og fortæller om XML-versionen og det tegnsæt, der benyttes i filen. Her anvendes tegnsættet ISO-8859-1 hvilket er nødvendigt for at kunne benytte de særlige danske bogstaver (Æ, Ø og Å).
<?xml version=’1.0’ encoding=’ISO-8859-1’?>
Elementerne i XML-filen beskrives med "tags". Det er væsentligt, at tag’en bliver skrevet med den rigtige kombiniation af små og store bogstaver. En tag skal følges af en værdi eller flere nestede tags og afsluttes af en "slut-tag". Slut-tag’en hedder det samme som "start-tag’en" men har fået sat en "/" foran.
Herunder er vist et eksempel på element med en værdi (nemlig værdien "10"):
<Antal>10</Antal>
Herunder er vist et eksempel på et element, der indeholder andre elementer:
<Karakter>
<Karaktervaerdi>03</Karaktervaerdi>
<Antal>2</Antal>
</Karakter>
I forbindelse med beskrivelsen af hver indberetning vises et eksempel på en udfyldt XML-indberetning.
Bemærk, at man kan åbne en XML-fil med sin Internetbrowser og dels se indholdet af XML-filen og dels få lavet en grov-validering af om XML-syntaksen er overholdt.
1.
Læsevejledning
De enkelte felter der kan indgå i indberetningen er beskrevet i en tabel med følgende indhold:
| Felt | Navnet på feltet (tag’en).
Nogle tags er vist med med orddeling. I XML-filen må der ikke anvendes bindestreger og tag’ene må ikke dels over flere linjer. Hvis et felt er udeladt, vil det blive tolket som 0, "Nej" eller "neutralt". |
| Type | Der arbejdes med følgende typer:
Numerisk (max antal cifre, antal decimaler)N(2,1) C(10) Alfanummerisk (max antal tegn) Ja/Nej Der kan angives teksten "Ja" eller teksten "Nej" Dato |
| Kode | Hvis der er et kryds i kode, er der særlige begrænsninger på formatet koderne. Disse er beskrevet i afsnit 3 Formatter og koder.
Bemærk, at der for koderne er forskellige lovlige værdier for de forskellige prøveområder |
| AVU /IVU/FVU/FAB | For hvert prøveområde er angivet
* Feltet skal være tilstede og være udfyldt V Brugen af feltet er valgfri --- Feltet må ikke benyttes |
| Bemærkning | Her er angivet eventuelle kommentarer til feltet, |
Fælles header-oplysninger
Der anvendes den samme header for alle filer. Headeren indeholder følgende felter:
| Felt | Type | Kode | AVU | IVU | FVU | FAP | Bemærkning |
| FormatVersion | N(4) | X | * | * | * | * | Dækker over versionen af formattet af indberetningsfilen.
For hver indberetnings-type er der i beskrivelsen af typen angivet angivet et versionsnummer. Dette nummer skal skrives i indberetningsfilen. |
| System | C(20) | * | * | * | * | Leverandørspecifik system-identifikation, f.eks.
PacerData_v4.1 CSC_VUCWIN_1.0 |
|
| Proeveomraade | C(3) | X | * | * | * | * | |
| Instnr | N(6) | X | * | * | * | * | |
| Instnavn | C(49) | * | * | * | * | ||
| Indberetningsdato | Dato | * | * | * | * | Den dato indberetningen er dannet. |
1.
Eksempel
<?xml version=’1.0’ encoding=’ISO-8859-1’?>
<InstitutionensProevestatistikker>
<Header>
<FormatVersion>1</FormatVersion>
<System>LUDUS 1.29.0</System>
<Proeveomraade>AVU</Proeveomraade>
<Instnr>615024</Instnr>
<Instnavn>Midtbyskolen</Instnavn>
<Indberetningsdato>07-08-2001</Indberetningsdato>
</Header>
<Proevetermin>Maj-juni 2001</Proevetermin>
<Proevestatistik>
<Proeve>AP1</Proeve>
<Proevebetegnelse>Almenprøve 1</Proevebetegnelse>
<Proeveform>Skr</Proeveform>
<Karakter>
<Karaktervaerdi>03</Karaktervaerdi>
<Antal>2</Antal>
</Karakter>
<Karakter>
<Karaktervaerdi>8</Karaktervaerdi>
<Antal>12</Antal>
</Karakter>
<Karakter>
<Karaktervaerdi>10</Karaktervaerdi>
</Karakter>
</Proevestatistik>
</InstitutionensProevestatistikker>
1.
<InstitutionensProevestatistikker>
| Felt | Type | Kode | AVU | IVU | FVU | FAP | Bemærkning |
| <Header> | * | * | * | --- | Netop 1 pr. fil | ||
| Proevetermin | C(50) | X | * | * | * | --- | |
| <Proevestatistik> | * | * | * | --- | 1 eller flere prøvestatistiker pr. institutionsprøvestatistik. |
1.
<Header>
Se afsnit 2.2 Fælles header-oplysninger.
Der skal anvendes FormatVersion 1.
<Proevestatistik>
| Felt | Type | Kode | AVU | IVU | FVU | FAP | Bemærkning |
| Proeve | C(10) | X | * | * | * | --- | |
| Proevebetegnelse | V | V | V | --- | |||
| Proeveform | C(4) | X | * | * | * | --- | |
| Karakteremne | C(8) | X | V | V | V | --- | |
| <Karakter> | * | * | * | --- | 1 eller flere karakterangivelse pr. prøvestatistik. Bemærk, at hvis en karakterværdi ikke er angivet, bliver det tolket som at ingen studerende har opnået den pågældende karakter (Antal = 0). |
1.
<Karakter>
| Felt | Type | Kode | AVU | IVU | FVU | FAP | Bemærkning |
| Karaktervaerdi | C(2) | X | * | * | * | --- | |
| Antal | N(3) | V | V | V | --- | Antallet af studerende med karakteren, der er angivet i karakterværdi |
Bemærk, at de koder, der er angivet i dette kapitel, vil løbende blive ændret. Ministeriet for Børn og Undervisnings prøveadministration for de enkelte prøveområder vil advisere om ændringer i de tilladte koder.
Generelle formatter og koder
| CPR-nummer | DDMMYY-LLLL |
| Dato | DD-MM-YYYY, f.eks. 01-08-2001 for den 1. august 2001 |
| Datoer for
beskikkelsesstart og -slut |
(Se under det enkelte prøveområde) |
| Fagbetegnelse | (Se under det enkelte prøveområde) |
| Fagkode | (Se under det enkelte prøveområde) |
| Holdnr | (Se under det enkelte prøveområde) |
| Holdtype | (Se under det enkelte prøveområde) |
| Inst.nr. | LLLLLL, f.eks. 615024. Det er instituionens officielle nummer, og er det samme nummer som det, der benyttes til indberetninger til f.eks. Danmarks Statistik |
| Karakteremne | (Se under det enkelte prøveområde) |
| Karaktervaerdi | (Se under der enkelte prøveområde) |
| Postadresse | Værdiliste som angiver hvilken postadresse, der skal anvendes, når der sendes post til censor:
PRIV Censors privatadresse ALT Censors alternative adresse INST Adressen på censors hjeminstitution |
| Proeveform | (Se under det enkelte prøveområde) |
| Proevekode | (Se under det enkelte prøveområde) |
| Proeveomraade | Felterne kan antage følgende værdier:
AVU Almen Voksenuddannelse IVU Dansk for Indvandrere FVU Forberedende Voksenuddannelse FAP Folkeskolens afgangsprøver |
| Proevetermin | Prøveterminer og navnet herpå udmeldes af det enkelte prøveadministration. |
| StorSkrift | 12, 14 eller 16. |
| Telefonnummer | Dansk telefonnummer: 12341234
Udenlandsk: Frit format |
Koder for AVU
| Datoer for
beskikkelsesstart og -slut |
Beskikkelse foretages i ulige år for perioden 01-08-åå - 31-07-åå, men undtagelsesvist, skal der kunne foretages beskikkelse i perioden, hvis der er behov f.eks. pga. afgang i "utide". |
| Holdnr | (Der er ingen format-krav for dette prøveområde) |
| Holdtype | Der kan anvendes følgende holdtyper:
Kode Betegnelse Kode: Betegnelse DF Dag/flex DS Dag/særligt forløb DFS Dag/flex/særligt forløb AF Aften/flexASAften/særligt forløb AFS Aften/flex/særligt forløb IO Ikke oplyst/ukendt |
| Karakteremne | (Må ikke benyttes) |
| Karaktervaerdi | Der anvendes 13- eller 7-trinsskala. Herudover benyttes:
Kode Betegnelse IM Ikke mødt S Syg |
| Proeveform | Der kan anvendes følgende prøveformer:
Kode Betegnelse Skr Skriftlige Mdt Mundtlig Prj Projektarbejde |
Prøveterminer
Der benyttes syntaksen årstal,blank,termin, således at prøveterminerne benævnes:
"2002 december" (svarer til LUDUS terminskode 0212 og 0301)
"2002 SærligeForløb" (svarer til LUDUS terminskode 0208, 0209, 0210, 0211, 0302, 0303, 0304, 0307)
"2003 maj/juni" (svarer til LUDUS terminskode 0305 og 0306)
"2003 december" (svarer til LUDUS terminskode 0312 og 0401)
"2003 SærligeForløb" (svarer til LUDUS terminskode 0308, 0309, 0310, 0311, 0402, 0403, 0404, 0407)
"2004 maj/juni" (svarer til LUDUS terminskode 0405 og 0406)
"2004 december" (svarer til LUDUS terminskode 0412 og 0501)
"2004 SærligeForløb" (svarer til LUDUS terminskode 0408, 0409, 0410, 0411, 0502, 0503, 0504, 0507)
1.
Listen over fag og prøver.
| Fag | Betegnelse | Prøve | Betegnelse | Skr. | Mdt. | Pro. |
| 01 | Dansk | 0111 | Dansk, trin 1 | * | * | |
| 0122 | Dansk, trin 2 | * | * | * | ||
| 02 | Matematik | 0212 | Matematik, trin 1 | * | ||
| 0222 | Matematik, trin 2 | * | * | |||
| 03 | Engelsk | 0312 | Engelsk, trin 1 | * | ||
| 0322 | Engelsk, trin 2 | * | * | |||
| 04 | Tysk | 0412 | Tysk, trin 1 | * | ||
| 0422 | Tysk, trin 2 | * | * | |||
| 05 | Fransk | 0512 | Fransk, trin 1 | * | ||
| 0522 | Fransk, trin 2 | * | * | |||
| 06 | Naturfag | 0612 | Naturfag, trin 1 | * | ||
| 0624 | Naturfag, trin 2 | * | ||||
| 07 | Samfundsfag | 0721 | Samfundsfag | * | ||
| 08 | Mediefag | 0821 | Mediefag | * | ||
| 09 | Filosofi | 0921 | Filosofi | * | ||
| 10 | Historie | 1021 | Historie | * | ||
| 11 | Psykologi | 1121 | Psykologi | * | ||
| 12 | Dansk som andetsprog | 1221 | Dansk som andet-sprog | * | * | |
| 13 | Edb-fag | 1311 | Edb-fag, trin 1 | * | ||
| 1323 | Edb-fag informatik, trin 2 | * | ||||
| 1324 | Edb-fag layout, trin 2 | * | ||||
| 1322 | Edb-fag tekstbehandling, trin 2 | * | ||||
| 14 | Latin | 1421 | Latin | * | ||
| 15 | Billedkunst | 1520 | Billedkunst | * | ||
| 16 | Samarbejde og kommunikation | 1620 | Samarbejde og kommunikation | * |
1.
Koder for FVU
| Datoer for
beskikkelsesstart og -slut |
Startdato: 01-01-ÅÅÅÅ, slutdato: 31-12-ÅÅÅÅ.
Beskikkelsesperioden er 2 år. |
| Fagkode |
Kode Betegnelse 01F01 Læsning trin 1 01F02 Læsning trin 2 01F03 Læsning trin 3 01F04 Læsning trin 4 01F08 Læsning trin 1 - for ordblinde 01F09 Læsning trin 1 - for tosprogede 02F01 Matematik trin 1 02F02 Matematik trin 2 |
| Holdnr | (Der er ingen format-krav for dette prøveområde) |
| Holdtype | (Må ikke benyttes) |
| Karakteremnu | (Må ikke benyttes) |
| Proeveform | Der kan anvendes følgende prøveformer:
Kode Betegnelse Skr Skriftlige |
| Karaktervaerdi | Der anvendes bestået/ikke-bestået:
Kode Betegnelse B Bestået IB Ikke-bestået Herudover benyttes: Kode Betegnelse IM Ikke mødt S Syg |
Listen over fag og prøver.
| Fag | Betegnelse | Prøve | Betegnelse | Skr. | Mdt. |
| 01F | Læsning | 01F01 | Læsning trin 1 | * | |
| 01F02 | Læsning trin 2 | * | |||
| 01F03 | Læsning trin 3 | * | |||
| 01F04 | Læsning trin 4 | * | |||
| 02F | Matematik | 02F01 | Matematik, trin 1 | * | |
| 02F02 | Matematik, trin 2 | * |