Vi samler statistik ved hjælp af cookies

Vi bruger cookies til at forbedre hjemmesiden til glæde for vores brugere. Du kan altid slette cookies fra os igen.

Primær navigation

Webservices til EASY-A

Der kan i forbindelse med EASY-A kaldes en række web-services fra internettet, som enten giver adgang til at udtrække data fra institutionernes EASY-A, eller giver adgang til at indsætte data på kontrolleret vis i institutionernes EASY-A database.

Der kan i forbindelse med EASY-A kaldes en række web-services fra internettet, som enten giver adgang til at udtrække data fra institutionernes EASY-A, eller giver adgang til at indsætte data på kontrolleret vis i institutionernes EASY-A database.

Der udbydes følgende web-services:

Principiel godkendelse af den eksterne part

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 Styrelsen for IT og Læring, 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 at den eksterne part råder over en applikation (Elevplan, virk.dk, skolens intranet eller andet), som Styrelsen for IT og Læring 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 Styrelsen for IT og Læring en pinkode, som applikationen præsenterer sig med overfor EASY-W. Pinkoden er en del af parameterlisten, der sendes til web-servicen.

Indgåelse af aftale

En aftale mellem Styrelsen for IT og Læring og en ekstern part indgås ved udfyldelse og underskrivelse af en aftaleformular. I aftaleformularen henvises til, at der skal indskrives de webservices, der skal være omfattet af aftalen.

For at indgå en aftale med STIL skal der oprettes en sag via STIL’s servicedesk, hvorefter en eksterne part vil modtage et aftaledokument, der skal udfyldes, underskrives og sendes til STIL. Eventuel afklaring vedrørende webservices skal ligeledes foregå via STIL’s servicedesk.

Klik her for at oprette en sag.

Konkret godkendelse af adgang til en given skoles data

Den konkrete beslutning om at åbne skolens/institutionens base træffes af skolen/institutionen selv.
Hver skole/institution skal således selv åbne for, hvilke web-services der må afvikles på skolens/institutionens 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/instituionens 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, hvor 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

Support

Hvis der opstår problemer i forbindelse med brug af webservice, skal du henvende dig til EASY-supporten.
Det skal foregå via kontaktformularen, der findes her: http://www.admsys.stil.dk/EASY-A/Support/Webform

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.

Oversigt over webservices

Herunder finder du en liste over de tilgængelige webservices med vejledninger.

Bemærk, at der er en række interne webservices mellem ÉASY-systemerne, som ikke optræder på denne liste, fordi de ikke kan tilgåes fra en ekstern part. Det drejer sig om W018, W019, W026, W036 og W037.

Godkendte webservice-aftagere

W000 HentPersonSkema

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.

W001 HentMedarbejderSkema

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.

W002 HentVEUSkema

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

W003 Fravær, Elev

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

W004 HentSkoleStamdata

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.

W005 KursusudbudViaWeb

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 4 og 5
Læs mere om version 4 ved at klikke her
Læs mere om version 5 ved at klikke her 

W006 KursustilmeldingViaWeb

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.

W007 Karakteroplysninger

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

W008 KursustilmeldingStatus

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.

W009 Holdplacering AMU ÅU

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
Læs mere om version 4 ved at klikke her

W010 Registrering af fravær ud fra skema

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

W011 Registrering af ugebaseret fravær

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.

W012 Holdplacering Fuldtid

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.

W013 Hold med skolefag

Webservicen udtrækker hold fra skolen inklusiv de skolefag, der er knyttet til holdet.
Læs mere ved at klikke her

W014 Personer, elever og holdplaceringer

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

W015 W016 W017 LMS-udtræk

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

W022 Eksamenplan

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.

W023 Importer skemabrikker

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.

W024 Hent ansøgning

Webservicen stiller en persons ansøgningsskema og uddannelsesplan til rådighed for andre systemer, f.eks. Elevplan. Bemærk, at web-servicen kun henter ansøgningsskema og uddannelsesplan på EASY-F.
Læs dokumentation for W024 - version 1

W025 UNI-login

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.
Læs mere ved at klikke her

W027 Vedligeholde holdplaceringer

W027 er en webservice, som giver eksterne parter mulighed for at oprette, ændre og slette holdplaceringer direkte på skolen
Læs dokumentation for W027- version 2

W028 Holdplaceringer

Webservicen gør det muligt for eksterne parter, at indsende holdplaceringer (elever) til EASY-A.
Læs mere ved at klikke her 

W029 Kontakter

Webservicen W029 Kontakter giver eksterne parter mulighed for at udtrække og opdatere kontaktoplysninger for en elev eller medarbejder.
Læs mere ved at klikke her

W030 Elever i skemabegivenhed

Denne webservice tillader eksterne parter at tilgå en EASY-A skole, hvorfra der med udgangspunkt i en dato og CPR-nr for medarbejder eller elev, kan udtrækkes skemabegivenheder på den dato for medarbejder eller elev.
Læs dokumentation til W030 - version 1

W031 Registrer skemabaseret fravær

Formålet med denne webservice er at registrere skemabaseret fravær med udgangspunkt i skemabegivenheds-id og elever. Der kan modtages oplysninger for flere skemabegivenheder / elever ad gangen.
Læs dokumentation til W031 - version 1

W034 Skift person på AMU-holdplacering

Med denne webservice kan man flytte en holdplacering fra én person til en anden person. Webservicen kan både anvendes til at ændre en reservation (unavngiven reservation registreret på fiktivt CPR-nr) til en rigtig person, samt til at ændre, hvilken person en virksomhed sender på kurset. W034 er en del af kommunikationen med efteruddanelse.dk.
Læs dokumentation til W034 - version 2

W035 Registrér fravær for AMU

Webservicen registrerer fravær for AMU via tilstededage samt opdaterer Skolefag på holdplaceringer med en markering af om skolefaget er gennemført. Det returnerede svar leveres som et XML-dokument, der angiver om opdateringen gik i gennem uden fejl.
Læs mere om version 1 ved at klikke her