4. Vedlegg. 4.1 Forklaring til strukturen. 1. Forklaring til strukturen 2. Oversikt over alle elementer og attributter 3.

Transkript

1 4. Vedlegg 1. Forklaring til strukturen 2. Oversikt over alle elementer og attributter 3. XML-skjema 4.1 Forklaring til strukturen Her følger en innledende beskrivelse av strukturen i XML-skjemaet (heretter kalt esu). Dette omfatter en beskrivelse av hovedstrukturen, generelle elementer og detaljer for enkelte av elementene. Dette er ikke en komplett beskrivelse av alle elementene i esu. Utfyllende og detaljerte kommentarer finnes i selve esu. ESUen er i henhold til XML-standarden. XML-standarden opererer med begrepene elementer, attributter og kommentarer. Elementer og attributter kan ses på som merkelapper. For enkelhets skyld bruker vi betegnelsen element for både element og attributt, med mindre det er nødvendig å spesifisere begge deler hver for seg. Elementnavn er skrevet på engelsk, og kommentarer og de fleste attributtverdier er skrevet på norsk. Engelske navn på elementene er valgt for å åpne for internasjonalisering av esu. For tilpasninger til norske forhold er kommentarene og de aller fleste attributtverdier skrevet på norsk. Å forandre disse på et senere tidspunkt, vil ikke ha store konsekvenser for esu. I denne beskrivelsen er alle navn på elementer skrevet med <haker> rundt seg. Enkelte elementer har tilleggsinformasjon i form av attributter. Attributtene er skrevet med gåseøyne rundt seg. Noen elementer har fastdefinerte lister over attributter, mens andre har attributtet user-defined der man selv kan velge hvilken attributtverdi som skal legges inn. Noen av elementene har også en kombinasjon av fastdefinerte attributter og user-defined. Bruken av user-defined skal dekke spesielle behov og tilpasninger for de enkelte institusjoner og aktører som skal benytte esu. Noen elementer kan brukes rekursivt; det vil si at et element kan brukes inni seg selv. Dette gir mulighet for bl.a. å beskrive at en institusjon kan ha mange underenheter (flere <unit> inni hverandre). De aller fleste elementer i esu er valgfrie. Dette gir god fleksibilitet i forhold til hvordan esu skal brukes, noe som igjen er avhengig av hvem som skal bruke den. De elementene som er påkrevd, er gjerne identifikatorer (Ider). I vedlagte skisser av esu, er valgfrie elementer stiplede bokser mens påkrevde elementer er hele bokser for elementene. Hovedelementet (rotelementet) i esu er <institution>. I noen tilfeller er det aktuelt å la andre elementer være rotelement. For eksempel kan det være nyttig å kunne levere en liste med <course> uten å måtte pakke informasjonen inn i informasjon om <institution>. En del av elementene er derfor definert som Schema Types. En slik definisjon gir blant annet mulighet for å bruke disse elementene som egne XML-filer. Et eksempel på et slikt esu , AFS, Dato: Side: 1

2 element er <course>. Det vil da være mulig å lage valide XML-filer som ikke har <institution>. Schema Types er skissert med gul bakgrunn på vedlagte skisser. Modellen er delt inn i tre hoveddeler, hhv <institution>, <course> og <program>. Disse tre hoveddelene skal kunne beskrive all utdanningsinformasjon. Et internt referansesystem for esu er basert på at institusjonen selv lager egne IDer på <unit>, <course>, <program> og <dicipline>. I <textblock> er det mulig å sette inn <IDref>. Her finnes det elementer som kan brukes til referanser mot de forskjellige ID-ene. Det vil da være opp til dem som skal bruke dataene, hvordan de setter opp et slikt referansesystem. <Generelle elementer> <textblock> er elementet for å sette inn et avsnitt. Inni dette elementet er det mulig å sette inn: <bold> for fet skrift <italic> for kursiv skrift <list> som er en liste med attributter bulleted og nummerert. <list> består av uendelig mange <list-item> som igjen kan inneholde de samme elementer som <textblock> <link> er en lenke til en webadresse. Denne består av en <href> som er adressen til hvor det skal lenkes, og <link-name> som er navnet på lenken. Det er kun <href> som er påkrevd, ettersom det i flere tilfeller kan være aktuelt å bruke <href> som <link-name>. < > skal brukes til epostadresser. <ID-ref> er et element som skal kunne brukes dersom man ønsker å lenke til andre elementer som har egen ID. Inni <ID-ref> ligger <course-id-ref>, <program-id-ref>, <diciplin-id-ref>, <unit-id-ref> og <institution-id-ref>. Disse referere til IDer med samme elementnavn uten ref. Her en oversikt over typen <textblock>: esu , AFS, Dato: Side: 2

3 <header-and-text> består av uendelig mange <textblock>. I tillegg er det mulig å sette inn en overskrift øverst. <user-defined> og user-defined er et element og et attributt som brukes for informasjon som ikke hører hjemme i de øvrige forhåndsdefinerte kodene i esu. En institusjon kan for eksempel ha behov for å merke informasjonen med egne koder. esu er fleksibel slik at elementet <user-defined> kan settes inn på flere steder i strukturen. <user-defined> har også et åpent attributt som heter user-defined. Attributtet user-defined finnes også i andre elementer med lister av attributter der vi ser at listene kan være utilstrekkelige, eller elementer der vi ser at det kan være behov en ekstra merkelapp. Dette er et åpent attributt, der institusjonen selv kan bestemme hva verdien skal være. På den måten vil det være mulig å trekke ut en mengde egendefinert elementer. <code> er et element som skal brukes til å angi koder som hovedsakelig er norske. Grunnen til at disse forskjellige kodene legges i samme element som attributtverdier, er for å internasjonalisere esu slik at alle elementnavn er generelle, og kun attributter som er spesielle for Norge. I dokumentasjonen under står det forklart hvilken type kode som skal presenteres på de forskjellige delene av modellen. <person> sine elementer er i hovedsak klassifisert etter IMS, se kapittel om internasjonale standarder. For å kunne klassifisere forskjellige grupper av <person>, er det mulig å selv gi attributt til <person>. Det er lagt inn <unitidref> inni person for mulighet til å referere til en <unit> som <person> hører til. I tillegg er det mulig å legge inn flere referanser og tekst i <textblock>. <person> har mulighet for flere <address>. Elementene <userid> og <name> er påkrevd. <person> har attributtet user-defined for å dekke spesialløsninger. <address> er illustrert til høyre Elementer som er satt inn i tillegg til det som direkte er hentet fra IMS, er <visit-hour> og <link>. I tillegg er det mulig å sette inn <headerand-text> i begynnelsen av elementet. Ingen elementer her påkrevd. <address> har også attributtet user-defined for å dekke spesialløsninger. <Institution> Dette er et rekursivt element. Det esu , AFS, Dato: Side: 3

4 betyr at man kan sette inn en <institution> inni en <institution>. På den måten kan en stor institusjon levere all sin informasjon samlet, med uendelig mange underinstitusjoner. De aller fleste vil kunne beskrive sin struktur ved hjelp av <unit>, men for eksempel BI vil ha et behov for en slik rekursiv løsning for <institution>. <institusjon> identifiseres ved <institutionid>. For Norge er dette organisasjonsnummeret fra Brønnøysundregisteret. <code>: Alternative identifikasjonskoder til <institutionid>. Dette vil her som oftest være SO-koden til institusjonen. I tillegg kan man legge til egne koder, ved å velge userdefined. <institutiontype>: Alternative attributter her er: "universitet", "vitenskapelig-hogskole", "kunsthogskoler, videregaende-fylke, folkehogskole, teknisk-fagskole, hogskoleprivat, hogskole-statlig, videregaende-privat, videregaende-statlig og studieforbud. Dersom ingen av disse passer, så kan man velge user-defined og skrive inn navnet på typen i elementet <institutiontype> <institution-acronym>: Forkortelse for institusjonen, eks UiB. <unit>: Kan brukes for å angi institusjonens indre struktur, f.eks. fakultet, institutt, avdelinger. Dette er et rekursivt element. <unitid> defineres etter organisasjonens egne behov. Den kan for eksempel være en stedkode. <institution-presentation>: Kort beskrivelse av institusjonen og evt. underenheter. Noen kategorier er forhåndsdefinert. I tillegg kan institusjonen legge til egen informasjon i <userdefined>. <Course> Dette er elementet som brukes for emner i høyere utdannelse, fag i videregående, kurs for de som bruker det begrepet (BI). <course> omfatter også kurs som ikke er kompetansegivende. Påkrevde elementer er kun <course-id> og <course-name>. <course-id>: brukes for å angi institusjonens ID for <course>. <code>: her skal det skrives inn kode til SSB (dette er NUS-koden eller andre koder definert av SSB) <level> har følgende attributter: "bachelor", "vgs", "master", "phd", user-defined. Velger man user-defined, kan man legge inn egen type. <credits>: her skal det skrives inn studiepoeng eller timer per år i videregående (Læreplanen bruker både per år og gjennomsnittlig uketimer). <course-presentation>: Her skal den formelle presentasjonen av <course> være. Elementene som er lagt inn her, er basert på elementer som er brukt i våre referanser. <syllabus> har et eget element for LOM objekter <form-of-teaching> kan fylles ut med informasjon om undervisningsform. Dersom formen er nettbasert eller brev kan dette velges som attributter. <teaching-semester> og <exam-semester> har begge attributter med følgende verdier: "vaar-og-hoest", hver-vaar", "hver-hoest", "annenhver-vaar", "annenhver-hoest", "userdefined". Sistnevnt element brukes dersom det ikke er mulig å angi semester med noen av de andre valgene. <teaching> beskriver alt som har med undervisningsaktiviteter for <course> å gjøre. Det er mulig å legge inn en del felles informasjon om all undervisning her i <textblock>. <admission-info> her er det mest interessant med av og -påmeldingsfrister. esu , AFS, Dato: Side: 4

5 <teaching-activity> kan man sette inn så mange man vil av. I tillegg er dette et rekursivt element. <teaching-activity> har attributtene: feltarbeid, forelesning, fjernundervisning, gruppeundervisning eller elearning. Dersom ingen av disse passer inn, velger man ikke å angi attributter selv i user-defined. <timetable-element> brukes for underaktiviteter av <teaching-activity>, for eksempel gruppeundervisning. <person> kan legges inn på alle nivåer i <teaching>. Dette kan for eksempel være faglærer. <exam> skulle dekke alle behov for presentasjon av tid og sted for eksamen. Alle hovedfeltene her har muligheten for <textblock>. Dette skal brukes dersom det ikke er tilstrekkelig med kun dato. <exam-structure> innholder alt om eksamensordningen. Det er mulig med uendelig mange <exam-structure> i <exam>. Dette vil det være behov for dersom man har for eksempel 2 alternativer for eksamen: skriftlig eller hjemmeoppgave i tilegg til muntlig. <exam-part> er de forskjellige eksmensdelene. Denne kan man ha uendelig mange av, for eksempel: en muntlig eksamensdel og en skriftlig. <text-block> brukes til å forklare andre detaljer om eksamen. <searchwords> skal brukes til å definere stikkord for søkemotorer, som for eksempel kan legges som metainformasjon i HTML-sider. Før et slikt element skal brukes, må de som skal bruke det lage retningslinjer for hvordan dette elementet skal fylles ut. <Program> <program> skal dekke alle typer samlinger av flere <course>. Det vil i høyere utdannelse hovedsakelig være studieprogram og i den videregående skole være løp. Kun <programname> og <program-id> er påkrevd. <program-id> skal identifisere <program>. Dette er en kode som kun trenger å være unik for institusjonen <duration> bør settes med attributtet aar eller semester her. Elementet godtar kun tall. <admission-info> inneholder en del forskjellige elementer for opptak. Dersom man ikke finner elementer for det som ønskes presentert, er det lagt inn mulighet for <header-andtext>. Ingen elementer er påkrevd. <admission-code> kan man sette inn opp til 2 stk av, ettersom man kan velge attributter for nom eller lokal kode. <program-presentation> er den største samlingen av informasjon. De elementene som er lagt inn her, er elementer som vi i våre undersøkelser har sett at det er ønskelig å trekke ut. Alle elementer her inneholder <header-and-text> ettersom det er store forskjeller fra institusjon til institusjon hvordan det er ønskelig å presentere disse elementene. Det er også mulig å legge inn <header-and-text> for annen informasjon i <programpresentation>. <discipline> er en underenhet av <program>. Dette er et rekursivt element som skal brukes til alle underenheter av <program>. Dette kan være spesialisering eller studieretninger. Denne skal presenteres på nesten samme måte som <program>. En av forskjellene er at man i <discipline-presentation> også kan legge inn <admission-info>, ettersom enkelte slike spesialiseringer har egne opptak. <code> skal her brukes med attributtet so-utdanningsomraadet. Dette er en kode som brukes for opptak via SO. esu , AFS, Dato: Side: 5

6 <qualification> beskriver den graden man oppnår. Her angis både vekting man oppnår, <credits>, og kompetanse til yrke, <profession>, eller for videre studier, <studyqualification> / <degree>. Ingen elementer her er påkrevd. <locality> sier noe om geografisk studiested. Det er her lagt inn mulighet for å legge inn <postnumber> og <place>. Det vil da være mulig å lage oversikter basert på <postnumber>. esu , AFS, Dato: Side: 6

7 4.2 Oversikt over alle elementer og attributter Her følger en oversikt over alle elementer og tilhørende attributter. Elementnavn er uthevet og kommentarer fra skjemaet står etterpå. Attributter er listet opp under de elementer som har det. year Årstall building Navn på bygning date YYYY-MM-DD first-time YYYY-MM-DD time-from hh:mm:ss time-to hh:mm:ss room Romnavn, romnr last-time YYYY-MM-DD weekday eks.: mandag adr Address used to deliver physical objects to a person address mulighet for egendefinerte klassifiskasjon med userdefined recommended-prerequisites anbefalte-forkunnskaper textblock visit-address Besøksaddress exam-semester eksamenssemester vaar-og-hoest hver-vaar hver-hoest annenhver-vaar annenhver-hoest annet course-id Denne må være unik for institusjonen. eks. 2MX, AA6210, INF1000 course-name course-admission emne-fag-opptak institution ROTELEMENT supplerende kode som styres av attributter institutiontype her skal det inn flere verdier på attributtene universitet vitenskapelig-hogskole kunsthogskoler videregaende-fylke folkehogskole teknisk-fagskole esu , AFS, Dato: Side: 7

8 hogskole-privat hogskole-statlig videregaende-privat videregaende-statlig studieforbund institution-acronym Forkortelse for institusjonen institution-name gjelder som løp eller deler av løp i vgs. (GK, VK1 eller VK2) course emne, kurs, fag person mulighet for egendefinerte klassifiskasjon med userdefined epostaddress fax nummer til fax bold Uthevet tekst formal-prerequisites formelle-forkunnskapskrav closing-dates avmeldingsfrister - YYYY-MM-DD objectives hva-laerer-du, og mål content innhold transfer innpassing contact-infomation kontaktinformasjon program-ingress kort-om-programmet italic Uthevet tekst i kursiv country link-name Navn på lenke i URL list bulleted nummerert list-item structure-accomplishment oppbygging-gjennomforing header POBox Postoffice Box postnumber-place place program-id unik for institusjonen esu , AFS, Dato: Side: 8

9 ID-ref Referanse til program, fordypning, emne-fag program-id-ref discipline-id-ref course-id-ref programname programnavn program-admission programopptak gsk-so krav-master ingen student-places Antall studieplasser angitt i tall eller tekst credits Studiepoeng angitt i tal, eller vgs- timer per år uketimer studiepoeng program studieprogram eller som løp eller deler av løp i vgs. (GK, VK1 eller VK2) discipline-id fordypningskode telephone attributtes: mobil, home and office mobile office home form-of-teaching undervisningsform:nettbasert, grupper, forelesnigner, seminar etc velg attributter for spesialformer. nettbasert brev teaching-semester undervisningssemester. attributter vaar-og-hoest hver-vaar hver-hoest annenhver-vaar annenhver-hoest annet teaching-language undervisningsspraak norsk engelsk engelsk-ved-behov annet study-abroad utenlandsopphold form-of-assessment forklaring av hvordan studentene vuderes href URL, link webaddress header-and-text overskrift-avsnitt esu , AFS, Dato: Side: 9

10 price materialavgifer, semester/års- avgifter, andre atgifter teaching-activity undervisningsaktivitet, typeaatributter feltarbeid forelesning fjernundervisning gruppeundervisning elearning teaching-group-id undervisningsparti-id teaching-place undervisningssted date-from YYYY-MM-DD date-to YYYY-MM-DD exam eksamen ordinaer kontinuasjon utsatt exam-part eksamensdel exam-part-name eksamensdelnavn exam-form eksmensform date-start DD.MM.ÅÅ date-end DD.MM.ÅÅ skriftlig muntlig annet exam-structure eksamensordning exam-place eksamenssted registration-dates oppmeldingsfrist announcement Kunngjøring av eksamensresultater person Definer selv hvilken rolle personen har i role timetable-element timeplanelement exam-closing-dates dato og forklaring til eksamenstrekkfrist(er) searchwords Dette må være en egen aktivitet hvor flere er med på å bestemme hvilke oppslagsord (med synonymer etc) som er relevante. searchword search-synonym qualification Diploma supplement definerer det som "diplomas, degrees, certificates etc." esu , AFS, Dato: Side: 10

11 Beskriver både studieprogram og kvalifikasjon. qualification-name Fullt navn på kvalifikasjonen institution-id Ornanisasjonsnummer fra Brønnøysundregisteret level Attributter for nivå på leve bachelor vgs master phd course-presentation learning-target kort definisjon av hva kurset skal lære deg target-group maalgruppe, hvem du henvender deg til. farmasøyter, snekkere...etc. overlap faglig overlapp locality studiested, Geografisk sted, som kan brukes av søkemotorer. "avsnitt" kan f.eks inneholde Bali bokmaal nynorsk engelsk ExtAdd Extra address data street Street address locality example of locality is city pcode postal code vist-hour userid name given fornavn family etternavn title role personrolle. Her kan man legge inn foreleser, hovedansvarlig for programmet, gruppelærer, ClassFronter-ansvarlig etc. discipline eks. studieretning, spesialisering discipline-name admission-info krav til opptak, inpassning, opptaksprøver++ commencement studiestart appearance-place oppmotested oppmotested esu , AFS, Dato: Side: 11

12 appearance-date-time last-reg-date siste påmeldingsfrist grounding forkunnskapskrav universal-adjustment universell-tilrettelegging, tekst om generelle tilpassninger til funksjonshemmede, utenlendinger etc. unit organisasjonsenheter. definerer institusjonens struktur unit-id organisasjonsenhetsid, denne defineres etter organisasjonens behov unit-acronym organisasjonsenhetsacronym, forkortelse for enhet unit-name organisasjonsenhetsnavn duration varighet. velg attributter for type. timer dager uker maaneder aar terminer semester welfare velferd regulations reglementer og lover som gjelder spesielt for dette programmet institution-presentation her må det være en konkret spesifikasjon av hva som skal være innholdet. Anbefale å legge inn URLer ting informasjon på web welfare velferd semesterprice semesteravgift til samskipnader user-defined egendefinert element for spesiell informasjon. definer selv attributter code diverse koder course=nus. program=utd.omrade, inst.=so Finenr du ikke koden, velg user-defined og skriv inn ssb so-utdanningsomraadet so vigo admission-code opptakskode. Muli gå velge nom eller lokal som attributt nom lokal unitid-ref referanse til unit sin ID esu , AFS, Dato: Side: 12

13 degree akademisk-grad bachelor master phd hogskolekandidat utgaatte-koder study-qualification studiekompetanse, Gjelder for videregående opplæring. Kan også brukes i høyere utdanning. profession yrkeskompetanse, Legg inn fritekst teaching termin presentation teaching-description syllabus her kan det skrives noe om læremateriell, pensum for emne-kurset, litteratur etc. E-learning-objects Referanse til LOM-objekt Bruk Norsk applikasjonsprofil av LOM esu , AFS, Dato: Side: 13