Versioner sammenlignet

Nøgle

  • Linjen blev tilføjet.
  • Denne linje blev fjernet.
  • Formatering blev ændret.
Releasenr.
ReleasedatoBeskrivelse

Nyt versionsnr. i webservice

R1.38TBA

Understøttelse af flere end 10 kontaktpersoner for børn på bosteder, samt understøttelse af erhvervsidentiteter fra NemLog-in.

  • Ny version af wsaIMPORT.
  • Ny version af wsiEKSPORT.
Ja

Releasenote ws-r1.37

Releasen indeholder en justering af schemaet for at klargøre webservicen til en fremtidig release ift understøttelse af erhvervsidentiteter.

Ændringerne i releasen giver anledning til et tvunget versionsskifte af de fire nedenstående webservices. Det betyder, at du skal skifte den URL, som du bruger til at tilgå webservicen med.

Derudover er der en schema-ændring i webservicen wsiEKSPORT, se beskrivelse af schema-ændringen i figurerne nedenforherunder

Klargøring til understøttelse af erhvervsidentiteter for en kontakt person

Ændringen er markeret med rødt i tabellen nedenfor.

ContactPerson

Felt

Type

Antal

Beskrivelse

relation
(F)

Enum

1

Kontaktpersonens relation til eleven.
En af værdierne: Mor, Far, Andet, Officielt tilknyttet person.

childCustody
(F)

Bool

1

Har personen forældremyndighed?

cvrString0-1CVR nummer til Erhvervsidentitet. Feltet vil være tomt indtil der releases en ny version af wsaIMPORT, som understøtter denne funktionalitet.
pnrString0-1P-nummer til Erhvervsidentitet. Feltet vil være tomt indtil der releases en ny version af wsaIMPORT, som understøtter denne funktionalitet.
accessLevel
(F)
Enum1

0 (default) angiver at kontaktpersonen må få adgang til almindelige personoplysninger om den tilknyttede elev.

1 angiver at kontaktpersonen må få adgang til fortrolige og følsomme personoplysninger om eleven. NB. Hvis kontaktpersonen ikke er forældremyndighedsindehaver, skal hjemmel opnås på anden vis.

Person
(F)

Person

1

Personoplysninger på kontaktpersonen

UNILogin

UNILogin

0-1

Eventuelle Unilogin-oplysninger


Fra juli 2021 kan leverandørerne begynde at skifte til de nye versioner af de fire webservices. Skiftet skal være gennemført 21. november 2021 (som udmeldt), hvorefter alle tidligere versioner af de fire webservices lukkes.

Se også oversigten over aktuelle driftsversioner af webservices Oversigt over versioner af Skolegrunddatas webservices




...

Dokumentation af tidligere releases

Udvid
titleHistoriske releases

Releases af Unilogins BPI webservices

Releasenr.
ReleasedatoBeskrivelse

Nyt versionsnr. i webservice

R1.30

26, august 2019

Vedligehold og mindre fejlrettelser

Nej
R1.3123. januar 2020

Håndtering af modtagelse af tomme Alias navne

Nej
R1.32februar 2020

Ny rolle fra rollekataloget: Officiel tilknyttet person

Ja
R1.33
  1. Juli 2020
Vedligehold Nej
R1.3410. August 2020Vedligehold Nej
R1.3511. september 2020Låsning af importer på institutionerNej
R1.3621. oktober 2020OmidentifikationNej

...

...

STIL anbefaler, at anvende den nyeste version af BPI-webservices, fordi opdateringerne kan indeholde vigtige og nødvendige fejlrettelser og ændringer.



Uddybende beskrivelse af udvalgte releases

...

Release ws-r1.37

For at understøtte at børn på bosteder kan have mere end 10 officielt tilknyttede kontakt personer er det nødvendigt, at lave en opdatering af skemaet i wsiEKSPORT. Der er altså tale om en ny version af wsiEKSPORT, som alle leverandører skal skifte til.

Ændringen er markeret med rødt i tabellen nedenfor.

Student

...

Felt

...

Type

...

Antal

...

Beskrivelse

...

StudentNumber

...

String

0-1

...

Elevens studienummer fra lokalt administrativt system.

...

Level

...

Enum

...

1

...

Elevens trin. En af følgende værdier: DT, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, U1, U2, U3, U4, VU, Andet. DT er dagtilbud, 1 svarer til 1. klassetrin i grundskolen, U1 er første trin på en ungdomsuddannelse. VU er voksenuddannelse.

...

Location

...

String

...

0-1

...

Afdeling, bygning eller værelsesnummer på efterskoler.

...

MainGroupId

...

String

...

1

...

Elevens hovedgruppe. For grundskoler elevens klasse og kan for andre institutioner for eksempel studieretning eller stamhold. (groupType for mainGroup er ”Hovedgruppe”)

...

GroupId

...

String

...

0-n

...

Yderligere grupper eleven er tilknyttet, ud over tilknytningen via MainGroupId.

...

ContactPerson
(F)

...

Contact-Person

...

Ændres fra 0-10

til 0-n

...


Release ws-r1.36

Indeholder de nødvendige rettelser, der skal til for at få omidentifikation til at virke igen. 

Release ws-r1.35

Der indføres en låsning på importerne, således at en institution kun kan have en aktiv import ad gangen. Hvis en institution har en aktiv import og der sendes en ny import imens den første import behandles vil den sidste import blive afvist med fejlbesked:

Fejl 10: Importen er låst, den bliver låst op dd.MM.yyyy HH:mm.ss. Bruger:wsbrugerid Institution:NNNNNN Kilde:kilde

Release ws-r1.34

Releasen indeholder ingen ændringer.

Release ws-r1.33

Releasen indeholder ingen ændringer.

Release ws-r1.32

Med release ws-r1.32 indføres der en ny rolle fra rollekataloget. Rollen er "Officiel tilknyttet person" i tabellen ContactPerson:

ContactPerson

Felt

Type

Antal

Beskrivelse

relation

Enum

1

Kontaktpersonens relation til eleven. Skal udfyldes. En af værdierne: Mor, Far, Andet, Officiel tilknyttet person.

childCustody

Bool

1

Har personen forældremyndighed?

accessLevel

Enum

0/1

Værdien 0 (default) angiver, at kontaktpersonen må få adgang til almindelige personoplysninger om den tilknyttede elev. Værdien 1 angiver, at kontaktpersonen må få adgang til fortrolige og følsomme personoplysninger om eleven. NB. Hvis kontaktpersonen ikke er forældremyndighedsindehaver, skal hjemmel opnås på anden vis.

Person

Person

1

Personoplysninger på kontaktpersonen.

Link til Rollekataloget

https://www.kl.dk/media/11557/rollekatalog-for-bpi-brugeraktrer-og-brugerroller.pdf