28
STADS A107.208.16 14.11.2007 Side 1 af 28 TV Konvertering af uddannelsesdata i STADS 12.1 STADS systemdokumentation INDHOLD: 1. Indledning ..................................................................................................................... 2 2. Omfang af konverteringen ............................................................................................ 3 3. Konverteringens forløb ................................................................................................. 4 3.1 Analyse .............................................................................................................. 5 3.2 Udtræk til rapporter ........................................................................................... 6 3.3 Udtræk til datafiler ............................................................................................ 6 3.4 Dannelse af kontrolfiler ..................................................................................... 6 3.5 Loadning til konverteringstabellerne ................................................................. 6 3.6 Udlæsning fra STADS til konverteringstabellerne............................................ 6 3.7 Manuel tilretning af data i konverteringstabellerne........................................... 8 3.8 Indtastning af basisoplysninger ......................................................................... 9 3.9 Konvertering til STADS .................................................................................. 10 4. Konverteringstabellerne .............................................................................................. 13 5. Konverteringsprogrammets struktur ........................................................................... 19 6. Bilag ............................................................................................................................ 21 6.1 Pakker (BE_KONV) ........................................................................................ 21 6.2 BE_KONVUD................................................................................................. 24

Konvertering af strukturdata - Kulturministerietmaer, m.h.p. at kontrollere, om de nødvendige data findes i det nuværende system. Hvis rap-porterne afslører mangler, især hvad

  • Upload
    others

  • View
    3

  • Download
    1

Embed Size (px)

Citation preview

Page 1: Konvertering af strukturdata - Kulturministerietmaer, m.h.p. at kontrollere, om de nødvendige data findes i det nuværende system. Hvis rap-porterne afslører mangler, især hvad

STADS

A107.208.16 14.11.2007 Side 1 af 28

TV Konvertering af uddannelsesdata i STADS 12.1

STADS systemdokumentation INDHOLD: 1. Indledning ..................................................................................................................... 2 2. Omfang af konverteringen ............................................................................................ 3 3. Konverteringens forløb ................................................................................................. 4

3.1 Analyse .............................................................................................................. 5 3.2 Udtræk til rapporter ........................................................................................... 6 3.3 Udtræk til datafiler ............................................................................................ 6 3.4 Dannelse af kontrolfiler..................................................................................... 6 3.5 Loadning til konverteringstabellerne................................................................. 6

3.6 Udlæsning fra STADS til konverteringstabellerne............................................ 6

3.7 Manuel tilretning af data i konverteringstabellerne........................................... 8

3.8 Indtastning af basisoplysninger ......................................................................... 9

3.9 Konvertering til STADS.................................................................................. 10 4. Konverteringstabellerne.............................................................................................. 13 5. Konverteringsprogrammets struktur ........................................................................... 19 6. Bilag............................................................................................................................ 21

6.1 Pakker (BE_KONV)........................................................................................ 21 6.2 BE_KONVUD................................................................................................. 24

Page 2: Konvertering af strukturdata - Kulturministerietmaer, m.h.p. at kontrollere, om de nødvendige data findes i det nuværende system. Hvis rap-porterne afslører mangler, især hvad

TV Konvertering af uddannelsesdata i STADS 12.1 STADS

A107.208.16 14.11.2007 Side 2 af 28

1. Indledning Dette notat udgør vejledningen i konvertering af eksisterende uddannelsesdata til STADS. Supplerende findes “Håndbog i beskrivelse af uddannelser”, udgivet af VUE-Centret som dok.nr. 3057, i det følgende kaldet Håndbogen, rettet mod det studieadministrative personale. Tilsammen er det hensigten, at dette materiale skal gøre institutionerne i stand til at gennem-føre konverteringen som et samarbejde mellem det studieadministrative personale og edb-afdelingen. Notatet redegør for ambitionsniveauet i konverteringen og beskriver de trin, der indgår i for-beredelsen og gennemførelsen af konverteringen. Notatet rummer desuden en beskrivelse af de konverteringstabeller, hvori data fra institutionen afleveres til endelig konvertering ind i STADS’s egentlige tabeller. Ved installation af STADS oprettes konverteringstabellerne, og der installeres et sæt simple forms til at redigere indholdet af tabellerne. Det er dog kun nogle af tabellerne, der kan redigeres i via skærmbillederne. Der henvises til package-headeren for pakken BE_KONV, der rummer konverteringspro-grammet til konvertering af dataene fra konverteringstabellerne til STADS. Oversigt over konverteringstabellerne kan ses fra STADS websiden. Undervejs i vejledningen henvises til skærmbilleder og udskrifter i STADS til kontrol af konverteringen. For en nærmere beskrivel-se af disse funktioner henvises til betjeningsvejledningen for STADS. Når konverteringen af uddannelsesdata er gennemført som beskrevet i denne vejledning, bør der køres analyze af tabeller og index i delsystem Uddannelsernes Struktur, dvs. alle tabeller med præfiks “BE”. Analyze kan gennemføres ved kald af stored procedure vy_analyze.delsystem (null, ‘BE’, null), idet denne procedure sikrer, at både tabeller og index analyseres. Se systemdokumentation/package-header for pakken vy_analyze. Der henvises til Oracle Server SQL Language Reference Manual for en nærmere beskrivelse af kommandoen Analyze. Herefter kan institutionen enten indtaste bekendtgørelser, studieordninger og rammer eller konvertere dem ind, hvorefter konvertering af studenterdata kan ske. Dette er beskrevet i en særskilt vejledning i konvertering af Studenterdata.

Page 3: Konvertering af strukturdata - Kulturministerietmaer, m.h.p. at kontrollere, om de nødvendige data findes i det nuværende system. Hvis rap-porterne afslører mangler, især hvad

TV Konvertering af uddannelsesdata i STADS 12.1 STADS

A107.208.16 14.11.2007 Side 3 af 28

2. Omfang af konverteringen Det er ambitionen at konvertere så meget som muligt fra institutionernes nuværende studie-administrative edb-systemer. Dette gælder både omfattende datamængder, som ville være me-get arbejdskrævende at indtaste, f.eks. aktiviteter og studerende, og mindre omfattende men mere komplekse datamængder, f.eks. studieordninger. Der konverteres dog ikke bevisstrukturer, normalstudieplaner, overgangsordninger, elementudtryk, grupper af rammer og grupper af studieordninger. Desuden konverteres historikoplysninger heller ikke. Det er dermed forsøgt at lægge et ambitionsniveau for konverteringen, der giver et passende kompromis mellem indtastningsarbejdet i det nye STADS system og konverteringsarbejdet. Resultatet af dette kompromis er, at der til delsystem Uddannelsernes Struktur, kan kon-verteres data om: • administrative enheder • hierarki af administrative enheder • studieretninger • struktur af grupper af studieretninger • emnekategorier • emnekrav • specialiseringskategorier • specialiseringer • bekendtgørelser – herunder også uddannelser og struktur af uddannelser • uddannelsesrammer • modeller • eksamensaktiviteter • undervisningsaktiviteter • grupper • studieordninger • regler • udtryk (pointforudsætninger, pointkonflikter og identiske aktiviteter) • udenlandske betegnelser på institutionen, studieretninger, administrative enheder, grupper,

aktiviteter, bekendtgørelsestitler, uddannelser og uddannelsestitler. (Bemærk, at det også er muligt at konvertere udenlandske betegnelser på tilmeldingers og resultaters opgavetitler - se vejledningen i konvertering af studenterdata, dokument A107.207).

Oplysninger om belastningsenheder, undervisningsformer og prøveformer indtastes manuelt i delsystem Uddannelsernes Struktur før konverteringen. Det samme gælder cen-sorhonorarnormsæt i delsystem Planlægning.

Page 4: Konvertering af strukturdata - Kulturministerietmaer, m.h.p. at kontrollere, om de nødvendige data findes i det nuværende system. Hvis rap-porterne afslører mangler, især hvad

TV Konvertering af uddannelsesdata i STADS 12.1 STADS

A107.208.16 14.11.2007 Side 4 af 28

3. Konverteringens forløb Der er derfor indført et sæt konverteringstabeller, der er en forenklet udgave af de tabeller i STADS, hvortil der kan konverteres data fra institutionens nuværende system. Disse konverte-ringstabeller er de eneste tabeller, som institutionen behøver at kende i detaljer i forbindelse med konverteringen. Konverteringen til konverteringstabellerne er institutionens ansvar, hvis institutionen ikke anvender udlæsningsprocedurerne i pakken BE_KONVUD, mens konverte-ringen videre fra disse tabeller og ind i det egentlige STADS er institutionens systemadmini-strator ansvar via et konverteringsprogram. På nedenstående figur er trinnene i konverteringen vist i den rækkefølge, de skal gennemføres, og med illustration af de mellemprodukter, der skabes undervejs.

1. Analyse

2. Rapport-udtryk

3. Udtræk til datafiler 4. Dannelse af kontrolfiler

Datafiler Kontrolfiler

5. Loading

Konverteringstabeller7. Manuel tilretning 8. Indtastning af basisopl.

9. Konverteringsprogram

STADS tabel

STADS tabel

6. STADS system

(ikke STADS system)

Page 5: Konvertering af strukturdata - Kulturministerietmaer, m.h.p. at kontrollere, om de nødvendige data findes i det nuværende system. Hvis rap-porterne afslører mangler, især hvad

TV Konvertering af uddannelsesdata i STADS 12.1 STADS

A107.208.16 14.11.2007 Side 5 af 28

De første trin i konverteringen tjener til at afdække, hvilke data, der kan og skal fremfindes automatisk fra det eksisterende system. Herunder gennemføres en praktisk afprøvning af, at dataene faktisk kan fremfindes i den korrekte form. Dette arbejde er beskrevet i detaljer i Håndbogen. I de følgende trin udtrækkes data og loades ind i konverteringstabellerne, enten vha SQL*LOADER eller vha udlæsningsprogrammet (BE_KONVUD). Til sidst konverteres data videre herfra ind i STADS vha. et konverteringsprogram, der leveres som en del af STADS (BE_KONV). Arbejdet hermed er hovedemnet for denne konverteringsvejledning. Det er muligt at gennemføre flere supplerende konverteringer efter hinanden. Hvis man tager STADS i brug, f.eks. til indtastning af studieordninger m.m., inden konverteringen er helt af-sluttet, vil der dog være en risiko for tab af indtastede data, der må håndteres ved hyppig back-up. Trinnene 1 til 4 kan gennemføres før modtagelse og installation af STADS. De efterfølgende trin forudsætter, at STADS er installeret i overensstemmelse med installationsvejledningen. Før konvertering slås rækkebaseret adgangskontrol fra ved kald fra sql*Plus af scriptet rem_adg_kntrl.sql, som ligger i stien $VUEHOME/tools/etc. Udfør konverteringen som Oracle-bruger “vueudv”. Efter konverteringen skal rækkebaseret adgangskontrol sættes i kraft igen ved kald fra sql*Plus af scriptet add_adg_kntrl.sql, som ligger i stien $VUEHOME/tools/etc. 3.1 Analyse

I Håndbogen findes en række skemaer, der anvendes som grundlag for konvertering og indda-tering. Skemaerne har til formål at beskrive studieordningers opbygning og give overblik over hvilke data, der er til rådighed på institutionens nuværende edb-system, med henblik på kon-vertering. Skemaerne med relevans for konverteringen og den forudgående indtastning af basisop-lysninger omtales i det følgende som de konverteringsrettede skemaer og omfatter: • Skema 7: Prøveformer • Skema 8: Undervisningsformer • Skema 9: Belastningsenheder • Skema 4: Administrative enheder • Skema 3: Aktiviteter • Skema 2: Gruppers indhold Oplysninger om udenlandske betegnelser forekommer på Håndbogens skemaer 2, 4, 5, 3a, 3b og 3d.

Page 6: Konvertering af strukturdata - Kulturministerietmaer, m.h.p. at kontrollere, om de nødvendige data findes i det nuværende system. Hvis rap-porterne afslører mangler, især hvad

TV Konvertering af uddannelsesdata i STADS 12.1 STADS

A107.208.16 14.11.2007 Side 6 af 28

3.2 Udtræk til rapporter

På baggrund af et antal udfyldte eksemplarer af hvert konverteringsrettet skema udvikles nu en rapport pr. skema, der viser skemaernes ledetekster og for hver record de oplysninger, der findes i det nuværende system. Rapporterne bruges til at sammenligne med de udfyldte ske-maer, m.h.p. at kontrollere, om de nødvendige data findes i det nuværende system. Hvis rap-porterne afslører mangler, især hvad angår de data, som er tvungne i skemaerne, må man ana-lysere sit nuværende system yderligere eller evt. indstille sig på at bruge en af de skitserede løsninger for manglende, tvungne oplysninger. Når rapporterne er bragt til at svare så meget til indholdet i skemaerne som muligt, er institu-tionen klar til den egentlige konvertering, idet disse første trin har afdækket, hvilke data, der findes i det nuværende system, og dermed hvilke, der kan konverteres. 3.3 Udtræk til datafiler

Nærværende beskrivelse af trinnene 3, 4 og 5 er baseret på anvendelse af SQL*Loader, der er dokumenteret i ”Oracle Database Documentation”. Dette skal opfattes som et forslag, idet in-stitutionerne naturligvis kan vælge andre måder at overføre data til konverteringstabellerne på. Vælger institutionen at anvende SQL*Loader, kan det gøres på følgende måde: Der udvikles et sæt udtræksprogrammer, der kan udtrække de samme data fra det nuværende system til et sæt datafiler, der kan loades til konverteringstabellerne i Oracle via SQL*Loader. Datafilernes format skal være i overensstemmelse med retningslinierne i Oracles manual for SQL*Loader: ”Oracle Database Documentation”. 3.4 Dannelse af kontrolfiler

Datafilerne skal loades ind i konverteringstabellerne vha. SQL*Loader og et sæt kontrolfiler. Hver kontrolfil beskriver, hvordan en datafil skal loades ind i konverteringstabellen. Formatet for kontrolfiler er beskrevet i ”Oracle Database Documentation” Kontrolfilerne udarbejdes manuelt ud fra beskrivelsen af konverteringstabellerne i afsnit 4 og i vedlagte dictionary, samt retningslinierne i manualen. Bemærk, at feltet “status” i alle konver-teringstabellerne skal sættes til “U” (ubehandlet). Dette kan dog evt. udskydes til trin 7 og til-rettes manuelt. 3.5 Loadning til konverteringstabellerne

Konverteringstabellerne oprettes under installationen af STADS, så herefter kan loadning fo-retages vha. SQL*Loader, eller vha udlæsningspakken BE_KONVUD. Der er ikke noget i ve-jen for, at institutionen kan loade data ind i konverteringstabellen ad flere omgange, f.eks. fa-kultet for fakultet. I beskrivelsen af de næste trin i konverteringen forudsættes det, at institutionerne let selv kan definere de relevante SQL*Plus udtræk fra konverteringstabellerne på basis af do-kumentationen af disse. F.eks. udtræk af hvilke records, der afvises og hvorfor. 3.6 Udlæsning fra STADS til konverteringstabellerne

Programmet til udlæsning er udviklet som en del af STADS-leverancen i form af en pakke med en samling stored procedures, der kræver, at databaselinket KONV_DB_LINK er opret-tet, for at procedurerne kan afvikles. Proceduren BE_KONVUD.START_KONV i kataloget

Page 7: Konvertering af strukturdata - Kulturministerietmaer, m.h.p. at kontrollere, om de nødvendige data findes i det nuværende system. Hvis rap-porterne afslører mangler, især hvad

TV Konvertering af uddannelsesdata i STADS 12.1 STADS

A107.208.16 14.11.2007 Side 7 af 28

$VUEHOME/Beskrivelse/dbprog kan startes fra sql*Plus. For at få eventuelle log meddelel-ser ud skal serveroutput sættes til forinden: set serveroutput on size 100000 execute BE_KONVUD.START_KONV; Se package-headeren for BE_KONVUD for yderligere dokumentation. Når udlæsningsproceduren afsluttes normalt, skal man kontrollere, at alle data er kommet over i konverteringstabellerne, hvorefter man kan gå videre med indlæsningsproceduren. Bemærk, at udlæsningen sker fra det modtagende system. Databaselinket KONV_DB_LINK, som udlæsningspakken gør brug af, oprettes/ændres vha sql-scriptet $VUEHOME/Beskrivelse/sql/BE_KONV_DBLINK.sql. Forud for hver udlæsning slettes alle rækker i de relevante konverteringstabeller hvor feltet TILRETN_STATUS mat-cher værdien af trimmeparameteren KONV_TILRETN_STATUS. OBS: Det er indholdet af trimmeparameteren KONV_TILRETN_STATUS i det system, der læses fra, der bliver indsat i feltet TILRETN_STATUS i konverteringstabellerne, at eventuelle rækker med samme indhold i feltet først bliver slettet, og at feltet bliver udfyldt med navnet på det system, data hentes fra, hvis trimmeparameteren ikke har nogen institutionsværdi. Rækkefølgen for udlæsning af data til konverteringstabellerne er for så vidt ligegyldig, idet der ingen indbyrdes afhængighed er, men udlæsningsproceduren BE_KONVUD.START_KONV foretager udlæsningen i følgende rækkefølge: UDTRAEK_ADMENHED for administrative enheder UDTRAEK_ADMENHED_STRUKTUR for administrative enheders strukturer UDTRAEK_AKTIVITET for aktiviteter UDTRAEK_EKSAMINATION for prøver UDTRAEK_STUDIERETN for studieretninger UDTRAEK_STUDIERETNSTRU for studieretningers struktur UDTRAEK_EMNEKRAV for emnekategorier og emnekrav UDTRAEK_EMNEKRAVOPFYLD for emner og emnekravopfyldelser UDTRAEK_SPECIALISERING for specialiseringskategorier og specialiseringer UDTRAEK_BEKENDTGOER for bekendtgørelser, uddannelser og titler UDTRAEK_UDDRAMME for uddannelsesrammer UDTRAEK_MODEL for modeller for uddannelsernes sammensætning UDTRAEK_UVAKT_UVFORM for bindingen mellem undervisningsaktiviteter og undervisningsformer UDTRAEK_EKSAMGRUP for valgmuligheder og deres bindingen til hhv. eksamensaktiviteter og prøver UDTRAEK_GRUPPE for grupper UDTRAEK_STUDIEORDNING for studieordninger UDTRAEK_STUDIEORDNING_STED for studieordningers lovlige steder UDTRAEK_UDENL_BETEGN for udenlandske betegnelser og

Page 8: Konvertering af strukturdata - Kulturministerietmaer, m.h.p. at kontrollere, om de nødvendige data findes i det nuværende system. Hvis rap-porterne afslører mangler, især hvad

TV Konvertering af uddannelsesdata i STADS 12.1 STADS

A107.208.16 14.11.2007 Side 8 af 28

EXPORT_REGLER for regler og deres infoværdier OBS: Husk at når som helst der bruges serveroutput, specielt ved kørsler af en nogenlunde størrelse, f. eks. konverteringsprogrammerne, at angive en passende stor værdi for paramete-ren size (den kan være op til 1000000). I modsat fald løber den interne ‘output-buffer’ fuld midt under programudførelsen hvilket kan medføre en meget generende fejlsituation.

3.7 Manuel tilretning af data i konverteringstabell erne

Før konverteringen i trin 9, er der en række felter i konverteringstabellerne, der skal være ud-fyldt. Dette kræves, for at alle constraints på STADS’s tabeller kan “enables”, før der tillades brug af de egentlige STADS-billeder, herunder især fremmednøgle-referencer og not-null-constraints. Det fremgår på STADS websiden, hvilke felter i konverteringstabellerne, der er tvungne. Man skal sikre sig, at data i konverteringstabellerne ikke indeholder efterstillede blanktegn, som f. eks. kan være opstået ved afkortning af lange felter i forbindelse med loadning til kon-verteringstabellerne. Hvis efterstillede blanktegn bliver stående i konverteringstabellerne, vil de blive ført med over i STADS-tabellerne, hvor de vil give problemer. Der eksisterer et hjæl-peværktøj, som evt. kan bruges til at fjerne blanktegn fra konverteringstabellerne: rm_trailing_blanks.sql, som ligger i stien $VUEHOME/tools/sql/. Når dette script køres fra SQL*Plus, skal man angive navnet på en fil, som kommer til at indeholde det sql-script der fjerner de efterstillede blanktegn. Efter kørsel af dette andet script kan man inspicere en log og se, hvad der er sket under programafviklingen. Der kan dog være visse data, der ikke er tilgængelige i institutionens eksisterende system, og som dermed ikke kan konverteres. Disse skal naturligvis indtastes manuelt. Vi anbefaler, at man først bruger de egentlige STADS-billeder, når den konverterede database er i en sådan stand, at alle constraints kan enables. Det giver institutionen to muligheder for håndtering af tvungne data, der ikke kan konverteres fra det gamle system: 1. Som en del af STADS leveres et sæt meget primitive Forms-billeder, der kan benyttes til

en manuel tilretning af konverteringstabellerne. Man kan benytte disse billeder til at indta-ste de manglende tvungne data før konverteringen i trin 9. Da billederne er meget simple, er denne fremgangsmåde mest interessant i forbindelse med ganske få manglende data. Bil-lederne ligger i kataloget $VUEHOME/Beskrivelse/forms og har navne præfixet med “BEK”. Billederne er tilgængelige fra den specielle konverteringsmenu, der følger med le-verancen.

2. Man kan indsætte en genkendelig default-værdi i konverteringstabellerne, der hvor den

tvungne værdi mangler. (Kan gøres ved et simpelt update-udtryk i SQL*Plus). Herefter kan man gennemføre trin 9. Senere kan data så tilrettes via de egentlige STADS billeder. I de situationer, hvor enhver mulig defaultværdi vil kunne forveksles med de rigtige værdier, kan man sætte en vilkårlig værdi i feltet og kombinere det med en genkendelig værdi i fel-tet tilretn_status. Feltet tilretn_status angiver fra hvilken database data er udlæst. Feltet

Page 9: Konvertering af strukturdata - Kulturministerietmaer, m.h.p. at kontrollere, om de nødvendige data findes i det nuværende system. Hvis rap-porterne afslører mangler, især hvad

TV Konvertering af uddannelsesdata i STADS 12.1 STADS

A107.208.16 14.11.2007 Side 9 af 28

udfyldes enten manuelt vha et update-udtryk, eller ifm pakken BE_KONVUD og indeholder værdien af trimmeparameteren KONV_TILRETN_STATUS.

Enkelte konverteringstabeller er “de-normaliserede”, idet data, der i de egentlige STADS-tabeller er splittet op på flere tabeller, evt. med en-til-mange-relationer imellem, i visse tilfæl-de er samlet i én konverteringstabel. I de-normaliserede konverteringstabeller, kan visse data derfor være redundant repræsenteret, eller der kan være lange felter, der benyttes til at oprem-se et antal relaterede værdier adskilt med “*”. Det har betydning ved manuel tilretning i kon-verteringstabellerne, idet rettelser af redundante data i givet fald skal gennemføres i alle fore-komster. Bemærk, at feltet “status” i alle konverteringstabellerne skal sættes til “U” (ubehandlet). Hvis dette ikke er sket under loadningen i trin 5, skal det sikres under den manuelle tilretning af konverteringstabellerne. Institutionen forventes at kunne klare sig med simple SQL-udtræk fra konverteringstabellerne, hvis det bliver nødvendigt med udskrifter i den fase, hvor dataene tilrettes manuelt. Der er ik-ke udviklet egentlige udskrifter til konverteringstabellerne. 3.8 Indtastning af basisoplysninger

Før data konverteres fra konverteringstabellerne ind i STADS, skal visse basisoplysninger væ-re på plads i STADS. De basisoplysninger, der skal indtastes, er oplysninger om belastnings-enheder, undervisningsformer, prøveformer og censor-honorarnormsæt. Værdier i disse tabel-ler skal fastlægges centralt på institutionen, idet de bruges på tværs af administrative enheder. Data i disse tabeller indtastes gennem STADS skærmbillederne: • US005 Belastningsenheder (delsystem Uddannelsernes Struktur) • US002 Undervisningsformer (delsystem Uddannelsernes Struktur) • US001 Prøveformer (delsystem Uddannelsernes Struktur) • PL026 Censor, honorar normsæt (delsystem Planlægning) Det er vigtigt, at felterne “belastningsenhed”, “undervisningsform”, “prøveform” og “cen_hon_normsaet” på hhv. belastningsenheder, undervisningsformer, prøveformer og cen-sor-honorarnormsæt skrives præcist som de refereres fra de konverteringstabeller, der refere-rer til dem. Ellers kan konverteringsprogrammet ikke etablere en korrekt frem-mednøglereference fra de konverterede data i STADS til basisoplysningerne. Konsekvensen af unøjagtigheder her vil få konverteringsprogrammet (trin 9) til at afvise data. Herefter kan man tilrette enten i konverteringstabellerne eller i basisoplysningerne og forsøge igen. Oplysninger om administrative enheder skal konverteres ind, og skal således indlægges i konverteringstabellen BEK_ADMENHED. Dette skyldes, at administrativ enhed refereres med gl_kode under konvertering og denne kan kun komme ind i STADS via konvertering.

Page 10: Konvertering af strukturdata - Kulturministerietmaer, m.h.p. at kontrollere, om de nødvendige data findes i det nuværende system. Hvis rap-porterne afslører mangler, især hvad

TV Konvertering af uddannelsesdata i STADS 12.1 STADS

A107.208.16 14.11.2007 Side 10 af 28

3.9 Konvertering til STADS

Når dataene i konverteringstabellerne er på plads og evt. manuelt tilrettet, kan de konverteres til de egentlige STADS tabeller. Forudsætningerne er: • Alle felter, der er markeret tvungne (afsnit 4), er udfyldt (not null) evt. med en værdi, som

man kan genkende og senere tilrette. • Alle status-felter på ikke tidligere konverterede data er “U” (eller “A” for “afvist, hvis de

tidligere er forsøgt konverteret). • Der er ingen brugere på systemet. • Man skal tage en back-up af databasen umiddelbart før konverteringen. Programmet til konverteringen er udviklet som en del af STADS-leverancen i form af en pak-ke med en samling stored procedures. Proceduren BE_KONV.START_KONV, i kataloget $VUEHOME/Beskrivelse/dbprog, kan startes fra sql*Plus, for at få evt. log meddelelser ud skal serveroutput sættes til forinden: set serveroutput on size 100000 execute BE_KONV.START_KONV(‘J’); --J: konverter så meget som muligt, --N: konverter kun hvis alt kan genfindes -- defaultværdien er N, hvis ikke andet er angivet. OBS: Husk at når som helst der bruges serveroutput, specielt ved kørsler af en nogenlunde størrelse, f. eks. konverteringsprogrammerne, at angive en passende stor værdi for parametren size (den kan være op til 1000000). I modat fald løber den interne ‘output-buffer’ fuld midt under programudførelsen hvilket medfører en meget generende fejlsituation. Se afsnit 5.2 og package-headeren for BE_KONV for yderligere dokumentation. Når konverteringsproceduren afsluttes normalt, kan man inspicere konverterede data på føl-gende skærmbilleder. Skærmbilledet til visning og tildeling af regler kaldes fra skærmbille-derne til registrering af bekendtgørelser, studieordninger, grupper, eksamensaktiviteter og un-dervisningsaktiviteter:

VY012 Administrative enheder (brugertast 3 viser udenlandske betegnelser) VY002 Hierarki af administrative enheder US009 Emnekategori og –krav US011 Titler på andre sprog US013 Registrering af Studieretninger (brugertast 3 viser udenlandske betegnelser) US014 Grupper af studieretninger US016 Undervisningsaktivitet (viser også undervisningsaktivitetens under visningsformer og brugertast 3 viser udenlandske betegnelser) US017 Eksamensaktivitet (viser også eksamensaktivitetens muligheder og prøver og brugertast 3 viser udenlandske betegnelser) US018 Grupper (brugertast 3 viser udenlandske betegnelser) US019 Bekendtgørelse, Uddannelsesdele (brugertast 3 viser udenlandske

Page 11: Konvertering af strukturdata - Kulturministerietmaer, m.h.p. at kontrollere, om de nødvendige data findes i det nuværende system. Hvis rap-porterne afslører mangler, især hvad

TV Konvertering af uddannelsesdata i STADS 12.1 STADS

A107.208.16 14.11.2007 Side 11 af 28

Betegnelser og brugertast 7 viser latinske titler) US020 Studieordning US021 Reg. af uddannelsesramme US022 Studieordning og regler tilknyttet (brugertast 5 viser tilknyttede regler) US033 Specialiseringer (brugertast 3 viser udenlandske betegnelser) US034 Specialiseringskategorier (brugertast 3 viser udenlandske betegnelser) US035 Registrering af pointkonflikter US036 Registrering af pointforudsætninger, US037 Reg. af identiske aktiviteter, US048 Modeller for sammenhæng af uddannelser VY007 Institution (Brugertast 3 viser udenlandske betegnelser)

Desuden kan anvendes følgende udskrifter til kontrol af konverteringen: US001U Liste over bekendtgørelser US002U Liste over uddannelser pr. bekendtgørelse US003U Liste over uddannelser og uddannelsesdele US004U Beskrivelse af en bekendtgørelse US005U Liste over uddannelsesrammer pr. uddannelse US006U Liste over uddannelsesrammer pr. studieretning US007U Beskrivelse af en uddannelsesramme US008U Liste over uddannelser med studieordninger US009U Liste over studieretninger med studieordninger US010U Beskrivelse af en studieordning US011U Beskrivelse af en studieordning med nedarvede regler US012U Liste over gruppe US013U Beskrivelse af gruppestruktur US014U Liste over eksamensaktiviteter US016U Liste over eksamensaktivitet pr. aktivitetsgruppe US017U Beskrivelse af en eksamensaktivitet US018U Liste over undervisningsaktiviteter US020U Liste over undervisningsaktiviteter pr. aktivitetsgruppe US021U Beskrivelse af undervisningsaktivitet US027U Liste over modeller US035U Pointkonflikter US036U Pointforudsætninger US037U Identiske udtryk Evt. afviste data under konverteringen kan udtrækkes fra konverteringstabellerne med status = “A” for afvist. Disse data kan rettes til som under trin 7, og konverteringsproceduren kan kø-res igen, idet den kun konverterer data med status “U” eller “A”. Data i konverteringstabeller-ne, som det er lykkedes at konvertere, er ændret af konverteringsprogrammet til at have status “K”. Eksempler på årsager til afvisning er: • Ikke entydighed i kode (det fremgår fra STADS websiden | Dokumentation | STADS meta-

data, hvilke felter, der skal være entydige) • Overholder ikke domæne-constraint

Page 12: Konvertering af strukturdata - Kulturministerietmaer, m.h.p. at kontrollere, om de nødvendige data findes i det nuværende system. Hvis rap-porterne afslører mangler, især hvad

TV Konvertering af uddannelsesdata i STADS 12.1 STADS

A107.208.16 14.11.2007 Side 12 af 28

• Umuligt at etablere fremmednøgle-constraint • Manglende værdi i et tvungent felt (brud på not-null constraint- tvungne felter fremgår

STADS websiden | Dokumentation | STADS metadata) Ligesom det på denne måde kan lade sig gøre at gentage konverteringen, hvis nogle af dataene afvises, så er det også muligt at foretage flere konverteringer, der supplerer hinanden. Dette er f.eks. relevant, hvis institutionen ønsker at lade forskellige fakulteter konvertere uafhængigt af hinanden og forskudt i tid. Der kan blot loades nye supplerende data ind i konverteringstabel-lerne og foretages ny konvertering vha. konverteringsproceduren. Hvis man vil undgå, at tidligere konverterede data i konverteringstabellerne bliver overskrevet ved en ny udlæsning af data, skal man ændre institutionsværdien af trimmeparameteren KONV_TILRETN_STATUS.

Page 13: Konvertering af strukturdata - Kulturministerietmaer, m.h.p. at kontrollere, om de nødvendige data findes i det nuværende system. Hvis rap-porterne afslører mangler, især hvad

STADS

A107.208.16 14.11.2007 Side 13 af 28

4. Konverteringstabellerne

Page 14: Konvertering af strukturdata - Kulturministerietmaer, m.h.p. at kontrollere, om de nødvendige data findes i det nuværende system. Hvis rap-porterne afslører mangler, især hvad

STADS

A107.208.16 14.11.2007 Side 14 af 28

De enkelte tabeller er beskrevet i detaljer på STADS websiden | Dokumentation | STADS me-tadata. Heri fremgår relationen til skemaerne i Håndbogen. Desuden er det angivet, hvilke fel-ter, der er tvungne eller unikke og eventuelle begrænsninger i tilladte værdier. Felter, som er markeret tvungne skal være udfyldt (not null) før trin 9 i konverteringen i-værksættes. Ellers afvises recorden under konverteringen. Felter, som er markeret unik, skal være entydige i tabellen. Felter med navnet gl_kode er beregnet til at rumme den kode, der i det nuværende system benyttes til entydigt at identificere records i en tabel. Denne kode bliver under konverteringen anvendt til at etablere fremmednøglereferencer. Enkelte steder i kommentarer på BEK-tabeller er der henvist til en note. Disse noter gennem-gås i det følgende og skal altså læses i sammenhæng STADS metadata. Note 0:

Note til flere tabeller: En del steder i STADS websiden | Dokumentation | STADS metadata fremgår det, at admini-strativ enhed skal findes i konverteringstabellen, BEK_ADMENHED. Dette skal forstås som følger: På det tidspunkt hvor data indlægges i konverteringstabellerne, skal administrativ en-hed på eksempelvis en aktivitet findes i BEK_admenhed. Men på det tidspunkt hvor konverte-ringsprogrammet kører, vil den administrative enhed på aktiviteten blive checket imod VYT_ADMENHED, idet administrative enheder konverteres før aktiviteter. Note 1:

Feltet elementtype benyttes til at skelne mellem undervisningsaktiviteter (UVA), eksa-mensaktiviteter (EKA) og aktiviteter, som skal give anledning til både en undervisnings-aktivitet og en eksamensaktivitet i STADS (BEG). ‘BEG’ står for ‘begge’. Felterne “ny_uva_kode”, “varighed”, “uva_sidste_afhold”, “samtid_ektilm” og “foe-rer_til_eksamen” er kun relevante for undervisningsaktiviteter, dvs. for aktiviteter med ele-menttype “UVA” eller “BEG”. Felterne “ny_eka_kode”, “eka_sidste_afhold”, “emne_v_tilmeld”, “emne_v_resultat”, “opg_v_tilmeld”, “opg_v_resultat” og “stud_ekgrup_valg” er kun relevante for eksamensakti-viteter, dvs. for aktiviteter med elementtype “EKA” eller “BEG”. Note 2:

Feltet indeholder gl_kode-værdier på de eksamensaktiviteter, som undervisningsaktiviteten leder frem til, adskilt med “*”. Hvis der er tale om en aktivitet af typen “BEG”, hvor under-visningsaktiviteten blot efterfølges af den tilsvarende eksamensaktivitet, udfyldes feltet blot med aktivitetens egen gl_kode. Note 3:

Hvis der kun er én eksamination (prøve) for en given eksamensaktivitet, og eksaminationen ikke indgår under andre eksamensaktiviteter, kan eksamensaktivitetens kode evt. bruges til både eksaminationen og den ene valgmulighed.

Page 15: Konvertering af strukturdata - Kulturministerietmaer, m.h.p. at kontrollere, om de nødvendige data findes i det nuværende system. Hvis rap-porterne afslører mangler, især hvad

TV Konvertering af uddannelsesdata i STADS 12.1 STADS

A107.208.16 14.11.2007 Side 15 af 28

Note 4:

Terminologien omkring eksamensaktiviteter er skiftet undervejs i udviklingen af STADS. Be-tegnelsen “eksamination”, som indgår i tabel- og feltnavne i databasen, skal opfattes som det samme som “prøve”. Tilsvarende bruges betegnelsen ‘eksamgrup’ i databasen om det, der kal-des ‘valgmulighed’. I den simple situation, hvor der til en eksamensaktivitet hører netop én måde at aflægge eksa-men på, som én prøve, der måske endda kun anvendes i denne ene sammenhæng, bør der alli-gevel skabes en record i tabellen bek_eksamgrup (og en record for prøven i bek_eksamination). Koderne kan i så fald være sammenfaldende som nævnt i note 3. Feltet “proevenavne” i bek_eksamgrup kan så rumme samme kode og mulighedsnr. kan være 1. Det er ikke muligt at gøre en eksamensaktivitet endelig i STADS, før der til eksamens-aktiviteten er tilknyttet mindst én eksamination. Om sammenknytningen skal ske under kon-verteringen eller manuelt senere, er op til institutionen. Det kan godt lade sig gøre at konverte-re aktiviteterne uden at sammenknytte dem med eksaminationer. Dog kan man i så fald ikke konvertere oplysningerne om censornormer mv. Note 5:

Tabellen er de-normaliseret. Felterne “gl_kode”, “ny_kode”, “navn” og “admenhed” er egen-skaber ved gruppen, og er dermed redundant repræsenteret. Felterne “akt_el_grp_kode” og “elementtype” er derimod egenskaber ved en aktivitets forekomst i gruppen. Ved konvertering kan en gruppe blive afvist, hvis en gruppe, der skal indgå i gruppen, endnu ikke er konverteret. I så fald gentages konverteringen, indtil alle er konverteret. Man kan nøjes med at køre konverteringsproceduren til konvertering af grupper et antal gange: execute BE_KONV.GRUPPE; Note 6:

Bemærk at i STADS er ‘kode’ unik indenfor: undervisningsaktiviteter, eksamensaktiviteter og grupper. Der er derfor to adskilte felter til angivelse af koden for hhv. undervisningsaktivite-ten og eksamensaktiviteter. Det er specielt nødvendigt, når typen er “BEG”. Note 7:

Syntaksen for udtryk kan beskrives ved følgende syntaxdiagram:

Page 16: Konvertering af strukturdata - Kulturministerietmaer, m.h.p. at kontrollere, om de nødvendige data findes i det nuværende system. Hvis rap-porterne afslører mangler, især hvad

TV Konvertering af uddannelsesdata i STADS 12.1 STADS

A107.208.16 14.11.2007 Side 16 af 28

,

eller

og

variabelnavn

[ tid – tid ]

udtryk

( udtryk ) • variabelnavn er gl_kode på en aktivitet. (Må ikke indeholde blanke, komma, runde eller

kantede parenteser). • tid er en tekst, der kan være tom, og som identificerer en termin f.eks S97.(Må ikke inde-

holde blanke, bindestreg eller kantede parenteser). • eller kan skrives som et ‘,’ (komma). Dette kan være formålstjenligt til f.eks. at angive

identiske aktiviteter eller grupper af gensidigt konfliktende aktiviteter. Således kan skrives “A, B, C”

Og har højere præcedens end eller. Dvs. og beregnes før eller. Identiske udtryk kan kun inde-holde eller. Eksempler på udtryk: pointforudsætning: ((A og B) eller C[S93-S94] identisk udtryk: A eller B eller C. Note 8:

Bemærk at i listen over prøver i feltet ‘proevenavne’ skal bruges eksam_kode (ny kode), ikke en gammel kode. Konverteringsprogrammet

Karakteristika ved STADS databasen

De fleste tabeller i STADS rummer et “id” felt, der entydigt identificerer hver record. Denne id genereres af systemet vha. en sequence ved oprettelse (og konvertering). Id’en benyttes alle steder, hvor andre tabeller skal rumme en fremmednøglereference til recorden. Herved opnås stabile fremmednøgler, der er uafhængige af semantiske rettelser i dataindholdet i recorden.

Under konverteringen skal fremmednøglereferencerne etableres ud fra de gamle entydige nøg-ler for data. Det kræver, at konverteringen af data sker i en bestemt rækkefølge. Denne række-følge er indbygget i konverteringsprogrammet.

F.eks. konverteres de administrative enheder før aktiviteter. De gamle koder på f.eks. admini-strative enheder gemmes i STADS-tabellen for administrative enheder, og ved konverteringen af en aktivitet finder konverteringsprogrammet frem til en administrativ enheds nye id ud fra den gamle kode, der står på aktiviteten. På tilsvarende måde håndteres, at der senere skal kon-verteres studenterdata, der refererer til allerede konverterede uddannelsesdata - f.eks. resulta-ter, der skal referere til aktiviteter.

Page 17: Konvertering af strukturdata - Kulturministerietmaer, m.h.p. at kontrollere, om de nødvendige data findes i det nuværende system. Hvis rap-porterne afslører mangler, især hvad

TV Konvertering af uddannelsesdata i STADS 12.1 STADS

A107.208.16 14.11.2007 Side 17 af 28

Regel afgrænsninger (infoværdier)

Der findes ca 150 regler i STADS. De anvender hver især et mindre antal inforværdier. En in-foværdi er en slags variabel, der tilfører reglen oplysning af en bestemt type. Denne type kal-der vi for en infotype. Der findes ca 40 infotyper i STADS. Hver eneste infotype har sin helt unikke konvertering. De simple typer består blot af tal eller tekst, og kræver ingen konvertering, mens de mere avancerede typer knytter sig til opslag i ba-sen, og skal konverteres. Infoværdierne registreres i bek_regelinfo iht. følgende tabel. Hvis infotypen er hentes infoværdiens kode, hhv. na vn, i tabellen og feltet

AAK bet_uddelement.kode, med mindre elementtypen er UDD: Så hen-tes navn samt bekendtgørelsens nummer og år

ADG opt_adgex.adgex

AEL bet_uddelement.kode, med mindre elementtypen er UDD: Så hen-tes navn samt bekendtgørelsens nummer og år

AGR bet_uddelement.kode, med mindre elementtypen er UDD: Så hen-tes navn samt bekendtgørelsens nummer og år

AUD bet_uddelement.navn samt bet_bekendtgoer.bekendtgoer_nr og aar

BED bet_bedoemform.bedoemform

BEL bet_belastnenhed.belastnenhed

BOG ret_karakter.karakter_id

BOO

BUA bet_belastnenhed.belastnenhed

CEN bet_censurform.censurform

CHK bet_chk_infotype.chk_info_forkort

EKA bet_uddelement.kode

ELM bet_uddelement.kode, med mindre elementtypen er UDD: Så hen-tes navn samt bekendtgørelsens nummer og år

EUD bet_udtryk.kode

GER

GRO bet_uddelement.kode, med mindre elementtypen er UDD: Så hen-tes navn samt bekendtgørelsens nummer og år

GYM bet_info_data.info_kode

Page 18: Konvertering af strukturdata - Kulturministerietmaer, m.h.p. at kontrollere, om de nødvendige data findes i det nuværende system. Hvis rap-porterne afslører mangler, især hvad

TV Konvertering af uddannelsesdata i STADS 12.1 STADS

A107.208.16 14.11.2007 Side 18 af 28

Hvis infotypen er hentes infoværdiens kode, hhv. na vn, i tabellen og feltet

KAR ret_karakter.karakter_id

KAT bet_emnekategori.emnekategori

KRV bet_emnekrav.emnekrav

KVL bet_info_data.info_kode

NIV bet_info_data.info_kode

POS

PRV bet_proeveform.betegnelse

SPR bet_sprog.forkortelse

STA

STG bet_studieretn.kode

STR bet_studieretn.kode

TAL

TEK bet_fritekst.fritekst

TFD bet_info_data.info_kode

UDD bet_uddelement.navn samt bet_bekendtgoer.bekendtgoer_nr og aar

UD bet_udtryk.kode

USG bet_uddelement.kode, med mindre elementtypen er UDD: Så hen-tes navn samt bekendtgørelsens nummer og år

UVA bet_uddelement.kode

VAL bet_eksamgrup.eksamgrup

Page 19: Konvertering af strukturdata - Kulturministerietmaer, m.h.p. at kontrollere, om de nødvendige data findes i det nuværende system. Hvis rap-porterne afslører mangler, især hvad

TV Konvertering af uddannelsesdata i STADS 12.1 STADS

A107.208.16 14.11.2007 Side 19 af 28

5. Konverteringsprogrammets struktur Konverteringstabellerne konverteres én ad gangen i følgende rækkefølge:

Bemærk. Regler er en statisk ressource. En regel konverteres ikke. Den er defineret i det mod-tagende system i det, som vi kalder de faste tabeller (tabeller, der er forudfyldt vha. scripts). Reglernes instanser konverteres derimod i takt med, at uddannelseselementerne bliver konver-teret. Generelt skal uddannelseselementerne konverteres først, og reglerne til sidst. Det skyl-des at reglerne indeholder referencer til uddannelseselementerne, men der findes ingen refe-rencer til reglerne.

1. Administrative enheder (bek_admenhed) 2. Hierarki af administrative enheder (bek_admenhed_struktur) 3. Studieretninger (bek_studieretn) 4. Struktur af grupper af studieretninger 5. Emnekategorier og emnekrav (bek_emnekrav) 6. Specialiseringskategorier og specialiseringer (bek_specialisering) 7. Bekendtgørelser – herunder også uddannelser, uddannelsestitler, struktur af uddannelser

samt tilhørende regler og oversættelser (bek_bekendtgørelser, bek_uddannelser, bek_uddtitel, bek_uddstruktur, bek_elem_regel, bek_regelinfo, bek_udenl_betegn)

8. Uddannelsesrammer – herunder også tilhørende regler (bek_uddramme, bek_regelinfo,

bek_elem_regel) 9. Modeller (bek_model) 10.Aktiviteter – herunder også emnekravopfyldelse og tilknyttede regler (bek_aktivitet,

bek_emnekravopfyldelse, bek_elem_regel, bek_regelinfo)). Først records med elementty-pe= “EKA”, så “BEG” og til sidst “UVA”. Ved “BEG”-aktiviteter, hvor undervisningsak-tiviteten udpeger en anden “BEG” aktivitet, kan det blive nødvendigt at konvertere flere gange, idet konvertering i første omgang kan resultere i afvisning.

11.Undervisningsaktiviteters undervisningsformer (bek_uvakt_uvform) 12.Eksaminationer (bek_eksamination) 13.Eksamensaktiviteters sammenhæng med eksaminationer (bek_eksamgrup)

Page 20: Konvertering af strukturdata - Kulturministerietmaer, m.h.p. at kontrollere, om de nødvendige data findes i det nuværende system. Hvis rap-porterne afslører mangler, især hvad

TV Konvertering af uddannelsesdata i STADS 12.1 STADS

A107.208.16 14.11.2007 Side 20 af 28

14.Gruppers sammensætning (bek_gruppe). Her kan det ligeledes blive nødvendigt at konver-tere flere gange pga. referencer mellem grupper. I proceduren BE_KONV.START_KONV kaldes proceduren til konvertering af grupper 3 gange for at håndtere grupper i op til tre ni-veauer. Flere kald kan være nødvendige, hvis der er flere niveauer. Under konverteringen checkes, at der ikke opstår “cykler” i gruppestrukturen. Konverteringen af grupper kan der-for være temmelig tidskrævende.

15.Studieordninger – herunder også tilknyttede uddannelseselementers struktur, STÅ-

oplysninger, steder for studieordningerne samt tilknyttede regler i studieordningstræet (bek_studieordning, bek_studieordn_sted, bek_uddstruktur, bek_elem_staa, bek_elem_regel, bek_regelinfo)

16.Udenlandske betegnelser (bek_udenl_betegn). 17.Udtryk (bek_udtryk) Hver tabel konverteres af en separat stored procedure, der gennemløber tabellen og kon-verterer én record ad gangen. Efter hver vellykket konvertering, sættes status-feltet i konverte-ringstabellen til “K”. Hvis en record ikke kan konverteres, sættes status-feltet til “A” og der gives en forklarende tekst i aarsags-feltet. Konvertering kan enten udføres ved kald af BE_KONV.START_KONV fra sql*Plus eller ved at køre hver enkelt konverteringsprocedure separat i den ovenfor angivne rækkefølge med: set serveroutput on size 1000000 execute BE_KONV.<konverteringsprocedure>; Konverteringsprocedurerne ligger ligesom START_KONV i pakken BE_KONV og hedder: ADMENHED for administrative enheder, ADMENHED_STRUKTUR for administrative enheder, STUDIERETN for studieretninger, STUDIERETN_STRUKTUR for studieretninger, EMNEKRAV for emnekategorier og emnekrav, SPECIALISERING for specialiseringskategorier og specialiseringer, BEKENDTGOER for bekendtgørelser, uddannelser og titler, UDDRAMME for uddannelsesrammer, MODEL for modeller for uddannelsernes sammensætning, AKTIVITET for aktiviteter og emnekravopfyldelser, UVAKT_UVFORM for bindingen mellem undervisningsaktiviteter og undervisningsformer, EKSAMINATION for prøver, EKSAMGRUP for bindingen mellem prøver og eksamensaktiviteter, GRUPPE for grupper,

Page 21: Konvertering af strukturdata - Kulturministerietmaer, m.h.p. at kontrollere, om de nødvendige data findes i det nuværende system. Hvis rap-porterne afslører mangler, især hvad

TV Konvertering af uddannelsesdata i STADS 12.1 STADS

A107.208.16 14.11.2007 Side 21 af 28

STUDIEORDNING1 for studieordninger, UDENL_BETEGN for udenlandske betegnelser og UDTRYK for udtryk. 6. Bilag 6.1 Pakker (BE_KONV) rem Package navn: BE_KONV rem rem Directory: ${VUEHOME}/Beskrivelse/dbprog rem rem Filnavn: ${VUEHOME}/Beskrivelse/dbprog/BE_KON V.ph rem rem Historik: rem ======== rem rem tt 940322 - Oprettet rem rem Rettet, 19950809, Bodil Feldinger (rhh) rem Rettelse Tilfoejet proc. UDTRYK til konvertering af udtryk. rem 19950815 Tilfoejet globale procedure r BEgoer_end, rem BEopdat_eksam_kode og BEgoe r_eka_end rem (omlaegning af sqlscripts). rem 19950914 Tilfoejet global procedure BEgoer_uva_end (ny). rem Procedure SUPPLERAKT udkomm enteret. rem loras 20071003 Tilføjet procedurerne Beken dtgoer, Uddramme, Model, rem Admenhed_struktur, Studiere tn_struktur og Studieordning rem i forbindelse med A107.1375 1.3. prompt Opretter package header for BE_KONV create or replace package BE_KONV is ------- -- Generel beskrivelse: -- ==================== -- -- BE_KONV er en pakke, som indeholder procedure r til konvertering af -- uddannelsesdata. Proceduren START_KONV udføre r en fuld konvertering -- af uddannelsesdata. Udover konverteringsproce durer indeholder pakken -- procedurer til masseopdatering af status på a ktiviteter, studieordninger -- bekendtgørelser og uddannelsesrammer -- procedure ADMENHED; -- Beskrivelse: Konvertering af data fra bek_adme nhed til vyt_admenhed -- Input: Records med status 'U' for ukonverteret eller 'A' for afvist. -- Output: Records i vyt_admenhed -- Sideeffekter: Opdatering af bek_admenhed procedure ADMENHED_STRUKTUR; -- Beskrivelse: Konvertering af data fra bek_adme nhed_struktur til -- vyt_admenhed_struktur. -- Input: Records med status 'U' for ukonvertere t eller 'A' for afvist. -- Output: Records i vyt_admenhed_struktur -- Sideeffekter: Opdatering af bek_admenhed_struk tur procedure STUDIERETN; -- Beskrivelse: Konvertering af data fra bek_stud ieretn til bet_studieretn -- Input: Records med status 'U' for ukonvertere t eller 'A' for afvist. -- Output: Records i bet_studieretn -- Sideeffekter: Opdatering af bek_studieretn procedure STUDIERETN_STRUKTUR; -- Beskrivelse: Konvertering af data fra bek_stud retnstru til -- bet_studretnstru. -- Input: Records med status 'U' for ukonvertere t eller 'A' for afvist.

1 Proceduren STUDIEORDNING tager en J/N værdi som in-parameter. Se nærmere forklaring under proceduren i pakkespecifikationen i bilaget vedr. pakker.

Page 22: Konvertering af strukturdata - Kulturministerietmaer, m.h.p. at kontrollere, om de nødvendige data findes i det nuværende system. Hvis rap-porterne afslører mangler, især hvad

TV Konvertering af uddannelsesdata i STADS 12.1 STADS

A107.208.16 14.11.2007 Side 22 af 28

-- Output: Records i bet_studretnstru -- Sideeffekter: Opdatering af bek_studretnstru procedure EMNEKRAV; -- Beskrivelse: Konvertering af data fra bek_emne krav til -- bet_emnekrav og bet_emnekategori. -- Input: Records med status 'U' for ukonvertere t eller 'A' for afvist. -- Output: Records i bet_emnekrav og bet_emnekate gori -- Sideeffekter: Opdatering af bek_studretnstru procedure SPECIALISERING; -- Beskrivelse: Konvertering af data fra bek_spec ialisering til -- bet_spec_kategori og bet_speciali sering. -- Input: Records med status 'U' for ukonvertere t eller 'A' for afvist. -- Output: Records i bet_spec_kategori og bet_spe cialisering -- Sideeffekter: Opdatering af bek_specialisering procedure EKSAMINATION; -- Beskrivelse: til konvertering af data -- fra Bek_eksamination til -- Bet_eksamiation -- Bet_hjaelpemiddel -- Bet_eksam_hjaelp -- Bet_planl_hensyn -- Bet_ekplanhensyn -- Input: Records i BEK_Eksamination med status ' U' for ukonverteret eller -- 'A' for afvist -- Output:Records i BEK_eksamination, samt de øvr ige tabeller -- Sideeffekter: Opdatering af bek_eksamination procedure AKTIVITET; -- Beskrivelse: Konvertering af data fra bek_akti vitet -- til bet_uddelement, bet_eksamensa kt, bet_undvisnakt, -- bet_uvakt_eksakt og bet_samtidekt ilm -- Input: Records med status 'U' for ukonverteret eller 'A' for afvist -- Output: Records i bet_ tabellerne og opdaterin g i bek_aktivitet -- Sideeffekter: Opdatering af bek_aktivitet procedure EKSAMGRUP; -- Beskrivelse: Konvertering af data fra bek_eksa mgrup til -- bet_eksamgrup og bet_ekgrup_eksam -- Input: Records med status 'U' eller 'A' fra be k_eksamgrup -- Output: Records i bet_eksamgrup og bet_ekgrup_ eksam -- Sideeffekter: Opdatering af bek_eksamgrup procedure STUDIEORDNING(p_meget_muligt in varchar 2); -- Beskrivelse: Konvertering af studieordninger f ra bek_studieordning m.fl. -- Hvis proceduren kaldes med J som parameterværdi, vil så meget -- som muligt af studieordningen bli ve konverteret ind, selvom -- ikke alt kan genfindes. Hvis proc eduren kaldes med N som -- parameterværdi, vil studieordning en kun blive konverteret ind, -- hvis alle elementer inkl. regler kan genfindes i det modtagende -- system. -- Input: Records med status 'U' eller 'A' -- Output: Records i bet_studieordn m.fl. -- Sideeffekter: Opdatering af bek_studieordning m.fl. procedure BEKENDTGOER; -- Beskrivelse: til konvertering af data -- fra Bek_bekendtgoerelse til -- Bet_bekendtgoer og -- bek_oms_bekendtgoerelse -- fra Bek_udenl_betegn til -- Bet_udenl_betegn -- fra Bek_uddannelse til -- Bet_uddannelse og -- Bet_uddelement og -- Bek_oms_element -- fra Bek_uddtitel til -- Bet_uddtitel -- fra Bek_uddstruktur til -- Bet_uddstruktur -- Input: Records i Bek_bekendtgoerelse, Bek_uden l_betegn, Bek_uddannelse, -- Bek_uddtitel og Bek_uddstruktur med sta tus 'U' for ukonverteret -- eller 'A' for afvist. -- Output:Records i Bet_bekendtgoer samt de øvrig e tabeller. -- Sideeffekter: Opdatering af bek_bekendtgoerels e m.fl.

Page 23: Konvertering af strukturdata - Kulturministerietmaer, m.h.p. at kontrollere, om de nødvendige data findes i det nuværende system. Hvis rap-porterne afslører mangler, især hvad

TV Konvertering af uddannelsesdata i STADS 12.1 STADS

A107.208.16 14.11.2007 Side 23 af 28

procedure UDDRAMME; -- Beskrivelse: Konvertering af data fra bek_uddr amme til bet_uddramme. -- Input: Records med status 'U' for ukonvertere t eller 'A' for afvist. -- Output: Records i bet_uddramme -- Sideeffekter: Opdatering af bek_uddramme -- Exceptions: procedure MODEL; -- Beskrivelse: Konvertering af data fra bek_mode l og bek_model_udd til -- bet_model hhv.bet_model_udd. -- Input: Records med status 'U' for ukonvertere t eller 'A' for afvist. -- Output: Records i bet_model og bet_model_udd -- Sideeffekter: Opdatering af bek_model og bek_m odel_udd procedure UVAKT_UVFORM; -- Beskrivelse: Konvertering af data fra bek_uvak t_uvform til bet_uvakt_uvform -- Input: Records i bek_uvakt_uvform med status ' U' eller 'A' -- Output: Records i bet_uvakt_uvform -- Sideeffekter: Opdatering af bek_uvakt_uvform procedure GRUPPE; -- Beskrivelse: Konvertering af data -- fra BEK_GRUPPE til -- Bet_gruppe -- Bet_uddelement -- Bet_uddstruktur -- Input: Records i BEK_gruppe med status 'U' for ukonverteret eller 'A' -- for afvist -- Output: Records i BEK_gruppe, samt de øvrige t abeller -- Sideeffekter: Opdatering af bek_gruppe procedure UDENL_BETEGN; -- Beskrivelse: Konvertering af data -- fra BEK_UDENL_BETEGN til -- BET_UDENL_BETEGN -- Input: Records fra bek_udenl_betegn med status 'U' for ukonverteret -- eller 'A' for afvist. -- Output: Records i bet_udenl_betegn. -- Sideeffekter: Hvis et angivet sprog ikke finde s oprettes det i bet_sprog -- med forkortelse og betegnelse li g det angivne. procedure UDTRYK; -- Beskrivelse: til konvertering af data -- fra BEK_UDTRYK til -- BET_UDTRYK -- Input: Records fra bek_udtryk med status 'U' f or ukonverteret -- eller 'A' for afvist. -- Output: Records i bet_udtryk. -- Sideeffekter: Opdatering af bek_udtryk procedure START_KONV (p_meget_muligt in varchar2 default null); -- Beskrivelse: bruges til at udføre konvertering sprocedurerne i pakken -- Input: intet -- Output: intet -- Sideeffekter: Data konverteres ind i Udd. stru ktur fra konv. tabellerne -- Exceptions: procedure Bekendtgoer_end(Aktion IN VARCHAR2 DEFA ULT 'STU', Kode_ind IN VARCHAR2 DEFAULT NULL); -- Beskrivelse: bruges til at gøre alle eller udv algte bekendtgørelser, -- uddannelsesrammer og studieordnin ger endelige. -- Input: Aktion - værdi -- ALLE (for at alle ovenstående gøres endelige), -- STU (for at kode_ind er studi eordn.kode) -- RAM (for at kode_ind er udd.r amme.kode) -- Kode_ind Studieordn.kode for STU og ud d.rammekode for RAM. -- Output: intet -- Sideeffekter: Status ændres også til endelig f or uddannelser, regler, -- grupper og aktiviteter, som indgår under beken dtgørelserne, rammerne og -- studieordningerne. -- Exceptions: -- Fejlnr 310020: Hvis en underliggend e eksamensaktivitet ingen -- valgmulighed har ell er ingen prøver har kommer -- fejlen. -- Fejlnr 310014: Hvis en underliggend e gruppe er tom kommer -- fejlen.

Page 24: Konvertering af strukturdata - Kulturministerietmaer, m.h.p. at kontrollere, om de nødvendige data findes i det nuværende system. Hvis rap-porterne afslører mangler, især hvad

TV Konvertering af uddannelsesdata i STADS 12.1 STADS

A107.208.16 14.11.2007 Side 24 af 28

-- Fejlnr 310310: Hvis studieordningen er tom kommer denne fejl procedure BEopdat_eksam_kode; -- Beskrivelse: Opdatering af eksaminationers kod e. -- Hvis man oensker, at eksamination er skal have en kode -- bestaaende af koden for den eksam ensaktivitet den anvendes i, -- anvendes denne procedure. -- NB! Under koersel af proceduren skal constrainten -- BET_EKSAMINATION_KODE_UK paa tabe l BET_EKSAMINATION -- disables (HUSK at enable den umid delbart efter koerslen!) -- -- Input: intet -- Output: intet -- Sideeffekter: procedure BEgoer_eka_end(admenhed_id_ind IN NUMBE R); -- Beskrivelse: Procedure der gør eksamensaktivit eter med en bestemt -- administrativ enhed endelige. Med null som parameter -- gøres alle eksamensaktiviteter en delige. -- -- Input: Id på en administrativ enhed fra vyt_ad menhed eller null -- Output: intet -- Sideeffekter: Eksamensaktivitetens regler får også status endelig -- Exceptions: Fejlnr 310020: Hvis en eksamensakt ivitet ingen valgmulighed har -- eller ingen prøve har kommer denne fejl procedure BEgoer_uva_end(admenhed_id_ind IN NUMBE R); -- Beskrivelse: Procedure der gør undervisningsak tiviteter med en bestemt -- administrativ enhed endelige. Med null som parameter gøres -- alle undervisningsaktiviteter end elige. -- -- Input: Id på en administrativ enhed fra vyt_ad menhed eller null -- Output: intet -- Sideeffekter: Undervisningsaktivitetens regler får også status endelig --<new_proc_h> end BE_KONV; / rem De følgende linjer bruges til at initialisere e macs: rem Local Variables: *** rem compile-command: "vpsqlinstall -s BE_KONV.ph" * ** rem End: ***

6.2 BE_KONVUD rem Package navn: BE_KONVUD rem Directory: ${VUEHOME}/Beskrivelse/dbprog rem Filnavn: ${VUEHOME}/Beskrivelse/dbprog/BE_KONVUD.ph rem Historik: rem ======== rem NIJOR 20080124 - Oprettet prompt Opretter package header for BE_KONVUD create or replace package BE_KONVUD is ---- -- Generel beskrivelse: -- ==================== -- -- BE_KONVUD er en package som indeholder konverteringsprocedurer -- for udlæsning af uddannelsernes struktur. -- -- Udlæsningen igangsættes med kommandoen -- -- exec be_konvud.start_konv --

Page 25: Konvertering af strukturdata - Kulturministerietmaer, m.h.p. at kontrollere, om de nødvendige data findes i det nuværende system. Hvis rap-porterne afslører mangler, især hvad

TV Konvertering af uddannelsesdata i STADS 12.1 STADS

A107.208.16 14.11.2007 Side 25 af 28

-- Når man skal læse ud, kan man vælge at læse ud til samme systems -- konverteringstabeller, hvilket er default. -- -- Hvis man i stedet vil læse data ud fra et system til et andet systems -- konverteringstabeller, skal man have et databaselink mellem de to -- systemer, og man skal stå i det modtagende system og bestille udlæsningen, -- Udlæsningen vil så hente data fra det system, som databaselinket peger på. -- Den tekst, der skrives i feltet ”tilretningsstatus”, hentes fra -- trimmeparameteren 'KONV_TILRETN_STATUS' i det afleverende system. -- Databaselinket kan ændres ved at køre scriptet -- $VUEHOME/Beskrivelse/sql/BE_KONV_DBLINK.sql og indtaste navnet på -- 1. udlæsende database, 2. usernavn og 3. password -- når man bliver bedt om det. -- Navnet på den udlæsende database skal være angivet i TNSNAMES.ora -- -- ======================================================= -- konveterings konstanter til brug i bek_ tabellerne const_afvist constant varchar(1) := 'A'; const_konverteret constant varchar(1) := 'K'; const_ukonverteret constant varchar(1) := 'U'; const_fejlet constant varchar(1) := 'F'; const_ja constant varchar(1) := 'J'; const_nej constant varchar(1) := 'N'; -- ======================================================= procedure UDTRAEK_ADMENHED; -- -- Beskrivelse: Udlæser bet_admenhed -- Input: -- Output: bek_admenhed -- Sideeffekter: -- Exceptions: -- Programbeskrivelse: udlæser data fra vys_admenhed til bek_admenhed -- procedure UDTRAEK_ADMENHED_STRUKTUR; -- -- Beskrivelse: Udlæser bet_admenhed_struktur -- Input: -- Output: bek_admenhed_struktur -- Sideeffekter: -- Exceptions: -- Programbeskrivelse: udlæser fra vys_admenhed_struktur til bek_admenhed_struktur -- procedure UDTRAEK_BEKENDTGOER; -- -- Beskrivelse: Udlæser bet_bekendtgoer og bet_uddannelse for denne -- Input: -- Output: bek_bekendtgoer + bek_uddannelse + bek_uddstruktur -- Sideeffekter: -- Exceptions: -- Programbeskrivelse: udlæser data til konverteringstabeller -- procedure UDTRAEK_STUDIEORDNING; -- -- Beskrivelse: Udlæser bet_studieordn -- Input: -- Output: bek_studieordn + bek_uddstruktur -- Sideeffekter: -- Exceptions: -- Programbeskrivelse: udlæser data til konverteringstabeller -- procedure UDTRAEK_STUDIEORDNING_STED;

Page 26: Konvertering af strukturdata - Kulturministerietmaer, m.h.p. at kontrollere, om de nødvendige data findes i det nuværende system. Hvis rap-porterne afslører mangler, især hvad

TV Konvertering af uddannelsesdata i STADS 12.1 STADS

A107.208.16 14.11.2007 Side 26 af 28

-- -- Beskrivelse: Udlæser bet_studieordn_sted -- Input: -- Output: bek_studieordn_sted -- Sideeffekter: -- Exceptions: -- Programbeskrivelse: udlæser data til konverteringstabeller -- procedure UDTRAEK_SPECIALISERING; -- -- Beskrivelse: Udlæser bet_specialisering -- Input: -- Output: bek_specialisering -- Sideeffekter: -- Exceptions: -- Programbeskrivelse: udlæser data til konverteringstabeller -- procedure UDTRAEK_AKTIVITET; -- -- Beskrivelse: Udlæser bet_aktivitet -- Input: -- Output: bek_aktivitet -- Sideeffekter: -- Exceptions: -- Programbeskrivelse: udlæser data til konverteringstabeller -- procedure UDTRAEK_EKSAMINATION; -- -- Beskrivelse: Udlæser bet_eksamination -- Input: -- Output: bek_eksamination -- Sideeffekter: -- Exceptions: -- Programbeskrivelse: udlæser data til konverteringstabeller -- procedure UDTRAEK_STUDIERETN; -- -- Beskrivelse: Udlæser bet_studieretn -- Input: -- output: bek_studieretn -- Sideeffekter: -- exceptions: -- Programbeskrivelse: Udlæser data til konverteringstabeller -- procedure UDTRAEK_STUDIERETNSTRU; -- -- Beskrivelse: Udlæser bet_studieretnstru -- Input: -- output: bek_studieretnstru -- Sideeffekter: -- exceptions: -- Programbeskrivelse: Udlæser data til konverteringstabeller -- procedure UDTRAEK_EKSAMGRUP; -- -- Beskrivelse: Udlæser bet_eksamgrup -- Input: -- output: bek_eksamgrup -- Sideeffekter: -- exceptions: -- Programbeskrivelse: Udlæser data til konverteringstabeller --

Page 27: Konvertering af strukturdata - Kulturministerietmaer, m.h.p. at kontrollere, om de nødvendige data findes i det nuværende system. Hvis rap-porterne afslører mangler, især hvad

TV Konvertering af uddannelsesdata i STADS 12.1 STADS

A107.208.16 14.11.2007 Side 27 af 28

procedure UDTRAEK_UDENL_BETEGN; -- -- Beskrivelse: Udlæser bet_udenl_betegn -- Input: -- output: bek_udenl_betegn -- Sideeffekter: -- exceptions: -- Programbeskrivelse: Udlæser data til konverteringstabeller -- procedure UDTRAEK_UVAKT_UVFORM; -- -- Beskrivelse: Udlæser bet_uvakt_uvform -- Input: -- output: bek_uvakt_uvform -- Sideeffekter: -- exceptions: -- Programbeskrivelse: Udlæser data til konverteringstabeller -- procedure UDTRAEK_GRUPPE; -- -- Beskrivelse: Udlæser bet_gruppe -- Input: -- output: bek_gruppe -- Sideeffekter: -- exceptions: -- Programbeskrivelse: Udlæser data til konverteringstabeller -- procedure UDTRAEK_UDENL_OPGAVETITEL; -- -- Beskrivelse: Udlæser bet_udenl_opgaver -- Input: -- output: bek_udenl_opgaver -- Sideeffekter: -- exceptions: -- Programbeskrivelse: Udlæser data til konverteringstabeller -- procedure UDTRAEK_UDDRAMME; -- -- Beskrivelse: Udlæser bet_uddramme -- Input: -- output: bek_uddramme -- Sideeffekter: -- exceptions: -- Programbeskrivelse: Udlæser data til konverteringstabeller -- procedure UDTRAEK_MODEL; -- -- Beskrivelse: Udlæser bet_model -- Input: -- output: bek_model -- Sideeffekter: -- exceptions: -- Programbeskrivelse: Udlæser data til konverteringstabeller -- procedure UDTRAEK_EMNEKRAV; -- -- Beskrivelse: Udlæser bet_emnekrav -- Input: -- output: bek_emnekrav -- Sideeffekter: -- exceptions: -- Programbeskrivelse: Udlæser data til konverteringstabeller -- procedure UDTRAEK_EMNEKRAVOPFYLD; --

Page 28: Konvertering af strukturdata - Kulturministerietmaer, m.h.p. at kontrollere, om de nødvendige data findes i det nuværende system. Hvis rap-porterne afslører mangler, især hvad

TV Konvertering af uddannelsesdata i STADS 12.1 STADS

A107.208.16 14.11.2007 Side 28 af 28

-- Beskrivelse: Udlæser bet_emnekravopfyld -- Input: -- output: bek_emnekravopfyld -- Sideeffekter: -- Exceptions: -- Programbeskrivelse: Udlæser data til konverteringstabeller -- procedure export_regler; -- procedure til eksport af regler. -- Proceduren eksporterer alle regler i bet_elem_regel tabellen samt -- tilhørende infoværdier i bet_regelinfo. -- data exporteres til respektive bek_ tabeller bek_elem_regel ig -- bek_regelinfo. -- pt. kan der ekspoorteres alle regler. procedure START_KONV; -- -- Beskrivelse: Udlæser alle relevante tabeller for design A107.14090 -- Input: -- output: -- Sideeffekter: -- Exceptions: -- Programbeskrivelse: Udlæser data til konverteringstabeller -- De udlæste data kan/skal indlæses med pakken BE_KONV.start_konv. -- -- --set pagesize 999 --set linesize 120 --set serveroutput on size 1000000 --exec vys_trace.set_tracelevel(20); --exec be_konvud.start_konv; --set serveroutput off --exec vys_trace.set_tracelevel(0); FUNCTION FindTrim(TrimKey VARCHAR2, InDelSys NUMBER, InBruger VARCHAR2 := NULL) RETURN VARCHAR2; --function der finder værdien af en trimmeparameter jvf en database-link, --i modsætning til den gængse, der finder værdien i det aktuelle system. end BE_KONVUD; / rem De følgende linjer bruges til at initialisere e macs: rem Local Variables: *** rem compile-command: "vpsqlinstall -s BE_KONVUD.ph" *** rem End: ***