Versjonsendringer FS-API

Generelt

Gjeldende versjon

Finnes ved å sjekke disse:

https://api.fellesstudentsystem.no/version
https://fsapi-test.uio.no/version

Versjonering

Prinsipper for versjonering er beskrevet her:

https://semver.org/spec/v2.0.0.html

 

Versjon 1.5.0

Kjente feil

• GET /emnekombinasjoner har problemer med flere filtre. (Ressursen er i pilot, og ikke tilgjengelig for alle)

Feature Request

• [FSWS-2649] - UndAktivitet - Legg til Status_Ekvivalent

• [FSWS-2663] - Studierett - Filter på endringsdato

• [FSWS-2748] - Emne - Terminer for undervisning og vurdering

• [FSWS-2805] - GET vekting og NUS-kode fra /emner

Improvement

• [FSWS-2149] - Legge til Eksport Timeplan (J/N) i Undervisning

• [FSWS-2379] - Fjerne Person.Bilde J/N

• [FSWS-2746] - Bedre ytelse i Person ved å skille ut Student og Fagperson

• [FSWS-2779] - Validering på date og datetime felt

• [FSWS-2791] - Inkonsistent bruk av felt i subressurs studierett.semester årstall i veiledningsforhold.

New Feature

• [FSWS-2410] - Ny ressurs Kommune

Bug

• [FSWS-2624] - Swagger-eksempel for /undervisning/id viser feil i emne-ref i ID

• [FSWS-2631] - Oper-filtre i Swagger må fjernes

• [FSWS-2813] - Legge til refId i Swagger

• [FSWS-2886] - /fnrendringer returnerer tomme verdier hvis person ikke eksisterer

• [FSWS-2888] - Fields med flere felt fungerer ikke

• [FSWS-2899] - GET /veiledningsforhold leverer tomme felt/ID med 0-komponenter (".../0,0,0", "/null,null,null,null")

Task

• [FSWS-1730] - Caching av ressurser som sjelden endres

• [FSWS-2405] - Deprecate embedded Kommuner

 

Versjon 1.4.3

Generelt

• Denne versjonen gir en generell forbedring av ytelse (rundt 2-5x) på ID-kall
• NB! Alle anbefales å bruke dbId=true i alle spørringer, da false er uryddig og kan gi navnekollisjoner mellom ID og payload (i versjon 2.0.0 vil true være default)
• Neste versjon er 1.5.0, som kommer i Test + Prod medio juni

Kjente feil

• GET /veiledningsforhold leverer feilaktige ID-forekomster med 0-komponenter (".../0,0,0"). (Ressursen er i pilot, og ikke tilgjengelig for alle)
• GET /emnekombinasjoner har problemer med flere filtre. (Ressursen er i pilot, og ikke tilgjengelig for alle)

Feature Request

• [FSWS-2764] - GET /evukurs: Legge til opptaksperiode for EVUWeb3

New Feature

• [FSWS-2452] - MQ for resten av vurderingsområdet

Improvement

• [FSWS-2614] - Ytelsesforbedring for ID-oppslag
• [FSWS-2629] - Fjern bruk av typelabel i ID i JSON-eksempler
• [FSWS-2674] - Forbedre swagger.json og andre definisjoner
• [FSWS-2720] - Rusk rundt DatoIntervall i GET/POST

Bug

• [FSWS-2624] - Swagger-eksempel for /undervisning/id viser feil i emne-ref i ID
• [FSWS-2651] - Gjennomgang av nye ressurser i Swagger mhp. fields og paginering
• [FSWS-2716] - Bruk av filter aktiv=true/false i sprak returnerer status 400.
• [FSWS-2721] - Rette beskrivelse av /studentundervisningsaktiviteter/id
• [FSWS-2725] - "null" er tillatt og blir konvertert til 0 i numerisk felt
• [FSWS-2727] - Sette riktig server tid
• [FSWS-2729] - Sjekk alle Timestamp felt
• [FSWS-2730] - Spesialtegn i ID gir 404 Not Found
• [FSWS-2731] - GET /personer/id/bilde gir 500
• [FSWS-2732] - GET /vurderingsenheter: Institusjonsfilter fungerer ikke
• [FSWS-2733] - GET /fnrendringer gir "504 Gateway Time-out" i test
• [FSWS-2740] - Feil oppdaget gjennom testing av simulert individ kall
• [FSWS-2752] - Person.Eposter returneres bare hvis PRIVAT Epost er satt
• [FSWS-2727] - Feil tidssone (Europe/London) på server
• [FSWS-2789] - POST /personer/ID/personbilde returnerer 5005
• [FSWS-2790] - Inkonsistent bruk av semester/termin i /studieretter
• [FSWS-2792] - GET /emner leverer ikke "semesterperiode" i "studieprogrammer"
• [FSWS-2793] - GET /tilbudsstatuser: Filter på prioritet fungerer ikke
• [FSWS-2811] - Feil i JSON-eksempler
• [FSWS-2838] - XML example cannot be generated

Task

• [FSWS-2468] - Lage tester for å fange opp mismatch m/Swagger mhp. fields/sortering/paginering
• [FSWS-2770] - JSON log-layout - sørge for at level blir uendret

Versjon 1.4.2

Kjente feil

• GET /veiledningsforhold leverer feilaktige ID-forekomster med 0-komponenter (".../0,0,0"). (Ressursen er uansett i pilot, og ikke tilgjengelig for alle)

Bug

• [FSWS-2686] - Bedre sperring (med melding i Swagger) ved utrulling
• [FSWS-2702] - Studentundervisning - Filtre med annet enn = fungerer ikke
• [FSWS-2704] - POST /personer/id inkrementerer Studentnr
• [FSWS-2706] - Feil i eksempelet i Swagger for POST emnekombinasjoner/{id} (beskrivelser inneholder sprakkode)
• [FSWS-2707] - Kall på emnekombinasjoner/{id}?fields=emner returnerer status 500 når vektinger har verdier i emner

Versjon 1.4.1

Kjente feil

/veiledningsforhold leverer feilaktige ID-forekomster med 0-komponenter (".../0,0,0"). (Ressursen er uansett i pilot, og ikke tilgjengelig for alle)

Bug

• [FSWS-2435] - Person - Oppdatering av LanetakerID fungerer ikke
• [FSWS-2486] - Bedre feilmeldinger på integritetsbrudd
• [FSWS-2633] - Legge på manglende ID-filtre i /semestre
• [FSWS-2643] - /veiledningsforhold med wildcard-filter returnerer 500
• [FSWS-2650] - Bygninger og Rom mangler fields og paginering i Swagger
• [FSWS-2665] - Collection-kall viser limit=10 selv om paginering ikke er aktiv
• [FSWS-2666] - emnekombinasjoner skal være åpent for lesing
• [FSWS-2670] - Feilaktige/manglende wildcard-angivelser
• [FSWS-2684] - Emnekombinasjon - Beskrivelser må utvides til 4000 tegn

Versjon 1.4.0

New Feature

• [FSWS-2495] - Knytte Bygning og Rom til Fagperson 
• [FSWS-2451] - MQ for Vurderingsenhet + StudentVurdering
• GET/emnekombinasjoner
• POST/emnekombinasjoner
• GET/emnekombinasjoner/{id}
• POST/emnekombinasjoner/{id}
• DELETE/emnekombinasjoner/{id}/emner/{emne}
• GET /veiledningsforhold
• GET /veiledningsforhold({id}
• GET /praksistyper
• GET /praksistyper/{id}

Improvement

• [FSWS-2422] - Standardisere Swagger-dokumentasjon for typeannotasjoner
• [FSWS-2492] - Misvisende POST-feilmelding "duplicate id"
• [FSWS-2498] - Bør filtrere NULL praksiskoder i emne uttrekk
• [FSWS-2539] - Individkall - Ignorere sortering/paginering istf. å gi feilmelding
• [FSWS-2569] - POST/DELETE i Koder må autentiseres
• [FSWS-2589] - Mulighet for å angi dbId i Swagger
• [FSWS-2590] - Dokumentere mulighet for å angi dbId i Swagger

Bug

• [FSWS-2423] - Studieretter - Filter på studentstatus.aktivStudent fungerer ikke
• [FSWS-2430] - Vurderingsenheter++: Filtre på ID-komponenter er inaktive
• [FSWS-2431] - Vurderingsenheter/ID++: Feil i ledetekst
• [FSWS-2432] - Vurderingsenheter/ID++: Feil format på klokkeslett
• [FSWS-2433] - Vurderingsenheter++: Gale JSON-navn på filtre
• [FSWS-2453] - Organisasjonsenheter - Fjerne fields-parameter
• [FSWS-2456] - Språk mangler paginering i Swagger
• [FSWS-2466] - Rette feil og mangler i Swagger
• [FSWS-2475] - Personer/{id}/pinkode fungerer ikke
• [FSWS-2486] - Bedre feilmeldinger på integritetsbrudd
• [FSWS-2491] - Vurderingsenheter++: Paginering er inaktiv
• [FSWS-2500] - Studieretter - Filter studentstatus.aktivStudent fungerer ikke
• [FSWS-2543] - Kommisjoner - Legge til manglende sorteringsfunksjonalitet
• [FSWS-2549] - Vurderingsenheter - Feil på klokkeslett
• [FSWS-2563] - Feil format på fødselsdato
• [FSWS-2564] - Collection-spørringer viser ikke alltid "last"
• [FSWS-2600] - MQ-feil for /studentundervisningsaktiviteter
• [FSWS-2608] - Personer - fields=personnummer har ingen effekt, mens fields=fodselsdato returnerer både fodselsdato og personnummer
• [FSWS-2620] - "." er ikke konvertert i filter
• [FSWS-2623] - Wildcard i filter på ID-komponenter må konverteres korrekt
• [FSWS-2636] - Instrumenttype - Legge på manglende annotasjonsfunksjonalitet

Task

• [FSWS-2373] - Fjerne %_Ekvivalent_Med i Vurderingskombinasjon
• [FSWS-2455] - Flytte /instrumenttyper til Koder
• [FSWS-2538] - Fjerne mulighet for å bruke filter i individkall
• [FSWS-2554] - Språk har sorteringsparameter som ikke brukes 
• [FSWS-2587] - Justere Praksis-området ifht. tabellendringer
• [FSWS-2594] - Håndtere navneendring fra Praksistype til Undpraksistype i basen
• [FSWS-2610] - Person/Deltaker - Sjekke Swagger vs. funksjonalitet
• [FSWS-2618] - Swagger - Rydde i dokumentasjon av NTNU-ressurser
• [FSWS-2628] - Synce tagging med Wildcard++ i Swagger med koden
• [FSWS-2638] - Merk Språk-referanse i felt som merknad, navn osv. som Deprecated

 

Versjon 1.3.0

New Feature

• [FSWS-2116] - GET Vurderingskombinasjoner og GET Vurderingskombinasjoner {id}
• [FSWS-2117] - GET Vurderingsenheter og GET Vurderingsenheter {id}
• [FSWS-2118] - GET Kommisjoner og GET Kommisjoner {id}
• [FSWS-2119] - GET VurderingsresultatStatuser og VurderingsresultatStatuser {id}
• [FSWS-2120] - GET Vektingstyper og GET Vektingstyper {id}
• [FSWS-2126] - GET Vurderingsordninger og GET Vurderingsordninger {id}
• [FSWS-2153] - GET StudentVurderinger og GET StudentVurderinger {id}
• [FSWS-2192] - GET Vurderingstider og GET Vurderingstider {id}
• [FSWS-2108] - GET Vektingstyper og GET Vektingstyper {id}
• [FSWS-2193] - GET Instrumenttyper og GET Instrumenttyper {id}
• [FSWS-2196] - GET Karakterer og GET karakterer {id}
• [FSWS-2171] - GET Bygning og GET Bygning {id}
• [FSWS-2122] - GET Rom og GET Rom {id}
• [FSWS-2334] - Ressurs for å avlevere studentens PIN-kode 

Improvement

• [FSWS-2331] - Tester og opprydding for Vurdering som helhet
• [FSWS-2362] - Justere Studentvurdering etter JSON-møte 
• [FSWS-2411] - GET Person - Filter på Studentnr og Fnr

Bug

• [FSWS-2368] - Fjerne unødvendig join med KvalGrunnlag i Person
• [FSWS-2419] - POST Person - Låntaker-ID blir ikke oppdatert

Task

• [FSWS-2369] - Deprecate %_Ekvivalent_Med i Vurderingskombinasjon
• FSWS-2392] - Deprecate Person.Bilde J/N
• [FSWS-2386] - Inline resterende SCRIPT-referanser (i tillegg til Grants

Versjon 1.2.2

En stor del av arbeidet siden forrige release er gått til utbedringer og omstruktureringa av det underliggende i FS-API. Vi legger opp til hyppigere releaser framover.

Noen nye ressurser, datafelt, filtre og fixer er med

• [FSWS-1980] - Flere datafelt for person  (app)
• [FSWS-1997] - epost, adresse, bibsys (app)
• [FSWS-1998] - Ny tjeneste GET Person/Bilde (app)
• [FSWS-2037] - Nye tjenester POST/DELETE Person/Bilde (app)
• [FSWS-2105] - Legge til filter for Studentnr og Fnr på Person (app)
• [FSWS-2265] - Bruke meny for Registreringsperiode++ i EVUkurs
• [FSWS-2237] - Utvide Rollenr fra 4 til 5 siffer i Personrolle_ID_T
• [FSWS-1999] - Paginerte endepunkter og 'limit'
• [FSWS-2039] - Komplettere toppnivået i Personer (app)
• [FSWS-2258] - NB NB - Fjerning av filterfelt i SemReg som ikke er i bruk (app)
• [FSWS-2259] - Diverse bugfix

 

Versjon 1.1.3.10

	Nye ressurser (flate felt i eksisterende ressurser erstattet med referanser) *
	Ressurs	Tidligere flate felt
FSWS-1912	semestre	ar + termin
FSWS-1888	tilbudsstatuser	tilbudstatus
FSWS-1883	studieretninger	studieretning
	foretak	foretak
	kullklasser	studieprogram + ar + termin + klasse
*	I noen tilfeller er prefiks på navn endret til type-label i referanse (f.eks. kullSemester => semester (KULL))
	Strukturering av flate felt
	Ressurser	Felt	Til
FSWS-1943	campuser	fylke/kommune	Inline infostruktur
FSWS-1943	studieretter, evukurs	(studierett)status	Inline infostruktur
FSWS-1943	studieretter	studentstatus	Inline infostruktur
FSWS-1943	studieretter	begrensetStudierettstatus	Inline infostruktur
FSWS-1705	Diverse	epost	Inline infostruktur
	personer	kvalifikasjonsgrunnlag	Ref. til ressurs
	Standardisering av type-labels
	Ressurs	Felt	Gammel label	Ny label
	personer	adresse	HJEM	PRIVAT
	personer	organisasjonsenhet	GODKJENT_STUDIEKOMP	GODKJENT_GSK
	Diverse	semesterregistreringsPeriode	REG BAS UTDPLAN STUDINFO STUDSEM	REGISTRERING BAS_EKSPORT UTDANNINGSPLAN STUDIEINFO STUDIESEMESTER

I tillegg er det fjernet noen felt som ikke er i bruk i FS.

Det er også ryddet opp i navngiving av felt, for å bli mere konsistent. Dessverre har vi ikke funnet noen farbar vei for å liste opp alle disse endringene, så man må nesten la det feile, felt for felt. Trøsten er at dette er siste store endring av denne typen.

Release 03.07.2018

• Fjernet unødvendig nivå "self" i ID'er og referanser
• Harmonisert type-labels (f.eks. er "ADMIN" blitt "ADMINISTRATIVT")
• Ryddet opp i strukturen til EVU-kursdeltaker
• Nye ressurser /land, /fag og /kvalifikasjonsgrunnlag
• Div. opprydding og smårettelser