Global funktion - SOKA - Utsökningspaket Kravspecifikation

KTH UTSÖKNINGSPAKET 1 Global funktion - SOKA - Utsökningspaket Kravspecifikation

KTH UTSÖKNINGSPAKET 2 Ändringshistorik Revision Datum Av Kommentar - - - 14-12-02 Eva Lundströmer Simu LADOK-19352 Underkänt betyg kan inte väljas i dropdown-lista för Kurs. Även kompletterat kravspec med ändrade formulärsnamn, printbilder mm

KTH UTSÖKNINGSPAKET 3 Innehåll 1. Funktionsbenämning............................ 4 2. Konstruktör................................... 4 3. Kortfattad beskrivning av funktionen - Syftet.......... 4 4. Uppdelning till delfunktioner...................... 5 5. Behörighetsanalys.............................. 5 6. Preferensstyrning.............................. 5 7. Kontroller.................................... 5 8. Funktionens resultat.......................... 6 9. Utskrifter.................................... 6 10. Översiktlig beskrivning av formulärstrukturen.......... Bilagor: SOKAA00G SOKAB00G SOKAC00G SOKAD00G SOKAE00C SOKAG00G SOKAH00G SOKAI00G SOKAJ00G SOKAK00G SOKAA02C SOKAA01S/ SOKAA01P Startformulär Kursregistreringsben Programregistreringsben Gruppben Visning av resultat från senaste utsökning (före bekräftelse) Kursresultatben Programresultat Behörighetsbakgrund Lokal serie och klass Tillgodoräknande Visning av utsökta personer (bekräftade) Visning av sökvillkor från en utsökning

KTH UTSÖKNINGSPAKET 4 1. Funktionsbenämning: Utsökningspaket 2. Konstruktörer: Inga-Maj Palmberg, Matz-Ola Cajdert, 3. Beskrivning av funktionen - Syftet Utsökningspaketet är ett paket globala program för utsökning av personer. Utsökningspaket finns tillgängligt för anrop i relevanta formulär i relevanta funktioner. Det kan nås med kommando Utsökning i menyn Special. Så länge man är kvar i utsökningspaketet kan man göra flera utsökningar efter varandra, varvid den utsökta populationen blir oförändrad eller ökar, den minskar aldrig. Hela tiden nettoräknas individerna, dvs var och en person räknas endast en gång. Efter varje gjord sökning visas resultat från utsökningen (antal personer samt personlista) automatiskt. Användaren har vid detta tillfälle möjlighet att bekräfta eller ångra den senaste utsökningen. Den utsökta populationen raderas när man från samma funktion anropar utsökningspaketet på nytt. Utsökningen sker via fem olika ben : Kursregistrering: sökning av personer som registrerats på angiven kurs Registrering på program: sökning av personer på grundval av påbörjade studier och/eller registrering på angivet program Kursresultat: sökning av personer som har resultat på angiven kurs Grupp: sökning av personer som tillhör grupp i program, grupp i kurs eller egen grupp. Lokal serie och klass: sökning av personer som omfattas av lokal serie och klass via kurs, program eller examina. Behörighetsbakgrund: sökning av personer som har en grundläggande behörighet eller omfattas av särskilt beslut. Tillgodoräknande: sökning av personer som berörs av tillgodoräknande av kurs När urvalskriterier för sökning ifylles, kan man inte använda mönstersökning. Detta innebär att exakta koder måste alltid anges. Om man inte vet koden, kan

KTH UTSÖKNINGSPAKET 5 den sökas fram genom att aktivera +++ -knappen. Då får man fram ett indexformulär där en av de framsökta koderna måste väljas. 4. Uppdelning till delfunktioner Inga delfunktioner finns. 5. Behörighetsanalys Användaren med behörighet till en funktion/delfunktion som anropar utsökningspaketet har full tillgång till alla ben i paketet. 6. Preferensstyrning 6.1 SYSTPREF Vad vill man styra Parametervärde Resultat Visning av terminsregistreringsuppgifter i programbenet. Termreg=J/bl Termreg=N Ja, visas Nej, visas ej Visning av kursregistreringsuppgifter i programbenet Kursreg=J/bl Kursreg=N Ja, visas Nej, visas ej 6.2 ANVPREF Vad vill man styra Parametervärde Resultat Visning av terminsregistreringsuppgifter i programbenet. Termreg=J/bl Termreg=N Ja, visas Nej, visas ej Visning av kursregistreringsuppgifter i programbenet Kursreg=J/bl Kursreg=N Ja, visas Nej, visas ej 6.3 PERSPREF Vad vill man styra Parametervärde Resultat

KTH UTSÖKNINGSPAKET 6 7. Kontroller Inga speciella kontroller behövs. 8. Funktionens resultat Efter utsökning är följande uppgifter tillgängliga i anropande funktion: Personnummer för alla som uppfyller angivna sökvillkor. Sökvillkoren är undansparade. De kan nås av ett globalt utskriftsprogram som skriver ut dessa för visning på skärmen eller på listor. Specialfall 1: Om man anropar utsökningspaketets kursresultatben från UT35, skall kurskod och resultatperiod från senaste utsökning överföras till motsvarande fält i UT35 startformulär (för att visas där som default). Specialfall 2: Om man anropar utsökningspaketets uppnådda -poäng-ben från UT46, skall programkod och resultatperiod från senaste utsökning överföras till motsvarande fält i UT46 startformulär (för att visas där som default). Resultat raderas när användaren nästa gång anropar utsökningspaketet. 9. Utskrifter Under arbetets gång kan man se personlistor och sökvillkor. De visas på skärmen. Med kommandot Skriv ut i menyn Arkiv får man utskrift på skrivare. Det finns två typer av personlistor. De är layoutmässigt nästan identiska, men innehållsmässigt olika: 1. Resultat från den senaste utsökningen. Detta innebär att denna population ännu inte har lagts till den tidigare utsökta populationen. Användaren kan ångra. 2. Alla utsökta som användaren har bekräftat. Sökvillkor för en utsökning visas när man i startformuläret markerar vilken utsökning man vill granska.

KTH UTSÖKNINGSPAKET 7 10. Översiktlig beskrivning av formulärstrukturen 10.1 Formulärförteckning Följande formulär finns i utsökningspaketet: SOKAA00G Utsökningsben: SOKAB00G SOKAC00G SOKAD00G SOKAG00G SOKAH00G SOKAI00G SOKAJ00G SOKAK00G Startformulär Kursregistreringsben Programregistreringsben Gruppben Kursresultatben Programresultatben Behörighetsbakgrund Lokal serie och klass Tillgodoräknande SOKAA02C SOKAE00C SOKAA01S/ SOKAA01P Visning av utsökta personer(bekräftade) Visning av resultat från senaste utsökning(före bekräftelse) Visning av sökvillkor från en utsökning

KTH UTSÖKNINGSPAKET 8 10.2 Dialogmodell Anm. SOKA00G har ersatts med SOKAA00G SOKA10C har ersatts med SOKAE00C SOKA11C har ersatts med SOKAA02C SOKA12C har ersatts med SOKAA01S/P

KTH UTSÖKNINGSPAKET 9 Startformulär SOKAA00G Generell utsökning 1. Hjälptext DET GENERELLA UTSÖKNINGSPAKETET: Generell utsökning Senast uppdaterad: 2004-04-13 Utsökningspaketet används när man vill söka fram en population. Flera utsökningar kan göras efter varandra, varvid populationen blir oförändrad eller ökar, den minskar aldrig. Hela tiden nettoräknas individerna, d v s varje person räknas endast en gång. Utsökningen sker via olika alternativ representerade av knapparna överst i startbilden. De utsökningsalternativ som finns är: Registreringsuppgifter: Kurs- och programregistreringar (i det senare ingår terminsregistreringar, programantagningsuppgifter mm) Resultatuppgifter: Kurs- och provresultat och resultat på program Övrigt: Gruppmarkeringar, kurser, program eller examen inom en viss serie/klass, behörighetsbakgrund och tillgodoräknanden Man gör utsökningar via ett alternativ åt gången. När utsökningen är utförd och man accepterat den, kommer man tillbaka till startformuläret och kan, om man så önskar, göra ytterligare utsökningar för att förändra populationen. När populationen är färdig klickar man på 'Klar'. Då kommer man automatiskt tillbaka till den funktion i vilken man anropade utsökningspaketet och kan gå vidare med den framsökta populationen. Den population som finns kvar efter den senast gjorda utsökningen är den som automatiskt tas med tillbaka till startformuläret i anropande funktion. Om man från samma funktion går tillbaka till utsökningspaketet förstörs den tidigare utsökta populationen. Information om gjorda utsökningar Under rubriken "Gjorda utsökningar" får man kortfattad information om de utsökningar som är utförda. Sökalternativ, sökvillkor och antal personer i populationen före och efter utförd utsökning visas. Sökparametrarna för samtliga utsökningar sparas tills man angivit 'Klar'. Därefter finns endast den sist gjorda utsökningen sparad.

KTH UTSÖKNINGSPAKET 10 Ytterligare information om respektive utsökning ges när man klickar på 'i'-knappen eller dubbelklickar på raden. Visa personer Man kan titta på vilka personer som ingår i populationen genom att välja 'Visa personer'. Beroende på vilka val som användaren gjort i bilden "Inställningar för namn-, adress och etikettlista" (under 'Inställningar' i menyraden) sorteras listan i namn- eller personnummerordning. 2. Kommandon och knappar Kommando Knapp Snabbkommando Vad händerr Arkiv Stäng Tillbaka till huvudmenyn. Redigera Sudda bild Ctrl-B Suddar bort allt i startformuläret. Omstart av utsökningspaket. Varna användaren. Funktion Sök kurs-registrerad e... Sök program-registr erade... Sök resultat på kurs... Sök resultat på program... Sök grupp... Sök via lokal serie och klass Sök via behörighetsbak grund Sök via tillgodoräknand en Registrering/ Kurs Registrering/ Program Resultat/ Kurs Resultat/ Program Övrigt/ Grupp Övrigt/ Serie och klass Övrigt/ Beh bakgrund Övrigt/ Tillgodo Gå till kursregistreringsbenet. Gå till programregistreringsbenet. Gå till kursresultatbenet. Gå till programresultatbenet Gå till gruppbenet. Se krav i dokument "soka_kravspecr_lokalserie_klass " Se krav i dokument "soka_kravspec_behorbakgrund" Visa personer... Visa personer Visa alla utsökta personer. Klar Klar Till anropande funktion.

KTH UTSÖKNINGSPAKET 11 Meny Special skall inte finnas i detta formulär. 3. Instruktioner för programmering Rutan Gjorda utsökningar Om användaren har bekräftat gjord utsökning, skall sökvillkoren i komprimerad form visas inklusive antal personer i populationen. Om användaren återkommer från utsökningsformulär utan att ha godkänt utsökning, skall ingenting nytt visas i detta formulär. Knappen i aktiverar ett formulär där fullständig bild av sökvillkor för en utsökning visas. Knappen Visa personer Aktivera formulär SOKAA02C för visning av alla utsökta. Sorteringsordning är enligt användarens personliga inställningar.

KTH UTSÖKNINGSPAKET 12 Kursregistreringsben - Formulär SOKAB00G 1. Hjälptext Utsökning via kursregistrering Senast uppdaterad: 2007-04-25 Här kan man söka ut populationen med hjälp av kursregistreringsuppgifterna. Man väljer att utgå från kurs- eller anmälningskod. Koder kan sökas fram med hjälp av >>-knappen. Termin eller terminsintervall måste anges, liksom minst en registreringstyp. Därefter anger man eventuella tilläggsvillkor som ska gälla för utsökningen. Om man anger flera tilläggsvillkor måste samtliga villkor vara uppfyllda för att en person ska tas med i den population som söks ut. Om sökmönster används för kurs- eller anmälningskod, kan man söka på utbildningsnivå. Efter utförd sökning visas hur många som finns i populationen. Väljer man att godta resultatet av utsökningen ('OK') kommer man sedan tillbaka till startformuläret för det generella utsökningspaketet. Ångrar man sökningen (Esc) kommer man åter till utsökningsformuläret för kurs. Flera utsökningar Det går bra att göra flera utsökningar efter varandra. Populationen blir då oförändrad eller ökar. Från startformuläret kan man välja andra utsökningsalternativ eller gå in på samma alternativ igen. Det är populationen från den senast gjorda utsökningen som är utgångspunkt när man går vidare till annat utsökningsalternativ eller tillbaka till anropande funktion. 2. Kommandon och knappar

KTH UTSÖKNINGSPAKET 13 Kommando Knapp Snabbkommando Vad händerr Arkiv Stäng Avbryt Tillbaka till startformuläret. Tillbaka till startformuläret. Redigera Sudda bild Ctrl-B Suddar bort allt i detta formulär. Funktion Sök... Sök Ctrl-S Startar sökningen. Meny Special skall inte finnas i detta formulär. 3. Instruktioner för programmering Tabeller som läses: FFGKURS skall läsas, om FFG är kryssad. FORTKURS skall läsas, om FO är kryssad. OMKURS skall läsas, om OM är kryssad. UBINDRG skall läsas, om FFG är kryssad. Uppgiften i individuell kursplan för utbytesstudenter skall jämställas med FFG-registrering på kurs. ANTLIN skall läsas om tilläggsvillkor angående program är ifyllda (utöver vad som finns i FFGKURS). GRUPPHUV, GRUPPRAD skall läsas om grupp i kurs resp program är ifylld. När skall formuläret rensas? Användare som ångrar sökningen (i formulär SOKA10C) kommer tillbaka till detta formulär. De angivna sökvillkoren skall då finnas kvar i formuläret. Användaren får vid behov själv rensa med Redigera/Sudda bild. När användaren kommer hit från startformuläret, skall detta formulär alltid vara tomt (även om flera sökningar i detta ben är gjorda tidigare).

KTH UTSÖKNINGSPAKET 14 Programregistreringsben - Formulär SOKAC00G 1. Hjälptext Utsökning via program Senast uppdaterad: 2004-01-07 Här kan man söka ut populationen med hjälp av programregistrerings- och programantagningsuppgifter. Man börjar med att ange programkod. Koder kan sökas fram med hjälp av >>-knappen. Mönstersökning på program möjlig. Man väljer sedan sökning på: 1 Antagningstermin eller kull. Kan kombineras med registreringsterminer och registreringstyp 2 Registreringsterminer samt minst en registreringstyp (för kurs- eller terminsregistreringen). Därefter anger man eventuella tilläggsvillkor som ska gälla för utsökningen, exempelvis programinriktning, programort m m. Om man anger flera tilläggsvillkor måste samtliga villkor vara uppfyllda för att en person ska tas med i den population som söks ut. Om de förvalda markeringarna under rubriken "Uteslut personer med" ej ändras gäller följande: Personer som har avbrott på programmet tas ej med om avbrottet ligger före eller inom angivet terminsintervall. Personer som har eller har haft studieuppehåll/utlandsstudier tas med vid utsökningen när man söker på antagningstermin/kull.

KTH UTSÖKNINGSPAKET 15 Personer som har studieuppehåll en angiven registreringsperiod tas med om de har en registrering inom den angivna perioden. Personer som deltar i utlandsstudier tas med om de är antagna till utlandsstudier en angiven registreringsperiod. Personer som har antagning till senare del av program tas alltid med. Efter utförd utsökning visas hur många som finns i populationen. Väljer man att godta resultatet av begränsningen ('OK') kommer man sedan tillbaka till startformuläret för det generella utsökningspaketet. Ångrar man sökningen (Esc) kommer man åter till utsökningsformuläret för program. Flera utsökningar Det går bra att göra flera utsökningar efter varandra. Populationen blir då oförändrad eller ökar. Från startformuläret kan man välja andra utsökningsalternativ eller gå in på samma alternativ igen. Det är populationen från den senast gjorda utsökningen som är utgångspunkt när man går vidare till annat utsökningsalternativ eller tillbaka till anropande funktion. 2. Kommandon och knappar Kommandon och knappar som i bilaga B00G (Kursregistreringsbenet). 3. Instruktioner för programmering Preferensstyrning: Se avsnitt 6 i den allmänna delen. Tabeller som läses: ANTLIN Terminsregistrering: FFGLIN OMREGLIN Kursregistrering: FFGKURS FORTKURS via FFGKURS OMKURS via FFGKURS GRUPPHUV/GRUPPRAD UPPHLIN UBINDRG AVBRLIN

KTH UTSÖKNINGSPAKET 16 Kursresultatben - Formulär SOKAG00G R1 Kurs Typ Format Ledtext Hjälptext Villkor Styrningar Inmatningsfält Kurs Övrigt R15 Begränsa Villkor för Kurs Typ Format Ledtext Hjälptext Villkor Dropdown Visar alltid alternativen Utan villkor, Avklarad, Ej Avklarad samt betyg från kursens betygsskala (BSKALA.KURS). Uppgift om kursens betyg hämtas från BETYG.BETSKALA för godkända

KTH UTSÖKNINGSPAKET 17 Styrningar och/eller tillgodoräknade betyg. Underkända betyg (KLASS.BETSKALA = U ) ska inte visas i dropdown-listan Övrigt Default värde. Utan villkor R16 Begränsa Villkor för Prov Typ Format Ledtext Hjälptext Villkor Styrningar Dropdown Visar alltid alternativen Utan villkor, Avklarat, Ej Avklarat samt betyg från provets betygsskala (BSKALA.PROV). Saknar provet betygsskala hämtas kursens betygsskala (BSKALA.KURS). Uppgift om provets betyg hämtas från BETYG.BETSKALA och visas i dropdown-listan Övrigt Default värde. Utan villkor 1. Hjälptext Utsökning via kursresultat Senast uppdaterad: 2007-04-25 Här kan man söka ut populationen med hjälp av resultat på kurs och prov. Man börjar med att ange kurskod. Därefter anges resultatperiod inom vilket resultaten skall finnas. Kurskod samt datumintervall är obligatoriska uppgifter. Koder kan sökas fram med hjälp av >>-knappen. När kurskoden anges skrivs samtliga i kursen ingående prov ut i listan under rubriken "Begränsa". Tillgodoräknade kurser samt tillgodoräknade prov tas med när sökningen utförs om rutorna för dessa uppgifter är ikryssade. Personer med avbrott i kursen tas med vid sökningen om inte det förifyllda krysset vid detta alternativ tas bort. Begränsa Följande villkor kan anges: alla som har resultat på kursen inom angivet poängintervall (högskolepoäng)(fältet "Avklarad poängsumma (hp)...") alla som har hela kursen avklarad och/eller visst prov avklarat alla som inte har kursen avklarad och/eller inte har visst prov avklarat

KTH UTSÖKNINGSPAKET 18 alla som har visst betyg i kurs och/eller prov. Betyg från gällande betygsskalor visas och kan väljas. Villkoren för kurs och prov kan kombineras. Villkoren kan sättas för flera prov samtidigt eller prov och kurs samtidigt. Vilka villkor som ska gälla för varje kurs och prov väljs i listan vid respektive kurs-/provkodsfält. "Avklarad" = alla godkända resultat. "Ej avklarad" = underkänt betyg eller inget resultat rapporterat. "U" = underkänt resultat under angiven resultatperiod. Om underkänt och godkänt resultat finns för samma person under aktuell resultatperiod tas personen endast med i den utsökning som avser godkänt resultat. Om man anger flera tilläggsvillkor måste samtliga villkor vara uppfyllda för att en person ska tas med i den population som söks ut. Efter utförd utsökning visas hur många som finns i populationen. Väljer man att godta resultatet av sökningen ('OK') kommer man sedan tillbaka till startformuläret för det generella utsökningspaketet. Ångrar man sökningen (Esc) kommer man åter till utsökningsformuläret för kurs/provresultat. Flera utsökningar Det går bra att göra flera utsökningar efter varandra. Populationen blir då oförändrad eller ökar. Från startformuläret kan man välja andra utsökningsalternativ eller gå in på samma alternativ igen. Det är populationen från den senast gjorda utsökningen som är utgångspunkt när man går vidare till annat utsökningsalternativ eller tillbaka till anropande funktion. 2. Kommandon och knappar Kommandon och knappar som i bilaga B00G (Kursregistreringsbenet). 3. Instruktioner för programmering Tabeller som läses: FFGKURS UTBYTE INBYTANN GODKPROV UNDKPROV GODKKURS UBINDBU, UBINDBG skall läsas. Uppgiften i individuell kursplan för utbytesstudenter skall jämställas med resultat, om datum är ifyllt. INREGFFG, INREGFO, INREGOM, om personer med avbrott på kursen skall uteslutas. När skall formuläret rensas? Se bilaga B00G (Kursregistreringsbenet).

KTH UTSÖKNINGSPAKET 19 Default: Kryssruta 'Ta med tillgodoräknade/utbytta kurser ej kryssad. Kryssruta Ta med tillgodoräknade prov kryssad. Kryssruta Ta med personer med avbrott på kursen kryssad. Alla dropdown-listor: Utan villkor.

KTH UTSÖKNINGSPAKET 20 Formulär SOKAH00G Programresultat Tabeller som läses: GODKPROV UNDKPROV GODKKURS UTBYTE ANTLIN INBYTANN

KTH UTSÖKNINGSPAKET 21 Gruppben - Formulär SOKAD00G 1. Hjälptext Utsökning via grupp Senast uppdaterad: 2000-09-06 Här kan man söka ut en population med hjälp av gruppmarkering. De olika slags gruppmarkeringar som finns är: Grupp i kurs Grupp i program Egen grupp Gruppmarkeringar läggs in i samband med kurs- eller terminsregistreringar och kan också skrivas in via funktionen SA10. Man börjar med att välja typ av grupp. Texten till nästa fält i bilden ändras då i enlighet med det val man gjort. D v s kurskod, programkod eller användarkod efterfrågas beroende på vilken grupptyp som gäller. Koder kan tas fram med hjälp av >>-knappen. Efter utförd sökning visas hur många som finns i populationen. Väljer man att godta resultatet av sökningen ('OK') kommer man sedan tillbaka till startformuläret för det generella utsökningspaketet. Ångrar man sökningen (Esc) kommer man åter till utsökningsformuläret för grupp. Flera utsökningar Det går bra att göra flera utsökningar efter varandra. Populationen blir då oförändrad eller ökar. Från startformuläret kan man välja andra utsökningsalternativ eller gå in på samma alternativ igen. Det är populationen från den senast gjorda utsökningen som är utgångspunkt när man går vidare till annat utsökningsalternativ eller tillbaka till anropande funktion. 2. Kommandon och knappar Kommandon och knappar som i bilaga B00G (Kursregistreringsbenet). 3. Instruktioner för programmering

KTH UTSÖKNINGSPAKET 22 Tabeller som läses: GRUPPHUV GRUPPRAD När skall formuläret rensas? Se bilaga B00G (Kursregistreringsbenet).

KTH UTSÖKNINGSPAKET 23 Lokal serie och klass - Formulär SOKAJ00G Se dokument "soka_kravspecr_lokalserie_klass"

KTH UTSÖKNINGSPAKET 24 Behörighetsbakgrund - Formulär SOKAI00G Se dokument "soka_kravspec_behorbakgrund"

KTH UTSÖKNINGSPAKET 25 Tillgodoräknande - Formulär SOKAK00G