Kravspecifikation Automatisk överföring av SB02 Reviderad kravspecifikation för SB02 [2016-05-26] Status:
Per Lindgren, Bengt Reinholdsson 2016-05-26 2 (215) Ändringshistorik Datum Av Kommentar Godkännare 2009-02-06 Per Lindgren Första utkast till struktur H Bachman 2010-04-22 PerLindgren Leverans av ny kravspec + leverans från 0106(fellista adress+urvalsdata) Proj STU T 0106 2010-08-26 PerLindgren Leverans från 0106 september 2010. Delvis ny hantering av NATEXAM o EXSUPPL Vi har även infört ett nytt upplägg för att dokumentera typ av fel/info. I skrivande stund bara infört för ovan nämnda tabeller. Vid ändringar av andra katalogtabeller ska det nya upplägget användas 2011-01-10 PerLindgren Leverans från STU-T 0106 och 0107 Efter kravgranskning i respektive projekt 2011-02-01 PerLindgren STU T-0107mars. Villkor 4 på fellista. Tidsstämpel i tabellerna AVGKURS o AVGTERM. 2011-02-21 Björn Edlund Uppdaterat tabell för programfel. Större delen av felmeddelandena har får information om urvalsgrupp och reservnummer. NOUVSD-8785. 2011-04-13 PerLindgren STU T-1101 april. Anpassningar för att helt gå över till avgifter 2011-12-06 David Andersson Ändrat vissa av texterna i drop down-listorna. NOUVSD-8618 2012-01-09 Martin Edlund STUSNYA-8. Lagt listan över studieavgiftsskyldiga studenter under rubrik R173. Tillägg för antagningar till kurspaket. 2012-06-13 PerLindgren STU T-2101 studavg leverans juni 2012 2012-06-28 PerLindgren Åtgärd https://jira.its.umu.se/browse/ladok- 11978 Reserver skrivs till LOKANTLR när antagning finns till samma program men annan inriktning Leverans 2012_3 2012-10-29 PerLindgren https://jira.its.umu.se/browse/ladok-12047 antagning program med terminsreg: varning vid borttag av övrigt villkor ska inte skrivas för tillhörande kursantagningar
Per Lindgren, Bengt Reinholdsson 2016-05-26 3 (215) 2013-01-16 PerLindgren Korrigering av läsning i AVGPERS Se kapitel: Behandling när avgiftstermin har ett värde(avgiftsbelagd omgång) 2013-01-29 David Andersson Kontroll av otillåtna tecken i in-filen. 2013-01-29 Anna-Carin Wiklund 2013-03-22 Bengt Reinholdsson 2013-05-13 Bengt Reinholdsson Tillägg studieavgifter och markering av avgiftsfritt kurs/programtillfälle. Kap 3.6.1 och 3.6.6 LADOK-3331: lagt in beloppen på utskriften 3.8.6, 3.8.6.1 Ny version av kraven på SB02 efter att ny hantering av överföring från NyA ändras i september 2013 2013-05-17 Per Lindgren Hantering av AVG-post/AVGPERS Se R98 & R99 2013-05-30 Marie Johansson Lagt till avsnitt 2.1 ang. batchanvändare och e- postaviseringar 2013-08-28 David Andersson LADOK-17091: Förlängning av FOU-post och GBG-post 2014-02-21 PerLindgren https://jira.its.umu.se/browse/ladok-16214 för reserver på kurspaket ska tillhörande behörigheter läggas in 2014-02-21 PerLindgren https://jira.its.umu.se/browse/ladok-3277 Permanent och tidsbegränsat uppehållstillstånd tillkommer och det enda som får läggas till för dessa är medborgarskap 2014-06-21 Thom Jönsson https://jira.its.umu.se/browse/ladok-18346 2015-09-16 Anna-Carin Wiklund Kontrollen av start- och slutvecka i Fap- och Kurposter sätter nu båda veckorna blanka om de inte redan är blanka eller består av 6 siffror. https://jira.its.umu.se/browse/ladok-11775 Ändrat hanteringen av Kur- och Fap-poster som hamnade på fellista pga att start/slutvecka inte låg inom startterminens intervall. Nu ändras istället start/slutvecka så de ligger inom startterminens intervall. Inget ut på fellista. 2015-09-29 Anna-Carin https://jira.its.umu.se/browse/ladok-18830
Per Lindgren, Bengt Reinholdsson 2016-05-26 4 (215) Wiklund Fanns inget gällande tabellen KTILLBEV i specen, lagt till det som borde legat här samt den nya kontrollen som gör att ingen ny post skapas i KTILLBEV om det redan finns en. 2015-08-28 PerLindgren Återbud från Nya. Kapitel Uppdatering ATEpost återbud https://jira.its.umu.se/browse/ladok-19164 2015-11-11 PerLindgren Nya skickar antagning där antagning redan finns. Kapitel URV-post uppdaterar LANTKURS och kapitel URV-post uppdaterar LOKANTLB Felmed URV-POST programantagning NR 14, 32 tom 37 Felmed URV-POST kurs o kurspaket nr 30 tom 32 2016-01-20 Anna-Carin Wiklund https://jira.its.umu.se/browse/ladok-20335 Om felaktiga poster finns i NyA filen ska inte FAP-poster (KTFORT2) uppdateras om det finns ett fel i motsvarande KUR-post (KTILL2). 2016-03-24 PerLindgren https://jira.its.umu.se/browse/ladok-20559 Skrivning till tabellen SB02LIST Nytt formulär SB02A04G Söka och visa listor https://jira.its.umu.se/browse/ladok-20561 mail inriktning https://jira.its.umu.se/browse/ladok-20565 ändringar I mail 2016-04-27 PerLindgren https://jira.its.umu.se/browse/ladok-20633 veckokontroll 2016-05-11 PerLindgren https://jira.its.umu.se/browse/ladok-20421 avgiftslistan 2016-05-26 PerLindgren https://jira.its.umu.se/browse/ladok-20409 VALDINR. Även återställt kod som tagits bort av misstag. 2016-06-08 PerLindgren https://jira.its.umu.se/browse/ladok-20637
Per Lindgren, Bengt Reinholdsson 2016-05-26 5 (215) Ta emot permanenta och tidsbegränsade UT Sidorna 78-84 2016-09-14 David Andersson https://jira.its.umu.se/browse/ladok-20748 Borttagning av poster I VALDKURS har lagts till för återbud på program 2016-09-15 David Andersson https://jira.its.umu.se/browse/ladok-20750 Termin har lagts till i kontrollen av INREGFFG vid avbrott på kurs/kurspaket
Per Lindgren, Bengt Reinholdsson 2016-05-26 6 (215) Innehållsförteckning 1 INLEDNING... 8 1.1 SYFTE... 8 1.2 BESKRIVNING... 8 1.2.1 Händelseflöden... 9 1.3 BEHÖRIGHET/PREFSTYRNINGAR... 10 1.3.1 Behörighet... 10 1.3.2 Preferensstyrningar... 10 1.4 ICKE FUNKTIONELLA KRAV... 10 1.5 FÖRKLARINGAR... 10 1.5.1 Förklaringar av terminologi... 10 1.6 REFERENSER... 10 2 NOUVEAUFUNKTIONER FÖR HÄMTA URVALSRESULTAT... 11 2.1 BATCHANVÄNDARE OCH E-POSTAVISERINGAR... 11 2.2 SB02 NOUVEAU: STATUSFORMULÄR ÖVER GJORDA HÄMTNINGAR I... 12 2.2.1 Villkorsbild SB02A00G... 12 2.3 VILLKORSBILD SB02A0XG... 16 2.3.1 Terminsregistrering... 17 2.3.2 Välj lagring av... 18 2.3.3 Uppdatering... 20 2.4 FORMULÄR LISTOR SB02A04G... 21 2.4.1 Tabbordning... 23 2.5 MEDDELANDEN... 23 3 AUTOMATISK INHÄMTNING AV URVALSRESULTAT... 24 3.1 HÄNDELSEFLÖDEN... 24 3.2 VAD ÄR ETT FEED-FLÖDE?... 24 3.3 BESKRIVNING AV FEED... 26 4 SB02 - JAVABATCHEN... 29 4.1 HÄNDELSEFLÖDEN... 29 4.2 PREFERENSSTYRNINGAR... 30 4.3 ÖVERFÖRINGSFIL... 30 4.4 DATUM OCH TERMINSHANTERING... 30 4.5 VALIDERING AV KATALOGDATA... 30 4.6 KATALOGUPPDATERING... 31 4.7 URVALSRESULTAT... 47 4.7.1 Händelseflöde för personposter... 47 4.7.2 Grundkontroller... 48 4.7.3 Personkontroller... 52 4.7.4 Kursantagning(typ av sökalt = 1 i urvalsposten)... 53 4.7.5 Programantagning(typ av sökalt = 2 i urvalsposten)... 59 4.7.6 Antagning till kurspaket(typ av sökalt = 3 i urvalsposten)... 67 4.7.7 Uppdatering av personposter... 74 4.7.8 Uppdatering Avgift poster... 78
Per Lindgren, Bengt Reinholdsson 2016-05-26 7 (215) 4.7.9 Uppdatering behörigheter... 85 4.7.10 Uppdatering URV post... 88 4.7.11 Uppdatering ATE-post återbud... 135 4.7.12 Uppdatera SKY post... 141 4.8 LISTOR... 154 4.8.1 Skrivning till tabellen SB02LIST... 154 4.9 AVSLUTAD KÖRNING... 189 5 KONTROLLER/UTSÖKNINGAR...190 5.1 DAG/TERMIN/VECKOKONTROLLER... 190 5.2 PROGRAMKOPPLING... 191 5.3 SÖK TERMIN I ORDNING (TERMORDNKONTROLL)... 196 5.4 STANDARDTERMIN... 199 5.5 INNEVARANDE-TERMIN +2... 202 5.6 KONTROLL OM BEHÖRIGHET REDAN FIN... 205 6 KRAVFÖRTECKNING...207
Per Lindgren, Bengt Reinholdsson 2016-05-26 8 (215) 1 Inledning 1.1 Syfte Det här är en omskriven kravspecifikation för SB02. Den gamla hade inte uppdaterats fortlöpande i takt med införda ändringar och var alltså inte att lita på i alla lägen. 1.2 Beskrivning SB02 används för att hämta urvalsresultat från Nya. I och med att hanteringen av hämtning av urvalsresultat ändrats i september 2013 genom projekten VEP136/STU T2102, har delar av gamla SB02 också förändrats. Kortfattat gäller att dåvarande AF54 försvann på NyA:s sida och ersättas av AF150. NyA publicerar allt katalogdata och urvalsresultat på en sk feedserver. De kommer inte ha kontroll om det publicerade data är hämtat eller om det uppstått fel på Ladoksidan. Det som händer på Ladoksidan är att vi har en Feedläsare som ligger och läser NyA:s feedserver med jämna mellanrum för att se om något nytt publiceras från NyA. Finns nytt data hämtar feedläsaren hem det nya data och skapar en sk infil samt en metadata fil som innehåller uppgifter om sista hämtningen. Därefter skapar feedläsaren en SB02 beställning i BATCHJOB och BATVILL med uppgifter som finns i SYSTPREF. SB02 startar som vanligt med skillnad att SB02 hämtar infilen från en lokal plats på Ladok server samt att ingen returfil skapas. Så fungerar SB02 SB02 lägger in urvalsdata i den egna databasen från en fil som skapats efter att feedläsaren hämtat hem det publicerade posterna som skapat en urvalsfil. Alla nödvändiga katalogdata bör finnas på plats innan batchen kan köras. Personuppgifter, dvs. namn, adress, telefon och e- postadress samt uppgift om grundläggande behörighet läggs in med urvalsdata. Under Villkor specificeras hur e-post-, telefon- och adressuppgifter skall läggas in. SB02 gör först de sk Grundkontrollerna vilka är: 1) Att posternas antagningstermin finns definierad i databasen och stämmer med beställningen. 2) Att alla anmälningsalternativ finns definierade. 3) Att urvalsgrupper och förutbildningskoder finns definierade. I villkorsformuläret anger man om SB02 skall lägga in urvalsdata även om fel hittas i grundkontrollerna. Om inga fel hittas, eller om man angivit att batchen skall fortsätta trots fel i grundkontrollerna, görs därefter kontroller och inläggning av de sökande och deras urvalsresultat.
Per Lindgren, Bengt Reinholdsson 2016-05-26 9 (215) En sökande stoppas om denne är markerad som avliden eller finns individuellt gallrad. Om den sökande redan har påbörjat studier/är registrerad på det program antagningen eller reservplatsen avser stoppas urvalsposten. Stoppade sökande och stoppade urvalsposter skrivs ut på fellista. 1.2.1 Händelseflöden Kontrollera om nya feeds för aktuell hsk och sedan förra kontrollen Vänta X sekunder Urvalsuppgifter som inte publicerats till Ladok Uppgifter Feed server Nytt? N J Hämta feed för visst hsk & lägg på lokal area Konvertera feeddatat till en batchfil beställer en SB02-körning Listor SB02 körs Ladok db NyA Ladok
Per Lindgren, Bengt Reinholdsson 2016-05-26 10 (215) 1.3 Behörighet/prefstyrningar 1.3.1 Behörighet 1.3.2 Preferensstyrningar Funk Nr Vad vill man styra Nyckelord Värde: Resultat Default Typ SB02 Hur långt in i framtiden en tidsbegränsad adress får gälla TIDSBEGR X: Antal månader Oändligt S Figur 1 Behörighet/prefstyrning (Tabell) 1) Typ betyder: S: SYSTPREF, A: ANVPREF, P: PERSPREF 1.4 Icke funktionella krav 1.5 Förklaringar Ord 1.5.1 Förklaringar av terminologi Feedläsare Feedserver Förklaring RSS-läsare, eller flödesläsare, är en vanlig benämning på den programvara eller webbaserad tjänst som används för att ta del av RSS-flöden. Med avsikt på den bakomliggande tekniken benämns de även för nyhetsaggregatorer - engelskans motsvarigheter är feed readers eller aggregators. kontrollerar automatiskt de RSSflöden man prenumererar på och presenterar nya inlägg på ett överskådligt sätt. Användaren behöver således inte aktivt söka upp webbsidor denne finner intressanta för att uppdatera sig om något har hänt. Flera webbläsare har också inbyggda RSS-läsare. Server som används för att publicera RSS-flöden. 1.6 Referenser
Per Lindgren, Bengt Reinholdsson 2016-05-26 11 (215) 2 Nouveaufunktioner för hämta urvalsresultat I och med att hanteringen av hämtning av urvalsresultat ändrats i september 2013 genom projekten VEP136/STU T2102, har delar av gamla SB02 också förändrats. Detta har inneburit att funktionerna i Nouveau har ändrats för att den nya hanteringen ska fungera. En användare kan inte längre göra en beställning av SB02 utan det görs utan det görs genom ett batchjobb som går kontinuerligt. En användare kan dock köra om avbruten körning. Följande förändringar har gjorts: Se och ändra körda batchkörningar i SB02 o Det gamla beställningsformuläret ersätts med nytt statusformulär över gjorda hämtningar från Nya o Formuläret ska vara möjligt att ändra avbrutna körningar samt stryka körningar oavsett körstatus o Hämta filer Lägga upp villkor för körningen o Nytt formulär skapas o Feedläsaren måste gå att starta och stoppa o Lägga in styrparametrar till batchen används systempreferenser o Anropas via SB02 2.1 Batchanvändare och e-postaviseringar Det kontinuerliga batchjobbet kräver att en utpekad Nouveau-användare finns upplagd i batchproperties som er driftcentral ställer in. Rekommendationen är att skapa en specifik Nouveauanvändare som agerar automatisk beställare för SB02-batcharna och som får e- postmeddelanden om avbrutna batch-körningar. E-postmeddelandena sänds till den adress som finns i tabellen ANVIP för den användare som driftcentralen har lagt in i batch-properties. Vi rekommenderar också att en grupp-brevlåda knyts till den Nouveau-användaren som är inlagd i batch-properties, så att de mailaviseringar som kommer om avbrutna körningar inte är bundet till en specifik person på lärosätet. Detta för att flera personer då kan uppmärksamma eventuella fel och avbrott och för att undvika personberoende. Körningar som går igenom genererar inga e-postmeddelanden.
Per Lindgren, Bengt Reinholdsson 2016-05-26 12 (215) 2.2 SB02 Nouveau: Statusformulär över gjorda hämtningar i 2.2.1 Villkorsbild SB02A00G Formuläret ska visa vilka hämtningar som är gjorda, status, filer. Det som ska gå att göra är: Visa beställda hämtningar Visa/ändra status på resultat på hämtningen Visa gjorda beställningsvillkor Hämta hem fellistor och andra filer Visa listor på ett samlat sätt Uppdatera ändringar av status
Per Lindgren, Bengt Reinholdsson 2016-05-26 13 (215) R1. Välj beställning Markering av rad ska göras enligt standard Antalet rader finns ingen begränsning Ska utformas som en datagrid R2. Beteckning Typ: Inmatningsfält Ledtext: Format: Defaultvärde F1-hjälp: Beteckning Visningsfält, ska rymma 20 tkn. Fältet ska gå att klicka på Feedläsaren skapar en körningsid som bara visas. Beteckning på beställningen. R3. Datum Typ: Inmatningsfält Ledtext: Format: Defaultvärde Kommentar F1-hjälp: Datum Visningsfält, ska rymma 12 tkn. Fältet ska gå att klicka på Feedläsaren skapar en körningstid som bara visas. Datum enligt standard, åååå-mm-dd Körningsdatum. R4. Tid Typ: Inmatningsfält Ledtext: Format: Defaultvärde Kommentar F1-hjälp: Körtid Visningsfält, ska rymma 6 tkn. Fältet ska gå att klicka på Feedläsaren skapar en körningsid som bara visas. Tid enligt standard, TT:MM Körtid.
Per Lindgren, Bengt Reinholdsson 2016-05-26 14 (215) R5. Status Typ: Dropdown Ledtext: Format: Körstatus Dropdown Default-värde Värdet Alla värden i ordning Kommentar F1-hjälp: 1. Ej körd Endast ändringsbar vid status AVBROTT Ändra körstatus efter att rättning av fel. Om körning resulterar i AVBROTT, måste användaren rätta upp felen och därefter ändra körstatus till Ej körd. Följande ska hända vid ändring: o ändra status till ej körd i dropbox Datum sätts till aktuellt datum Tiden sätts till nu Ändring dimmar upp Uppdatera knappen o Villkor Batchvillkoren uppdateras med poster från SYSTPREF och rutin SB02FD med undantag för filnamn Saknas villkoren i SYSTPREF ska ett felmeddelande visas som berättar att villkor för hämtning saknas och ändring av status avbryt. Ingen ny hämtning sker förrän avbruten post satts om till Ej körd
Per Lindgren, Bengt Reinholdsson 2016-05-26 15 (215) R6. Knapp Stryk Typ: Knapp Default-värde Alltid tillgänglig Kommentar Ska ta bort aktuell beställning oavsett status, 2.3.?.1 Aktivering av knapp dimma upp Uppdatera knappen F1-hjälp: Visa villkor för batch. Det ska vara möjligt att stryka poster som ej är klara. Detta kräver dock: Infil och metadata fil måste tas bort. De ligger under inkatalogen, se propertyfilen. Ompublicerng krävs från NyA sidan från visst datum. R7. Knapp Villkor Typ: Knapp Default-värde Alltid valbar för alla körningar Kommentar Ska anropa samma formulär som i kap 2.2 F1-hjälp: Visa villkor för batch. R8. Knapp Hämta fil Typ: Knapp Default-värde Kommentar F1-hjälp: Tillgänglig om status inte är ej körd Ska fungera på samma sätt som motsvarande knapp i GB01A00G och anropa samma formulär Kopiera resultatfiler efter en batchkörning. R9. Knapp Listor Typ: Knapp Default-värde Kommentar F1-hjälp: Tillgänglig Leder till formuläret SB02A04G Sök ut och visa listor
Per Lindgren, Bengt Reinholdsson 2016-05-26 16 (215) R10. Knapp Uppdatera Typ: Knapp Default-värde F1-hjälp: Endast valbar när avbruten körning ändrats eller någon/ra köringar strukits Uppdatera status för hämtning av urvalsresultat. 2.3 Villkorsbild SB02A0xG R11. Automatisk hämtning av urvalresultat Genom att markera detta alternativ startar man hämtning av. Det som händer vid markering av checkboxen, är att en s k feedläsare börjar söka nya publiceringar för ett specifik lärosäte av katalogdata samt urvalsresultat på en specifik NyA server. Feedläsaren kontrollerar NyAs server med förutbestämt intervall om det finna nya publiceringar. Finns det nya händelser så hämtar feedläsaren hem resultatet och skapar en lokal fil som SB02 kan sedan läsa in. När filen är skapad så beställer feedläsaren en SB02 körning i BATCHJOB och batchvillkor från SYSTPREF Typ: Ledtext: Format: Checkbox Automatisk hämtning av urvalsresultat Checkbox
Per Lindgren, Bengt Reinholdsson 2016-05-26 17 (215) Default-värde Aktion F1-hjälp: Markerad. Alltid valbar Om checkboxen markeras ska automatisk hämtning av göras via feed läsaren. Övriga fält ska vara valbara Motsatsen gäller också. Om checkboxen avmarkeras så dimmas alla andra fält. Feedläsaren slutar hämta resultat Markera om du vill starta automatisk hämtning av urvalsresultat. 2.3.1 Terminsregistrering R12. Ska finnas möjligt att välja var antagningsuppgifterna ska läggas för terminsregistrering För kurser inom program med terminsregistrering finns det möjligt att välja var antagningsuppgifterna ska läggas (VALDKURS är default eller LANTKURS). Det finns också möjlighet att välja att få en kommentar skriven på listan. OBS! Endast tillgänglig om det finns post i tabellen LINJE där LINJEREG=J. Uppdatering kommer att ske i batchen enligt nedan schema. Styra inläggningen=kryssad checkbox. Om beställaren inte vill styra inläggningen o Inläggning i VALDKURS utifrån programplanen(progplk). Saknas programplan för aktuell kurs blir det ingen inläggning. Om beställaren vill styra inläggningen till VALDKURS o Inläggning i VALDKURS utan hjälp av programplanen Om beställaren vill styra inläggningen till LANTKURS o Inläggning i LANTKURS R13. Checkbox som styr terminsregrutan Typ: Checkbox Ledtext: Format: Default-värde Aktion Vid kursantagning lägg alltid antagningsuppgifter i: checkbox Öppen och omarkerad om post finns där LINJEREG.LINJE=J Annars är den dimmad Om checkboxen markeras ska radiogruppen för VALDKURS/LANTKURS och checkboxen för skriv kommentar öppnas.
Per Lindgren, Bengt Reinholdsson 2016-05-26 18 (215) Motsatsen gäller också. Om checkboxen avmarkeras så dimmas radiogruppen och checkbox skriv kommentar F1-hjälp: Markera om du vill välja vilken tabell där resultat vid kursantagning i samband med terminsregistering ska läggas in. R14. Radiogrupp VALDKURS/LANTKURS Typ: Radiogrupp Ledtext: Format: Defaultvärde F1-hjälp: Radiogrupp med två knappar: VALDKURS LANTKURS Dimmad VALDKURS markerad Markera vilken tabell som ska användas för inläggning av antagningsuppgifter. R15. Checkbox skriv kommentar Typ: Checkbox Ledtext: Format: Default-värde F1-hjälp: Skriv kommentar checkbox Dimmad och omarkerad. Markera om du vill ha en kommentar på listan när resultat vid kursantagning inom program med terminsregistrering läggs in 2.3.2 Välj lagring av R16. Det ska gå att bestämma på vilket sätt adresser, telefon och epost ska lagras vid inläggning. Alternativ 2 ska jämföras mot dagensdatum R17. Dropdown för folkbokföringsadress Typ: Dropdown Ledtext: Format: Folkbokföringsadress Dropdown
Per Lindgren, Bengt Reinholdsson 2016-05-26 19 (215) Default-värde Alla värden i ordning F1-hjälp: Värdet Inte alls 1. Lagra om ingen folkbokföringsadress finns i Ladokregistret 2. Ersätt befintliga data om nyare adress finns i VHS-filen 3. Lägg till/ersätt befintliga data oavsett datum 4. Inte alls Välj hur du vill lagra folkbokföringsadress. R18. Dropdown för tidsbegränsad adress Typ: Dropdown Ledtext: Format: Default-värde Alla värden i ordning F1-hjälp: Tidsbegränsad adress Dropdown Värdet Inte alls 1. Lagra om ingen tillfällig adress finns i Ladokregistret 2. Ersätt befintliga data om nyare adress finns i VHS-filen 3. Lägg till/ersätt befintliga data oavsett datum 4. Inte alls Välj hur du vill lagra tidsbegränsad adress. R19. Dropdown för telefonnummer Typ: Dropdown Ledtext: Format: Default-värde Alla värden i ordning F1-hjälp: Telefonnummer Dropdown Värdet Inte alls 1. Lagra om inga telefonnummer finns i Ladokregistret 2. Ersätt befintliga data om nyare telefonnummer finns i VHS-filen 3. Lägg till/ersätt befintliga data oavsett datum 4. Inte alls Välj hur du vill lagra telefonnummer.
Per Lindgren, Bengt Reinholdsson 2016-05-26 20 (215) R20. Dropdown för e-post Typ: Dropdown Ledtext: Format: Default-värde Alla värden i ordning F1-hjälp: E-post Dropdown Värdet Inte alls 1. Lagra om ingen e-post finns i Ladokregistret 2. Ersätt befintliga data om nyare e-post finns i VHS-filen 3. Lägg till/ersätt befintliga data oavsett datum 4. Inte alls Välj hur du vill lagra e-post. 2.3.3 Uppdatering R21. Knapp Uppdatera, Ska gå att spara villkor i SYSTPREF Typ: Knapp Default-värde Tillgänglig i alla lägen Kommentar Se 2.1.7 F1-hjälp: Uppdatera villkor för hämtning av urvalsresultat.
Per Lindgren, Bengt Reinholdsson 2016-05-26 21 (215) 2.4 Formulär Listor SB02A04G Sökning sker mha angivna parametrar i tabellen SB02LIST. Kolumn Pos Ny Beskrivning Domän LISTTYP 1 Listtyp A/B/C/D/E/F 2) DATUM 10 * Datum ÅÅÅÅ-MM-DD TID 6 * Klockslag TTMMSS LOPNR 10 * Löpnummer 9999999999 1) 4) TEXT 250 Text 3) 1) A = Fellista, B = Statistiklista, C = Interimspersonnummer, D = Sekretesslista, E = Avgiftslista, F = Återbudslista Visning av uppgifterna i SB02LIST.TEXT sker i standard listvisning
Per Lindgren, Bengt Reinholdsson 2016-05-26 22 (215) R22. Tabellen SYSTPREF parametersätts enligt nedan tabell. Funk nr Vad vill man styra Nyckelord Värde Resultat Default Typ SB02 1 Starta och stoppa automatisk hämtning av urvalsresultat SB02FD 1 SB02FD 2 Inläggning av folkbokföringsadres s Inläggning av tidsbegränsad adress FEED_READ_ ENABLED FADRESS= TADRESS J = Feedläsaren läser in poster N = Feedläsaren läser inte in poster 1=Lagra om ingen folkbokföringsadress finns i Ladokregistret, 2=Ersätt befintliga data om nyare adress finns i VHSfilen, 3=Lägg till/ersätt befintliga 4=Inte alls 1=Lagra om ingen tillfällig adress finns i Ladokregistret 2=Ersätt befintliga data om nyare adress finns i VHS-filen 3=Lägg till/ersätt befintliga data oavsett datum 4=Inte alls SB02FD 3 Inl av telefonnummer TELEFON 1=Lagra om inga telefonnummer finns i Ladokregistret 2=Ersätt befintliga data om nyare telefonnummer finns i VHS-filen 3=Lägg till/ersätt befintliga data oavsett datum 4=Inte alls SB02FD 4 Inl av e-post EPOST 1=Lagra om ingen e- post finns i Ladokregistret 2=Ersätt befintliga data om nyare e-post J S 4 S 4 S 4 S 4 S
Per Lindgren, Bengt Reinholdsson 2016-05-26 23 (215) finns i VHS-filen 3=Lägg till/ersätt befintliga data oavsett datum 4=Inte alls SB02FD 5 Terminsregistrering TERMREG J/blank? S SB02FD 6 I vilken tabell ska antagningsresultat för kurs inom program med terminsreg läggas TABELL 1=VALDKURS, 2=LANTKURS S SB02FD 7 Ska en kommentar skrivas på listan för terminsreg när VILLNR 8 är satt till TERMREG= KOMMENTAR J/blank S 2.4.1 Tabbordning Automatisk hämtning Terminsregistrering Välj lagring av Uppdatera Vid bakåt tabbning gäller det omvända 2.5 Meddelanden
Per Lindgren, Bengt Reinholdsson 2016-05-26 24 (215) 3 Automatisk inhämtning av urvalsresultat 3.1 Händelseflöden Kontrollera om nya feeds för aktuell hsk och sedan förra kontrollen Vänta X sekunder Urvalsuppgifter som inte publicerats till Ladok Uppgifter Feed server Nytt? N J Hämta feed för visst hsk & lägg på lokal area Konvertera feeddatat till en batchfil beställer en SB02-körning 3.2 Vad är ett feed-flöde? Ett feed-flöde består av en mängd paket som kallas feeds. Dessa består i sin tur av ett antal poster som alla har en taggning. Taggningen innehåller vilket lärosäte posten tillhör, en beställningstermin, samt ett unikt ID-nummer per post. De äldsta publicerade uppgifterna ligger i den sista feedens sista post. Det nyaste ligger i första feedens första post. Alla poster och alla feeds har inbördes relationer till föregående och nästa post respektive feed.
Per Lindgren, Bengt Reinholdsson 2016-05-26 25 (215) Vad händer när vi läser en feed? Feed-läsning initieras varannan minut av batch-ramverket förutsatt att det inte finns någon avbruten eller ej körd batch-beställning för SB02. Första gången feed-läsaren frågar feed-servern efter poster för vårt lärosäte läses äldsta posten och dess termin upp. Sedan fortsätter läsningen av poster i kronologisk ordning tills en post med en annan termin hittas. Av de hittills upplästa posterna som har samma termin som den äldsta upplästa posten skapas en batch-fil till SB02. ID-numret för den nyaste posten som ingår i batch-filen lagras i tabellen IDLOGG. Batch-filen sparas i mappen incoming och namnges på formatet FEED_54_<ÅÅÅÅMMDD_ttmmss>_RESULT. Därefter läses villkor upp för automatiserade körningar ur tabellen SYSTPREF. Villkoren har lagts in med hjälp av SB02A02G i Nouveau. Feed-läsaren lägger in en beställning i tabellen BATCHJOB för SB02. Beställningens startdatum och starttid sätts så att batchen startar direkt. Villkor som baseras på information som lästs från SYSTPREF läggs in i BATVILL. Nästa gång feed-läsaren frågar feed-servern efter poster för vårt lärosäte hämtas poster som är publicerade senare än den post som har det ID-nummer som lagrades i IDLOGG. Sedan fortsätter läsningen på samma sätt som ovan, genom att plocka ut terminen för den äldsta av dessa poster och fortsätter läsa poster i kronologisk ordning så länge de har samma termin.
Per Lindgren, Bengt Reinholdsson 2016-05-26 26 (215) Varje gång en Feed-läsning har genomförts så söker batch-ramverket efter batch-beställningar. Om något nytt data hittades i feeden så har det lagts i en batch-fil och en SB02-beställning skapats, vilket innebär att batch-ramverket kommer att hitta en ej genomförd batch-beställning som den då startar. 3.3 Beskrivning av feed R23. Uppbyggnad av Feeds Ett feed-flöde består av en mängd paket som kallas feeds. Dessa består i sin tur av ett antal poster som alla har en taggning som säger:
Per Lindgren, Bengt Reinholdsson 2016-05-26 27 (215) vilket lärosäte och vilken termin som posten är kopplad till, samt ett unikt id för just den posten som består av 36 tecken. De äldsta publicerade uppgifterna ligger i den sista feedens sista post. Det färskaste ligger i första feedens första post. Alla poster och alla feeds har inbördes relationer genom getprevious och getnext. R24. Inställning för feedläsning ska finnas i properties fil Lägg in i ladok.batch.properties. 1. feed.sb02.url=http://<host:port>/<feedserver> 2. feed.sb02.user=<user> R25. Feedläsning ska ske med jämna intervall Feedläsning ska endast ske om: Det saknas poster i BATCHJOB för SB02 eller, Alla SB02 poster i BATCHJOB har status Klar. Feedläsning ska läsa med jämna intervaller t ex rekommenderat är läsning var 120e sekund av ett script. Inställningen ska finnas i ladok.batch.properties. Finns inget nytt på NyA:s feed server ska läsningen vänta i de sekunder som angetts i properties filen. Annars hämtas feeddata, se R27. R26. Villkor för automatiska körningar måste finnas i tabellen SYSTPREF Dessa villkor har lagts in via Nouveau, kapitel 2. Saknas dem ska det ej gå att starta feed läsningen. R27. Beställning av SB02 körning Beställning läggs in i tabellen BATCHJOB för SB02 med startdatum och starttid genast. Till detta BATCHJOB läggs även poster in i BATVILL som baseras på den information som lästs upp ur SYSTPREF. R28. Senaste hämtning ska sparas undan När batchbeställningen är gjord så sparar vi det nyaste idnumret från läsningen i tabellen IDLOGG. R29. Hämtning av poster Första gången feed-servern anropas för visst lärosäte och termin, ska allt data ur alla poster på flödet hämtas hem och sammanställas till en fil i mappen incoming.
Per Lindgren, Bengt Reinholdsson 2016-05-26 28 (215) Nästa gång feed-servern ropas, ska enbart poster hämtas sedan senaste förändringar har skett. dvs hämta hem poster som är nyare än posten med det senast kända idnumret och sammanställer dessa poster till en fil, lägger in beställning och sparar det nya idnumret. När scriptet har kört en feed-läsning så ska den fortsätta det på samma sätt som tidigare och söker efter batchbeställningar, och om det fanns något data i feeden så har vi vid det här laget summerat det till en fil och lagt in en SB02-beställning som således körs igång nu. R30. Skapa en lokal urvalsfil Filen namnges på formatet FEED_54_<ÅÅÅÅMMDD_ttmmss>_RESULT. Filen ska se ut enligt tidigare filbeskrivning För att kunna ta del av posttyperna ska man ha tillgång till NyAs dokument i clearcase. Posttyperna finns i dokumentet AF150 överföringsformat.xls.
Per Lindgren, Bengt Reinholdsson 2016-05-26 29 (215) 4 SB02 - Javabatchen 4.1 Händelseflöden (4.3) Urvalsfilen läses in. Vid inläsningsproblem avbryts körningen inläsningsproblem (4.5) Kataloguppdatering. OBS! Uppdatering sker av alla korrekta poster. Se resp posttyp om avbrott ska göras vid fel. (4.7.2) Grundkontroller. Fel? (4.7.3) Kontroller och uppdatering av persontabeller (4.8) Listor skapas (4.9) Efter avslutad körning rensas filer Avbryt körning
Per Lindgren, Bengt Reinholdsson 2016-05-26 30 (215) 4.2 Preferensstyrningar R31. Systempreferens för tidsbegränsad adress Det finns en möjlighet att begränsa tomdatum i den tidsbegränsade adressen. Finns denna sysemtpreferens ska vid inläggning av tidsbegränsad adress hänsyn tas till det värde (antal månader) som finns angivet här. Om tomdatum.tidsbadress > körningsdatum + x.antal.månader så sätts ADRESS.TOMDAT till körningsdatum+x.antal.månader Funk Nr Vad vill man styra Nyckelord Värde: Resultat Default Typ SB02 4 Hur långt in i framtiden en tidsbegränsad adress får gälla TIDSBEGR X: Antal månader Oändligt S 4.3 Överföringsfil R32. Posttyper i överföringsfil ska följa dokument för AF150 Se Skapa en lokal urvalsfil R33. Kontroller av överföringsfil innan uppdateringar startar Urvalsfilen läses in från lokal server. Om det inte går att läsa filen vi får ett IOException skrivs meddelandet: Kunde inte öppna resultatfilen till log-filen och till ett mail som senare skickas till beställaren. Batchen avbryts sedan. Om något annat oförväntat fel inträffar ett Unchecked Exception skrivs meddelandet: Hittade fel under parsningen av urvalsfilen till log-filen och till ett mail som senare skickas till beställaren. 4.4 Datum och terminshantering R34. Jämförelsedatum sätts till dagensdatum-1 Vid inläggning av adress och telekom poster där användaren valt alternativ 2 dropboxarna villkorsformuläret används en standard datum som är bestämt till dagensdatum-1 R35. Beställningstermin Tidigare angav användaren en beställningstermin. Denna termin har utgått och ersatts av att NyA skickar med vilken termin som posterna avser. 4.5 Validering av katalogdata Katalogdata valideras enligt nedan typer. R36. Allvarliga fel, fatal
Per Lindgren, Bengt Reinholdsson 2016-05-26 31 (215) Den allvarliga typen leder till att batchen avbryts, vilket sker efter all katalogdata validerats och inte mitt i någon validering. Ingen inläggning/uppdatering av aktuell post. Korrekta poster läggs in i databasen. R37. Medelallvarliga fel, error Den medelallvarliga typen leder till att vidare behandling av aktuell post avbryts. Ingen inläggning/uppdatering av aktuell post. R38. Varning, eventuellt är det fel, warning Den mindre allvarliga där man inte är säker på om det finns ett fel, men där man ha misstämmelser mellan NyA och Ladok, resulterar i en varning som skrivs ut på fellistan men aktuell post behandlas i övrigt som om den vore felfri. Inläggning/uppdatering görs. Eventuella otillåtna tecken (enligt RB03_kravspec.docx) byts ut mot blanksteg och en varning skrivs ut på fellistan. R39. Information, Info Informationsmeddelanden, datat är korrekt men ett infomeddelande anses nödvändigt. Inläggning/uppdatering görs. R40. Korrekt För korrekt data görs inl/uppd utan några andra åtgärder. 4.6 Kataloguppdatering 1. Katalogposterna ligger först i Urvalsfilen. 2. KUR-poster ligger före FAP-poster och KUP-poster ligger före IKP-poster för att underlätta hanteringen. 3. Inläggning av samma katalogdata ska kunna ske flera gånger om inläggningen av urvalsdata inte fungerar som avsett, så att filen måste köras igen. 4. Om aktuell post redan finns med samtliga data identiska ska ingen inläggning ske. Om aktuell post redan finns, men med icke identiska data, ska posten uppdateras med nya data. I övriga fall ska en ny post skapas. 5. Varje post ska räknas som en egen transaktion. För inlagda korrekta poster ska ingen roll-back ske. 6. Poster med förutbildningar (FOU), urvalsgrupper (URG), ingående kurstillfällen i kurspaket (IKP) och meddelanden (MED) görs bara inlägg, aldrig någon uppdatering av eventuella förändrade kolumner.
Per Lindgren, Bengt Reinholdsson 2016-05-26 32 (215) R41. KUR-post uppdaterar KTILL2 För fullständig layout vid utskrift av felaktigheter se kapitlet Fellista KUR-post KTILL2 Kontroll Avbryter körning om fel Fellista Kurskod KURSKOD Ska finnas i KURS Ja Kurskod+KURposten Starttermin STARTTER Ska finnas i TERMIN Ja Starttermin+KURposten Kurstakt KURSTAKT Ska finnas i KURSTAKT. Obs andra takter än 100 ska skrivas in som tex blank50. 50 Kurstid KURSTID Ska finnas i KURSTID Undervisningsform UNDFORM Ska finnas i UNDFORM Ja Ja Ja Kurstakt+KURposten Kurstid+KURposten Undform+KURposten Kursort ORT Ska finnas i ORT Ja Ort+KURposten Kursomgång KURSOMG Finansieringsform KURSTYP Om blank lägg in blank- underscore Poängbidrag starttermin FFGPOANG Annars Ska den finnas i ETYPBEN Lagras vänsterjusterat med decimalpunkten angiven Om ny post och blank eller ickenumeriskt värde i filen, sätt värdet till null. Anmälningskod KOD Om en post motsvarande typen Ja Nej Nej Kurstyp+KURposten Anmkod +KUR-post
Per Lindgren, Bengt Reinholdsson 2016-05-26 33 (215) KUR redan finns i databasen(alla nycklar) och fälten Anmälningskod eller Poängbidrag starttermin i KURposten skiljer sig från databasposten Startvecka STARTV Veckokontroll Nej Slutvecka SLUTV Veckokontroll Nej Planeringstal PLANTAL Om ny post och blank eller Antagningstal, ANTALORD ickenumeriskt ordinarie urval värde i filen, sätt ANTALRES värdet till null. Antagningstal reservurval Uppgiften saknas från NyA VALUTA KONVERT AVGFRI Om post redan finns och planeringstalen skiljer sig ska uppdatering ske med värdena i nyafilen H Blankt om ny post Om helt ny post ska N läggas in. Om det redan finns en post så rör vi inte värdet som finns. Inte heller om det är en post som redan finns men med icke identiska data. Nej Nej
Per Lindgren, Bengt Reinholdsson 2016-05-26 34 (215) R42. FAP-post uppdaterar KTFORT2 För fullständig layout vid utskrift av felaktigheter se kapitlet Fellista FAP-post KTFORT2 Kontroll Avbryter körning om fel Fellista Kurskod KURSKOD Starttermin STARTTER Ska finnas i KTILL2 med Starttermin o Anmälningskod Ja Starttermin + anmälningskod + FAP-posten KURSTAKT Se STARTTER Ja Se STARTTER KURSTID Se STARTTER Ja Se STARTTER UNDFORM Se STARTTER Ja Se STARTTER ORT Se STARTTER Ja Se STARTTER KURSOMG Se STARTTER Ja Se STARTTER KURSTYP Se STARTTER Ja Se STARTTER Termin i ordning TERMORDN Fel om blank eller < 2 Poäng aktuell termin FORPOANG Lagras vänsterjusterat med decimaltecken och decimal i filen Ja Termin i ordning + FAP-posten Anmälningskod KOD 1. Ska finnas i KTILL2 med Starttermin o Anmälningskod Ja Se STARTTER 2. Om en post motsvarande typen FAP redan finns i databasen (alla nycklar) och Anmälningskod eller Poängbidrag aktuell termin i KUR-posten skiljer sig från databasposten Nej. Ingen uppdatering i detta fall Anmkod +FAPposten Kalendertermin TERMIN Ska finnas i TERMIN Ja Kalendertermin + FAP-posten Startvecka STARTV Veckokontroll Nej
Per Lindgren, Bengt Reinholdsson 2016-05-26 35 (215) Slutvecka SLUTV Veckokontroll Nej DEP1 DEP2 LOK1 LOK2 Sätts till null om posten inte är inlagd tidigare, annars sparas det gamla värdet VALUTA H KONVERT Blankt om ny post.
Per Lindgren, Bengt Reinholdsson 2016-05-26 36 (215) R43. KUP-post uppdaterar PAKETDEF För fullständig layout vid utskrift av felaktigheter se kapitlet Fellista KUP-post PAKETDEF Kontroll Avbryter körning om fel Fellista Anmälningskod ANMPAKET Om en post motsvarande typen KUP redan finns i databasen (alla nycklar) och Benämning anmälningsalternativ, Engelsk benämning anm alternativ eller Totalpoäng i KUPposten skiljer sig från databasposten Nej. Ingen uppdatering i detta fall Anmkod + KUPposten Starttermin STARTTER Ska finnas i TERMIN Ja Starttermin+KUPposten Benämning anmälningsalternativ Engelsk benämning för anmalt BENAMNS BENAMNE Totalpoäng TOTPOANG 1. Lagras Planeringstal Antagningstal ordinarie urval Antagningstal reservurval PLANTAL ANTALORD ANTALRES VALUTA KONVERT vänsterjusterat med decimaltecken och decimal 2. Om ny post och blank eller ickenumeriskt värde i filen, sätt värdet till null i tabellen. 3. Om post redan finns och planeringstalen skiljer sig ska uppdatering ske med värdena i NyAfilen. H Blankt om ny post.
Per Lindgren, Bengt Reinholdsson 2016-05-26 37 (215) R44. IKP-post uppdaterar NYAPAKET Endast inläggning av NYAPAKET. Inga ändringar görs. För fullständig layout vid utskrift av felaktigheter se kapitlet Fellista IKP-post NYAPAKET Kontroll Avbryter körning om fel Anmälningskod ANMPAKET Ska finnas i PAKETDEF på aktuell termin Om en post motsvarande typen IKP redan finns i databasen (alla nycklar) och Starttermin (ingående anm kod) i IKP-posten skiljer sig från databasposten Nej Nej. Fellista Anm.kod + IKP-post Om post redan finns med annan STARTANM Nej Anmkod + IKP-posten Starttermin STARTTER Ska finnas i TERMIN Ja Starttermin + IKPposten Anmälningskod(för ingående ktill) ANMKOD Ska finnas i KTILL2 Ja Anmkod + IKP-posten Starttermin(för ingående ktill) STARTANM Ska finnas i KTILL2 Ska finnas i TERMIN Ja Ja Anmkod+IKP-posten Starttermin + IKPposten
Per Lindgren, Bengt Reinholdsson 2016-05-26 38 (215) R45. FOU-post uppdaterar FORUTB Endast inläggning av FORUTB. Inga ändringar görs. FOU-post FORUTB Kontroll Avbryter körning om fel Fellista Förutbildningskod KOD Finns post redan ska inlägg inte göras Nej Benämning BENAMN Antal årskurser i utbildningen ARSKURS BEHNIVA STATKOD Sätts till blankt Betygstyp Ekvivalent kod BETYGTYP EKVKOD REGION Sätts till blankt
Per Lindgren, Bengt Reinholdsson 2016-05-26 39 (215) R46. PRO-post uppdaterar PTILL För fullständig layout vid utskrift av felaktigheter se kapitlet Fellista PRO-post PTILL Kontroll Avbryter körning om fel Fellista Anmälningskod ANMKOD Starttermin TERMIN Ska finnas i TERMIN Ja Termin + PRO-posten Programkod PROGR Ska finnas i LINJE Ja Program + PRO-posten Programinriktningskod PROGINR Ska finnas i LINJEINR Ja Program + inriktning + PRO-posten Om programinriktningskod = blank och INRKRAV.LINJE=J Nej Anmkod + PRO-posten Programort ORT Ska finnas i ORT Ja Programort + PROposten Programfart PROGTAKT Ska finnas i LINFART om <> 100 Ja Programfart + PROposten Undervisningsform UNDFORM Ska finnas i UNDFORM Ja Undervisningsform + PRO-posten Finansieringsform FINFORM Om blank sätt till blankunderscore Annars Ska finnas i ETYPBEN Ja Finansieringsform + PRO-posten Kurstid KURSTID Ska finnas i KURSTID Ja Kurstid + PRO-posten Planeringstal PLANTAL Om ny post och blank eller Nej
Per Lindgren, Bengt Reinholdsson 2016-05-26 40 (215) Antagningstal ordinarie urval Antagningstal reservurval ANTALORD ANTALRES ickenumeriskt värde i filen, sätt värdet till null. Om post redan finns och planeringstalen skiljer sig ska uppdatering ske med värdena i NyAfilen Uppgiften saknas från NyA AVGFRI Om helt ny post ska N läggas in. Om det redan finns en post så rör vi inte värdet som finns. Inte heller om det är en post som redan finns men med icke identiska data. Nej R47. URG-post uppdaterar URVGRUPP Endast inläggning av URVGRUPP. Inga ändringar. URG-post URVGRUPP Kontroll Avbryter körning om fel Fellista Urvalsgruppskod URVGRUPP Benämning BENAMN
Per Lindgren, Bengt Reinholdsson 2016-05-26 41 (215) R48. MED-post uppdaterar NYAMEDD MED-post NYAMEDD Kontroll Avbryter körning om fel Fellista Meddelandeid MEDDID TERMIN Termin tas från beställningsposten punkt 1 Meddelande MEDDTEXT Om en med-post redan är inlagd, men kommer med annan formulering så läggs nya formuleringen in. MEDDTYP Sätts till Ö
Per Lindgren, Bengt Reinholdsson 2016-05-26 42 (215) I samband med att meddelande för villkoret VI läggs in ska även MEDDTYP uppdateras. Läggs in i NYAMEDD så här: NYAMEDD Kontroll Avbryter körning om fel Fellista MEDDID Sätts till VI TERMIN Termin tas från beställningsposten punkt 1 MEDDTEXT MEDDTYP Tas från beställningsposten Om en vi-post redan är inlagd, men kommer med annan formulering så läggs nya formuleringen in. Sätts till V
Per Lindgren, Bengt Reinholdsson 2016-05-26 43 (215) R49. AME-post uppdaterar NYAMEDD AME-post NYAMEDD Kontroll Avbryter körning om fel Fellista Meddelandeid MEDDID TERMIN Termin tas från beställningsposten punkt 1 Meddelande MEDDTEXT Om en ame-post redan är inlagd, men kommer med annan formulering så läggs nya formuleringen in. MEDDTYP. Sätts till A
Per Lindgren, Bengt Reinholdsson 2016-05-26 44 (215) R50. SME-post uppdaterar NYAMEDD SME-post NYAMEDD Kontroll Avbryter körning om fel Fellista Meddelandeid MEDDID TERMIN Termin tas från beställningsposten punkt 2 Meddelande MEDDTEXT Om en NYAMEDD-post redan är inlagd, men det kommer en SME med annan formulering så läggs nya formuleringen in. MEDDTYP Sätts till S
Per Lindgren, Bengt Reinholdsson 2016-05-26 45 (215) R51. EXA-post uppdaterar NATEXAM o EXSUPPL I NATEXAM görs inläggning och eventuellt ändring. I EXSUPPL görs endast inläggning. Antalet skrivna poster ska med i statistiklistan. Förklaring till typ av fel/info se Validering av katalogdata Se även clearcase för AF54 överföringsformat för EXA-post. EXA-post NATEXAM Kontroll Typ av fel/info Nationell examenskod NATEXKOD 1. Om koden finns sedan tidigare ska koll om något ändrats göras. Se respektive kolumn 1. Fellista 1. Nej 2. Kolla om koden redan finns i EXSUPPL. 2. Error 2. Skriv: Kod menad för tabellen NATEXAM finns redan i EXSUPPL+EXAposten Kod för examenstyp EXTYP 1. Kolla i tab EXTYP att examenstypen existerar. 1. Warning 1. Skriv: Examenstyp saknas i Ladok + EXA-posten Antal HP för examen 2. Om EXTYP är ändrad ska uppdatering göras POANG 1. Korrekt är om det saknas poäng eller så ska det vara numeriskt. 2. Info 1. Error 2. Skriv: Examenstyp ändrad + EXAposten 1. Skriv: Felaktigt värde i poäng + EXA-posten 2. Om poäng är ändrad ska uppdatering göras Benämning BENAMNS Om benämningen är ändrad ska uppdatering göras 2. Info Info 2. Skriv: Poäng ändrad + EXAposten Skriv: Benämning ändrad + EXA-posten Typ av nationell examen 1. Behandla bara de som är = N i EXA-posten. 2. Om annat värde än N/S se fellista. 1. 2. Error 1. Nej 2. Skriv Felaktigt värde i typ av nationell examen + EXA-posten
Per Lindgren, Bengt Reinholdsson 2016-05-26 46 (215) EXA-post EXSUPPL Kontroll Typ av fel/info Fellista Nationell examenskod SUPPLKOD 1. Om koden finns sedan tidigare behöver ingenting göras. Vi gör enbart nyinläggning 1. 1. Nej Benämning BENAMNS 2. Kolla om koden redan finns i NATEXAM. 2. Error 2. Skriv: Kod menad för tabellen EXSUPPL finns redan i NATEXAM+EXA-posten Typ av nationell examen 1. Behandla bara de som är = S i EXAposten. 2. Om annat värde än N/S se fellista. 1. 2. Error 1. Nej 2. Skriv Felaktigt värde i typ av nationell examen + EXA-posten
Per Lindgren, Bengt Reinholdsson 2016-05-26 47 (215) 4.7 Urvalsresultat 4.7.1 Händelseflöde för personposter Grundkontroller. Om körningen ska avbrytas vid fel styrs av beställningsfunktionen Personkontroller för alla posttyper Typ av post SKY post ADR post GBG post GBA post AVG post Typ av URVpost Sökalt=1 Kurs Sökalt=2 Program Sökalt=3 Kurspaket Listor: Fel, statistik sekretess, interimpnr..
Per Lindgren, Bengt Reinholdsson 2016-05-26 48 (215) 4.7.2 Grundkontroller R52. Hanteringen förutsätter att katalogdata från NyA har överförts till Ladok. Valet mellan avbryt/fortsätt inläggning i beställningen gäller endast grundkontroller. Om fel hittas ska bearbetningen avbrytas efter att fellistan har skrivits ut. OBS! Endast en unik post per kontroll ska skrivas ut på fellistan! R53. Om en URV-post innehåller något fel enligt kontrollerna 1-3 eller 5-6 ovan, ska innehållet i posten skrivas ut på fellistan och all övrig bearbetning av posten avslutas. R54. Slår kontrollen 4 in ska URV-posten skrivas ut på varningslista. R55. Fellistan ska förses med relevanta rubriker så att det går att identifiera körningstillfället. R56. Om inga fel hittas fortsätter programmet med kontroll av personen. R57. Samtliga poster ska kontrolleras map följande innan någon övrig bearbetning sker: R58. Kontroll 1: att det är korrekt högskolekod läs EGENHSK med högskolekod i URV-posten som nyckel om koden saknas o läs ALLAHSK med högskolekod i URV-posten som nyckel o om koden saknas skrivs följande text ut på fellista: Högskolekod saknas, högskolekod i URVposten R59. Kontroll 2: att terminen finns definierad i Ladok läs TERMIN med starttermin i URV-posten som nyckel om terminen saknas o skrivs följande text ut på fellista: Termin saknas, starttermin i URV-posten R60. Kontroll 3: att anmälningskoden finns definierad för aktuell termin läs PTILL med anmälningskod och starttermin i URV-posten som nyckel
Per Lindgren, Bengt Reinholdsson 2016-05-26 49 (215) Om saknas o läs KTILL2 med anmälningskod och starttermin i URV-posten som nyckel o Om saknas läs PAKETDEF med anmälningskod och starttermin i URV-posten som nyckel om saknas skrivs följande text ut på fellista: Anmälningskod saknas, anmälningskod och termin i URV-posten R61. Kontroll 4: Om antagningstermin i beställningsposten inte överensstämmer med starttermin i URV-post Posten ska körningen inte längre avbrytas oavsett om man valt Avbryt inläggning eller ej i villkorsformuläret. (AVBRYT=J/N) utan bearbetningen ska fortsätta och kontroll ska göras om det är en villkorad antagning enligt punkt 4a-4c Kontroll 4a: Villkorad antagning övrigt villkor Kontrollera om övrigt villkor = 1 (pos 69) och meddelandeid för övrigt villkor (pos 70-77) finns i URV-post. Kontroll 4b: Villkorad antagning avancerat villkor Kontrollera om villkor gällande GBA = 1 (pos 59) och meddelandeid för GBA-villkor (pos 60-67) finns i URV-post. Kontroll 4c: Villkorad antagning särskild behörighet Kontrollera om villkor gällande särskild behörighet = 1 (pos 68) finns i URV-post. Slår ingen av kontrollerna 4a 4c in så är det ingen villkorad antagning och man gå vidare med nästa grundkontroll. Slår däremot någon av kontrollerna in är det en villkorad antagning och villkoret ska finnas för aktuell starttermin i NYAMEDD, finns ej villkoret ska det uppdateras se uppdateringa av NYAMEDD nedan. R62. Kontroll 5: att urvalsgruppkod finns definierad i Ladok läs URVGRUPP med urvalsgrupp i URV-posten som nyckel om urvalsgruppen saknas o skrivs följande text ut på fellista: Urvalsgrupp saknas, urvalsgrupp i URV-posten
Per Lindgren, Bengt Reinholdsson 2016-05-26 50 (215) R63. Kontroll 6: att förutbildningskod finns definierad i Ladok läs FORUTB med GB-förutbildningskod som nyckel om förutbildningskoden saknas o skrivs följande text ut på fellista: Förutbildningskod saknas, GB-förutbildningskod i ADR-posten o OBS! Undantag: 25:4, REKO, UNDANTAG, GENUTGBUO, GENUTGBUÖ, GENUTGBUA. R64. Uppdatering i samband med grundkontroller, uppdatering av NYAMEDD Kontroll A. Meddelande i NYAMEDD Kontrollera om meddelandeidentitet för URV-postens startterminen redan finns i Ladoktabellen för meddelande från NyA (NYAMEDD). Meddelandeid hämtas från URV-posten: vid övrigt villkor från pos 70-77, vid avancerat villkor från pos 60-67 och vid villkor för särskild behörighet är (pos 68 = 1) meddelandeid = VI Kontroll B. Meddelandetext särskild behörighet Är det ett VI-villkor som gäller görs kontroll i beställningsposten (BATCHJOB) om villkor (VILLKOR = J) lagts in via SB02:s villkorsformulär. Om villkor lagts in ska kontroll göras mot tabellen för villkor (BATVILL) för att se om även text för VI-villkoret lagts in. Kontrollen görs genom att man läser BATVILL för aktuell beställning där VILLNR=11. Finns rätt villnr för beställningen kontrolleras om fältet VILLKOR innehåller text som inleds NYAMEDD=. Uppdatering av NYAMEDD Är det ett övrigt villkor (4a) och meddelande finns i NYAMEDD (kontroll A) ska tabellen NYAMEDD uppdateras med eventuellt ändrad meddelandetext (MEDDTEXT) för aktuellt meddelandeid, hämtas från MED-post. Det är alltså texten i MED.-posten som ska gälla. Är det ett avancerat villkor (4b) och meddelande finns i NYAMEDD (kontroll A) ska tabellen NYAMEDD uppdateras med eventuell ändrad meddelandetext (MEDDTEXT) för aktuellt meddelandeid, hämtas från AME-post. Det är alltså texten i AME.-posten som ska gälla. Är det en villkorad antagning med särskild behörighet (4c) och meddelande finns i NYAMEDD (kontroll A) ska tabellen NYAMEDD uppdateras med eventuell ändrad meddelandetext (MEDDTEXT) för aktuellt VI-villkor. Texten vid VI-villkor hämtas från tabellen BATVILL, se ovan punkt B. Det är alltså texten i BATVILL som ska gälla. Är det ett övrigt villkor (4a) och meddelande inte finns i NYAMEDD ska en ny post skapas i NYAMEDD, meddelandetext hämtas från MED-post, meddtyp= Ö. Är det ett avancerat villkor (4b) och meddelande inte finns i NYAMEDD ska en ny post skapas i NYAMEDD, meddelandetext hämtas från AME-post, meddtyp= A.