Ladok Funktionsbeskrivning SB01 Datum: Beteckning: 2015-05-29 SB01_funkbeskr Ändringshistorik Datum Av Kommentar Granskare Godkännare 2005-06-22 Martin Edlund Första utkast. Meritdatadelen är inte beskriven 2005-06-23 Martin Edlund Lagt till beskrivande text under 2.2 2005-12-20 Martin Edlund Lagt till punkt 2, beskrivning av funktionen.. Matz-Ola Matz-Ola Matz-Ola 2006-12-29 Håkan Bachman Utvidgad / omarbetad Matz-Ola 2009-02-16 Mattias Wickberg Lagt till Hjälptexter enligt NOUVSD-5989 2009-12-23 Mattias Wickberg Lag till om hantering av skyddade personer i 3.3 Matz-Ola - - -
Martin Edlund / Håkan Bachman 2015-05-29 SB01_funkbeskr 2 (8) 2015-05-29 Anna-Carin Wiklund Lagt till villkor för utsökning av katalogdata för EXAMBEN och EXAMINR. Innehållsförteckning 1 ALLMÄNT... 3 2 FUNKTIONSDELAR... 3 2.1 BESTÄLLNINGSFUNKTION I LADOK NOUVEAU... 3 2.2 BATCH I JAVA... 3 3 INFORMATIONSFLÖDET MELLAN LADOK OCH NYA... 4 3.1 KATALOGDATA... 5 3.2 MERITDATA... 6 3.3 MERITDATA SKYDDADE PERSONER... 7 4 BAKOMLIGGANDE BESLUT... 7 5 BEHÖRIGHETSANALYS... 7 6 PREFERENSSTYRNING... 8 6.1 SYSTEM- OCH ANVÄNDARPREFERENSER... 8 6.2 PERSONLIGA PREFERENSER (PERSONLIGA INSTÄLLNINGAR)... 8 7 AVVIKELSER FRÅN STANDARD & GUIDELINES... 8 8 UTSKRIFTER... 8 9 BILAGOR: FORMULÄR OCH HJÄLPTEXTER... FEL! BOKMÄRKET ÄR INTE DEFINIERAT. 9.1 GB01A00G... FEL! BOKMÄRKET ÄR INTE DEFINIERAT. 9.1.1 Formulär... Fel! Bokmärket är inte definierat. 9.1.2 Funktionshjälp... Fel! Bokmärket är inte definierat.
Martin Edlund / Håkan Bachman 2015-05-29 SB01_funkbeskr 3 (8) 1 Allmänt SB01 används för skicka katalog- och meritdata till VHS antagningssystem NyA. SB01 består av en funktion i Ladok Nouveau och en batch i java. I denna funktion beställer du körningar av batchen SB01. Normalt körs SB01 varje dygn så att NyA alltid har uppdaterad data. I startformuläret kan du se dina egna beställningar, men preferensstyrning för att se alla beställningar finns. Så fungerar SB01 NyA-systemets batchprogram 26 skapar beställningsfiler för vart och ett av Ladoksystemen. Ladoksystemet hämtar de två beställningsfilerna som ligger på en filarea i NyA-systemet och sedan körs batchen igång. Den ena filen avser beställning av katalogdata, den andra filen avser meritdata och består av personnummer för nya sökanden i en antagningsomgång sedan senaste överföringen. De tillkommande personerna i en antagningsomgång sparas undan i Ladok så att systemet har en komplett uppsättning av personer för vilka meriter ska överföras till NyA. NyA skickar även en fil för att bekräfta om senaste överföringen från Ladok-instansen gick bra och eventuellt vad som inte gick bra. Sedan skickar NyA också en fil med personer som de inte vill ha meriter för längre, en avbeställningsfil. SB01 sammanställer sedan katalog- och meritdata i en resultatfil som skickas till NyA:s ftpserver. 2 Funktionsdelar 2.1 Beställningsfunktion i Ladok Nouveau SB01 bygger på den generella batchbeställningsfunktion GB01, vilken finns beskriven separat. Det vanligaste är att man skapar en stående beställning, måndag fredag under antagningstid. Meddelande via e-post som innehåller information om hur batchen körts skickas till användarens e-postadress. Flera adresser kan skrivas in under Inställningar. Inga listor skapas som kan hämtas via Hämta fil. En logfil skapas på driftstället. 2.2 Batch i Java Batchen SB01 består i stora drag av två delar. En del sammanställer katalogdata och en meritdata.
Martin Edlund / Håkan Bachman 2015-05-29 SB01_funkbeskr 4 (8) 3 Informationsflödet mellan Ladok och NyA SB01-batchen kommunicerar med NyA-systemet med hjälp av filöverföringar. Följande filer används: CATALOG. Beställningsfil skapad av NyA. Filen är alltid tom men innebär att NyA behöver katalogdata. Katalogdata kan beställas separat från meriter. MERITS. Beställningsfil skapad av NyA för meriter. Innehåller personnummer som NyA behöver meriter för. Endast personnummer som tillkommit sen förra beställningen finns i filen. Denna fil kan inte finnas ensam utan skall alltid följas av en CATALOG-fil. CONFIRM. Fil skapad av NyA. Innehåller denna fil information betyder det att vissa meriter eller katalogdata från förra beställningen inte kunde tas emot av NyA. Om filen är tom gick förra körningen bra. REMOVE. Innehåller personnummer som NyA inte längre vill ha meriter på. RESULT. Skapas av SB01 och innehåller all katalogdata och meriter som SB01 tagit fram. Flödet för SB01 när denna körs för första gången är följande: (något förenklat) SB01 startar då beställning i Nouveau skapats och beställningsfiler från NyA finns. SB01 läser in filerna MERITS och CATALOG. Tabell MERITBES i Ladok uppdateras med personnumren i MERITS-filen. SB01 framställer en katalog- och meritdatafil, RESULT. När en första hämtning görs tas i princip all data med bakåt i tiden. SB01 levererar RESULT-filen till NyA. SB01 avslutas och en e-post om detta skickas till ladokanvändaren/batchbeställaren. Då SB01 körs dag två är flödet något mer komplicerat: SB01 startar, om ny beställning från NyA finns, med att läsa in en CONFIRM-fil. Denna fil innehåller ett datum då senaste inläsningen hos NyA lyckades. Alla poster i tabellerna MERITBES och KATBEST i Ladok uppdateras med detta datum. (Har ingen inläsning lyckats hos NyA finns ingen CONFIRM-fil och flödet är precis som ovan). SB01 läser in filen MERITS och CATALOG. I denna MERITS-fil finns sökande som tillkommit sen förra beställningen. Dessa personnummer läggs in i tabell MERITBES. I detta läge kommer man ha två typer av personnummer i MERITBES. Dels de som har datum från senaste lyckade överföringen, och de nytillkomna som har blankt i detta datumfält.
Martin Edlund / Håkan Bachman 2015-05-29 SB01_funkbeskr 5 (8) SB01 sammanställer katalogdata, men ingen totalhämtning denna gång, utan bara de data som tillkommit sen förra lyckade körningen tas med. I praktiken jämförs tex KURS.IDATUM med det datum som finns i tabell KATBEST. Detta görs för att minimera mängden data som förs över varje natt. SB01 framställer meriter på samma sätt. De personnummer som saknar datum i tabell MERITBES får alla sina meriter med i RESULT-filen, emedan de med datum får endast nytillkomna meriter. RESULT-filen levereras till NyA. SB01 avslutas och mail om detta skickas till ladokanvändaren. I de fall VHS skickar med en REMOVE-fil tar SB01 hand om denna fil först av alla filer. De personnummer som finns i filen tas bort ur ladoks tabell MERITBES innan meriter och katalogdata samlas ihop. 3.1 Katalogdata SB01 framställer en lista med katalogdata indelat i posttyper. Posttypernas benämning och innehåll följer i princip motsvarande tabell i NyA. Poster markerade med * har uppgift om inläggningsdatum och endast nya poster tas med. Post med **, dvs programplaner, har inte något inläggningsdatum, men för att begränsa mängden data tas bara innevarande termin och framåt med. Poster med ***, dvs EXAMBEN och EXAMINR har en begränsning lagts till som innebär att: Alla EXAMBEN poster kommer med förutom de med EXTYP=X. Alla EXAMINR poster kommer med förutom de som har en motsvarig post i EXAMBEN där EXTYP = X. För övriga posttyper görs totalhämtning varje gång. Posttyperna är följande: ACCOUNT*, alla studenters konto från i första hand tabell NAMN och och i andra hand från tabell TELEKOM. DEPARTMENT, hsk alla institutioner från tabell INST. COURSE*, kurserna från tabell KURS. Med denna posttyp följer information om kursen är poänggivande eller inte. Detta styrs genom att ev märkning med lokal serie och klass NYA/EJPOANG läses. EDUCATIONFIELD*, kursernas utbildningsområde från tabell KURSUOMR. SUBJECT, kursernas ämnestillhörighet från tabell DKLASS
Martin Edlund / Håkan Bachman 2015-05-29 SB01_funkbeskr 6 (8) TEST*, kursernas prov från tabell PROV. PROGRAM, alla program från tabell LINJE PROGRAMSPEC, inriktningar på program från tabell LINJEINR PROGCOURSE, kursers programtillhörighet från tabell PROGKURS PROGSEMCOURSE**, programplaner från tabell PROGPLK EXAMINA***, examensdefinitioner från tabell EXAMBEN EXAMINASPEC***, examensinriktningar från tabell EXAMINR FOREIGNEDUORG, utländska hsk från tabell UTLHSK. 3.2 Meritdata Då VHS beställer meritdata från alla hsk samtidigt kommer MERITS-filen ha samma innehåll för alla hsk. Detta innebär att alla hsk kommer att ha samma innehåll i sin tabell MERITBES, förutsatt att alla hsk kör SB01 på samma sätt. Meriterna till NyA ställs samman i en mängd olika posttyper. En viss posttyp kan innehålla information från olika ladoktabeller. Gemensamt för alla merittyper med kurskod (tex reg, resultat etc) är att de selekteras på den lokala serien NYA med klasserna EJPOANG respektive EJMERIT. Kurser med märkning med EJMERIT tas inte med alls, emedan märkningen med EJPOANG innebär att meriterna tas med men märks så att NyA inte räknar meritvärde. Om resultat eller registrering tas bort ur Ladok för person skickas en speciell bortpost med till NyA. Detta gäller i princip alla meriter som har en motsvarande BORT-tabell i Ladok. Följande meritposter ställs samman: CORQ, registrering, avbrott och resultat på hel kurs. Från tabellerna FFGKURS, INREGFFG, GODKKURS, BORTRES och BORTREGK. CORR, fortsättnings- och omregistreringar. Från ladoktabellerna FORTKURS, OMKURS, INREGFO, INREGOM och BORTREGK TEQ, resultat på prov. Från ladoktabellerna GODKPROV, UNDKPROV och BORTRES CRAQ tillgodoräknanden. Från ladoktabellerna UTBYTE och BORTTG CRIS, tillgodoräknanden egen högskola. Från ladoktabell INBYTEGH CRES, tillgodoräknanden annan högskola. Från ladoktabell INBYTANN CRTS, specifikation av tillgodoräknanden på prov. Från ladoktabell GODPRTG EXQ, examina. Från ladoktabellerna EXAMEN2 och EXAMLOGG PRR, programantagningar. Från ladoktabellerna ANTLIN och AVBRLIN
Martin Edlund / Håkan Bachman 2015-05-29 SB01_funkbeskr 7 (8) PRSR, inriktningsantagningar. Från ladoktabellerna ANTINR och AVBRINR PRB, studieuppehåll. Från tabell UPPHLIN. PSR, terminsregistreringar. Från tabell FFGLIN. PSRR, terminsregistreringar. Från tabell OMREGLIN. LATQ, personens sammanlagda akademiska poäng. OEX, utresande utbytesstudier. Från tabell UBUTSTUD OEXR, utresande utbytesstudier, registreringar och resultat. Från tabell UBUTRANT och UBUTREG IEX, inresande utbytesstudier. Från tabell UBINSTUD. IEXQ, iresesande utbytesstudier, registrering och resultat. Från tabellerna UBINDRG, UBINDBG, UBINDBU, BORTRES och BORTREGK. 3.3 Meritdata skyddade personer NyA skickar med en markering huruvida aktuell person är skyddad eller inte. Denna markering används för att se till att rätt data skickas till NyA. För en person som är skyddad i båda systemen skickas data till NyA. För en person som är skyddad i NyA men inte i LADOK skickas data till NyA. För person som är skyddad i LADOK men ej i NyA skickas inga meriter från det aktuella lärosätet. 4 Bakomliggande beslut Följande beslut finns som påverkar denna funktion. Nr Ärende Anmärkning 5 Behörighetsanalys Användaren måste ha behörighet till funktionen för att kunna beställa en körning av batch SB01.
Martin Edlund / Håkan Bachman 2015-05-29 SB01_funkbeskr 8 (8) 6 Preferensstyrning 6.1 System- och användarpreferenser Funk Nr Vad vill man styra SB01 1 Lägg till/ta bort ändra andras batchbeställningar SB01 2 Begränsa möjlighet att skapa stående beställningar Nyckelord Värde: Resultat Default Typ SUPER J N A/S? EJSTAENDE SB01 3 Defaulttid för batchbeställningar DEFAULTTID *) Typ betyder: S: SYSTPREF/ A: ANVPREF J = stående beställning kan ej anges N/bl = stående beställning kan anges bl 2000 S A/S? 6.2 Personliga preferenser (personliga inställningar) Personliga preferenser saknas i funktionen 7 Avvikelser från Standard & Guidelines Var Vad S&G 8 Utskrifter Utskrifter saknas.