Web-services i forbindelse med EASY-A

Inden en ekstern part (dvs. ekstern i forhold til EASY-A) kan tilgå EASY-A web-services, skal der ansøges om tilladelse hertil hos UNI•C, administrative systemer.

Dette gælder, uanset om den eksterne part er en skole, der selv udvikler en løsning til sine egne data, en leverandør, der udvikler en løsning til salg til skolerne eller om den EASY-A-eksterne part er af en anden type.

Tilladelsen til adgang fra Internettet kræver, den eksterne part råder over en applikation (Elevplan, virk.dk, skolens intranet eller andet), som UNI•C har godkendt til at få adgang til EASY-data. Adgangen sker via en web-service proxy, der fungerer som firewall. En slutbruger skal have brugernavn/kodeord, evt. digital signatur, for at blive autentificeret af den eksterne parts internetapplikation. Applikationen skal herefter sikre, at brugeren kun forespørger på eller anvender data, som brugeren er autoriseret til.

I forbindelse med godkendelse af applikationen, udsteder UNI•C en pinkode, som applikationen præsenterer sig med overfor EASY-W. Pinkoden er en del af parameterlisten, der sendes til web-servicen. En aftale mellem UNI•C og en eksterne part indgås ved udfyldelse og underskrivelse af en aftaleformular.

I aftaleformularen henvises til, at der skal indskrives de web-services, der skal være omfattet af aftalen. UNI•C anbefaler, at den eksterne part inden udfyldelse af aftalen først kontakter projektleder Mads Helweg Harpsøe, 3587 8894, Mads.Helweg.Harpsoe@uni-c.dk med henblik en uformal afklaring af eventuelle uklarheder. Den underskrevne aftale indsendes til UNI•C, att. Mads Helweg Harpsøe, Vermundsgade 5, 2100 Købehavn Ø.

Support: Henvendelse til EASY-supporten sker gennem kontaktformularen, der findes her: https://uas.uni-c.dk/support/ 

Som "Skolenavn og -nummer" skrives den skole du forsøger at trække data fra.

Du bedes vedhæfte parameterliste og evt. fejlkodetekst.

EASY-supporten kan også kontaktes på 35 87 88 00.

Den konkrete beslutning om at åbne skolens base gives af skolen selv. Hver institution skal således selv åbne for, hvilke web-services der må afvikles på skolens database og herunder hvilke applikationer, som må tilgå de enkelte web-services. Dette sker på EASY-A-vinduet B936 Autorisation for webServices, hvor der f.eks. kan søges på skolenummeret. Herefter afmærkes de eksterne parter, der skal have tilladelse til at benytte web-services mod skolens EASY-A-database.

Omkring de forskellige web-services er der yderligere opbygget en række sikkerheds foranstaltninger.

For at sikre adgang fra Internettet til Sektornettets A-ben, hvilket under normale omstændigheder ikke er muligt, indeholder konceptet en Proxy server, der agerer firewall. Dette sikrer, at kun godkendte applikationer kan få adgang til EASY-W.

Der kan opstå situationer, bl.a. i netværket, således at der kan gå meget lang tid, inden EASY-W modtager et svar. Det kan derfor anbefales, at internet applikationen definerer, hvor lang tid den vil vente på svar.

Det samlede koncept for udbydelse af webservices i forbindelse med EASY-A kan læses her

Web-servicen tillader eksterne parter at tilgå en EASY-A skole, hvorfra der udtrækkes en persons skema. Det returnerede svar leveres som et XML-dokument, som indeholder en persons skemabegivenheder og tilhørende oplysninger, der er tilstrækkelige for, at en ekstern-part selv kan opbygge en præsentation af en persons skema. Webservicen findes i to versioner, hvor version 2 er udviddet med mulighed for at benytte EASY-A's interne nøgler som identifikation.

Læs mere om version 1 ved at klikke her.

Læs mere om version 2 ved at klikke her.

Web-servicen tillader eksterne-parter at tilgå en EASY-A skole, hvorfra der udtrækkes en medarbejders skema. Det returnerede svar leveres som et XML-dokument, som indeholder en medarbejders skemabegivenheder og tilhørende oplysninger, der er tilstrækkelige for, at en ekstern part selv kan opbygge en præsentation af en medarbejders skema. Webservicen findes i to versioner, hvor version 2 er udviddet med mulighed for at benytte EASY-A's interne nøgler som identifikation.

Læs mere om version 1 ved at klikke her.

Læs mere om version 2 ved at klikke her.

Web-servicen tillader eksterne parter at tilgå en EASY-A skole, hvorfra der udtrækkes VEU-oplysninger. Det returnerede svar leveres som et XML-dokument, som indeholder oplysninger til brug i VEU-godtgørelsesskemaet. En ekstern-part kan med disse udfylde elev- og uddannelsesoplysninger på et VEU-godtgørelsesskema.

Der kan udtrækkes oplysninger for en elevs placeringer på hold og fag. Der kan bestilles per elev, periode, virksomhed, hold og UVM-fag.

Webservicen findes i to versioner (version 2 og 3), hvor version 3 er udvidet med en række oplysninger på baggrund af ønsker fra SU-Styrelsen.

Læs mere om version 2 ved at klikke her.

Læs mere om version 3 ved at klikke her

Web-servicen tillader eksterne parter at tilgå en EASY-A-skole, hvorfra der udtrækkes oplysninger om elevers fravær.

Læs mere om version 1  ved at klikke her.

Læs mere om version 2  ved at klikke her

Web-servicen præsenterer stamdata-information for EASY-A skole-tabellen. Denne webservice er god at have adgang til i sammenhæng med for eksempel W005 KursusudbudViaWeb.

Læs mere ved at klikke her.

Web-servicen gør skolerne i stand til at kunne udbyde aktiviteter med tilhørende skolefags-oplysninger (Aktivitetsudbud) til en ekstern web-part. Skolens Aktivitets-udbud sendes først til EASY-F (central fælles EASY server), hvor oplysningerne gemmes og herfra kan en ekstern web-part tilgå oplysningerne via web-service kald. Det er således kun skoler, som vælger at sende aktivitets udbuddet til den fælles EASY-A server, som kan tilspørges.

Bemærk version 3 af W005 har aldrig været offentliggjort. Der er pt. 2 åbne versioner: Version 2 og version 4.

Læs mere om version 4 ved at klikke her

Web-servicen giver funktionalitet så man kan tilmelde sig til kurser gennem en web-service.

Tilmeldingen forgår fra en web-portal og de tilmeldte personer behandles i EASY-A som øvrige placeringer. Det vil sige der foregår ikke direkte optagelse på hold. Anmodninger om optagelse på hold skal viderebehandles af den enkelte skole, og udkommet bliver enten en afvisning, optagelse eller placering på venteliste.

Webservicen findes i to version, hvor version 2 i forhold til version 1, er blevet udvidet med nye oplysningsfelter i inputet bla. kontaktoplysninger for lærested og personer. Endvidere er det blevet muligt at anvende EASY-A's interne nøgler som identifikation af personen.

Læs mere om version 1 ved at klikke her.

Læs mere om version 2 ved at klikke her.

Web-servicen tillader eksterne parter at tilgå en EASY-A skole og udtrække karakteroplysninger for en eller flere elever/personer.

Bemærk der medtages ikke karakterer for elever/personer med fiktive CPR-numre (dvs. CPR-numre der starter med et ciffer større end 3) og der medtages KUN frigivne karakterer.

Læs mere om version 1 ved at klikke her

Læs mere om version 2 ved at klikke her

Web-servicen giver mulighed for at kunne spørge på status for en anmodning om holdplacering foretaget med W006 KursustilmeldingViaWeb, og få svar på om personen/personerne er optaget/kommet på venteliste eller andet.

Læs mere om ved at klikke her.

Web-servicen giver mulighed oprette personer som elever på AMU og ÅU hold - det som i EASY-A terminologi kaldes en holdplacering. Den enkelte skole styrer ved hjælp af en trimmeparameter, om webservicen må nyoprette personer og elever eller kun tilmelde eksisterende personer og elever til hold.
Bemærk at webservicen ikke opdaterer eksisterende personer og elever med nye oplysninger, såsom adresse eller kontaktoplysninger

Læs mere om version 1 ved at klikke her

Læs mere om version 2 ved at klikke her.

Web-servicen tillader eksterne parter at tilgå en EASY-A skole og - ud fra tidsmæssige angivelser af elevers tilstedeværelse og kendt fravær - registrere fravær for de af elevens skemabegivenheder, hvor eleven er fraværende.
En elev er tilknyttet en skemabegivenhed, når eleven følger et tilknyttet hold og skolefag på skemabegivenheden på den pågældende dato. Fraværet registreres på den aktivitetsplacering, der tilhører den pågældende holdplacering.

Læs mere ved at klikke her

Web-servicen tillader eksterne parter at tilgå en EASY-A skole og registrere ugebaseret fravær på personer/elever.
Det er angivet på de enkelte holds aktivitetsafdeling, om der registreres ugebaseret eller skemabaseret fravær på et hold. Denne web-service kan udelukkende bruges til hold, hvor der på den tilknyttede aktivitetsafdeling er angivet "U"(ugebaseret fravær) i feltet "Fraværsregistrering". 

Læs mere ved at klikke her.

Web-servicen giver mulighed for at oprette personer som elever på fuldtidshold - det som i EASY-A terminologi kaldes en holdplacering. Den enkelte skole styrer ved hjælp af en trimmeparameter, om man webservicen må nyoprette personer og elever eller kun tilmelde eksisterende personer og elever til hold.

Bemærk at webservicen ikke opdaterer eksisterende personer og elever med nye oplysninger såsom ændringer i adresse eller kontaktoplysninger. 

Læs mere ved at klikke her.

Webservicen udtrækker hold fra skolen inklusiv de skolefag, der er knyttet til holdet.

Læs mere ved at klikke her

Webservicen kan benyttes til at udtrække personoplysninger, oplysninger om tilknyttede elever og deres holdplaceringer. 

Bemærk at webservicen kan benyttes til at udtrække samtlige personer i databasen. Af samme grund bør den anvendes med en vis forsigtighed, da antallet af returnerede post kan være stort, hvis ikke der afgrænses.

Læs mere ved at klikke her

Der er i EASY-oprettet en række webservice til at understøtte LMS-systemer som Black-board, Fronter og lignende.

Af hensyn til LMS-systemer bliver data først samlet på EASY-F(den centrale EASY-server) og LMS-webservices trækker data herfra

Læs mere om version 1 ved at klikke her

Læs mere om version 2 ved at klikke her

Web-servicen kan vise eksamensplanen, dvs. tidspunkt, lokale og fag for elever, hvor der er dannet individuel eksamensplan.

Da eksamensplaner er fortrolige indtil offentliggørelsesdato, kan det ikke lade sig gøre, at udtrække eksamensplaner før tidligst på offentliggørelsesdagen.

Webservicen svarer i øvrigt til EASY-A udskriften A849 Eksamensplan elev, og har samme afgrænsninger.

Læs mere ved at klikke her.

Webservicen kan benyttes til at oprette og slette skemabegivenheder i EASY-A.

I EASY-A har man mulighed for at låse for import af skemabegivenheder fra eksterne systemer via W023 (sker i vinduet C384 Låsning af skemabegivenheder). Låsningen forhindrer, at ændringer foretaget i EASY-A efterfølgende bliver slettet af et eksternt skemaplanlægningssystem.

Læs mere ved at klikke her.

Webservicen giver et totaludttræk af alle ikke afgangsmeldte elever og medarbejdere, der er registreret i EASY-A. Webservicen anvendes af UNI-login til at trække informationen om, hvilke elever, der skal tildeles et UNI-login.

Samtidig kan webservicen også anvendes af skolen selv til at hente brugerne eller medarbejderes loginoplysninger fx til brug for skolens AD eller intranet.

Webservicen gør det muligt for eksterne parter, at indsende holdplaceringer (elever) til EASY-A.

Læs mere ved at klikke her 

Webservicen W029 Kontakter giver eksterne parter mulighed for at udtrække og opdatere kontaktoplysninger for en elev eller medarbejder.