Versioner sammenlignet

Nøgle

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

...

API’er for Unilogin SkoleGrunddata webservices beskrives her på et konceptuelt niveau. Det konkrete niveau er beskrevet i WSDL-beskrivelserne, som der er henvist til fra de enkelte webservices.

Begrebsmodel

Der skelnes i det følgende mellem data, som vedligeholdes af en institution, og data, som vedligeholdes af en udbyder. En institution er en organisation, som bedriver undervisning eller udgør et dagtilbud, og som derfor har knyttet brugere til sig i form af ansatte og elever/børn.

En udbyder er en organisation, som udbyder tjenester til at understøtte den aktivitet, der foregår på en undervisningsinstitution institution i form af administrative og læringsmæssige processer og læringsprocesser.


Advarsel
iconfalse

Bemærk

Vedligeholdelsesansvaret for data er med til at opdele de enkelte services, og der skal som udgangspunkt laves aftaler med den ansvarlige part om for at tilgå data via en service.

I praksis skal man som udbyder tilsluttes en given service på Tilslutning. Herefter kan der oprettes anmodninger til institutionerne om dataadgang for den pågældende service.

Når en administrator hos den ansvarlige part godkender anmodningen i Tilslutning, er der adgang til at trække data.

...

Advarsel
iconfalse

Bemærk

  • Services til fulde træk må maksimalt kaldes 4 gange pr. institution pr. dag. Bemærk, at services til fulde træk og administration har en driftprofil med lavere kritikalitet end services til straksopslag.
  • Services til straksopslag må kun kaldes i kontekst af et aktivt login via Unilogin Broker. Services til straksopslag må således ikke anvendes til batch-opdatering af lokal cache.

Se mere på Udbyderes brug af BPI-webservices (Anvendelsespolitik)


Der findes et antal gennemgående metoder i alle services til test og overblik over indgåede dataaftaler.

...

Id

Navn

Adm/Info

Straks/Fuld

Vedligehold

Beskrivelse

Institutionsoplysninger, herunder forældre og kontaktpersoner

ws22

wsiINST

info

straks

Institution

Information om grupper , og deres medlemmer og licenser

ws71

wsiBRUGER

info

straks

Institution

Information om slutbrugers kontaktpersoner

Import og eksport, herunder forældre og kontaktpersoner

ws10

wsaIMPORT

adm

fuld

Institution

Import af grupper, medlemmer og kontaktpersoner

ws17

wsiEKSPORT

info

fuld

Institution

Eksport af grupper, medlemmer og kontaktpersoner


wsiiIDENTIFIKATIONinfostraksInstitutionMapning mellem UniID og CPR-nummer

...

Objektnavn

Attributter

Anker
Institution
Institution
Institution

instnr, instnavn, type, typenavn, type3, type3navn, adresse, bynavn, postnr, telefonnr, faxnr, mailadresse, www, kommunenr, kommune, admkommunenr, admkommune, regionsnr, region

(Se feltdefinitioner i Institutionsregistret. Officielle oplysinger vedrørende institutioner stammer ligeledes herfra)

Anker
Brugertilknytning
Brugertilknytning
Brugertilknytning

instnr, brugerid, navn, AnsatTilknytning/EksternTilknytning/ElevTilknytningMedHovedgruppe

Anker
Bruger
Bruger
Bruger
brugerid, navn

Anker
Elevbruger
Elevbruger
Elevbruger

ElevTilknytning, instnr, brugerid, navn, Hovedgruppe

Anker
InstBruger
InstBruger
InstBruger

instnr, brugerid, navn, Elev?/Ansat?/Ekstern?, [Gruppe]

Anker
InstTilknytning
InstTilknytning
InstTilknytning

instnr, AnsatTilknytning/EksternTilknytning/ElevTilknytning/KontaktTilknytning

Anker
AnsatTilknytning
AnsatTilknytning
AnsatTilknytning

[ansatRolle]

Anker
EksternTilknytning
EksternTilknytning
EksternTilknytning

eksternRolle

Anker
ElevTilknytning
ElevTilknytning
ElevTilknytning

elevRolle

Anker
ElevTilknytningMedHovedgruppe
ElevTilknytningMedHovedgruppe
ElevTilknytningMedHovedgruppe

elevRolle, hovedgruppeid, hovedgruppenavn

Anker
KontaktTilknytning
KontaktTilknytning
KontaktTilknytning

relation

Anker
Elev
Elev
Elev

ElevTilknytning, hovedgruppeid, hovedgruppenavn, elevtrin

Anker
Ansat
Ansat
Ansat

AnsatTilknytning, initialer, stilling

Anker
Ekstern
Ekstern
Ekstern

EksternTilknytning

Anker
Kontakt
Kontakt
Kontaktperson

instnr, brugerid, navn, relation, myndighed, verifikation, adgangsniveau

Anker
Hovedgruppe
Hovedgruppe
Hovedgruppe

instnr, gruppeid, gruppenavn, gruppetype, gruppetrin, fradato, tildato

Anker
Gruppe
Gruppe
Gruppe

instnr, gruppeid, gruppenavn, gruppetype, gruppetrin?, fradato, tildato

Anker
Udbyder
Udbyder
Udbyder

udbydernr, udbydernavn

Anker
Serie
Serie
Serie

seriekode, serienavn

Anker
Tjeneste
Tjeneste
Tjeneste

udbydernr, serienavn, seriekode, tjenestekode, tjenestenavn, url, matplatid?

Anker
GruppeMedAntal
GruppeMedAntal
GruppeMedAntal

Gruppe, antal

Anker
Svar
Svar
Svar

reskode, restekst

Anker
XMLinst
XMLinst
XMLinst

instXML

Anker
XMLsvar
XMLsvar
XMLsvar

svarXML