...
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 | ||
---|---|---|
| ||
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 | ||
---|---|---|
| ||
Bemærk
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 | info | straks | Institution | Information om grupper , og deres medlemmer og licenser | |
ws71 | info | straks | Institution | Information om slutbrugers kontaktpersoner | |
Import og eksport, herunder forældre og kontaktpersoner | |||||
ws10 | adm | fuld | Institution | Import af grupper, medlemmer og kontaktpersoner | |
ws17 | info | fuld | Institution | Eksport af grupper, medlemmer og kontaktpersoner | |
wsiiIDENTIFIKATION | info | straks | Institution | Mapning mellem UniID og CPR-nummer |
...
Attributnavn | Type | Beskrivelse | ||||||
| String | Systembruger, som ejes af en udbyder | ||||||
| String | Systembrugerens password | ||||||
| String | Unikt brugerid (UniID) | ||||||
| String | CPR-nummer | ||||||
| String | Består af fornavn+’ ’+efternavn Ved . Hvis der er navne- og adressebeskyttelse vises det importerede alias-navn. | ||||||
| String | Seks-tegns registreringsnummer, som identificerer en institution (kan indeholde både bogstaver og tal) | ||||||
| String | Institutionsnavn | ||||||
| String | Et gruppeid, holdID eller fagkode som er unikt på institutionen. | ||||||
| String | Gruppeid på hovedgruppen. For grundskoler er hovedgruppen lig elevens klasse. | ||||||
| String | Navnet på gruppen. Navnet er enten en gruppe oprettet af institutionen eller et af de fast definerede gruppenavne i UNI•Login - Alle, Elever og Ansatte. | ||||||
| String | Gruppenavnet på en elevs hovedgruppe. For grundskoler er hovedgruppen lig elevens klasse. | ||||||
| String | Typen af gruppe. En af værdierne: ”Hovedgruppe”, ”Årgang”, ”Retning”, ”Hold”, ”SFO”, ”Team” eller ”Andet” | ||||||
| String | Seks-tegns registreringsnummer, som identificerer en udbyder (kan indeholde bogstaver og tal) | ||||||
| String | Udbydernavn | ||||||
| String | Skal være entydig inden for en udbyder | ||||||
| String | Beskrivende navn for en serie af tjenester. Serier oprettes til gruppering af udbyderens tjenester. Unikt inden for udbyderen | ||||||
| String | Skal være entydig inden for en udbyder | ||||||
| String | Beskrivende navn for en tjeneste. Skal være entydigt inden for en udbyder. | ||||||
| String | Link til materialet eller tjenesten. | ||||||
| String | Reference til materialet eller tjenestens ”matplat-id” på Materialeplatformen. | ||||||
| Date | Startdato på formen: YYYY-MM-DD | ||||||
| Date | Slutdato på formen: YYYY-MM-DD | ||||||
| String | Klassens/stamgruppens 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. | ||||||
| String | 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. | ||||||
| String | "Lærer", "Pædagog", "Vikar", "Leder", "Ledelse", "TAP", "Konsulent" | ||||||
| String | En af følgende værdier: "Ekstern", "Praktikant" | ||||||
| String | En af følgende værdier: "Barn", "Elev", "Studerende" | ||||||
| String | Initialer for en ansat | ||||||
| String | Stillingsbetegnelse | ||||||
| String | Et tal, som er en statuskode defineret af den aktuelle webservice. | ||||||
| String | Kvitteringstekst. | ||||||
| Num | Antal medlemmer i en gruppe | ||||||
| String | Beskrivelse af kontaktpersonens relation til eleven. En af værdierne: ”Mor”, ”Far”, ”Andet”. | ||||||
| Bool | Har personen forældremyndighed? | ||||||
| Num | Er informationen vedrørende kontakten verificeret i CPR-registret af kildesystemet. 1=CPR-verificeret, 0=uverificeret | ||||||
| Num | 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. | ||||||
| XML | XML dokument med data på en institution | ||||||
| XML | XML format med fejlmeddelelser. Fejlmeddelelserne er henvendt til udviklere og lister fejlmeddelelsen samt den linje i XML filen, der fejler i forhold til skemaet. |
...
Objektnavn | Attributter | ||||||
| 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) | ||||||
| instnr, brugerid, navn, AnsatTilknytning/EksternTilknytning/ElevTilknytningMedHovedgruppe | ||||||
| brugerid, navn | ||||||
| |||||||
| |||||||
| instnr, AnsatTilknytning/EksternTilknytning/ElevTilknytning/KontaktTilknytning | ||||||
| [ansatRolle] | ||||||
| eksternRolle | ||||||
| elevRolle | ||||||
| elevRolle, hovedgruppeid, hovedgruppenavn | ||||||
| relation | ||||||
| |||||||
| |||||||
| EksternTilknytning | ||||||
| instnr, brugerid, navn, relation, myndighed, verifikation, adgangsniveau | ||||||
| instnr, gruppeid, gruppenavn, gruppetype, gruppetrin, fradato, tildato | ||||||
| instnr, gruppeid, gruppenavn, gruppetype, gruppetrin?, fradato, tildato | ||||||
| |||||||
| |||||||
| udbydernr, serienavn, seriekode, tjenestekode, tjenestenavn, url, matplatid? | ||||||
| |||||||
| |||||||
| |||||||
|