Veldenmappings

Docent

Docenten worden geïmporteerd vanuit de EDU-DEX “teacher” elementen. De volgende eigenschappen worden overgenomen naar Class:

Faciliteit

Faciliteiten worden geïmporteerd vanuit de EDU-DEX “location” elementen. De onderstaande eigenschappen worden overgenomen naar Class. Naam en unieke code worden gegenereerd op basis van een speciale samenstelling van deze eigenschappen:

Opleiding

Opleidingen worden geïmporteerd vanuit de EDU-DEX “program” elementen. Alleen opleidingen met applicationType “individual” worden door ons systeem geïmporteerd.

Alleen opleidingen met startDateDetermination “fixed starting date”, “agreed starting date” of “direct start” worden in Class ingelezen. Bij een opleiding met startDateDetermination “agreed starting date” wordt door ons systeem automatisch een uitvoering met status “startdatum in overleg” aangemaakt. Merk op dat in de EDU-DEX xsd het toevoegen van de “startDate” en “endDate” altijd verplicht is. Class zal deze waardes echter negeren voor “agreed starting date” uitvoeringen. Bij een opleiding met startDateDetermination “direct start” wordt automatisch een uitvoering aangemaakt waarbij “Directe start / volledig online” is aangevinkt.

Vanuit de programDescriptions worden alleen de teksten met attribuut lang “nl” ingelezen.

De onderstaande eigenschappen worden overgenomen naar Class.

Prijzen

Let op dat prijzen in Class zijn gedefinieerd op het niveau van een opleiding, maar in EDU-DEX op het niveau van de uitvoering (programRun). Class zal proberen de prijzen uit de uitvoeringen van de opleiding te herleiden. Hierbij is het van belang dat er geen uitvoeringen met dezelfde startdatum bestaan, waarbij de prijzen van elkaar afwijken. Wanneer dit wel het geval is, zal Class een foutmelding m.b.t. de overlap geven. Wanneer er geen prijzen worden gevonden in “programRun” elementen, zal Class proberen de prijzen te herleiden vanuit het “genericProgramRun” element.
Indien bij de prijzen van een “programRun” prijscomponent (cost) met waarde “amountIsFinal” false zijn opgenomen, wordt de complete opleiding (program) niet geïmporteerd. CLC kan alleen opleidingen met vastgestelde prijs ontsluiten.

Indien bij de prijzen van een “programRun” prijscomponenten (cost) met een andere currency dan euro staan, zal de complete opleiding (program) niet worden geïmporteerd.

Optionele kostentypes, ofwel costTypes met voor eigenschap isRequiredCost de waarde “false”, worden door Class niet ingelezen. Een uitzondering daarop is het kostentype “accomodation” welke wordt ingelezen als “Overnachtingskosten (optioneel)”.

De volgende eigenschappen worden overgenomen naar Class:

Uitvoering

Aan de hand van het programSchedule worden de uitvoeringen in Class bepaald. Wij importeren daarbij alle “programRun” elementen als uitvoering.

Let op: Van het EDU-DEX element “genericProgramRun” wordt alleen het element “numberOfContactSessions” geïmporteerd. Deze wordt echter niet in de uitvoering geplaatst, maar in het veld “Aantal bijeenkomsten” van de opleiding. Verder wordt het “genericProgramRun” element gebruikt voor het bepalen van de prijzen, wanneer er in geen enkel “programRun” element een prijs wordt gevonden.

Bijeenkomst

Bijeenkomsten worden samengesteld uit de “courseDay” elementen uit de EDU-DEX XML. Hiervan worden de volgende elementen geïmporteerd:

Referentietabellen

Thema

Voor het bepalen van het thema wordt gekeken naar de “theme” classificatie van EDU-DEX. Hiervoor wordt de volgende mapping gehanteerd:

Doelgroep

Voor het bepalen van de doelgroep wordt gekeken naar de “targetSector” classificatie van EDU-DEX. Hiervoor wordt de volgende mapping gehanteerd:

Afronding

Voor het bepalen van de afronding wordt gekeken naar de “degree” classificatie van EDU-DEX. Hiervoor wordt de volgende mapping gehanteerd:

Werkvorm

Voor het bepalen van de werkvorm wordt gekeken naar de “instructionMode” classificatie van EDU-DEX. Hiervoor wordt de volgende mapping gehanteerd:

Opleidingsniveau

Voor het bepalen van opleidingsniveau wordt gekeken naar de “levelType” classificatie van EDU-DEX. Hiervoor wordt de volgende mapping gehanteerd:

Uitvoering status

Voor het bepalen van de status van de uitvoering wordt gekeken naar de “programRunStatus”. Hiervoor wordt de volgende mapping gehanteerd:

Kosten

De VAT velden van prijzen worden door ons systeem genegeerd. Wij houden de volgende vaste mapping van kosten type (costType) naar Class kostensoort en BTW percentage aan:

Aanbod importeren via EDU-DEX

De volledige Toelichting op importeren via EDU-DEX vind je in de beheeromgeving op de pagina Aanbod -> Aanbod importeren, tabblad XML import (inclusief Springest en EDU-DEX).

Hieronder vind je de eerste hoofdstukken uit de Toelichting op importeren via EDU-DEX.

Inleiding

Opleidingsleveranciers kunnen hun aanbod importeren in het LMS CLASS. Het aanbod wordt na importeren niet automatisch in de catalogi van de aangesloten leerportalen opgenomen. De learning services partner van het aangesloten leerportaal stemt met de beheerder van het portaal af of het aanbod wel, niet of gedeeltelijk wordt opgenomen.

Het aanbod in het LMS CLASS moet door de opleidingspartner zelf actueel worden gehouden. Om dit voor jou als opleidingspartner zo makkelijk mogelijk te maken biedt CLASS hiervoor diverse mogelijkheden:

• Importeren via CSV bestanden
• Importeren via XML feed(s)
• Importeren via EDU-DEX feed(s)
• Importeren vanuit Springest

Wij raden aan om via EDU-DEX te importeren. EDU-DEX (http://edudex.nl) is een initiatief van de Nederlandse opleidingssector tot een open standaard voor aanbod van cursussen, opleidingen, studies, en e-learning modules.

Omdat CLASS en EDU-DEX qua datamodel niet precies gelijk zijn, worden tijdens het importeren een aantal transformaties op de data gedaan. Dit document beschrijft hoe het LMS CLASS vanuit een EDUDEX feed het aanbod inleest in CLASS. In dit document worden o.a. de veldenmappings en vertalingen van EDU-DEX waardes naar CLASS beschreven.

⚠  Het is een vereiste dat je als opleidingspartner zorgt voor een actueel aanbod!

Instellen van een EDU-DEX feed in CLASS

Conclusion ondersteunt het importeren via XML feeds volgens de EDU-DEX standaard. Je kunt hier testen of je feed valideert tegen de standaard van EDU-DEX: https://feeds.edudex.nl/validator/.

De EDU-DEX import in CLASS is momenteel gebaseerd op EDU-DEX versie 2.0. CLASS ondersteunt het importeren van EDU-DEX directory en catalogus feeds.

Instellen van de feed
Volg de volgende stappen om je feed in te stellen:

• Ga via het menu naar Aanbod -> Aanbod importeren.
• Ga naar de tab ‘XML-import (inclusief Springest en EDU-DEX)’.
• Selecteer bij ‘Xml import feed type’ de optie ‘EDU-DEX XML feed’.
• Geef een e-mailadres op waar e-mails naartoe worden verzonden als er een fout optreedt.
• Vul onderaan de pagina de url van de feed in. Geef ook een naam aan deze feed.
• Klik op Opslaan.

Hoe vind je de url van jouw feed in EDU-DEX

In EDU-DEX is het mogelijk als opleider om een selectie (“catalogus”) aan te maken van de eigen programma’s. De URL voor de XML-file van die selectie kunt u vinden door in het submenu Catalogusbeheer op “Links tonen” te klikken. De bovenste link is de URL voor het XML-bestand die u in CLASS kunt invoeren.

Stappen in het importproces

Stap 1. Downloaden van de feed

In deze stap wordt de feed gedownload en opgeslagen in de database van CLASS. Het downloaden van de feed gebeurt elke nacht.

Tijdens de download wordt getoetst of de inhoud van de feed gewijzigd is ten opzichte van de feed van de vorige nacht. De velden lastEdited en Expires worden buiten beschouwing gelaten bij deze toets. Als de inhoud van de feed onveranderd is, wordt de feed niet verwerkt. In het importlog kan de leverancier zien dat er die nacht geen wijzigingen zijn doorgevoerd.

Tijdens het downloaden controleert CLASS of er in de feed meerdere programs (leeractiviteiten) zitten met hetzelfde programId.
Ook controleert CLASS op de structuur van de xml feed. Deze moet voldoen aan de EDU-DEX standaard versie 2.0.

Als een van bovenstaande fouten voorkomt, dan wordt het importproces afgebroken en stuurt CLASS een e-mail aan de leverancier waarin vermeld is dat de feed niet verwerkt kan worden. De reden daarvan staat in de e-mail.

Voorbeeld van deze e-mail:

In het importlog ziet de leverancier in dit geval de opmerking ‘Import mislukt (feed bevat fouten)’.

Stap 2. Importeren van de gedownloade feed

Als stap 1 succesvol is, dan importeert CLASS in stap 2 de gedownloade feed.

Tijdens het importeren controleert CLASS of de data in de xml feed voldoet aan de eisen die de omgeving stelt. De fouten in de data die kunnen voorkomen, zijn allemaal beschreven in hoofdstuk 3 ‘Validatie op data’.

Als tijdens het importeren blijkt dat de data in de xml feed van een program niet voldoet aan de eisen die de omgeving stelt, dan wordt de betreffende program overgeslagen. Hierover stuurt CLASS een e-mail aan de leverancier waarin vermeld is dat de feed gedeeltelijk niet verwerkt kan worden.

Voorbeeld van deze e-mail:

De leverancier kan op basis van deze informatie de data van het overgeslagen program aanpassen. Nadat de aanpassing is gedaan zal CLASS de nacht daarop het overgeslagen program alsnog proberen te importeren.

In het importlog ziet de leverancier in dit geval de opmerking ‘Import uitgevoerd met fouten (batch)’.

⚠ Let op: Als de leverancier de data van eerder overgeslagen programs de dag na de import nog niet heeft aangepast, dan zal het importlog niet opnieuw de opmerking ‘Import uitgevoerd met fouten (batch)’ tonen. Op de tussenliggende dagen zal het importlog in plaats daarvan de opmerking ‘Geen wijzigingen t.o.v. vorige import’ tonen.

Omdat CLASS en EDU-DEX qua datamodel niet precies gelijk zijn, worden tijdens het importeren een aantal transformaties op de data gedaan. Deze transformaties op de data zijn allemaal beschreven in hoofdstuk 4 ‘Veldenmappings’.

Validatie op data

Tijdens het importeren controleert CLASS of de data in de xml feed van een program voldoet aan de eisen die de omgeving stelt. Zo niet, dan wordt de betreffende program overgeslagen. Hierover stuurt CLASS een e-mail aan de leverancier waarin vermeld is dat de feed gedeeltelijk niet verwerkt kan worden.

De volgende validatie vindt plaats:

Algemeen

• programAdmissionApplicationType moet ‘individual’ zijn.Voorbeeld van hoe deze foutmelding in de e-mail wordt weergegeven:
  Import <program> with ID ‘1’
  Skipping <program> with ID ‘1’ because <applicationType> is not ‘individual’
• Het aantal thema’s mag niet groter zijn dan het maximum aantal thema’s dat in CLASS is toegestaan (50 thema’s).Voorbeeld van hoe deze foutmelding in de e-mail wordt weergegeven:
  “Skipping <program> with ID ‘1’ because it has 52 themes, while only 50 are allowed.”
• Meerdere programRuns (uitvoeringen) met hetzelfde ID zijn niet toegestaan.Voorbeeld van hoe deze foutmelding in de e-mail wordt weergegeven:
  “Skipping <program> with ID ‘1 ‘ because it has <programRun>s with the same IDs (2, 3, 4).”
• Meerdere courseDays (bijeenkomsten) met hetzelfde ID zijn niet toegestaan.Voorbeeld van hoe deze foutmelding in de e-mail wordt weergegeven:
  “Skipping <program> with ID ‘1′ because it has <programRun>s with <courseDay>s with the same IDs: programRun 2: courseDays 3, 4.”

Kosten

• Van de kosten mag amountIsFinal niet ‘false’ of ‘0’ zijn.Voorbeeld van hoe deze foutmelding in de e-mail wordt weergegeven:
  “Skipping program with ID ‘1’ because it contains <cost> elements where amountIsFinal is false”
• Het kostentype singlePaymentDiscount mag niet gebruikt worden.Voorbeeld van hoe deze foutmelding in de e-mail wordt weergegeven:
  “Skipping program with ID ‘1 ‘ because it contains <cost> elements with <costType> ‘single payment discount’.”
• Meerdere programRuns die op dezelfde dag starten mogen geen verschillende bedragen hebben voor eenzelfde costType.Voorbeeld van hoe deze foutmelding in de e-mail wordt weergegeven:
  Validating costs for <program> with ID ’66’
  Skipping <program> with ID ’66’: Unable to merge prices. <programRun>s with the same start date (6-9-2022 00:00:00) have different amounts for the cost types Course
  Import <program> with ID ’66’

⚠ Let op: als er geen kosten zijn voor programRuns, maar wel voor een genericProgramRun, wordt deze gebruikt voor de import en dan wordt daarop gevalideerd.