Eduarte

Import - Eduarte

Dit artikel beschrijft de import. De exports van deze koppeling, zoals de roosterpublicatie en de export van groepen, staan in het artikel Export - Eduarte.

Inleiding

De koppeling tussen Eduarte en Xedule verbindt de deelnemer- en onderwijsadministratie met het plannen en roosteren. De gegevensstroom loopt twee kanten op. Vanuit Eduarte komen de basisgegevens naar Xedule: deelnemers, groepen, opleidingen, onderwijsproducten, afspraaktypen, keuzes en toetsmomenten. Vanuit Xedule gaat het rooster naar Eduarte, en kunnen groepen waarvan Xedule de bron is naar Eduarte worden weggeschreven. Er gaan geen andere basisgegevens van Xedule naar Eduarte.

Dit document beschrijft die drie stromen: de import van basisgegevens (hoofdstuk “Basisgegevens importeren uit Eduarte”), de roosterpublicatie Weekrooster Export: Eduarte – Participatie (hoofdstuk “Weekrooster Export: Eduarte – Participatie”) en Eduarte Export: Groepen (hoofdstuk “Eduarte Export: Groepen”). Daarnaast staan de randvoorwaarden, de configuratiepagina en de meldingen beschreven.

De koppeling werkt per organisatorische eenheid. Elke eenheid heeft een eigen adres, een eigen sleutel en een eigen roosterstructuur in Eduarte. Niets wordt automatisch gesynchroniseerd: u start een import of een publicatie zelf, of u laat dit door een geplande taak doen.

Randvoorwaarden en functionele eisen

Technische randvoorwaarden

• De koppeling Eduarte is voor uw omgeving geactiveerd. Het activeren gebeurt door de functioneel beheerders van Eduarte en van Xedule samen.
• Per klantomgeving is bij Eduarte een eigen adres ingericht, van de vorm klantnaam.educus.nl voor productie en klantnaam-test.educus.nl voor acceptatie. Xedule vult dat adres per organisatorische eenheid aan met het onderdeel dat het nodig heeft, bijvoorbeeld /services/api/xedule/deelnemer.
• Bij elk adres hoort een API-sleutel. Die wordt door Eduarte gegenereerd, kan alleen door de functioneel beheerder worden opgeslagen en is daarna niet meer zichtbaar. De sleutel wordt bij iedere aanroep meegestuurd.
• De combinatie van adres en sleutel geeft toegang tot gegevens in Eduarte. Behandel die combinatie daarom als vertrouwelijk: komt de sleutel in verkeerde handen, dan kan dat een datalek aan de Eduarte-zijde veroorzaken.
• Per organisatorische eenheid zijn de roosterstructuurcode en de roosterstructuurnaam uit Eduarte vastgelegd. Beide worden bij elke aanroep meegestuurd en bepalen op welk deel van Eduarte de koppeling werkt.
• De actie voor de betreffende service is voor de organisatorische eenheid ingeschakeld en de gebruiker heeft er rechten op. Is dat niet zo, dan staat de service niet in de lijst met services.

Inrichtingseisen in Eduarte

• Groepen hebben een actieve geldigheid voordat ze worden aangeboden, en een groepscode die binnen een lesjaar uniek is. Dubbele groepscodes leiden tot dubbele groepen in Xedule.
• Het type onderwijsproduct komt overeen met het vrijgegeven type.
• De periodisering in Eduarte komt overeen met de periodisering in Xedule. Keuzes worden namelijk per onderwijsperiode opgehaald en op de Xedule-perioden geplaatst die daarmee overlappen.
• De medewerkercode in Eduarte is dezelfde identificatie als in Xedule.
• De afspraaktypen die voor de presentieregistratie nodig zijn, bestaan in Eduarte.
• Voor de export van groepen geldt dat de deelnemercode in Eduarte overeenkomt met de studentcode in Xedule, en dat die code een geheel getal is.

Inrichtingseisen in Xedule

• De afspraaktypematrix is ingericht: hierin legt u vast welk Xedule-activiteitstype bij welk Eduarte-afspraaktype hoort. Gebruikt u alleen het roosterbericht, dan is Eduarte de bron voor de groepscodes en de deelnemercodes.
• De roosterstructuren zijn aanwezig. Dit heeft geen invloed op bestaande inrichting.
• Alleen geroosterde activiteiten gaan mee in het roosterbericht. Activiteiten in Lessen (Week) waarvan het veld Tijd niet is gevuld, gaan niet naar Eduarte.
• Voor de groepenexport moeten de velden Groep.code en Groep.referentie dezelfde waarde hebben, en moet er ten minste één student aan de groep hangen.
• De referentie van het onderwijsproduct is optioneel. Zijn de onderwijsproducten via de koppeling uit Eduarte gekomen, dan is die referentie automatisch gevuld en gaat hij automatisch mee. Een afspraak met onderwijsproductreferentie wordt in de agenda van Eduarte anders getoond dan een afspraak zonder.

De configuratiepagina

De koppeling wordt ingericht via Beheer, onderdeel Configuratie. De pagina bestaat uit twee delen: instellingen die voor de gehele organisatie gelden — dus over alle organisatorische eenheden heen — en instellingen per organisatorische eenheid. Normaliter hoeft u in het eerste deel niets aan te passen; dat is bedoeld voor uitzonderingen.

Dit hoofdstuk beschrijft uitsluitend wat u in het configuratiescherm instelt. Wat er per entiteit wordt opgehaald staat in hoofdstuk “Basisgegevens importeren uit Eduarte”, wat het roosterbericht bevat in hoofdstuk “Weekrooster Export: Eduarte – Participatie”, en wat de groepenexport verstuurt in hoofdstuk “Eduarte Export: Groepen”.

Instellingen voor de gehele organisatie

De velden Uid, Location, Prod id, Description, Summary en Comment en de waarden van de kenmerken zijn maskers: u kiest per veld uit een vaste lijst met gegevens van de activiteit, de groep, de student, de medewerker of de faciliteit, en u kunt die combineren met vaste tekst. Deze instellingen werken alleen op het roosterbericht (hoofdstuk “Weekrooster Export: Eduarte – Participatie”); op de import en op de groepenexport hebben ze geen invloed.

Instelling	Betekenis en standaardwaarde
Geplande uitval exporteren	Bepaalt of geplande uitval in het roosterbericht wordt meegenomen. Standaard: aan. Zie paragraaf “Geplande uitval”.
Split kleine pauze	Neemt kleine pauzes binnen een activiteit op in het rooster, zodat er voor en na de pauze afzonderlijk presentie kan worden geregistreerd. Standaard: aan.
Individuele studenten	Stuurt studenten afzonderlijk mee in plaats van alleen hun groep. Standaard: aan. Zie paragraaf “Deelnemers van een afspraak”.
Alleen individuele studenten met referentie	Beperkt dat tot studenten met een referentie in de basisdata. Standaard: uit.
Alleen individuele studenten bij studentgroep	Stuurt de studenten van studentgroepen afzonderlijk mee. Standaard: aan.
Alleen individuele studenten bij lesgroep	Stuurt de studenten van lesgroepen afzonderlijk mee. Standaard: uit.
Uid	Sleutel waarmee Eduarte een afspraak herkent bij een volgend roosterbericht. Standaard: het nummer van de activiteit, zoals u dat in Lessen (Week) ziet.
Location	Locatie van de afspraak. Standaard: de naam van de organisatorische eenheid.
Prod id	Herkomst van de afspraak. Standaard: de referentie van het onderwijsproduct.
Description	Titel van de afspraak. Standaard: de vakcode.
Summary	Aanvullende titel. Standaard leeg; wordt alleen meegestuurd als u het vult.
Comment	Opmerking bij de afspraak. Standaard leeg.
Groep code	De code waarmee een groep wordt meegestuurd. Standaard: de referentie van de groep, en als die leeg is de code van de groep.
Student code	Idem voor studenten. Standaard: de referentie van de student, en als die leeg is de code van de student.
Medewerker code	Idem voor medewerkers. Standaard: het personeelsnummer.
Faciliteit code	Idem voor faciliteiten. Standaard: de code van de faciliteit.
Groep / Student / Medewerker / Faciliteit call address	Het adres dat bij een deelnemer wordt meegestuurd. Standaard: de code van de deelnemer gevolgd door @xedule.nl.
Categories	De kenmerken die bij elke afspraak worden meegestuurd, elk met een naam en een waarde. Standaard zijn zeven kenmerken ingericht; zie paragraaf “Inhoud van het roosterbericht”.

Instellingen per organisatorische eenheid

Per organisatorische eenheid legt u vast met welk deel van Eduarte die eenheid communiceert. Alle vier de velden zijn nodig; ontbreekt er één, dan mislukken de import en de publicatie voor die eenheid.

Veld	Waarde / voorbeeld	Toelichting
Endpoint	https://klantnaam.educus.nl	Het adres van de klantomgeving bij Eduarte. Xedule vult dit adres zelf aan met het onderdeel dat bij de gevraagde gegevens hoort. De invoer wordt op het formaat van een webadres gecontroleerd.
Api key	•••••••••	De sleutel die bij dit adres hoort. Na opslaan is de waarde niet meer zichtbaar, maar wel in werking.
Roosterstructuurcode	Code uit Eduarte	Wordt bij elke aanroep meegestuurd en bepaalt op welke roosterstructuur in Eduarte wordt gewerkt.
Roosterstructuurnaam	Naam uit Eduarte	Wordt samen met de code meegestuurd.

Basisgegevens importeren uit Eduarte

Handmatig importeren en geplande taken

Eduarte zet de gegevens klaar op zijn webserviceplatform; Xedule haalt ze daar op. U krijgt de opgehaalde gegevens eerst naast de bestaande basisdata te zien en bepaalt daarna zelf wat er wordt doorgevoerd. Zo komt er niets in de basisdata terecht zonder dat u het hebt gezien.

Van Eduarte naar de basisdata van Xedule.

Een import start u handmatig via het tabblad Import, of u laat dit door een geplande taak doen. In beide gevallen kiest u hoe de gegevens worden verwerkt: bijwerken; toevoegen en bijwerken; of toevoegen, bijwerken en verwijderen. Bij een handmatige verversing kunt u daarnaast filteren; wat u wegfiltert, wordt niet verwerkt.

Een import haalt de gegevens op voor het schooljaar waarvoor u importeert. Bij de eerste keer dat een deelnemer wordt aangemaakt, worden de velden Studeert en Beschikbaar gevuld. Studeert volgt daarna de gegevens uit Eduarte: komt een deelnemer niet meer mee omdat zijn verbintenis in het actieve schooljaar is geëindigd, dan komt Studeert op een minteken te staan; wordt de verbintenis verlengd en importeert u binnen de nieuwe looptijd, dan staat Studeert weer op een plusteken. De beschikbaarheid wordt eenmalig bij het aanmaken op actief gezet en daarna niet meer bijgewerkt.

Toetsmomenten en keuzes kunnen in het modulescherm worden uitgeschakeld, zodat ze niet per ongeluk kunnen worden geïmporteerd. Zijn ze uitgeschakeld, dan zijn ze niet beschikbaar bij een handmatige import en niet bij een geplande taak.

De drie doorvoerknoppen

Een import schrijft nooit rechtstreeks weg. Nadat de gegevens zijn opgehaald, toont Xedule een vergelijking: links de gegevens zoals het bronsysteem ze aanlevert, rechts dezelfde gegevens zoals ze op dat moment in Xedule staan. Pas wanneer u op een doorvoerknop drukt, verandert er iets in Xedule. Welke knop u kiest, bepaalt hoe ver dat doorvoeren gaat.

Elke import doorloopt dezelfde vier stappen; alleen de laatste stap wijzigt gegevens.

Er zijn drie knoppen. Ze werken in alle importkoppelingen op dezelfde manier en gaan altijd één kant op: van het bronsysteem naar Xedule. Via deze schermen wordt er nooit iets naar het bronsysteem teruggeschreven.

Pictogram	Knop	Wat de knop doet	Wanneer u die kiest
	bijwerken	Werkt alleen de regels bij die zowel in het bronsysteem als in Xedule bestaan en waarvan een of meer waarden verschillen. Er wordt niets toegevoegd en niets verwijderd.	Als u alleen wijzigingen op bestaande gegevens wilt overnemen en bewust nog geen nieuwe objecten in Xedule wilt laten ontstaan.
	toevoegen en bijwerken	Doet hetzelfde als bijwerken en maakt daarnaast de regels aan die alleen in het bronsysteem voorkomen. Er wordt niets verwijderd.	De gebruikelijke keuze voor een reguliere import gedurende het jaar.
	toevoegen, bijwerken en verwijderen	Doet hetzelfde als toevoegen en bijwerken en trekt daarnaast de geldigheid in van de objecten die alleen nog in Xedule bestaan.	Alleen wanneer het bronsysteem voor deze gegevensgroep volledig leidend is en de aanlevering compleet is.

Er is geen knop waarmee u uitsluitend toevoegt: bij elke knop die toevoegt, worden bestaande regels ook bijgewerkt.

Het resultaat van elke knop, per soort verschil tussen beide kanten.

Welke velden worden overgenomen

Bij een bijwerking worden niet alle velden overschreven, maar alleen de velden die daadwerkelijk verschillen; regels die in het geheel niet verschillen worden overgeslagen. Welke velden worden vergeleken, ligt per gegevensgroep vast: dat zijn precies de velden die in de vergelijking naast elkaar worden getoond. Velden die niet in de vergelijking voorkomen, worden door een import dus nooit overschreven.

Wat verwijderen precies doet

Verwijderen is geen harde verwijdering. Xedule trekt de geldigheid van het object in voor het tijdvak waarin u werkt; het object zelf en zijn historie blijven bestaan. In de praktijk betekent dat bijvoorbeeld dat een medewerker voor dat tijdvak uit dienst wordt gezet, een student in dat tijdvak niet meer studeert, een faciliteit in dat tijdvak niet meer geldig is, of dat een relatie tussen twee objecten voor dat tijdvak vervalt. Een groep is de uitzondering: valt de periode van de groep volledig binnen het tijdvak, dan wordt de groep zelf opgeruimd.

• Alleen gegevens die per tijdvak geldig zijn, kunnen op deze manier worden ingetrokken. Gegevenssoorten zonder tijdvak worden door de verwijdervariant ongemoeid gelaten.
• De knop kijkt niet naar de herkomst van een object. Objecten die handmatig in Xedule zijn aangemaakt en die niet in de aanlevering voorkomen, worden dus ook ingetrokken — tenzij de koppeling ze via een vast filter buiten de vergelijking houdt.
• Er wordt niet gecontroleerd of het object elders nog in gebruik is. Een object dat nog in het rooster of de jaarplanning voorkomt, wordt evengoed ingetrokken.

Alleen bij deze variant vraagt Xedule vooraf om een bevestiging. Het doorvoeren zelf gebeurt in één handeling: gaat er iets mis, dan blijven de gegevens in Xedule zoals ze waren.

Hoe een regel links aan een regel rechts wordt gekoppeld

Of een regel als nieuw, als gewijzigd of als alleen in Xedule wordt gezien, hangt af van de manier waarop beide kanten aan elkaar worden gekoppeld. Xedule gebruikt daarvoor in de eerste plaats de referentie uit het bronsysteem die bij het Xedule-object is vastgelegd. Is die niet gevuld, dan valt de vergelijking terug op de natuurlijke sleutel van het object: bijvoorbeeld het personeelsnummer van een medewerker, de code van een student of leeractiviteit, of de combinatie van code, periode en type bij een groep. Hoofdletters spelen daarbij geen rol.

Dit verklaart de twee situaties die het vaakst tot onverwachte uitkomsten leiden. Wijzigt in het bronsysteem de sleutel van een object waarvan in Xedule nog geen referentie is vastgelegd, dan ziet Xedule dat als een nieuw object naast het bestaande. En heeft een handmatig aangemaakt Xedule-object dezelfde sleutel als een aangeleverd object, dan worden beide als één regel behandeld en wordt het handmatige object met de aangeleverde waarden bijgewerkt.

Waarop een knop wordt toegepast

Een knop werkt op alle regels van de gegevensgroep die op dat moment geopend is, en niet op een selectie; er is geen aanvinkmogelijkheid per regel. Wel kan de lijst worden gefilterd op het soort verschil — alles, alleen links, alleen rechts, in beide, of in beide maar ongelijk — en werkt de knop daarna alleen op de regels die het filter overlaat. Wordt de knop op het overzichtstabblad gebruikt, dan geldt de keuze voor alle gegevensgroepen van die import tegelijk.

Dezelfde keuze in een geplande taak

Wordt de import als geplande taak uitgevoerd, dan vervalt de vergelijkingsstap en ligt de keuze vooraf vast. Per gegevensgroep zijn dezelfde drie mogelijkheden in te stellen, aangevuld met de mogelijkheid die gegevensgroep over te slaan. Is er voor een taak niets ingericht, dan geldt de ruimste variant en wordt er dus ook verwijderd. Richt een geplande taak daarom altijd bewust in, en werk in de beginperiode handmatig tot de gegevensstroom stabiel is.

Deelnemers

Deelnemers worden opgehaald op het onderdeel /services/api/xedule/deelnemer, in blokken van vijfhonderd deelnemers tot er geen gegevens meer volgen. Bij elke deelnemer komen de inschrijvingen en de groepsdeelnames mee.

Extern veld (exacte benaming)	Betekenis	Xedule-bestemming	Verwerking / filter
roepnaam	De roepnaam van de deelnemer.	Voornaam van de student.	—
achternaam	De achternaam van de deelnemer.	Achternaam van de student.	Is er een voorvoegsel, dan wordt dat achter de achternaam geplaatst, gescheiden door een komma.
voorvoegsel	Het voorvoegsel van de achternaam.	Achternaam van de student.	Zie de regel bij achternaam; het voorvoegsel krijgt geen eigen veld.
deelnemernummer	Het deelnemersnummer.	Code van de student.	Hierop wordt bij een volgende import herkend, en hierop is de groepenexport gebaseerd (hoofdstuk “Eduarte Export: Groepen”).
inschrijvingen	De opleidingen waarop de deelnemer is ingeschreven, met looptijd.	Volgt opleiding.	Alleen inschrijvingen die in het schooljaar vallen. Levert een deelnemer geen enkele inschrijving op een bekende opleiding op, dan wordt hij niet geïmporteerd. Importeer daarom de opleidingen mee.
groepsdeelnames	De groepen waarvan de deelnemer lid is, met looptijd.	Lid van groep.	De looptijd wordt omgezet naar de tijdvakken van het schooljaar. Een deelnemer die op hetzelfde moment aan meerdere klassen is gekoppeld, wordt niet geïmporteerd; zie hoofdstuk “Foutafhandeling en meldingen”.
—	Opmerking bij de deelnemer.	Opmerking van de student.	Wordt bij de import leeg gelaten.

Groepen

Groepen worden opgehaald op het onderdeel /services/api/xedule/inrichting. Een groep wordt alleen geïmporteerd wanneer de geldigheid overlapt met de periode waarvoor u importeert.

Extern veld (exacte benaming)	Betekenis	Xedule-bestemming	Verwerking / filter
code	De groepscode zoals die in Eduarte bestaat.	Code en referentie van de groep.	De code wordt op beide velden gezet. Staat een groep in Xedule zonder referentie of met een afwijkende referentie, dan ontstaat bij het doorvoeren een tweede groep, met de naam van de gebruiker tussen haakjes achter de groepscode.
naam	De groepsnaam zoals die in Eduarte bestaat.	Naam van de groep.	—
groepstype	Het groepstype uit Eduarte.	Opmerking bij de groep.	—
xeduleGroeptype	Het soort groep voor Xedule.	Type van de groep.	XeduleKlas wordt een klas en XeduleLesgroep wordt een lesgroep. Is er niets aangegeven, dan wordt het een klas.
begindatum / einddatum	De geldigheid van de groep.	—	Dient als filter: valt de geldigheid volledig buiten de periode waarvoor u importeert, dan wordt de groep overgeslagen.
—	Het jaar waarin de groep bestaat.	Jaar van de groep.	Het schooljaar waarvoor u importeert.

Opleidingen, onderwijsproducten, afspraaktypen en keuzes

Deze vier onderdelen komen alle van het onderdeel /services/api/xedule/inrichting, behalve de keuzes: die komen van /services/api/xedule/keuzeregel. Onderwijsproducten worden in blokken van honderd opgehaald. Keuzes worden per onderwijsperiode opgehaald die overlapt met de periode waarvoor u importeert.

Entiteit	Extern veld (exacte benaming)	Betekenis	Xedule-bestemming	Verwerking / filter
Opleiding	code	Code van de opleiding.	Code van de opleiding.	—
Opleiding	naam	Naam van de opleiding.	Weergavenaam van de opleiding.	—
Opleiding	duurInMaanden	Nominale duur in maanden.	Nominale duur van de opleiding.	Wordt naar hele jaren omgerekend en naar boven afgerond. Is de duur niet gevuld, dan wordt het niveau als duur gebruikt; is ook dat niet gevuld, dan wordt de duur 1.
Opleiding	niveau	Het opleidingsniveau.	Niveau van de opleiding.	Zie de regel bij duurInMaanden. Standaard 1.
Opleiding	leerweg	De leerweg.	Leerweg van de opleiding.	BBL wordt overgenomen; elke andere waarde wordt BOL.
Opleiding	externeCode	De crebocode.	Externe code van de opleiding.	—
Opleiding	beginDatum / eindDatum	De looptijd van de opleiding.	Startjaar en eindjaar.	Zijn ze leeg, dan geldt de periode waarvoor u importeert.
Onderwijs-product	code	Code van het onderwijsproduct.	Code en referentie van het onderwijsproduct, en code van de leeractiviteit.	Er wordt één onderwijsproduct met één leeractiviteit aangemaakt die naar elkaar verwijzen.
Onderwijs-product	naam	Naam van het onderwijsproduct.	Naam van het onderwijsproduct.	—
Onderwijs-product	duur	De duur in rooster-eenheden.	Duur van de leeractiviteit.	—
Onderwijs-product	frequentie	Hoe vaak het product gegeven moet worden.	Aantal keer bij de leeractiviteit.	—
Afspraaktype	naam	Naam van het afspraaktype.	Code van het afspraaktype.	—
Afspraaktype	omschrijving / categorie	Omschrijving en categorie.	Omschrijving van het afspraaktype.	Beide worden samengevoegd tot omschrijving (categorie).
Keuze	deelnemernummer	De deelnemer die de keuze heeft gemaakt.	De student.	De deelnemer en het onderwijsproduct moeten in Xedule bestaan; anders wordt de keuze overgeslagen.
Keuze	onderwijsproduct.code	Het gekozen onderwijsproduct.	Volgt opdracht bij de student.	De keuze wordt geplaatst op elke Xedule-periode die met de onderwijsperiode overlapt.

Toetsmomenten

Toetsmomenten worden opgehaald op het onderdeel /services/api/xedule/toetsmomenten, in blokken van honderd, voor de periode waarvoor u importeert. Alleen toetsmomenten die volledig binnen het schooljaar vallen worden verwerkt, en alleen wanneer er een planningsperiode of een begin- en eindtijd bekend is; zo niet, dan volgt een melding (hoofdstuk “Foutafhandeling en meldingen”).

Eén toetsmoment levert in Xedule meer dan één object op. Er wordt een toets aangemaakt met daaronder één toetsactiviteit, een groep met de deelnemers van dat toetsmoment, en — wanneer het toetsmoment binnen één periode valt — een geroosterde activiteit met de docenten erbij. Is er voorbereidingstijd opgegeven, dan komt daar een tweede activiteit voor de voorbereiding bij, direct vóór het toetsmoment.

Extern veld (exacte benaming)	Betekenis	Xedule-bestemming	Verwerking / filter
titel	De titel van het toetsmoment.	Naam van de toets en de toetsactiviteit.	De groep die bij het toetsmoment hoort krijgt de titel als naam en de titel met het nummer van het toetsmoment als code.
omschrijving / opmerking	Omschrijving en opmerking.	Omschrijving van de toets.	Beide worden onder elkaar gezet.
id	Het nummer van het toetsmoment in Eduarte.	Referentie van de toets.	Wordt ook in de code van de groep opgenomen en als referentie van de geroosterde activiteit gebruikt.
toetsduur	De duur van de toets in minuten.	Duur van de toetsactiviteit.	Is de duur 0, dan wordt de duur van één rooster-eenheid gebruikt.
maximaalAantalPlaatsen	Het maximum aantal deelnemers.	Maximum aantal studenten van de toetsactiviteit.	Is het maximum 0, dan wordt 999 gebruikt.
planningsperiode of begindatumTijd / einddatumTijd	Wanneer het toetsmoment plaatsvindt.	Geldigheid en plaatsing van de activiteit.	De begin- en eindtijd hebben voorrang op de planningsperiode. Is geen van beide bekend, dan volgt een melding.
deelnemers	De deelnemers van het toetsmoment, met hulpmiddelen.	Studenten in de toetsgroep, en volgt toets.	Alleen deelnemers die al in Xedule bestaan. Een deelnemer volgt de toets alleen wanneer het toetsmoment binnen één periode valt.
hulpmiddelen	Hulpmiddel met percentage extra tijd.	Hulpmiddel bij de student en bij de toets.	Code en percentage vormen samen de code van het hulpmiddel; het percentage wordt als factor opgeslagen.
medewerkers	De docenten bij het toetsmoment.	Gegeven door medewerkers.	Bestaat de medewerker nog niet, dan wordt hij aangemaakt.
afspraakType.naam	Het afspraaktype van het toetsmoment.	Afspraaktype van de activiteit.	—
voorbereidingstijd	De voorbereidingstijd in minuten.	Een tweede activiteit voor de voorbereiding.	De duur wordt omgerekend naar rooster-eenheden, met een minimum van één.

Foutafhandeling en meldingen

Meldingen zijn per import, publicatie of export op te vragen in het paneel Resultaten. Bij de roosterpublicatie geeft de kolom Status het technische verloop weer: Bezig met vrijgeven terwijl het bericht wordt aangemaakt en verstuurd, Vrijgeven wanneer Eduarte het bericht heeft ontvangen, en Fout wanneer er bij het aanmaken, versturen of ontvangen iets is misgegaan.

Bij de status staat een icoon met een i. Daarachter zit het functionele report van het roosterbericht: wat Eduarte van het bericht heeft gemaakt. Xedule toont altijd het report van het laatst verstuurde bericht; verstuurt u een nieuw bericht, dan wordt het vorige report overschreven. De meldingen die Eduarte teruggeeft, worden op niveau ingedeeld: informatieve meldingen over het ontvangen bericht, waarschuwingen over elementen die Eduarte niet herkent, en fouten wanneer het bericht wel is ontvangen maar niet kan worden afgehandeld.

Melding	Niveau	Betekenis en actie
Medewerker onbekend, Groep onbekend, Deelnemer onbekend, Onderwijsproduct onbekend, Afspraaktype onbekend	Waarschuwing	Eduarte herkent dit element uit het roosterbericht niet. De afspraak staat wel in de agenda, maar zonder dit element. Herstel de oorzaak en verstuur het bericht opnieuw.
Meldingen over de roosterstructuur of het afspraaktype	Fout	Het bericht is ontvangen maar kan niet worden afgehandeld. Controleer de roosterstructuur van de eenheid (paragraaf “Instellingen per organisatorische eenheid”) en de afspraaktypematrix.
Overige meldingen van Eduarte over het ontvangen bericht	Informatie	Informatie over de verwerking; er is geen actie nodig.
De tekst van een technische fout bij het versturen	Fout	Het bericht is niet verstuurd of niet ontvangen. Veelvoorkomende oorzaken: er is geen configuratie voor deze organisatorische eenheid, of het adres of de sleutel is onjuist.
Deelnemer aan meerdere groepen gekoppeld	Fout bij de import	De deelnemer is in Eduarte binnen één schooljaar aan meerdere groepen met dezelfde code gekoppeld. Deze deelnemer wordt niet geïmporteerd.
Meerdere klassen op hetzelfde moment	Fout bij de import	De deelnemer is op hetzelfde moment lid van meer dan één klas. Deze deelnemer wordt niet geïmporteerd; herstel het lidmaatschap in Eduarte.
No valid time specified for toetsmoment	Fout bij de import	Bij het toetsmoment is geen planningsperiode en geen begin- en eindtijd bekend. Vul dit in Eduarte aan.
Invalid format: Code is not a valid integer.	Fout bij de groepenexport	De code van een student is geen geheel getal. De export wordt niet uitgevoerd; herstel de studentcode.
Overflow: Code is too large or too small for an integer.	Fout bij de groepenexport	Dezelfde oorzaak: de studentcode is geen bruikbaar getal.
<groepscode> gevolgd door de meldingen van Eduarte	Fout bij de groepenexport	Eduarte heeft deze groep niet verwerkt. De melding bevat de reden die Eduarte teruggeeft.
<groepscode>: unexpected error	Fout bij de groepenexport	De aanroep voor deze groep is mislukt. De overige groepen zijn wel verstuurd; probeer deze groep opnieuw.